[PATCH xorg-docs 2/2] Replace XMLTO with XSLTPROC, XMLLINT and W3M tools
dbn.lists at gmail.com
Tue Mar 22 17:14:12 PDT 2011
On Tue, Mar 22, 2011 at 4:28 PM, Matt Dew <marcoz at osource.org> wrote:
> On 03/22/2011 03:25 PM, Dan Nicholson wrote:
>> On Tue, Mar 22, 2011 at 7:19 AM, Gaetan Nadon<memsize at videotron.ca>
>>> Xmlto is a script that selects the appropriate back-end
>>> based on options and tools availability.
>>> Xmlto uses an xsl "fragment" which is not compatible with
>>> the standard use of xsl stylesheets. The customization for
>>> xhtml and fo cannot be used with xsltproc in that context.
>>> It makes adoption of docbook features like olink and profiling
>>> significantly more difficult.
>> If you pass -x to xmlto instead of -m, you can use a full stylesheet
>> instead of a fragment. Moving to xsltproc means you have to duplicate
>> the internal smarts of xmlto.
> Unfortunately, with the '-x' xmlto will look for that stylesheet on the
> local machine, so there's no way to use the http://... stylesheets. and we
> want to use those for portability. The local catalogs detect if there are
> local copies and uses them if they exist.
More importantly, xmlto always uses --nonet for xsltproc and xmllint.
Do you really want builds to hang trying to fetch sheets over the
network? You guys are the ones doing the doc work, so I won't try to
slow you down anymore. Please put the correct justification in the
commit messages, though.
More information about the xorg-devel