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

Subject: Re: [Boost-docs] [quickbook] Processing names with more than oneunderscore ( _ )
From: Daniel James (dnljms_at_[hidden])
Date: 2011-02-26 15:23:25

On 26 February 2011 14:30, Barend Gehrels <barend_at_[hidden]> wrote:
>
> Looked for solutions.
> -> Indeed renaming it as make_prefix (either ticked or not) does help. But
> make_prefix is not one word, the prefix is make_
> -> Of course I can omit the last _ and that helps either. But strictly the
> prefix is make_
> -> Escaping like \_ does not help (according to the docs it seems that it
> should work)

Without the fixed version, you have to quote/escape the opening mark,
not the closing one. Once it enters 'simple markup' it uses a
different parser which doesn't recognise a lot of markup. This is
something I'm planning to deal with in a future version. Although, it
shouldn't be too difficult to add support for escapes.

> -> Escaping like  '''make_''' let quickbook crash

What's happening here is that the first ''' is within the simple
markup, so it doesn't recognise it and uses the second one as the
start of the escaped markup. It probably matches that with another '''
elsewhere in your document. This causes it to parse what you think of
as quickbook as xml. And the xml parser is prone to crashing on xml
that isn't well formed. There's an easy fix for this, I can change the
simple markup grammar so that it can't include '''.

Daniel