[Scons-dev] Problem using doc toolchain?

[Bill Deegan]

William,

On Wed, Jul 29, 2015 at 5:10 PM, William Blevins <wblevins001 at gmail.com>
wrote:

> 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?
>

Ubuntu 14.04 + python 2.7.10 built from scratch + lxml
(Built from scratch as the python which ships with ubuntu drops the windows
installer stubs we use for our windows installers..)

-Bill



>
> 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
>>
>
>
> _______________________________________________
> 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/3d3c7329/attachment.html>