From owner-freebsd-doc@FreeBSD.ORG Mon Nov 3 08:14:20 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4D5051065678 for ; Mon, 3 Nov 2008 08:14:20 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: from fg-out-1718.google.com (fg-out-1718.google.com [72.14.220.157]) by mx1.freebsd.org (Postfix) with ESMTP id CBA738FC22 for ; Mon, 3 Nov 2008 08:14:19 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: by fg-out-1718.google.com with SMTP id l26so2044998fgb.35 for ; Mon, 03 Nov 2008 00:14:18 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :organization:user-agent:mime-version:to:cc:subject:references :in-reply-to:content-type:content-transfer-encoding:sender; bh=VGFN040o/5Isrfyogj6imoqM3KlIzLj0sU8jue/X3fA=; b=EWGne06r28HoHcys3lW+4cucf5ga9kJkp5onaUNtTjcLapAQMOki/p/b6qnXap9wPb 6ASYztbHMb2fwHvAzgfijCVhE5FKOteIxmmEKzxAkh31pwfe4dD7HZBRuLD7PtqJqB+D WjJM2g4TqWxlA1gQPA13X0X0D2cAgo9jvAR0U= DomainKey-Signature: a=rsa-sha1; c=nofws; d=googlemail.com; s=gamma; h=message-id:date:from:organization:user-agent:mime-version:to:cc :subject:references:in-reply-to:content-type :content-transfer-encoding:sender; b=fBlsQBziBm43u9x4ASRX/kTOrInmixBXgXoVi10tg2Cy8KFU99ptF2+OHa+evbRgxi u0gjH3VeNtyT5GgLT/O/hbdhWr8SHjwwvjSrQDn53NJXSH70+IB+EUnieApqReeskLLL MoV63abUB0CxLzaxneLz5QEGAfcW1Ad0kqtBc= Received: by 10.86.54.3 with SMTP id c3mr3713365fga.33.1225698827988; Sun, 02 Nov 2008 23:53:47 -0800 (PST) Received: from ?192.168.1.12? (oktnb24.inf.elte.hu [157.181.167.24]) by mx.google.com with ESMTPS id d6sm8169065fga.2.2008.11.02.23.53.45 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sun, 02 Nov 2008 23:53:46 -0800 (PST) Message-ID: <490EADFA.3020708@FreeBSD.org> Date: Mon, 03 Nov 2008 08:53:30 +0100 From: Gabor PALI Organization: The FreeBSD Project User-Agent: Thunderbird 2.0.0.17 (X11/20081023) MIME-Version: 1.0 To: Eitan Adler References: <490E2907.5090907@gmail.com> In-Reply-To: <490E2907.5090907@gmail.com> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Sender: =?UTF-8?B?UMOBTEkgR8OhYm9yIErDoW5vcw==?= Cc: freebsd-doc@freebsd.org Subject: Re: change to sgml-primer example X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 03 Nov 2008 08:14:20 -0000 Eitan Adler wrote: > Can anyone comment on the attached patch to be run from > /usr/doc/en_US.ISO8859-1/books/fdp-primer/sgml-primer ------------------------------------------------------------------------ --- chapter.sgml 2008-10-31 08:23:35.000000000 -0400 +++ newchapter.sgml 2008-11-02 17:21:54.000000000 -0500 @@ -862,6 +862,7 @@ Erroneous SGML comments + The SGML parser will treat ]]> - The SGML parser will treat this as though it were actually: + as though it were actually: I would not prefer splitting paragraphs around elements, as I have already fought against this before [1]. <!THIS IS OUTSIDE THE COMMENT> This is not valid SGML, and may give confusing error messages. + Because "--" delimitates the end of a comment do do not write comments like this: + ]]> - As the example suggests, do not write - comments like that. + This is a (slightly) better approach, but it still potentially confusing to people new to SGML: ]]> - That is a (slightly) better approach, but it still potentially - confusing to people new to SGML. In my very humble opinion, I am good with the original text. Cheers, :g [1] http://www.freebsd.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml