16 Oct
2009
16 Oct
'09
6:18 p.m.
On Fri, Oct 16, 2009 at 4:32 PM, Olle E. Johansson <oej(a)edvina.net> wrote:
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
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.