Date: Mon, 23 Aug 2004 12:02:10 GMT From: Rostislav Krasny <rosti_bsd@yahoo.com> To: freebsd-gnats-submit@FreeBSD.org Subject: docs/70856: List of flags and their aliases in `man 1 chflags` is not clear Message-ID: <200408231202.i7NC2ADT004778@www.freebsd.org> Resent-Message-ID: <200408231210.i7NCAKvl054369@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 70856 >Category: docs >Synopsis: List of flags and their aliases in `man 1 chflags` is not clear >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Aug 23 12:10:20 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Rostislav Krasny >Release: 5.3-BETA1 >Organization: >Environment: FreeBSD localhost 5.3-BETA1 FreeBSD 5.3-BETA1 #0: Sat Aug 21 08:19:34 UTC 2004 root@mack.dcsl.buffalo.edu:/usr/obj/usr/src/sys/GENERIC i386 >Description: I think that following part of `man 1 chflags` is not clear: The flags are specified as an octal number or a comma separated list of keywords. The following keywords are currently defined: arch set the archived flag (super-user only) opaque set the opaque flag (owner or super-user only) nodump set the nodump flag (owner or super-user only) sappnd set the system append-only flag (super-user only) schg set the system immutable flag (super-user only) sunlnk set the system undeletable flag (super-user only) uappnd set the user append-only flag (owner or super-user only) uchg set the user immutable flag (owner or super-user only) uunlnk set the user undeletable flag (owner or super-user only) archived, sappend, schange, simmutable, uappend, uchange, uimmutable, sunlink, uunlink aliases for the above The list of the aliases say nothing about what keyword is the alias of what another keyword in the above list. It also say nothing about that some keywords have two aliases. >How-To-Repeat: Run 'man 1 chflags' >Fix: IMHO the above part of the manual should be changed as following: The flags are specified as an octal number or a comma separated list of keywords. The following keywords are currently defined: arch archived set the archived flag (super-user only) opaque set the opaque flag (owner or super-user only) nodump set the nodump flag (owner or super-user only) sappnd sappend set the system append-only flag (super-user only) schg schange simmutable set the system immutable flag (super-user only) sunlnk sunlink set the system undeletable flag (super-user only) uappnd uappend set the user append-only flag (owner or super-user only) uchg uchange uimmutable set the user immutable flag (owner or super-user only) uunlnk uunlink set the user undeletable flag (owner or super-user only) >Release-Note: >Audit-Trail: >Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200408231202.i7NC2ADT004778>