DocMaker is a tool to automatically create documentations for your programs. It's a bit like "JavaDoc" but for PureBasic with some nice features. Just write the infos for the documentation inside your procedures and use the tool to make a HTML documentation at the click of a button. It is possible to tag procedures, enumerations, structures and the code itself. Chapters can be defined to structure  the documentation. It's possible to use html tags within the comments to use them in the final documentation. Example codes, images, links to other procedures or enumeration lists and more are available to use.

How it works:

1. Include the information you want to your procedures:

Procedure DocMakerTest(SomeText.s, Value.i=0)
  ;@ This is a procedure to test DocMaker's functionality.
  ;@param SomeText Some text to give to the procedure.
  ;@param Value A value to give the procedure as a parameter. <i>(optional)</i>
  ;@return This procedure returns nothing.
  Debug "The text: "+SomeText
  Debug "Given Value: "+Value
EndProcedure

2. Start the DocMaker tool and add the source code file to the file list

3. Export the HTML documentation

Features

• Automatically collects general, procedure, enumeration and structure comments
• Sorting of procedures, enumerations and structures to chapters
• Configurable html style (colors, sizes, …)
• Configurable export options (export a table of contents yes/no, process enumerations, structures, procedures, …)
• Automatic creation of internal links
• Support for example code, images, links, …

Used tags

General tags for documentation layouting

;@title The title of the project/documentation
;@author The author of the project/documentation
;@version The version of the project/documentation
;@chapter The title of the current chapter
;@ Description (can be multilined) All descriptions that are not in a procedure, enumeration block or structure block will be considered as chapter descriptions

Tags for Procedures

;@ Description (can be multilined)
;@author The name of the author
;@version The version
;@param Name Description (A parameter name and a description (\n for line feed))
;@event Name
;@attribute Name Rights Description (An attribute this procedure processes (\n for line feed))
;@return Description of the return value
;@link Type Link
;@code Some code here
;@image An image file

Tags for Enumerations

;@name The name of a enumeration list
;@ Description (can be multilined)
; A commentary behind a constant in a enumeration block will be saved as the description (\n for line feed)

Tags for Structures

;@ Description (can be multilined)

A manual with all information needed is included.

The source code for the tool is included, too, but won't be compilable because it uses sqUId as the UI system which is not included with the download. But it can be used to see how the processing of the data works.

If you have any questions or ideas just leave a comment.