[Scons-dev] Problem using doc toolchain?

William Blevins wblevins001 at gmail.com
Wed Jul 29 20:10:52 EDT 2015


Bill,

When I try to run the doc generator, I get something similar.  I am using
the standard tools from Debian 8.

Dirk,

What platform and tool versions are you using?

V/R,
William

On Wed, Jul 29, 2015 at 6:47 PM, Dirk Bächle <tshortik at gmx.de> wrote:

> Hi Bill,
>
> On 30.07.2015 00:30, Bill Deegan wrote:
>
>> Dirk (and anyone who understands the doc toolchain),
>>
>> I've run:
>>
>>     python bin/docs-update-generated.py
>>     python bin/docs-validate.py
>>     python bin/docs-create-example-outputs.py
>>
>> Per our release procedure working on getting 2.3.5 out.
>>
>> [...]
>> Here's diff for functions.gen
>> https://pastebin.mozilla.org/8841011
>>
>> (pretty much all the files have a diff, but I'm not sure they're an issue)
>>
>> Are any of these differences important?
>>
>>
> I'll make this a "yes". The problem here is that the special XML tags like
> "example_commands" don't exist in the standard "Docbook" namespace, but
> only in the "http://www.scons.org/dbxsd/v1.0" namespace referring to the
> extended "SCons Docbook". If you leave out these specifications
>
>   xmlns="http://www.scons.org/dbxsd/v1.0"
>
> this may lead to errors during processing later. Even when you don't see
> it at first while creating a PDF or EPUB directly, users might not be able
> to directly edit the XML files with an editor like XmlMind or SernaFree.
>
> Can you try and find out why your XML processing chain omits the namespace
> definition within the single XML tags?
>
> Best regards,
>
> Dirk
>
> _______________________________________________
> Scons-dev mailing list
> Scons-dev at scons.org
> https://pairlist2.pair.net/mailman/listinfo/scons-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://pairlist2.pair.net/pipermail/scons-dev/attachments/20150729/e9be9e5c/attachment.html>


More information about the Scons-dev mailing list