## CcDoc
v08r40 2003/05/15
Joe Linoff

Ccdoc is a free javadoc inspired tool that automatically generates HTML web documentation from C++ programs by parsing the source file headers. It was designed to aid collaboration between package users and package developers by documenting the interface.

Introduction | Downloads | Users Guide | FAQ | Support | Issues | More Links...

Recent News
May 21, 2003 Wednesday | Released a new version of ccdoc (r40) that fixes issues 0172 and 0173. I will be on vacation until mid-June so no work will be done on ccdoc during that time.

May 15, 2003
Thursday

Logged a new issue:

- Issue 0173 - The md5hash macro is being improperly ignored by the rptmac1 heuristic.

This issue has been fixed in r40 (not yet released).

I will release r40 in the next couple of days.

Mar 11, 2003
Tuesday

Logged a new issue:

- Issue 0172 - Template friend declarations are not resolved properly when packages are used.

This issue has been fixed in r40 (not yet released). If this is a critical problem for you, please let me know and I will spin a release.

Mar 06, 2003 Thursday | Dmitry Steklenev has ported ccdoc v08r39 to the OS/2 Warp platform. It can be downloaded from this URL (which is also available on the downloads page): ftp://ftp.ptv.ru/pub/glass/ccdoc/ccdoc_v08/ccdoc_v08r39.zip .
Mar 03, 2003 Monday | The Mac OSX port is now available.

Feb 28, 2003
Friday

A new version of ccdoc: v08r39, is available that fixes the bugs described by the following issues:

- Converted all of the source files to unix format for the upcoming release to cygwin (ccdoc-0.8.39-1).
- Created a cygwin compatible release package (with lots of help from the cygwin folks). The package provides a man page, a configure script, patches, etc. This might be useful for folks that want to support ccdoc on linux platforms. I will add a link to the cygwin package when it is officially accepted.
- Improved the man page generation (also for cygwin). There were still a number of problems in r38. The r39 man page is now readable.
- Removed dead code found by Christian Ehrlicher during his port to the Borland compiler.
- Issue 0152 - Ignore duplicate macros names. This resurfaced during r39 testing. I found a case where duplicate macros were reported when they were defined in different packages.
- Issue 0167 - In German we want to use embedded dots in the short description.
- Issue 0168 - Slow g++ 3.2 compile of help.cc because of the large help string.
- Issue 0169 - Man page has formatting problems.
- Issue 0170 - Bug on NT platforms parsing command line with spaces and wildcards.
- Issue 0171 - Constructors with constructed default arguments are reported with the wrong method name.
- Added _INCLUDED and _included suffixes to the -rtpmac1 heuristics.

The Mac OSX port is not yet available because the server on the SourceForge compile farm server that I use for porting is down. I will update the release as soon as it is ported.

Feb 27, 2003
Thursday

The following issues have been reported and will be fixed in the upcoming v08r39 release. Please contact me if you need any of these fixes now.

- Converted all of the source files to unix format for the upcoming release to cygwin.
- Removed dead code found by Christian Ehrlicher during his port to the Borland compiler.

Feb 26, 2003
Wednesday

The following issues have been reported and will be fixed in the upcoming v08r39 release. Please contact me if you need any of these fixes now.

- Issue 0152 - Ignore duplicate macros names. This resurfaced during r39 testing. I found a case where duplicate macros were reported when they were defined in different packages.
- Issue 0170 - Bug on NT platforms parsing command line with spaces and wildcards.
- Issue 0171 - Constructors with constructed default arguments are reported with the wrong method name.
- Improved the man page generation. There were still a number of problems. The r39 man page is now readable.
- Added _INCLUDED and _included suffixes to the -rtpmac1 heuristics.

The current plan is to release v08r39 this weekend.

Feb 25, 2003
Tuesday

The following issues have been reported and will be fixed in the upcoming v08r39 release. Please contact me if you need any of these fixes now.

