Re: [Boost-docs] [Quickbook] Templates and Namespaces

Subject: Re: [Boost-docs] [Quickbook] Templates and Namespaces
From: Joel de Guzman (joel_at_[hidden])
Date: 2007-08-03 00:36:09

Matias Capeletto wrote:

> What about something like:
> 
>    [section:sid Section Title
>    ...
>    ]
> 
> And optionally you allow the user to include the id of the section:
> 
>    [section:sid Section Title
>    ...
>    :sid]
> 
> I think it solves both issues. We have to check other blocks construct
> if we follow this path. For example, the doc type block. I think it
> will be better like:

[snip document stuff]

> What do you think?

Both are good, implementable ideas. The colon is not
necessary. The symbol table will detect sid unambiguously.
Even the /sid/ is not required. We can simply use the
Section title itself:

    [section DaDoDoDoo
    ...
    DaDoDoDoo]

or:

    [section:daa DaDaDaDaa
    ...
    daa]

The document block is also a good idea.

Regards,
-- 
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net