From owner-freebsd-doc@FreeBSD.ORG Sun Jun 12 02:08:56 2005 Return-Path: X-Original-To: doc@freebsd.org Delivered-To: freebsd-doc@FreeBSD.ORG Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id EEFCB16A41C for ; Sun, 12 Jun 2005 02:08:56 +0000 (GMT) (envelope-from bfoz@bfoz.net) Received: from sccrmhc12.comcast.net (sccrmhc12.comcast.net [204.127.202.56]) by mx1.FreeBSD.org (Postfix) with ESMTP id A158B43D48 for ; Sun, 12 Jun 2005 02:08:56 +0000 (GMT) (envelope-from bfoz@bfoz.net) Received: from [192.168.0.5] (c-24-6-134-233.hsd1.ca.comcast.net[24.6.134.233]) by comcast.net (sccrmhc12) with ESMTP id <200506120208550120016pise>; Sun, 12 Jun 2005 02:08:55 +0000 Message-ID: <42AB9935.4070201@bfoz.net> Date: Sat, 11 Jun 2005 19:08:53 -0700 From: Brandon Fosdick User-Agent: Mozilla Thunderbird 1.0.2 (X11/20050326) X-Accept-Language: en-us, en MIME-Version: 1.0 To: Chuck Swiger References: <42AA2B21.8040708@bfoz.net> <42AA761B.5020909@cs.tu-berlin.de> <42AB6EE1.7070405@bfoz.net> <42AB958F.7080300@mac.com> In-Reply-To: <42AB958F.7080300@mac.com> X-Enigmail-Version: 0.91.0.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doc@freebsd.org Subject: Re: Fwd: ACL not supported on 5.4? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 12 Jun 2005 02:08:57 -0000 Chuck Swiger wrote: > Brandon Fosdick wrote: >> Are handbook bugs handled through send-pr like everything else? > > > Yep. Although it's OK to forward the thread over to freebsd-doc and > hope someone does a quick fix, too. :-) It would help to mention which > section of the handbook is out-of-sync with the manpages.... > Thanks, I forgot about the doc list. The relevant handbook section is 14.12.1 (http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/fs-acl.html) and the offending text is the first sentence of the second to last paragraph and describes the -k flag of the setfacl command. It reads "The -k flag will remove all of the currently defined ACLs from a file or file system." which would indicate that -k can operate on regular files. According to the portion of the man page setfacl(1) regarding the -k flag "An error will be reported if any of the specified files cannot have a default entry (i.e. non-directo-ries)." which indicates that it doesn't work on ordinary files. I propose the following replacement text for the offending sentence. Feel free to come up with something better. "The -k flag will remove all of the currently defined ACLs from a directory."