Date: Fri, 5 May 2000 01:59:02 +0100 From: Nik Clayton <nik@freebsd.org> To: Mark Ovens <mark@ukug.uk.freebsd.org> Cc: doc@freebsd.org Subject: Re: Porter-handbook not being built Message-ID: <20000505015902.A48362@kilt.nothing-going-on.org> In-Reply-To: <20000504175920.A299@parish>; from mark@ukug.uk.freebsd.org on Thu, May 04, 2000 at 05:59:20PM %2B0100 References: <20000504175920.A299@parish>
index | next in thread | previous in thread | raw e-mail
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 <xref ...>
and <link ...> elements in there that now don't point anywhere useful.
We could
a) remove them
b) replace them with <ulink ...>s
c) use the <olink ...> 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 <olink> 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
help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000505015902.A48362>