- Issue 0167 - In German we want to use embedded dots in the short description.
- Issue 0168 - Slow g++ 3.2 compile of help.cc because of the large help string.
- Issue 0169 - Man page has formatting problems.

Feb 24, 2003
Monday

A new version of ccdoc: v08r38, is available that has extensive updates to the on-line help.

It is very similar in function to v08r37. The only differences are:

- It officially supports the @endlink directive.
- It ignores macros with the _INCLUDED_ suffix in -rptmac1 mode.
- Issue 0166 was fixed.

There are a number of infra-structure changes. I added a script to automatically update the downloads page and removed the Makefile dependency on the set_release_info script. None of the infra-structure changes affect the program.

I also added the FAQ.

Feb 21, 2003
Friday

A new version of ccdoc: v08r37, is available that fixes the bugs described by the following issues:

- 0157 - In some cases operator code is being processed incorrectly.
- 0158 - Class method implementations are reported as global functions.
- 0159 - Very long names make the contents table very hard to read.
- 0160 - Empty function names appear under certain conditions.
- 0161 - Strange function names like "max)" appear sometimes.
- 0162 - Doxygen compatibility - support single line comments using doxygen syntax.
- 0163 - Doxygen compatibility - ignore the @endlink directive.
- 0164 - Doxygen compatibility - ignore @file comment blocks.

This release was made because this version actually successfully parsed an STL release!

The best practices document was also updated to include namespace and template sections.

Be careful, there was an intermediate version of r37 that was available for a couple of days because of source forge compile farm problems. To make sure that you have the correct version of r37 look for the -doxygen switch in the help.

Feb 20, 2003
Thursday

A new version of ccdoc v08r36 is available that fixes the bugs described by the following issues:

- 0156 - More namespace problems in r35.

This release was made because this was a critical bug.

Two new bugs were reported.

These have already been fixed in the working version of r37 and will be released later this week.

- 0157 - In some cases operator code is being processed incorrectly.
- 0158 - Class method implementations are reported as global functions.

Feb 19, 2003
Wednesday

A new version of ccdoc v08r35 is available that fixes the bugs described by the following issues:

- 0154 - Eliminate the requirement that the -rptmac and -rptmac1 switches appear in phase 1.
- 0155 - Incorrect documentation when there is only one ccdoc namespace comment for namespace declarations in multiple files.

This release was made because the r34 requirement that -rptmac and -rptmac1 switches appear in phase 1 was inconsistent with the interface paradigm.

Feb 18, 2003
Tuesday

A new version of ccdoc v08r34 is available that fixes the bugs described by the following issues:

- 0056 - Incorrect line numbers reported in warning messages.
- 0098 - It would be a help if you made the reference red if the class cannot be found for @link.
- 0107 - javadoc # syntax is not supported in the {@link...} directive.
- 0109 - Print warnings to stderr.
- 0122 - Enhance template reporting.
- 0149- Template method implementations confuse ccdoc. There was a corner case that was not handled properly.
- 0150 - Make it easier to update the revision number in the source files.
- 0152 - Ignore duplicate macros names.
- 0153 - Add a heuristic to ignore include guards and DLLIMPORT macros.

This release was made because a user had a critical need for the 0149 fix and because I had some time.

Feb 17, 2003
Monday

A new version of ccdoc v08r33 is available that fixes the bugs described by issues

- 0144 - Mark static members and methods in the class overview.
- 0149- Template method implementations confuse ccdoc.

This release was made because a user had a critical need for the 0149 fix.

Feb 10, 2003
Monday

A new version of ccdoc v08r32 is available that fixes the bugs described by issues

- 0146 - Namespace processing doesn't work properly in certain cases.
- 0147- Lots of compiler warnings when building ccdoc using the Borland C++ compiler.

This release was made because a user had a critical need for the 0146 fix.

Old News

$Id: index.html,v 1.56 2003/05/21 18:45:34 jlinoff Exp $
Visitors since 2002/12/30