From nobody@FreeBSD.org  Mon Aug 23 12:02:11 2004
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 14FE816A4E1
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 23 Aug 2004 12:02:11 +0000 (GMT)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id E6F7143D1F
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 23 Aug 2004 12:02:10 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.12.11/8.12.11) with ESMTP id i7NC2Axa004779
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 23 Aug 2004 12:02:10 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.12.11/8.12.11/Submit) id i7NC2ADT004778;
	Mon, 23 Aug 2004 12:02:10 GMT
	(envelope-from nobody)
Message-Id: <200408231202.i7NC2ADT004778@www.freebsd.org>
Date: Mon, 23 Aug 2004 12:02:10 GMT
From: Rostislav Krasny <rosti_bsd@yahoo.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: List of flags and their aliases in `man 1 chflags` is not clear
X-Send-Pr-Version: www-2.3

>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:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 23 12:10:20 GMT 2004
>Closed-Date:    Tue Dec 21 22:32:00 GMT 2004
>Last-Modified:  Tue Dec 21 22:32:00 GMT 2004
>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:
State-Changed-From-To: open->patched 
State-Changed-By: keramida 
State-Changed-When: Tue Sep 21 10:13:41 GMT 2004 
State-Changed-Why:  
I committed a fix for this in HEAD.  An MFC will be done in a few 
days.  Thanks for your help improving FreeBSD :) 

http://www.freebsd.org/cgi/query-pr.cgi?pr=70856 
Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Tue Oct 12 14:56:07 GMT 2004 
Responsible-Changed-Why:  
Assign this to me, as a reminder to MFC the changes. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=70856 
State-Changed-From-To: patched->closed 
State-Changed-By: keramida 
State-Changed-When: Tue Dec 21 22:30:26 GMT 2004 
State-Changed-Why:  
I've merged this to RELENG_5.  Thanks again for submitting the initial PR and 
being patient with the long delays between my commits :) 

http://www.freebsd.org/cgi/query-pr.cgi?pr=70856 
>Unformatted:
