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
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk