[Scons-users] New SCons.org website up

[Marc Branchaud]

On 16-01-18 03:45 PM, Dirk Bächle wrote:
> Hi Marc,
> 
> On 18.01.2016 16:25, Marc Branchaud wrote:
>> On 16-01-16 05:35 PM, Bill Deegan wrote:
>>> Greetings,
>>>
>>> We've refreshed the website.
>>> Please let me know if you find any issues/comments/suggestions for
>>> improvement.
>>
>> I like the new look!
>>
>> One minor note: The "Version Specific SCons Documentation" link on the
>> documentation.html page is broken.
>>
>> More importantly, a while back (around 2.3.1) the HTML man page was changed
>> in an unfortunate way.  The old version had an Index at the bottom with links
>> to various sections in the page (see, for example,
>> http://www.scons.org/doc/2.3.0/HTML/scons-man.html).  I really miss that!
> 
> this was a feature of "man2html", which we ditched as a dependency when
> introducing the new DocBook-based toolchain.
> 
>> Any chance of it coming back?
> 
> It's possible to define an "Index" in DocBook too (see example image
> attached)...it's just that someone would have to do the work of
> re-introducing all previous entries as proper "indexterms", and then all the
> other formats (PDF, ePUB) would benefit from this automatically. Care to
> write a short Python script for this?

A table-of-contents is more of what I'm looking for.  Just because the
previous version called it an "Index" doesn't mean that DocBook's "index" is
necessarily the thing to use.

Doesn't DocBook do automatic table-of-contents generation for various
<chapter>s and <section>s?  Or does that just work for <book>s (and the SCons
document seems to be a <reference>)?

(Every time I try to do anything in DocBook it takes me at least 3 days to
figure out the magic incantations...)

		M.