[Vorbis-dev] BUilding the docs

[Michael Crawford]

On Sun, Feb 8, 2009 at 12:30 AM, ogg.k.ogg.k at googlemail.com
<ogg.k.ogg.k at googlemail.com> wrote:
> This is just... SO wrong... Is it not possible to configure this
> to *not* attempt to connect to a distant site when building
> *local* data ?

YES!  What you do is install an XML catalog file, then set the
environment variable XML_CATALOG_FILES to point to it.  The http://
Internet URL is then used only as a key to look up the locally-cached
file:/// URL.

At least some of the tools have command-line options that prevent them
from attempting to hit the network.  If they can't find what they need
in the catalog, they'll emit an error message.  I know xsltproc does
this with the --nonet argument, for example.

A good test is to try building the documentation with your ethernet
cable unplugged. :-/

   http://www.sagehill.net/docbookxsl/WriteCatalog.html

   http://www.oasis-open.org/committees/entity/spec-2001-08-06.html

   http://www.cafeconleche.org/books/effectivexml/chapters/47.html
-- 
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