1. RE: Why we need a good IDE ! (also about block comments)

Dan Moyer wrote:

> Just out of curiosity, have you looked at the "makeDoc.exw" that comes 
> with
> Win32Lib, which peruses comment tags in Win32Lib to create the Win32Lib 
> HTM
> documentation?  I ask because Ive been working on an "editor" to allow 
> easy
> insertion of at least some of those comment tags into any library of
> routines in order to make them self-documenting.  If you have looked at 
> the
> Win32Lib system of comment tagging, & find it lacking, what would you
> suggest to improve it?

    Hey Dan,

    I was not aware of that, but I did suspect some tool was used
    to build the win32lib documentation.

    I'm currently e-mailing with Travis Beaty about such a tool
    as he is planning something and thought it would be possible
    to include in my IDE. I myself think that the concept can be
    taken much further, like generating HTMLhelp files from included
    comments.

    I'll take a look at your tool and I'm sure Travis will also blink

Hans Peter Willems

new topic     » topic index » view message » categorize

2. RE: Why we need a good IDE ! (also about block comments)

Hello Dan,

Dan Moyer wrote:
> Not sure, but I think you thought I made MakeDoc, which I didn't.

   I didn't assume anything, just that such a tool was used blink

> Just to be clear:  what I'm working on is an "editor" to add comment 
> tags to
> a library so "MakeDoc.exw" can create the HTM documentation for that 
> library
> from those specially tagged comments; the utility "MakeDoc.exw" is an
> *existing* program created by David Cuny & included with Win32Lib, 
> although
> Derek may have made improvements to it (& I did make an amended version 
> to
> break up the output file from one to many in order to improve speed of
> jumping to links on slower machines).

   I like the doc-generators so far, but I want more from them.
   For example I want to have the possibility to generate (HTML)
   helpfiles from included comments and also the possibility to 
   dump documentation directly to a printer.


Hans Peter Willems

new topic     » goto parent     » topic index » view message » categorize

Search



Quick Links

User menu

Not signed in.

Misc Menu