Date: Mon, 12 Nov 2012 18:14:03 -0500 (EST) From: Benjamin Kaduk <kaduk@MIT.EDU> To: Eitan Adler <eadler@freebsd.org> Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org Subject: Re: svn commit: r39981 - head/en_US.ISO8859-1/books/faq Message-ID: <alpine.GSO.1.10.1211121809090.2164@multics.mit.edu> In-Reply-To: <CAF6rxgnn_B0BZsxM51OQpa_Q2rzEApaj9OG5R0sTGKDuOp65iA@mail.gmail.com> References: <201211112229.qABMT1il009287@svn.freebsd.org> <alpine.GSO.1.10.1211121456040.2164@multics.mit.edu> <CAF6rxgnn_B0BZsxM51OQpa_Q2rzEApaj9OG5R0sTGKDuOp65iA@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, 12 Nov 2012, Eitan Adler wrote: > On 12 November 2012 14:58, Benjamin Kaduk <kaduk@mit.edu> wrote: > >>> - 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. > > Note the commit message: ""Limited additional checking was done of the > surrounding content."" I did see that, yes. > I noticed quite a few things, but few of which I felt I wanted to fix > in this iteration. Hopefully nothing gets lost; with a lot of changes pending to this file it could be exciting. >>> <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. > > I did not know this. Can you propose some alternative wording? Well, it may not be a fully settled point; possibly someone else wants to chime in on the matter. As far as rewording, I would try "Using <option>-R</option> causes &man.chmod.1 to act <emphasis>recursively</emphasis>." -Ben
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.GSO.1.10.1211121809090.2164>