"PROGRAMLISTING", "TITLE" not permitted

Tom Hukins tom at FreeBSD.org
Wed Apr 30 15:59:35 UTC 2003


On Wed, Apr 30, 2003 at 09:28:44AM -0400, Chris Pepper wrote:
> At 10:00 AM +0100 2003/04/30, Nik Clayton wrote:
> 
> >[1]
> >http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/writing-style.html#AEN3228
> 
> 	A good reference, but it confuses me a bit. According to 
> "Content within elements should be indented by two spaces if the 
> content runs over more than one line.", shouldn't the 'which' inside 
> the <emphasis> be indented two more spaces, or should it say "Content 
> within BLOCK elements"?

No, because the content of <emphasis> does not run over more than one
line.

I agree that this particular paragraph could be written more clearly,
though.  I tried to improve it recently, but I don't feel completely
happy with the changes I made.

Tom



More information about the freebsd-doc mailing list