Date: Mon, 12 Sep 2005 10:40:14 GMT From: Pierre Riteau <kineox@gmail.com> To: freebsd-doc@FreeBSD.org Subject: Re: docs/85928: [patch] typo in ftp-primer (en_US.ISO8859-1) Message-ID: <200509121040.j8CAeE77023751@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/85928; it has been noted by GNATS. From: Pierre Riteau <kineox@gmail.com> To: Yar Tikhiy <yar@comp.chem.msu.su> Cc: freebsd-gnats-submit@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@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200509121040.j8CAeE77023751>