svn commit: r39981 - head/en_US.ISO8859-1/books/faq
Benjamin Kaduk
kaduk at MIT.EDU
Mon Nov 12 19:58:50 UTC 2012
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 @@
> <para>Where the format is
> <literal>html-split</literal>, the files are bundled
> up using &man.tar.1;. The resulting
> - <filename>.tar</filename> file is then compressed
> + <filename>.tar</filename> 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.</para>
> </listitem>
> @@ -8741,8 +8740,8 @@ ATDT1234567</programlisting>
> 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 <command>close lcp</command> command (a following
> - <command>term</command> command) will reconnect you to the
> + <command>close lcp</command> (a following
> + <command>term</command>) 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.</para>
>
> <para>If nothing in your log file indicates why the link might
> @@ -9054,12 +9053,12 @@ hint.sio.7.irq="12"</programlisting>
> <para>When changing modes of the file hierarchies rooted in the
> files instead of the files themselves,
> you have to use either <option>-H</option> or
> - <option>-L</option> together with the <option>-R</option>
> - option to make this work. See the &man.chmod.1; and
> - &man.symlink.7; manual pages for more info.</para>
> + <option>-L</option> together with <option>-R</option>
> + to make this work. See &man.chmod.1; and
> + &man.symlink.7; for more information.</para>
>
> <warning>
> - <para>The <option>-R</option> option does a
> + <para><option>-R</option> does a
My understanding was that we did not like to start sentences with markup.
-Ben Kaduk
> <emphasis>recursive</emphasis> &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
>
More information about the svn-doc-all
mailing list