From owner-freebsd-doc Mon Jan 8 2:23:16 2001 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (unknown [194.128.198.234]) by hub.freebsd.org (Postfix) with ESMTP id B69A237B69F for ; Mon, 8 Jan 2001 02:20:36 -0800 (PST) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.0/8.11.0) id f089nOX05138; Mon, 8 Jan 2001 09:49:24 GMT (envelope-from nik) Date: Mon, 8 Jan 2001 09:49:23 +0000 From: Nik Clayton To: Udo Erdelhoff Cc: freebsd-doc@freebsd.org Subject: Re: Strange sequences Message-ID: <20010108094923.A5107@canyon.nothing-going-on.org> References: <20010106211512.L64806@nathan.ruhr.de> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010106211512.L64806@nathan.ruhr.de>; from ue@nathan.ruhr.de on Sat, Jan 06, 2001 at 09:15:12PM +0100 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Sat, Jan 06, 2001 at 09:15:12PM +0100, Udo Erdelhoff wrote: > I've noticed several strange SGML comments within the sourcecode, > see $subject. What's the purpose of these things? They look like HTML > leftovers (in an SGML document???) and I cannot find any effect caused > by them. Removing them doesn't change the HTML output. > > What's the stroy behind them? The old LinuxDoc format let you explicitly specify where you wanted breaks to occur (I think DocBook has elements for this as well). If any remain in comments it's probably as a reminder that a break was intended, and the person converting from LinuxDoc to DocBook should check the formatted output, to ensure that the break does occur (and tweak the stylesheets as necessary if it doesn't). N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message