svn commit: r39981 - head/en_US.ISO8859-1/books/faq

[Benjamin Kaduk]

On Mon, 12 Nov 2012, Eitan Adler wrote:

> On 12 November 2012 14:58, Benjamin Kaduk <kaduk at 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