Re: [Boost-docs] [quickbook] Macros and scoping

Subject: Re: [Boost-docs] [quickbook] Macros and scoping
From: Joel de Guzman (joel_at_[hidden])
Date: 2007-07-30 01:23:39

> This would be useful if one wanted to define templates that link to
> different section content in the same file as the the section content
> (but outside the [section], of course), and had two sections that
> cross-referenced each other.  I imagine this is the behavior you
> envisioned but just making sure.
> 
>> 2 Change the old scoping behavior for old macros and templates
>>    starting with 1.4, but maintain backward compatibility for
>>    1.3 and older docs.

>> Comments? I tend towards 2.
> 
> 2 seems to make the most sense to me also.

Alrighty, unless there are objections, I going after 2. Seems there
are 1.4 users..., so, I think John's suggestion is best. Start with
1.5. That means, I'll be bumping the version and start from there.
1.5 will have these changes:

* The conditional generation
* Macro scopes will be at document/section/template bodies
* Ditto for template scopes
* There will be an implicit include guard. A qbk file will only
   be included once per scope (like pragma once).
* 1.4 and lower will not be affected with these changes.

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