[sr-dev] Why fetch docbook stylesheets remotely?

[Olle E. Johansson]

16 okt 2009 kl. 17.18 skrev 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.

Well, since we are referencing 4.4 in many places and catalog files  
are 4.3
we have this issue with fetching over http.

Just to check, documentation updates are not frozen, only code changes  
- right?

/O