Thanks for the reply, I think you are probably right about the parser being the better place to handle this, I made the changes a few years back in small steps as it was during my transition from CodeWright (the reason for
cworg) to SlickEdit. I had written the rough beginnings of a "GenComment" equivalent for CW that I used as my basis for the modifications to your tool. I also wrote a script file for connecting the GUI controls to the documentation (all the information is in a header file LabWindows regenerates every time a change is made to the GUI).
LabWindows is a National Instruments C compiler with some specialization for handling GUIs and instruments (oscilloscopes, meters, power supplies and such things used in laboratories during development of new products or testing of them). A demo version can be downloaded at
www.ni.com/lwcvi/. The two main things that are decoded in what I sent you are menu bar handling routines and control handling routines. They each have specific generic prototypes that can be found by the CVICALLBACK define (finds either one) and then classified by the parameter names,
panel for controls and
menuBar for the menu selections. It also has the ability to create ActiveX servers, their prototypes have varying signatures but the return type has been
HRESULT CVIFUNC with a first parameter of
CAServerObjHandle objHandle.
I am using doxygen (
www.doxygen.org) to extract the documentation from my code and it has parts of the documentation notated different ways (like JavaDoc and CDoc and others) the
%brief section is just a brief description that goes in various parts of the documentation that you usually don't want the full description in (indexes and such), it needs to follow the same prefix (@ or \ typically) rules as param and return.
Attached are the INI, my other script, a source file with some of the types of prototypes, header file from a GUI (corresponds to some of the functions in the source file), and if you want I can post two doxygen related "headers" (*.hox) generated by CVI_NoteContol and an output CHM file (MS compiled help file after all processing is done).
Thanks.