Re: [Boost-docs] Sphinx integration

Subject: Re: [Boost-docs] Sphinx integration
From: Dave Abrahams (dave_at_[hidden])
Date: 2011-10-04 17:17:51

on Mon Oct 03 2011, Edward Diener <eldiener-AT-tropicsoft.com> wrote:

> On 10/3/2011 10:04 AM, Dave Abrahams wrote:
>>
>
>> on Sun Oct 02 2011, Edward Diener<eldiener-AT-tropicsoft.com>  wrote:
>>
>>>
>>> Conversely there is no limit in doxygen to documenting whatever you
>>> want as free-from doxygen documentation and so you could document
>>> concepts' in doxygen if you wanted to do so in whatever format you
>>> like. There are a number of techniques for this but probably the
>>> easiest is to just add such documentation to a @file documentation,
>>> and it will show up in the final output.
>>
>> 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?
>
> I agree with you. There is no big advantage trying to fit into
> doxygen, which is largely an attempt to document at the source code
> level C++ constructs, documentation that is outside the area of a C++
> construct when one has quickbook to do that.

Well, I'm not making that claim, since I'm no expert in Doxygen; I'm
just asking.

-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com