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 15:51:17

> -----Original Message-----
> From: Boost-docs [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of Daniel James
> Sent: Sunday, June 23, 2013 4:08 PM
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] [quickbook] Phrase templates containing blocks
> 
> On 23 June 2013 15:53, Paul A. Bristow <pbristow_at_[hidden]> wrote:
> >
> >
> >> -----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.
> 
> I'm not sure what you mean as "an explicit forbidden newline".

I mean "an explicit forbidden newline" = a [br]

(I've yet to find it causes the downstream trouble that you warned about).

> Maybe I should explain my reasoning a bit better. Phrase templates normally just do something like
text
> substitution, i.e. in this case:
> 
>     Text before template. Text before table. [table] Text after table.
> Text after template.
> 
> But `[table]` is a block element, so that is equivalent to:
> 
>     Text before template. Text before table.
> 
>     [table]
> 
>     Text after table. Text after template.

I'm OK with that.

I think I'm not really OK with blocks and phrases, (nor layout as part of syntax as I've complained
before)  but I'll have to live with all of that ;-)

And it's all worth it!

Paul

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