From owner-freebsd-doc Wed Jan 10 2:31: 0 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 4EE2F37B400 for ; Wed, 10 Jan 2001 02:30:41 -0800 (PST) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.1/8.11.1) id f0AARH133771; Wed, 10 Jan 2001 10:27:17 GMT (envelope-from nik) Date: Wed, 10 Jan 2001 10:27:16 +0000 From: Nik Clayton To: Udo Erdelhoff Cc: freebsd-doc@freebsd.org Subject: Re: Strange sequences Message-ID: <20010110102716.A33645@canyon.nothing-going-on.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> <20010109225057.L4211@nathan.ruhr.de> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="KsGdsel6WgEHnImy" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010109225057.L4211@nathan.ruhr.de>; from ue@nathan.ruhr.de on Tue, Jan 09, 2001 at 10:50:57PM +0100 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --KsGdsel6WgEHnImy Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Tue, Jan 09, 2001 at 10:50:57PM +0100, Udo Erdelhoff wrote: > > 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). Yep. > 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. Try the attached patch, which, IMHO, provides sufficient contextual information for the reader, while keeping the book information together. I've only converted one entry in the list, but that should be enough to get an idea of what I mean. Longer term we should probably have a doc/en_US.ISO_8859-1/share/sgml/bilbiography.sgml file (or directory), that contains biblio information that can be shared by all the documents that want it. > Form (SGML) should follow function (giving information about the > 4.4BSD books), not the other way around. If necessary, the stylesheets could probably be amended to insert some of the bibliography information (which is stored in the element) wherever or similar is used. 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 --KsGdsel6WgEHnImy Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename=d Index: book.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/books/faq/book.sgml,v retrieving revision 1.135 diff -u -r1.135 book.sgml --- book.sgml 2001/01/05 20:44:26 1.135 +++ book.sgml 2001/01/10 10:21:54 @@ -604,12 +604,8 @@ - 4.4BSD System Manager's Manual - By Computer Systems Research Group, UC Berkeley - 1st Edition June 1994, 804 pages - ISBN: - 1-56592-080-5 + 4.4BSD System Manager's Manual, + @@ -11499,4 +11495,30 @@ thanks! + + + Useful FreeBSD and Unix Books + + + + 4.4BSD System Manager's Manual + + Computer Systems Research Group, University of + California, Berkeley + + + O'Reilly and Associates + + + 1st + + June 1994 + + +1-56592-080-5 + + + + --KsGdsel6WgEHnImy-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message