From owner-freebsd-doc Wed Jun 16 3:10:51 1999 Delivered-To: freebsd-doc@freebsd.org Received: from firewall1.lehman.com (firewall1.Lehman.COM [192.147.65.82]) by hub.freebsd.org (Postfix) with ESMTP id 1337C14C59 for ; Wed, 16 Jun 1999 03:10:47 -0700 (PDT) (envelope-from nclayton@lehman.com) Received: from relay2.messaging-svcs4.lehman.com by firewall1.lehman.com (8.8.6/8.8.6) id GAA23607; Wed, 16 Jun 1999 06:10:44 -0400 (EDT) Message-ID: <19990616104716.U15628@lehman.com> Date: Wed, 16 Jun 1999 10:47:16 +0100 From: Nik Clayton To: beaupran@jsp.umontreal.ca, freebsd-doc@freebsd.org Subject: Re: Problems making the handbook in stable References: <199906152359.AAA10668@lonmailhost.lehman.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.93.2i In-Reply-To: <199906152359.AAA10668@lonmailhost.lehman.com>; from Spidey on Tue, Jun 15, 1999 at 06:30:59PM -0400 Organization: Lehman Brothers Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Jun 15, 1999 at 06:30:59PM -0400, Spidey wrote: > I already talked about this with Nik Clayton, but I'm still stuck. Hi again. . . > here is my supfile: > > -- > *default host=cvsup.FreeBSD.org > *default base=/usr > *default prefix=/usr > *default release=cvs tag=. > *default delete use-rel-suffix > *default compress > doc-all > -- Looks fine. > /usr/local/bin/jade -V html-manifest -ioutput.html -c /usr/doc/share/sgml/catalog -c /usr/local/share/sgml/docbook/dsssl/modular/catalog -c /usr/local/share/sgml/docbook/catalog -c /usr/local/share/sgml/jade/catalog -d /usr/doc/share/sgml/freebsd.dsl -t sgml handbook.sgml Verify that all the file names in that command line exist. In particular, /usr/local/share/sgml/docbook/catalog. > /usr/local/bin/jade:/usr/doc/share/sgml/freebsd.dtd:54:63:W: cannot generate system identifier for public text "-//OASIS//DTD DocBook V3.1//EN" This is the root of the problem. The handbook starts: Jade has successfully converted that FPI in to the filename /usr/share/doc/sgml/freebsd.dtd (by reading in /usr/share/doc/sgml/catalog). If you look at freebsd.dtd you will see that it is a customisation layer around the DocBook DTD. So it needs to include the entirety of the DocBook DTD within it. In freebsd.dtd you will see the lines %orig-docbook; As before, Jade will need to convert "-//OASIS//DTD DocBook V3.1//EN" in to the name of a file on your system. Jade's term for a filename in this context is a "system identifier", and it looks these up using a catalog file in the same way that it used doc/share/sgml/catalog for the freebsd.dtd file. In this case, the catalog file that Jade should be using is /usr/local/share/sgml/docbook/catalog (it's one of the "-c" options to Jade in the original command line). If you look in this file, it should contain just three entries, all starting with "CATALOG", and pointing at catalog files in the three subdirectories that correspond with the 3 different versions of the DocBook DTD you should have installed (2.4.1, 3.0, and 3.1). This is legal, catalog files are allowed to point to other catalog files like this. If you look in /usr/local/share/sgml/docbook/3.1/catalog you should see a line that looks something like PUBLIC "-//OASIS//DTD DocBook V3.1//EN" docbook.dtd which is what does the mapping between the FPI and the file name (system identifier). This file is created when you install the docbook meta-port. > /usr/local/bin/jade:/usr/doc/share/sgml/freebsd.dtd:55:13:E: reference to entity "orig-docbook" for which no system identifier could be generated This error message means that something in the above chain of steps has gone wrong. Jade has failed to find the DocBook 3.1 DTD -- this means that most of the element and entity definitions are missing, and Jade is about to get *very* confused. > /usr/local/bin/jade:/usr/doc/share/sgml/freebsd.dtd:62:24:E: parameter entity "cptr.char.mix" not defined Here, for example -- this entity is defined in DocBook 3.1, Jade can't find it, hence the error. > /usr/local/bin/jade:introduction/chapter.sgml:392:6:E: element "TERM" undefined Likewise -- no DTD found, no elements defined. Jade will print about 200 or so errors before giving up. > Has _anyone_ built this darn handbook??? Yep :-) hub.freebsd.org successfully rebuilds it at 0400 every morning as well. > How. Why. Work through the description above, and see if you can see what's missing. Try de-installing and re-installing the docbook meta-port, # cd /usr/ports/textproc/docbook # make deinstall # make install You might need to add a command line option to "make deinstall" to get it to remove itself completely, because it might complain that other ports depend on it. If so, show no mercy, blow it away completely and reinstall it. Then verify the /usr/local/share/sgml/docbook/catalog file has been created. > Sorry if this is out of context for the list, It's not, don't worry. > I use a 3.2-stable system, So do I, so that shouldn't be a factor at all. Let me know how you get on. N -- --+==[ Systems Administrator, Year 2000 Test Lab, Lehman Brothers, Inc. ]==+-- --+==[ 1 Broadgate, London, EC2M 7HA 0171-601-0011 x5514 ]==+-- --+==[ Year 2000 Testing: It's about time. . . ]==+-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message