17 Oct
2009
17 Oct
'09
10:38 a.m.
16 okt 2009 kl. 17.18 skrev Jan Janak:
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.
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
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.