From owner-freebsd-doc@FreeBSD.ORG Mon Sep 12 10:40:15 2005 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3578B16A41F for ; Mon, 12 Sep 2005 10:40:15 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id D9CA043D48 for ; Mon, 12 Sep 2005 10:40:14 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j8CAeEcS023752 for ; Mon, 12 Sep 2005 10:40:14 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j8CAeE77023751; Mon, 12 Sep 2005 10:40:14 GMT (envelope-from gnats) Date: Mon, 12 Sep 2005 10:40:14 GMT Message-Id: <200509121040.j8CAeE77023751@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Pierre Riteau Cc: Subject: Re: docs/85928: [patch] typo in ftp-primer (en_US.ISO8859-1) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Pierre Riteau List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 12 Sep 2005 10:40:15 -0000 The following reply was made to PR docs/85928; it has been noted by GNATS. From: Pierre Riteau To: Yar Tikhiy 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 : > 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 @@ > > > >
Term 3
> > > > -
Paragraph 1 of definition 3. Note that the <p> > > +
Paragraph 1 of definition 3. Note that the

> > element is not required in the single paragraph case.

> > ]]> > > >=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 "

" 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. >=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 "

" in front of it because > there can be style elements implicitly associated with the

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

and
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
with the "]]"). Why would a

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

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