From: David Abrahams (dave_at_[hidden])
Date: 2002-11-01 18:53:14
"David Bergman" <davidb_at_[hidden]> writes:
> Did you have such a "patched" version of Synpsis somewhere?
Did I? Yes, I did. All of my patches have been in the Synopsis CVS for
some time now, though.
> I could not get Synposis to work "out-of-the-box".
You need a few other libraries to get going, e.g. graphviz.
> I used Doxygen to produce HTML (directly) and PDF (through pdftex)
> documentation of the 1.29 version of Boost.Python. It was not a very
> interesting document... Doxygen seems to not acknowledge templates as
> "compounds", so one basically get a list of the files involved in the
> project. Not very useful for Boost, in other words. I used it in
> non-template libraries, and with other languages, and it is quite good,
> with inlined code, keeping the links.
That corresponds roughly to my experience of several years ago.
> It is a pitty that the Doxygen group has not put much effort in
> handling templates, since Doxygen is a more supported tool than
> Synopsis. I think the Boost group has to more or less adopt Synopsis
> to make it viable as a documentation generator...
Maybe so. I think it might be worth it.
-- David Abrahams dave_at_[hidden] * http://www.boost-consulting.com