Re: BUilding the docs

Michael Crawford <[email protected]>
Newsgroups gmane.comp.multimedia.ogg.vorbis.devel
Message-ID <[email protected]>
On Sat, Feb 7, 2009 at 8:40 PM, Ralph Giles <[email protected]> wrote:
> That's what I meant by broken. Even if you installed the stylesheets
> and schemas locally it wouldn't use them unless you manually set up a
> catalog file.

It occured to me just now that there may be a simple way to set up the
catalog file at build time.  What we'd have to do is supply separate
catalog files for each way the documents are installed - I have one
for MacPorts now, but there would need to be one for each Windows
DocBook package, and each variation of the way they are installed on
*NIX and so on.

Then you can detect the platform in the Makefile, and set
XML_CATALOG_FILES to point at the catalog appropriate for the platform
that the build is actually being done on.

Some of the tools, xsltproc in particular, have command line options
that prevent network access when given an Internet URL.  So you can
force the use of catalog files one way or another.

There is probably some reasonable way to ensure that the catalog file
is properly set up before actually trying to build anything.

Mike
-- 
Michael David Crawford
mdcrawford at gmail dot com

   I'm looking for a job in Silicon Valley:
     http://www.goingware.com/resume/cover-letter.html
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.