Re: [Boost-docs] [quickbook] Processing names with more than one underscore ( _ )

Subject: Re: [Boost-docs] [quickbook] Processing names with more than one underscore ( _ )
From: Daniel James (dnljms_at_[hidden])
Date: 2011-02-13 18:24:37

On 12 February 2011 19:51, Edward Diener <eldiener_at_[hidden]> wrote:
>
> One can do whatever manipulations one wants to keep from having to escape
> underscores in names which have the form of '_seq_' but it still does not
> make having a simple format, which one can not turn off, easy to use.

Quickbook is a markup language, so to use it effectively you have to
mark up text. If that's a problem, then maybe it isn't the right
solution for you.

>  I am
> merely suggesting that this simple format, which naturally causes many
> headaches when used with names which are ubiquitous when documenting Boost
> libraries, be turned off by some option. Is that really that hard to do for
> quickbook ?

It's not hard, but it's the wrong thing to do. Multiple dialects can
cause all sorts of problems. The only dialect switch in quickbook is
the version switch, and that's only there for backwards compatibility
(and it's problematic enough - it's a bit buggy for included files).

Daniel