[sr-dev] Why fetch docbook stylesheets remotely?

[Jan Janak]

On Fri, Oct 16, 2009 at 4:32 PM, Olle E. Johansson <oej at edvina.net> wrote:
>>
>> The catalog file contains references for Docbook 4.3, have you changed
>> the docbook version number in documentation files perhaps? If yes then
>> this could be the reason why the build system tries to download XSL
>> stylesheets from the internet.
>
> Checking modules directory I see that we have both 4.2 and 4.4 used. Maybe
> we should standardize
> and make sure that we have the 4.4 files referenced.

Changing docbook version only makes sense if you need to use any of
the bug-fixes or improvements done between 4.2 and 4.4 in XML source
files, that means in docbook sources. Those changes fix minor bugs in
the schema and sometimes allow some elements to be used in new
contexts. In other words, you only need to change docbook version if
you want to use something that has been specified after 4.2 and it
makes your docbook documents invalid.

Changing Docbook version does not change the version of XSL
stylesheets that are used to generate various output formats, such as
HTML or READMEs. These are configured in catalog files and in *.xsl
files in sip-router/docbook.

If you want to change docbook versions anyway then the latest
compatible version is 4.5. There is also version 5.0, but that would
require changes in source XML files because this version is not
backwards compatible anymore.

Also, if you do the change, please wait until the master branch is unfrozen.

  -- Jan