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 <> wrote:

> On 10/3/2011 10:04 AM, Dave Abrahams wrote:
>> on Sun Oct 02 2011, Edward Diener<> 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

This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC