From owner-svn-doc-head@freebsd.org Thu Oct 1 15:39:34 2015 Return-Path: Delivered-To: svn-doc-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 5D4F4A0D103; Thu, 1 Oct 2015 15:39:34 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "wonkity.com", Issuer "wonkity.com" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 043501E73; Thu, 1 Oct 2015 15:39:33 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.15.2/8.15.2) with ESMTPS id t91FdWtw097024 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Thu, 1 Oct 2015 09:39:32 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.15.2/8.15.2/Submit) with ESMTP id t91FdWGJ097021; Thu, 1 Oct 2015 09:39:32 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Thu, 1 Oct 2015 09:39:32 -0600 (MDT) From: Warren Block To: Jason Helfman cc: Warren Block , doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: Re: svn commit: r47469 - head/en_US.ISO8859-1/books/fdp-primer/writing-style In-Reply-To: Message-ID: References: <201510011455.t91EteM1034915@repo.freebsd.org> User-Agent: Alpine 2.20 (BSF 67 2015-01-07) MIME-Version: 1.0 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Thu, 01 Oct 2015 09:39:32 -0600 (MDT) Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8BIT X-Content-Filtered-By: Mailman/MimeDel 2.1.20 X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 01 Oct 2015 15:39:34 -0000 On Thu, 1 Oct 2015, Jason Helfman wrote: > On Thu, Oct 1, 2015 at 7:55 AM, Warren Block wrote: > Author: wblock > Date: Thu Oct  1 14:55:39 2015 > New Revision: 47469 > URL: https://svnweb.freebsd.org/changeset/doc/47469 > > Log: >   Swap two words transposed. > > Modified: >   head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml > > Modified: head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml     Thu Oct  1 14:34:32 2015        (r47468) > +++ head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml     Thu Oct  1 14:55:39 2015        (r47469) > @@ -196,7 +196,7 @@ >           For example, commands: > >           > -           Wrong: Use the command svn to > +           Wrong: Use the svn command to >               update sources. >           > > _______________________________________________ > svn-doc-all@freebsd.org mailing list > https://lists.freebsd.org/mailman/listinfo/svn-doc-all > To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org" > > > > Why we are documenting what shouldn't be done? I thought that this was discouraged. It is. This section has been around forever, but a bigger issue is that this type of redundancy is difficult to explain without showing the wrong way. Suggestions welcome. From owner-svn-doc-head@freebsd.org Thu Oct 1 15:42:04 2015 Return-Path: Delivered-To: svn-doc-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 392C1A0D363; Thu, 1 Oct 2015 15:42:04 +0000 (UTC) (envelope-from jgh@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 2A3B11190; Thu, 1 Oct 2015 15:42:04 +0000 (UTC) (envelope-from jgh@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.70]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id t91Fg4eQ055428; Thu, 1 Oct 2015 15:42:04 GMT (envelope-from jgh@FreeBSD.org) Received: (from jgh@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id t91Fg4mI055427; Thu, 1 Oct 2015 15:42:04 GMT (envelope-from jgh@FreeBSD.org) Message-Id: <201510011542.t91Fg4mI055427@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: jgh set sender to jgh@FreeBSD.org using -f From: Jason Helfman Date: Thu, 1 Oct 2015 15:42:04 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r47470 - head/en_US.ISO8859-1/books/faq X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 01 Oct 2015 15:42:04 -0000 Author: jgh Date: Thu Oct 1 15:42:03 2015 New Revision: 47470 URL: https://svnweb.freebsd.org/changeset/doc/47470 Log: - tighten and clarify wording PR: 203338 (based on) Submitted by: varnishedgreen@aim.com Approved by: wblock@ (mentor) Differential Revision: https://reviews.freebsd.org/D3749 Modified: head/en_US.ISO8859-1/books/faq/book.xml Modified: head/en_US.ISO8859-1/books/faq/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/faq/book.xml Thu Oct 1 14:55:39 2015 (r47469) +++ head/en_US.ISO8859-1/books/faq/book.xml Thu Oct 1 15:42:03 2015 (r47470) @@ -3362,12 +3362,12 @@ kern.sched.name: ULE deleted, the file is not really removed from the file system until the program stops using it. The file is immediately deleted from the directory listing, however. - As an example, consider a file that is large enough that - its presence affects the output of - du and df. If this - file is deleted while using more on it, - more does not immediately choke and - complain that it cannot view the file. The entry is + As an example, consider a file large enough + to affect the output of + du and df. A + file being viewed with more can be + deleted wihout causing an error. + The entry is removed from the directory so no other program or user can access it. However, du shows that it is gone as it has walked the directory tree and the