cvs commit: doc/en_US.ISO8859-1/books/porters-handbook book.sgml

[Rene Ladan]

On 04-01-2010 22:28, Doug Barton wrote:
> Gavin Atkinson wrote:
>> On Mon, 4 Jan 2010, Doug Barton wrote:
>>> dougb       2010-01-04 20:38:15 UTC
>>>
>>>    Modified files:
>>>      en_US.ISO8859-1/books/porters-handbook book.sgml
>>>    Log:
>>>    Actually having the $FreeBSD$ tag expanded in the example rc.d script
>>>    did not end up looking as cool as I thought it would, so switch to an
>>>    unexpanded example.
>>>
>>>    Fix the text in the new paragraph to work better around the markup.
>>
>>>        <para>  Unless there is a good reason to start the service
>>> 	earlier all ports scripts should use
>>> -	<programlisting>REQUIRE: LOGIN</programlisting>. If the service
>>> +	<programlisting>REQUIRE: LOGIN</programlisting>  If the service
>>> 	runs as a particular user (other than root) this is mandatory.
>>
>> This is now grammatically incorrect.  I actually think the original is
>> better than any rewording I can come up with.
>
> Take a quick look at the page before it auto-updates. The old way the
> period ends up all by itself in the text after the programlisting box,
> so it looks like this:
>
> . If the service
>
This feels like working around some bug/shortcoming in the markup engine 
to me (?)  The source text never knows the dimensions and font of the 
resulting output (computer screen/paper/pda/...).

Regards,
Rene
-- 
http://www.rene-ladan.nl/

GPG fingerprint = ADBC ECCD EB5F A6B4 549F  600D 8C9E 647A E564 2BFC 
(subkeys.pgp.net)