Confused about Synopsis

"David Piepgrass" <[email protected]> Fri, 17 Aug 2007 15:11:42 -0600
Newsgroups gmane.comp.documentation.synopsis
Message-ID <[email protected]>
Hi, I'm having trouble figuring out what Synopsis can be used for.

Firstly, can it be used as a replacement for Doxygen? Where is the
documentation for Synopsis's documentation generator?

Secondly, I installed synopsis-0.8.win32-py2.4.exe on my Windows
computer, but there is no executable called synopsis anywhere on my
computer. It's discussed in the documentation; where is it?

Thirdly, I would like to have a tool that makes C++-to-C++ wrappers in
order to create C++ dynamic-link libraries. My idea is to convert header
files that are full of low-level details about a library into another
set of header files that only have high-level details. For example if
the original file says:

class Foo {
private:
   void blah(int x, Bar y);
   int x;
   Bar* y;
public:
   Foo() { x =3D 0; y =3D NULL; }
   operator const char*() { return y->z + x; }
}

then (...to make a long story short...) it would put out a scrubbed file
like this:

class Foo {
   char data[8];
public:
   Foo();
   operator const char*();
}

Would Synopsis be suitable for this purpose? Another way I could do this
is by extending SWIG (www.swig.org) but in my research so far, it feels
like an extremely complex tool to write code for.

P.S. I'm going on vacation for two weeks after today. Bye!