[Boost-bugs] [Boost C++ Libraries] #1190: Markups inside simple markups

Subject: [Boost-bugs] [Boost C++ Libraries] #1190: Markups inside simple markups
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2007-08-20 07:36:19

#1190: Markups inside simple markups
------------------------------+---------------------------------------------
 Reporter:  djowel            |       Owner:  djowel   
     Type:  Feature Requests  |      Status:  new      
Milestone:  To Be Determined  |   Component:  quickbook
  Version:  Boost 1.34.1      |    Severity:  Cosmetic 
 Keywords:                    |  
------------------------------+---------------------------------------------
 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.

-- 
Ticket URL: <http://svn.boost.org/trac/boost/ticket/1190>
Boost C++ Libraries <http://www.boost.org/>
Boost provides free peer-reviewed portable C++ source libraries.