From owner-svn-doc-all@FreeBSD.ORG Mon Nov 12 19:58:50 2012 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id BFB9FE69; Mon, 12 Nov 2012 19:58:50 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-1.mit.edu (DMZ-MAILSEC-SCANNER-1.MIT.EDU [18.9.25.12]) by mx1.freebsd.org (Postfix) with ESMTP id 1BA588FC0C; Mon, 12 Nov 2012 19:58:49 +0000 (UTC) X-AuditID: 1209190c-b7f286d000000ee3-de-50a154f76b09 Received: from mailhub-auth-1.mit.edu ( [18.9.21.35]) by dmz-mailsec-scanner-1.mit.edu (Symantec Messaging Gateway) with SMTP id F7.CC.03811.7F451A05; Mon, 12 Nov 2012 14:58:47 -0500 (EST) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-1.mit.edu (8.13.8/8.9.2) with ESMTP id qACJwlOq012037; Mon, 12 Nov 2012 14:58:47 -0500 Received: from multics.mit.edu (SYSTEM-LOW-SIPB.MIT.EDU [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id qACJwj7X006122 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 12 Nov 2012 14:58:46 -0500 (EST) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id qACJwiLC001466; Mon, 12 Nov 2012 14:58:44 -0500 (EST) Date: Mon, 12 Nov 2012 14:58:44 -0500 (EST) From: Benjamin Kaduk To: Eitan Adler Subject: Re: svn commit: r39981 - head/en_US.ISO8859-1/books/faq In-Reply-To: <201211112229.qABMT1il009287@svn.freebsd.org> Message-ID: References: <201211112229.qABMT1il009287@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrAIsWRmVeSWpSXmKPExsUixCmqrPs9ZGGAwbXflhY/Ph5istj1dw6z xY1F+5ksdvf3MjuweMz4NJ8lgDGKyyYlNSezLLVI3y6BK2PLzU7WgqkSFQsnf2dtYPwn1MXI ySEhYCIxp3MjI4QtJnHh3nq2LkYuDiGBfYwSZz5NgnI2MEr8O7uLCcI5wSTx69hWRgingVHi 0bQWdpB+FgFtiRX71rGA2GwCKhIz32xkA7FFgOzv+38ygdjMAlESe5Y2soLYwgIOEot/NAAN 4uDgFLCSaP4mAGLyAoX3v/AFMYUELCXOr+UBKRYV0JFYvX8K2HBeAUGJkzOfsEAMtJQ49+c6 2wRGwVlIUrOQpBYwMq1ilE3JrdLNTczMKU5N1i1OTszLSy3SNdTLzSzRS00p3cQIDlhJnh2M bw4qHWIU4GBU4uG96bIwQIg1say4MvcQoyQHk5Io77dAoBBfUn5KZUZicUZ8UWlOavEhRgkO ZiUR3t93FwQI8aYkVlalFuXDpKQ5WJTEeS+n3PQXEkhPLEnNTk0tSC2CycpwcChJ8KoCI1NI sCg1PbUiLTOnBCHNxMEJMpwHaLgMSA1vcUFibnFmOkT+FKOilDivGEhCACSRUZoH1wtLKK8Y xYFeEeY1AaniASYjuO5XQIOZgAav3wZydXFJIkJKqoEx4BPfx+c21xdM9vi5I/Dt9ocy6x6k 3xdfPfNZQ46666KTK4MfvL24PXuDsO/6OPv1+w4end9ScX3x2bkvtOel3Mzlz1ZxsT8m170r b4foy7WOef8/POCIl7qc9up8ePGvWKuMp3f7t8bfr+aKd4u7v2nRLL0puQVTzstPqlhkvSRn 6U25p01qdkosxRmJhlrMRcWJALDcty4DAwAA Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 12 Nov 2012 19:58:50 -0000 On Sun, 11 Nov 2012, Eitan Adler wrote: > Author: eadler > Date: Sun Nov 11 22:29:01 2012 > New Revision: 39981 > URL: http://svnweb.freebsd.org/changeset/doc/39981 > > Log: > Reduce redundant markup and word and other minor problems reported by > igor. Limited additional checking was done of the surrounding content. > > Approved by: jkois (mentor, before merge conflict resolution) > > 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 Sun Nov 11 21:42:32 2012 (r39980) > +++ head/en_US.ISO8859-1/books/faq/book.xml Sun Nov 11 22:29:01 2012 (r39981) > @@ -923,7 +923,7 @@ > Where the format is > html-split, the files are bundled > up using &man.tar.1;. The resulting > - .tar file is then compressed > + .tar is then compressed This would seem like a candidate where the "redundant" use of "file" actually is helpful, since there is not a specific file name given. > using the compression schemes detailed in the next > point. > > @@ -8741,8 +8740,8 @@ ATDT1234567 > if the incoming data is actually a login or shell prompt. > If you have a shell prompt at the remote end, it is possible > to terminate &man.ppp.8; without dropping the line by using > - the close lcp command (a following > - term command) will reconnect you to the > + close lcp (a following > + term) will reconnect you to the I have trouble making sense of this sentence; perhaps the close paren is misplaced? Not a bug in your change, but I would have expected it to be noticed in pre-commit review. > shell on the remote machine. > > If nothing in your log file indicates why the link might > @@ -9054,12 +9053,12 @@ hint.sio.7.irq="12" > When changing modes of the file hierarchies rooted in the > files instead of the files themselves, > you have to use either or > - together with the > - option to make this work. See the &man.chmod.1; and > - &man.symlink.7; manual pages for more info. > + together with > + to make this work. See &man.chmod.1; and > + &man.symlink.7; for more information. > > > - The option does a > + does a My understanding was that we did not like to start sentences with markup. -Ben Kaduk > recursive &man.chmod.1;. Be careful > about specifying directories or symlinks to directories to > &man.chmod.1;. If you want to change the permissions of a >