Re: [Boost-docs] Sphinx integration

Subject: Re: [Boost-docs] Sphinx integration
From: Mateusz Loskot (mateusz_at_[hidden])
Date: 2011-10-05 09:06:31

On 05/10/11 00:15, Dave Abrahams wrote:
> on Tue Oct 04 2011, Mateusz Loskot<mateusz-AT-loskot.net>  wrote:
>> On 03/10/11 15:04, Dave Abrahams wrote:
>>>
>>> But what's the advantage in that over, say, just using quickbook,
>>> boostbook, or any of the other non-automatic tools for that part of the
>>> documentation?
>>
>> One of important Doxygen features is it extracts and interlinks C++
>> names/symbols (with or without attached documentation).
>> BoostBook could use this interlinking capability and generate the
>> relations we lack currently:
>> - concepts
>> - models
>> - template parameters to concepts as type requirements
>>
>> I think this interlinking is one of most important features that is
>> missing from the docs in current form.
>
> Although, I must say, it has always seemed to me that those kinds of
> links could be set up mostly-automatically by any tool, with very little
> markup of any kind needed to make them work.

Yes. And, it's essential.

Best regards,
-- 
Mateusz Loskot, http://mateusz.loskot.net
Charter Member of OSGeo, http://osgeo.org
Member of ACCU, http://accu.org