Re: [boost] Boost documentation

From: Daniel Wallin (daniel_at_[hidden])
Date: 2007-07-02 04:14:39

Stefan Seefeld wrote:
> Eric Niebler wrote:
> 
>> Let me repeat the point about QuickBook I made earlier, since you seem 
>> to have missed it:
> 
> I didn't. I hoped David would jump in, as he seems to be the ReST expert
> here.
> 
>>> I needed something that would let me write docs fast in a plain text 
>>> editor, with cross-links to a reference section generated by Doxygen. I 
>>> wasn't aware of any tool that fit that description. I'm still not.
>> And later I asked:
>>
>>> I've never used ReST. I know Dave 
>>> has. Can I cross-link to a Doxygen-generated section?
>> I never saw a response. I'm all for using ReST, as long as it does what 
>> I need it to do. So does it?
> 
> I believe ReST can be configured to do that. David ?

Yes, docutils could pretty easily be extended to do that. It doesn't
handle it by default, naturally, since it's way outside the scope of the
project, but docutils has very well defined extension points that can be
used for these kinds of things.

-- 
Daniel Wallin
Boost Consulting
www.boost-consulting.com