Re: [Boost-docs] The beauty of LATEX

Subject: Re: [Boost-docs] The beauty of LATEX
From: Mateusz Łoskot (mateusz_at_[hidden])
Date: 2011-10-21 12:08:18

2011/10/21 Mateusz Łoskot <mateusz_at_[hidden]>:
> On 21 October 2011 12:02, Paul A. Bristow <pbristow_at_[hidden]> wrote:
>> If we have a C++ function in a header, and provide some 'concept' info in Doxygen syntax inside a
>> C++ comment.
>>
>> /*!
>> Â  Â  Â  nontype template function that just returns the template value.
>> Â  Â  Â \tparam size is a constant integer argument.
>> Â  Â  Â \returns constant integer size always.
>> Â  Â  Â \pre No preconditions.
>> Â  Â  Â \post No side effects.
>> Â  Â  Â \throws Never.
>> Â  Â  Â \warning This is not a very useful function.
>> Â  Â  Â \see More useful functions.
>> Â */
>> Â template <int size>
>> Â int template_parameter_size()
>> Â {
>> Â  Â return size;
>> Â }
>>
>> Could we invent a better syntax? Â I'm sceptical - it seems so simple.
>
> Doxygen is greedy (in regexp terms).
> To make Doxygen greedy, you need to juggle comment styles what leads to mess.
---------------------------^^^^^^^^^^^

I made mistake, it should read "not greedy", of course.

Best regards,
-- 
Mateusz Loskot, http://mateusz.loskot.net
Charter Member of OSGeo, http://osgeo.org
Member of ACCU, http://accu.org