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

[Alan Coopersmith]

Dan Nicholson wrote:
> 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.

Neither would I as xmlto works better for me.

> 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.

Hmm, absolute path for both parts (the file:///... in the .xml file
and the Makefile call to xmlto) does actually seem to work... yay!

Scratch the Patch 1.5 then and replace the previous patch 3 with the
new version about to come...

-- 
	-Alan Coopersmith-        alan.coopersmith at oracle.com
	 Oracle Solaris Platform Engineering: X Window System