Re: [Boost-docs] a couple quickbook bugs (or features?) regarding italics and variablelists

Subject: Re: [Boost-docs] a couple quickbook bugs (or features?) regarding italics and variablelists
From: Joel de Guzman (joel_at_[hidden])
Date: 2007-07-30 00:44:51

Stjepan Rajko wrote:
> On 7/29/07, Joel de Guzman <joel_at_[hidden]> wrote:
>> Stjepan Rajko wrote:
>>> If I have a template ProducerConcept and I write:
>>>
>>> ['[ProducerConcept]]
>>>
>>> the template gets expanded and written in italics, but if I write:
>>>
>>> /[ProducerConcept]/
>>>
>>> I get [ProducerConcept] in italics, i.e. the template does not get
>>> expanded.  Is this intended? Seems a bit weird.
>> This is documented:
> 
> Doh!  Yep, right there it is... sorry for the noise.
> 
>> I know a way to relax these limitations, but it will involve some
>> complexity. I am not sure yet if the added complexity is worth it.
>>
> 
> I don't see it as necessary.  I was just confused, due to having
> missed the relevant parts of the docs.

Don't brush it off just yet. There's the principle of "least
surprise". If this behavior is surprising, regardless if it
is documented or not, then it must be reconsidered.

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