From owner-freebsd-doc Tue Jan 9 13:49:44 2001 Delivered-To: freebsd-doc@freebsd.org Received: from mail.ruhr.de (in-ruhr3.ruhr.de [212.23.134.2]) by hub.freebsd.org (Postfix) with SMTP id 7469637B402 for ; Tue, 9 Jan 2001 13:49:26 -0800 (PST) Received: (qmail 9927 invoked by alias); 9 Jan 2001 21:47:54 -0000 Received: (from ue@localhost) by nathan.ruhr.de (8.11.0/8.11.0) id f09Lovw24531 for freebsd-doc@freebsd.org; Tue, 9 Jan 2001 22:50:57 +0100 (CET) (envelope-from ue) Date: Tue, 9 Jan 2001 22:50:57 +0100 From: Udo Erdelhoff To: freebsd-doc@freebsd.org Subject: Re: Strange sequences Message-ID: <20010109225057.L4211@nathan.ruhr.de> Mail-Followup-To: freebsd-doc@freebsd.org References: <20010106211512.L64806@nathan.ruhr.de> <20010108094923.A5107@canyon.nothing-going-on.org> <20010108163030.G4211@nathan.ruhr.de> <20010109122858.A6334@canyon.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010109122858.A6334@canyon.nothing-going-on.org>; from nik@freebsd.org on Tue, Jan 09, 2001 at 12:28:59PM +0000 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi Nik, On Tue, Jan 09, 2001 at 12:28:59PM +0000, Nik Clayton wrote: > These are supposed to format information about books. Sadly, it > includes all the bibliographic information about the book inline, as it > where. exactly, that's why I figured that the
sequences were ignored. > On the whole, I'd prefer it if the markup was the same across > translations. That's why I offered to do an adaption of my patch for the german version. There are some instances where the markup and content of the german version should be different from the english version but that should be the exception, not the rule. > Should anyone want to jump up and fix the markup in the > English FAQ to use then please do so, otherwise I'll get > to it in my copious free time. Hmm, there's a small problem: According to the information on the website, a element cannot be placed inside an . And a quick test confirms this information (jade [....] document type does not allow element "BIBLIOGRAPHY" here). In other words, the has to be placed at the of the chapter/FAQ and the answer entity can only contain references to the entries in the bibliography. Something like "The old 4.4BSD Manuals (cryptic string1, cryptic string2, ...) can also be used." That may be fine for a scientific article or a book in that context but I don't think it's a great idea for the FAQ. Form (SGML) should follow function (giving information about the 4.4BSD books), not the other way around. The information about the formatting expectations for (cause page break on formatted media etc.) don't look too good, either. That's why I used tables in the first place. Check http://www.ruhr.de/home/nathan/FreeBSD/de-faq/preface.html#BOOKS and http://www.ruhr.de/home/nathan/FreeBSD/de-faq/book.sgml (line 715ff) for my solution. If you think that this solution is unaccetable, I'd like to know why. /s/Udo -- Abandon the search for Truth; settle for a good fantasy. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message