From owner-freebsd-doc@FreeBSD.ORG  Mon Sep 12 09:20:13 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 6D3BB16A41F
	for <freebsd-doc@hub.freebsd.org>; Mon, 12 Sep 2005 09:20:13 +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 08A3B43D53
	for <freebsd-doc@hub.freebsd.org>; Mon, 12 Sep 2005 09:20:13 +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 j8C9KCXW015052
	for <freebsd-doc@freefall.freebsd.org>; Mon, 12 Sep 2005 09:20:12 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j8C9KCaQ015051;
	Mon, 12 Sep 2005 09:20:12 GMT (envelope-from gnats)
Date: Mon, 12 Sep 2005 09:20:12 GMT
Message-Id: <200509120920.j8C9KCaQ015051@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Yar Tikhiy <yar@comp.chem.msu.su>
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: Yar Tikhiy <yar@comp.chem.msu.su>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 12 Sep 2005 09:20:13 -0000

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, &lt; and
 > &gt; 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 &lt;p&gt;
 > +  <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 "&lt;p&gt;"
 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