docs/85928: [patch] typo in ftp-primer (en_US.ISO8859-1)

Mon Sep 12 09:20:13 UTC 2005

The following reply was made to PR docs/85928; it has been noted by GNATS.

From: Yar Tikhiy <yar at comp.chem.msu.su>
To: Pierre Riteau <kineox at gmail.com>
Cc: freebsd-gnats-submit at freebsd.org
Subject: Re: docs/85928: [patch] typo in ftp-primer (en_US.ISO8859-1)
Date: Mon, 12 Sep 2005 13:19:31 +0400

 On Fri, Sep 09, 2005 at 09:59:12PM +0000, Pierre Riteau wrote:
 > >Description:
 > In the fdp-primer document, in the chapter sgml-markup, < and
 > > entites are used but they are in a CDATA section, so the tag
 > is not displayed correctly. I may add that there are a huge number
 > of the same mistakes in the french (fr_FR.ISO8859-1) translation
 > of fdp-primer. I have not made a patch for this one.

 > >How-To-Repeat:
 > Read http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/sgml-markup.html#AEN1203
 > >Fix:
 > --- chapter.sgml.orig   2005-09-09 23:30:54.000000000 +0200
 > +++ chapter.sgml        2005-09-09 23:44:47.000000000 +0200
 > @@ -302,7 +302,7 @@
 > 
 >    <dt>Term 3</dt>
 > 
 > -  <dd>Paragraph 1 of definition 3.  Note that the <p>
 > +  <dd>Paragraph 1 of definition 3.  Note that the <p>
 >      element is not required in the single paragraph case.</dd>
 >  </dl>]]></programlisting>
 >         </example>

I'm afraid you're not quite right here. The subsection talks about HTML
 and gives examples of raw HTML code, where you need to write ""
 to get "" in the rendering. If you write just "", it will be
 swallowed by the HTML engine, and you will get a new paragraph, which
 is not what you want. Therefore the example is correct WRT to this.

However, I'd argue the statement the example makes. According to my
 experience with HTML documents using CSS, you will get different renderings
 of a text block depending on whether you use "" in front of it because
 there can be style elements implicitly associated with the tag. Since
 today nearly everybody uses CSS, it is an important point.

 -- 
 Yar