From owner-freebsd-doc Fri May 5 1:48:16 2000 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 63F4637B6DF for ; Fri, 5 May 2000 01:48:07 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from kilt.nothing-going-on.org (kilt.nothing-going-on.org [192.168.1.18]) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id CAA00853; Fri, 5 May 2000 02:37:25 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Received: (from nik@localhost) by kilt.nothing-going-on.org (8.9.3/8.9.3) id BAA48385; Fri, 5 May 2000 01:59:02 +0100 (BST) (envelope-from nik@catkin.nothing-going-on.org) Date: Fri, 5 May 2000 01:59:02 +0100 From: Nik Clayton To: Mark Ovens Cc: doc@freebsd.org Subject: Re: Porter-handbook not being built Message-ID: <20000505015902.A48362@kilt.nothing-going-on.org> References: <20000504175920.A299@parish> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <20000504175920.A299@parish>; from mark@ukug.uk.freebsd.org on Thu, May 04, 2000 at 05:59:20PM +0100 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, May 04, 2000 at 05:59:20PM +0100, Mark Ovens wrote: > Is there any reason why the porter-handbook doesn't get built when > building all the docs? Two reasons. 1. Satoshi requested a repo-copy to preserve the history, so that's happening. 2. I'm still kicking around how to get the links working properly. Because it was originally part of the handbook there are and elements in there that now don't point anywhere useful. We could a) remove them b) replace them with s c) use the element. It seems to be the most SGMLish solution. I'm trying to get (c) working, but not getting very far -- I think there's something amiss in my understanding, but I'm not sure where. If anyone else wants to jump in then please do. The reason I don't want to use (b) is that you can only do that if you know the Porter's Handbook and the ``main'' Handbook are going to appear in the same place in a directory tree relative to one another. We can't do that (or, at least, I don't want to impose that as a restriction when installing the docs), and as I say, I *think* (c) solves that problem. > parish# cd /usr/doc/en_US.ISO_8859-1/books/porter-handbook > parish# make > /usr/local/bin/jade -V html-manifest -ioutput.html -c /usr/doc/en_US.ISO_8859-1/books/porter-handbook/../../../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/en_US.ISO_8859-1/books/porter-handbook/freebsd.dsl -t sgml /usr/doc/en_US.ISO_8859-1/books/porter-handbook/book.sgml > /usr/local/bin/jade:/usr/doc/en_US.ISO_8859-1/books/porter-handbook/book.sgml:2144:25:X: reference to non-existent ID "PORTS-CD" > /usr/local/bin/jade:/usr/doc/en_US.ISO_8859-1/books/porter-handbook/book.sgml:823:34:X: reference to non-existent ID "POLICIES-MAINTAINER" > /usr/local/bin/jade:/usr/doc/en_US.ISO_8859-1/books/porter-handbook/book.sgml:2045:51:X: reference to non-existent ID "CVSUP-CONFIG" > /usr/local/bin/jade:/usr/doc/en_US.ISO_8859-1/books/porter-handbook/book.sgml:1348:43:X: reference to non-existent ID "POLICIES-SHLIB" > /usr/local/bin/jade:/usr/doc/en_US.ISO_8859-1/books/porter-handbook/book.sgml:330:56:X: reference to non-existent ID "CONTRIB-GENERAL" > /usr/local/bin/jade:/usr/doc/en_US.ISO_8859-1/books/porter-handbook/book.sgml:2081:23:X: reference to non-existent ID "CONTRIB-GENERAL" > /usr/local/bin/jade:/usr/local/share/sgml/docbook/dsssl/modular/html/dblink.dsl:201:1:E: XRef LinkEnd to missing ID 'CVSUP-CONFIG' > *** Error code 1 That's the missing link targets. > Yet all the HTML docs get made; I can load index.html in Netscape and > read the whole handbook? Not quite. Hunt for something that should be a link to somewhere in the Handbook. You'll see that the link text is missing. If I don't get my head wrapped around by the end of next week then I'll turn on the build -- in the mean time people can commit to the copy in the big Handbook, and I'll make sure that the changes are merged over as necessary. 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