[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