From owner-freebsd-doc@FreeBSD.ORG Mon Aug 23 12:10:20 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C854116A4CE for ; Mon, 23 Aug 2004 12:10:20 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id AB38A43D41 for ; Mon, 23 Aug 2004 12:10:20 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i7NCAKSU054370 for ; Mon, 23 Aug 2004 12:10:20 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i7NCAKvl054369; Mon, 23 Aug 2004 12:10:20 GMT (envelope-from gnats) Resent-Date: Mon, 23 Aug 2004 12:10:20 GMT Resent-Message-Id: <200408231210.i7NCAKvl054369@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Rostislav Krasny Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 14FE816A4E1 for ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-2.3 Subject: docs/70856: List of flags and their aliases in `man 1 chflags` is not clear X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 23 Aug 2004 12:10:21 -0000 >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: