[PATCH 1.5/5] Use docbook2{html,txt,pdf} instead of xmlto

[Dan Nicholson]

On Mon, May 17, 2010 at 8:39 PM, Alan Coopersmith
<alan.coopersmith at oracle.com> wrote:
> I can't get xmlto to accept catalogs, but docbook2* takes them fine.
>
> I can't get builddir != srcdir builds to work without catalogs to
> specify the *.ent files are in a different directory than the
> .xml src files.   On the bright side, this avoids having to link/copy
> the .ent files to every directory with docbook docs in.
>
> XXX: squash into initial LinuxDoc -> DocBook patch #1 before push/pull
>
> Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

I'd rather not use the docbook2* wrapper scripts.

1. They're really for SGML, and we're using DocBook XML.

2. The package where they come from, docbook-utils, is completely dead.

For this issue, I didn't have to use a catalog when I played with an
external entity file the other day.

In the xml:
<!ENTITY % defs SYSTEM "file:///defs.ent"> %defs;

Then run xmlto with --searchpath $PWD/../ents or whatever. It has to
be an absolute path. It's not pretty, but it gets the job done. The
underlying XML tools, xmllint and xsltproc, seem to behave the same
way. Maybe it's just an SGML vs. XML thing.

--
Dan