#25 Exceptions and comments in source files

[Thomas Bryan]

Submitted by Borlik, Jeffrey on Thu, 2 Sep 1999
10:46:19 -0700

Tom -

I have found Perceps (version 3.5.0) to be very
useful in producing documentation of my project's
API.

However, I have run into a couple of problems:

1) Functions that throw an exception are not
registered as doing that. My functions are
generally defined in an implementation file
(.cpp), and it doesn't seem like Perceps finds
those exceptions.

2) User-defined comments in an implementation file
don't seem to make it into the class's html file.
I have a "warn" comment, which is run through a
filter to make a bulleted list. However, I can
only have the "warn" comments in the header file,
and only before the class definition at that. Am
I missing something in the documentation?

The attached files are a simple example to show my
two points. (The "warn.flt" is a useful filter in
itself, that you might be interested in.)

Thanks,
Jeff Borlik