[Scons-dev] User-guide generation

[William Blevins]

Dirk,

Apparently, the user guide data doesn't regenerate unless you call:

>    python bin/docs-update-generated.py
>    python bin/docs-validate.py
>    python bin/docs-create-example-outputs.py
>
> I guess it just doesn't make a lot of sense to me why these are manual
steps rather than being commands that run as part of the #doc/user build
step.

V/R,
William

On Fri, Aug 19, 2016 at 8:09 AM, Dirk Bächle <tshortik at gmx.de> wrote:

> Hi William,
>
> I hope you don't mind since we're among developers here, but I think it's
> fair to apply the same rules to everyone.


Sure. I'm don't even know what you would have done otherwise. Laugh? Also
acceptable :)


> So I'm treating this the same as on the user list.
> Please tell us which commands exactly you have run, and which parts of the
> documentation you follow as reference. The "doc/user/SConstruct" should
> work fine and is supposed to allow you to build the corresponding
> PDFs/HTMLs standalone, during editing for example.
> So simply removing it is not an option at the moment.
>
> Best regards,
>
> Dirk
>
>
> On 19.08.2016 06:32, William Blevins wrote:
>
>> Team,
>>
>> While I was chasing my tail, I went ahead and followed the
>> SimplifiedReleaseProcedure
>> <https://bitbucket.org/scons/scons/wiki/ReleaseHOWTO/Simplif
>> iedReleaseProcedure>. Not sure how to verify I did it right. What's the
>> process for handing out alphas?
>>
>> I didn't make a branch or anything. This was just for my personal
>> reference.
>>
>> V/R,
>> William
>>
>> On Fri, Aug 19, 2016 at 4:54 AM, William Blevins <wblevins001 at gmail.com
>> <mailto:wblevins001 at gmail.com>> wrote:
>>
>>     Team,
>>
>>     I think I chased my tail until I figured out I needed to run some
>> python scripts under #bin which do fairy magic...
>>
>>     V/R,
>>     William
>>
>>     On Fri, Aug 19, 2016 at 4:12 AM, William Blevins <
>> wblevins001 at gmail.com <mailto:wblevins001 at gmail.com>> wrote:
>>
>>         Team,
>>
>>         Is the doc/user/SConstruct legacy? If I build from #SConstruct
>> then I seem to get some not insane in the build directory. If
>>         doc/user/SConstruct is no longer functional or maintained, I
>> would like to remove it to alleviate my confusion!
>>
>>         V/R,
>>         William
>>
>>         On Fri, Aug 19, 2016 at 3:18 AM, William Blevins <
>> wblevins001 at gmail.com <mailto:wblevins001 at gmail.com>> wrote:
>>
>>             Team,
>>
>>             I have a strange issue. The user-guide build does not throw
>> any errors but doc/user/index.html does not regenerate and
>>             doc/user/scons-user/index.html is empty. All the addition
>> html files under doc/user/scons-user seem to generate correctly.
>>
>>             Anyone else have this issue?
>>
>>             V/R,
>>             William
>>
>>
>>
>>
>>
>>
>> _______________________________________________
>> 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/20160819/504c7eca/attachment.html>