Free Generator of HTML Documentation from PBLs

I was searching for an application to document my PBLs in a HTML website, by extracting comments etc. from my code, I ended up writing something, which I have attached, and offer for free for anyone's use.

It can document a single PBL, or all of the PBLs in a target (PBT).

It's not a completely standalone solution, as it requires the installation and use of the generic documentation generator NaturalDocs ( www.naturaldocs.org ).

What's in the Zip file is a PB 2021 workspace, target and PBL with my application in it, configuration files for NaturalDocs, and a fairly comprehensive Help file explaining the required setup and usage.

The generated documentation can be improved by writing your comments at the start of functions, events etc. in the style it expects, and for objects that don't contain code, supplying a Comment in the object's Properties. It's all explained in the Help.

I'm sure this doesn't do anywhere near as good a job as VisualExpert ( www.visual-expert.com/ ) but it's free! It was good enough for my purposes, which was helping a new PB hire to understand the common library used in our applications.

Jim,
Feel free to send what you have so far.

Heribert,
I'm sorry, I discovered some issues with how I was parsing the source code, especially with older syntax for events. I was never able to fully resolve them. I haven't worked on this for quite a while now. If I get back to it, I will post it. I could post what I had up to that point, but it does mis-handle some things.

Hello Jim,
I would like your mentioned changes very much.
Can you already provide something about this?

Looks great Jim, thanks!

Thanks for posting this, I think it is terrific. I've been tinkering with it and I'll be posting an updated version when I'm done. Some of the modifications include:

• An option to include the source code
• Maintaining the formatting of the extracted datawindow SQL
• Improving the readability of the datawindow SQL that is still using the SQL painter
• Scanning existing comments for keywords that don't meet the formatting requirements and fixing them so they present properly in the final HTML

I'm including some sample images with some of these revisions.