[PATCH xorg-docs 2/2] Replace XMLTO with XSLTPROC, XMLLINT and W3M tools

[Dan Nicholson]

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

--
Dan