Re: [Boost-docs] [quickbook] Phrase templates containing blocks

Subject: Re: [Boost-docs] [quickbook] Phrase templates containing blocks
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2013-06-23 14:53:54

> -----Original Message-----
> From: Boost-docs [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of Daniel James
> Sent: Sunday, June 23, 2013 10:24 AM
> To: Discussion of Boost Documentation
> Subject: [Boost-docs] [quickbook] Phrase templates containing blocks
> 
> Hi,
> 
> I've recently done a little on changing the way phrase and block templates work for 1.7. My
initial
> version (not in subversion yet) works by just changing the parser to allow blocks in phrase
templates, and
> letting the block handling code deal with it. This works okay, but can be surprising. For example
this:
> 
>     [template thing[] Text before table. [table]. Text after table.]
> 
>     Text before template. [thing] Text after template.
> 
> Generates:
> 
>     Text before template.
> 
>     Text before table.
> 
>     [table]
> 
>     Text after table.
> 
>     Text after template.
> 
> But I imagine most people would expect:
> 
>     Text before template. Text before table.
> 
>     [table]
> 
>     Text after table. Text after template.

> Does that look right to you? 

If I've understood this right, I suppose so, but I think people can cope with either, but it's
better to have an 'extra newline' than being tempted (forced?) into using an explicit forbidden
newline.

> It'll need some changes to implement that, but it's doable. The problem is,
> what should happen in a case like this:
> 
>     [template thing1[] Line 1
> 
>     Line 2]
> 
>     Text before template. [thing1] Text after template.
> 
> What do you think that should that be? (Don't think about what it currently does).

My brain hurts!  I just wants this control-of-newlines problem to go away ;-)

Paul

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