Date: Thu, 1 Oct 2015 09:39:32 -0600 (MDT) From: Warren Block <wblock@wonkity.com> To: Jason Helfman <jgh@FreeBSD.org> Cc: Warren Block <wblock@freebsd.org>, 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 Message-ID: <alpine.BSF.2.20.1510010937350.40909@wonkity.com> In-Reply-To: <CAMuy=%2Bh-9XZF%2BFXYu7Hm6zG5wFh_vgWaWpNX%2BEBcCsTNvnLhwQ@mail.gmail.com> References: <201510011455.t91EteM1034915@repo.freebsd.org> <CAMuy=%2Bh-9XZF%2BFXYu7Hm6zG5wFh_vgWaWpNX%2BEBcCsTNvnLhwQ@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, 1 Oct 2015, Jason Helfman wrote: > On Thu, Oct 1, 2015 at 7:55 AM, Warren Block <wblock@freebsd.org> 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 @@ > <para>For example, commands:</para> > > <informalexample> > - <para>Wrong: Use the command <command>svn</command> to > + <para>Wrong: Use the <command>svn</command> command to > update sources.</para> > </informalexample> > > _______________________________________________ > 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: <owner-svn-doc-head@freebsd.org> 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 <jgh@FreeBSD.org> 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 <svn-doc-head.freebsd.org> List-Unsubscribe: <https://lists.freebsd.org/mailman/options/svn-doc-head>, <mailto:svn-doc-head-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-head/>; List-Post: <mailto:svn-doc-head@freebsd.org> List-Help: <mailto:svn-doc-head-request@freebsd.org?subject=help> List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/svn-doc-head>, <mailto:svn-doc-head-request@freebsd.org?subject=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</screen> 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 - <command>du</command> and <command>df</command>. If this - file is deleted while using <command>more</command> on it, - <command>more</command> 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 + <command>du</command> and <command>df</command>. A + file being viewed with <command>more</command> can be + deleted wihout causing an error. + The entry is removed from the directory so no other program or user can access it. However, <command>du</command> shows that it is gone as it has walked the directory tree and the
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.BSF.2.20.1510010937350.40909>