Re: [boost] Boost documentation

From: Eric Niebler (eric_at_[hidden])
Date: 2007-07-01 21:49:11

Stefan Seefeld wrote:
> David Abrahams wrote:
>> on Sun Jun 24 2007, Stefan Seefeld <seefeld-AT-sympatico.ca> wrote:
>>
>>> David Abrahams wrote:
>>>> on Sat Jun 23 2007, "Gennadiy Rozental" <gennadiy.rozental-AT-thomson.com> wrote:
>>>>> There several WYSWYG editors producing DocBook (and I don't need to
>>>>> enter markup at all!) and this trend is going to grow.
>>>> Yeah, but we need to represent semantic information (e.g. Concepts)
>>>> that are outside the builtin representational abilities of DocBook.
>>> DocBook is designed for extensibility. 
>> I know.  That's why I said *builtin*.
>>
>> BoostBook is just an extension of DocBook, using expressly-designed
>> hooks in DocBook for that purpose.  I don't consider that an NIH move
>> on our part; quite the contrary.
> 
> Yes, understood. With NIH I'm not referring to BoostBook, but to QuickBook,
> which is neither an extension to DocBook, nor ReST. Thus, no existing
> parser will work with it, no existing documentation will help, and no
> existing community can answer questions and help resolve issues.

Let me repeat the point about QuickBook I made earlier, since you seem 
to have missed it:

> 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?

-- 
Eric Niebler
Boost Consulting
www.boost-consulting.com