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

Subject: Re: [Boost-docs] [quickbook] Processing names with more than one underscore ( _ )
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2011-02-17 18:38:31

> -----Original Message-----
> From: boost-docs-bounces_at_[hidden] [mailto:boost-docs-
> bounces_at_[hidden]] On Behalf Of Joel de Guzman
> Sent: Wednesday, February 16, 2011 2:38 AM
> To: boost-docs_at_[hidden]
> Subject: Re: [Boost-docs] [quickbook] Processing names with more than one
> underscore ( _ )
> 
> On 2/15/2011 1:30 PM, Eric Niebler wrote:
> 
> > IIRC, the original version of quickbook that I wrote (actually ported
> > from Joel's quickdoc) didn't have the shortcut notation for bold,
> > italics, underline, etc. Joel added it later as a convenience. I never
> > particularly cared for it, for just the reasons Edward describes: it's
> > not quickbook-ish, it doesn't nest cleanly, and it sometimes catches
> > you unawares, forcing you to examine the output carefully to catch
mistakes.
> > I wouldn't be opposed to a switch that disabled it, or at least warned.
> > (I'd like to rip it out, but we can't now.) Daniel, it wouldn't be
> > creating a new dialect since one would be a proper subset of the other.
> 
> To be honest, I don't care for it now. It was added as a feature request
from this
> (boost.docs) list way back to allow for more wiki style stuff. It is one
of the
> things I regret adding :-(
> 
> I'd definitely support a switch for disabling it.

+1

And I'd also like to be able to disable the 'indent-means-a-code-box'
feature.

I would prefer to mark each code inline and code block explicitly with ` and
`` ... ``

(This would allow indenting to show structure, and prevent a single errant
leading space causing inscrutable mayhem).

Paul

---
Paul A. Bristow,
Prizet Farmhouse, Kendal LA8 8AB  UK
[phone]  07714330204
pbristow_at_[hidden]