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

[Pierre Riteau]

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

From: Pierre Riteau <kineox at gmail.com>
To: Yar Tikhiy <yar at comp.chem.msu.su>
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 12:31:40 +0200

 2005/9/12, Yar Tikhiy <yar at comp.chem.msu.su>:
 > 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.
 >=20
 > > >How-To-Repeat:
 > > Read http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/sgml-m=
 arkup.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>
 >=20
 > 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 "<p>"
 > to get "<p>" in the rendering.  If you write just "<p>", 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.
 >=20
 > However, I'd argue the statement the example makes.  According to my
 > experience with HTML documents using CSS, you will get different renderin=
 gs
 > of a text block depending on whether you use "<p>" in front of it because
 > there can be style elements implicitly associated with the <p> tag.  Sinc=
 e
 > today nearly everybody uses CSS, it is an important point.
 
 Well, did you watch the document I linked ? I am sure it was not
 intended to be displayed like this. In the SGML source [1] you can see
 that there are <dl> and <dd> tags around the <p> we are talking
 about. They are displayed as is in the HTML document, they are not
 caught as definition tags by the SGML -> HTML conversion engine,
 because a CDATA section is on (it ends after the </dl> with the "]]").
 Why would a <p> not be displayed as is in the same way ?
 
 And if you watch the source [1] a few lines above (ln 395, 297 and
 301), you will see that there are <p> tags, and they are displayed as
 is in the HTML document. So I think I am quite right here ;)
 
 Anyway thanks for working on the problem. And sorry for my crappy english..=
 .
 
 Pierre
 
 [1] http://www.freebsd.org/cgi/cvsweb.cgi/~checkout~/doc/en_US.ISO8859-1/bo=
 oks/fdp-primer/sgml-markup/chapter.sgml?rev=3D1.69