Date: Mon, 12 Sep 2005 09:20:12 GMT From: Yar Tikhiy <yar@comp.chem.msu.su> To: freebsd-doc@FreeBSD.org Subject: Re: docs/85928: [patch] typo in ftp-primer (en_US.ISO8859-1) Message-ID: <200509120920.j8C9KCaQ015051@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: Yar Tikhiy <yar@comp.chem.msu.su> To: Pierre Riteau <kineox@gmail.com> Cc: freebsd-gnats-submit@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 "<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. 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 "<p>" in front of it because there can be style elements implicitly associated with the <p> tag. Since today nearly everybody uses CSS, it is an important point. -- Yar
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200509120920.j8C9KCaQ015051>