[C++-sig] [Implementation] Calling wrapped functions, converters, policies

Ralf W. Grosse-Kunstleve rwgk at yahoo.com
Fri Sep 19 04:47:19 CEST 2003


--- Nicodemus <nicodemus at globalite.com.br> wrote:
> Ralf W. Grosse-Kunstleve wrote:
> 
> >There is another most wanted feature on my list: automatic integration of
> >documentation embedded in C++ code. I.e. I'd like to see my Doxygen
> >documentation appear merged with the Python documentation. It seems to me
> that
> >no amount of meta-programming wizardry will be able to do this. My current
> >state of mind is that gcc-xml/Pyste could potentially provide a solution.
> >Bruno, does gcc-xml preserve the comment blocks in C++ code? If not, could
> it
> >be made to?
> >
> 
> Hi Ralf,
> 
> It doesn't, and I believe it would be very hard for it to do it, because 
> normally the comments are discarded during the syntax check, so the 
> grammar would have to change to support that... but we should ask Brad 
> King to know for sure.

I can see that it would be hard to extract the comments. Here is a different
idea:

void foo()
{
  static const char* documentation =
"A silly function "
" that does nothing.";
}

class bar
{
  static const char* documentation =
"A silly class"
" that does nothing.";
};

This assumes that it is possible to extract the documentation strings with
gcc-xml. Does this sound feasible?

Ralf


__________________________________
Do you Yahoo!?
Yahoo! SiteBuilder - Free, easy-to-use web site design software
http://sitebuilder.yahoo.com




More information about the Cplusplus-sig mailing list