[sr-dev] Why fetch docbook stylesheets remotely?

[Jan Janak]

On Fri, Oct 16, 2009 at 4:30 PM, Olle E. Johansson <oej at edvina.net> wrote:
>
> 15 okt 2009 kl. 17.03 skrev Jan Janak:
>
>> On Thu, Oct 15, 2009 at 4:29 PM, Juha Heinanen <jh at tutpro.com> wrote:
>>>
>>> Olle E. Johansson writes:
>>>
>>>  > Is there any particular reason for why we always fetch docbook style
>>>  > sheets over HTTP when running "make README" ?
>>>
>>> also schema generation required net access, but henning fixed it.
>>> perhaps similar fix is needed here.
>>
>> I just tried to build a couple READMEs in modules and both files with
>> docbook 4.2 and 4.4 seem to build fine on Debian with docbook-xsl
>> package installed.
>>
>> If I uninstall the package then the build system fetches the XSL
>> stylesheets from the net.
>>
>> Olle, if you have the XSL stylesheets in a non-standard location then
>> modify the file docbook/catalog.xml so that the build system can find
>> them. There is a small example (commented out) which points to a
>> directory in my home directory.
>>
>> If you are no debian then just install package debian-xsl.
>
> Well, I'm on OS/X, but I understand the issue now, thanks!

In that case simply download the stylesheets somewhere and add the
location to the catalog file in sip-router/docbook/catalog.xml (but do
not commit, this should be your local change). Then it should work.

> Had very poor connections during Astricon, so I could not fix this.
> Thanks for the explanation, we need to store it somewhere...

By the way, the docbook build system should not overwrite READMEs if
the stylesheets are missing or if you terminate the build process,
that's a bug. I will fix it as soon as I am finished with some other
debugging I am doing right now.

  -- Jan