            VBdocman 2.0 - An Automatic VB Documentation Generator
                                (Trial version)



1. OVERVIEW

VBdocman is a program for automatic generating of technical 
documentation from your Visual Basic source files with just few mouse clicks. 
It parses source code and automatically creates table of contents, index, 
topics, cross-references and context sensitive help. The format of output 
documentation is fully configurable by user. The predefined output formats are:

  - HTML Help (*.chm file which looks like MSDN)-2 variants
  - HTML files (with Java index and table of contents)
  - WinHelp (*.hlp file)
  - RTF document

User is allowed to define his own format for any ASCII based document such 
as XML, LATEX, custom HTML and others.



2. HOW IT WORKS

VBdocman works as an add-in into MS Visual Basic 6.0. After invoking simple dialog 
through main menu and (in the simplest case) clicking one button the specified 
output documentation is generated. It automatically creates all interesting 
links such as "Applies To", "Methods", "Events", "Properties", "Events", table 
of contents and index. In greater projects only this work saves many days of 
boring work. Documentation can be then edited and additional description given 
there such as "See Also", "Examples" links, object, method, property or event 
description, parameters description and so on. VBdocman allows to add even that 
description automatically by extracting it from source code comment from 
special tags. It works similarly as JavaDoc system. But, user is not forced 
to write comments manually, VBdocman adds it itself just by two mouse clicks. All 
necessary tags are added and user then fills just short description to them. 
The types of information that can be extracted are:

  - See Also links
  - Examples links
  - Object, form, method, property, event, variable or constant description
  - Parameters description
  - Settings description
  - Return value
  - Remarks
  - Author
  - Version
  - Revision date
  - User defined information



3. INSTALLATION

Before installing VBdocman uninstall any previous versions of VBdocman installed
on your computer. Then just run installation EXE file. VBdocman will be
installed. After that it should be accessible in VB IDE Add-Ins list. Detailed
help is also available. 



4. UNINSTALLATION

Go to "Control Panel" -> "Add/Remove Programs" and select VBdocman. All work 
is done automatically.



5. TRIAL VERSION

Trial 14 day version of VBdocman comes with these limitations:

  - warning message is displayed every time a new documentation is compiled
  - all documentation topics are generated properly but warning message is appended to them



6. CHANGES
In version 2.0
 1. New comment tags are added: @author, @revision and @version.
 2. User can define up to 5 own comment tags.
 3. The program processes also private variables and constants now.
 4. External declarations are supported.
 5. "End of line" macro is added and can be used directly in comments to 
    invoke new line in generated documentation.
 6. Text on the title page of generated documentation can be edited directly
    from VBdocman dialog.
 7. There are two modes of processing indents in comments. VBdocman comments
    indentation can be ignored now.
 8. VBdocman appears also as an icon on standard toolbar in VB IDE.
 9. After compiling the documentation user can easily show it by pressing
    newly added button.
 10.ParamArray argument is processed correctly.
 11.When there is only Get property (no Let or Set exists), data type of this
    property was not reported. Therefore "Returns" section is added for property.
 12.Properties with multiple arguments are processed correctly.
 13.Title for Properties link in some templates, which was misspelled is corrected.
 14.Switching to other application when compilation dialog was shown caused that it was 
    impossible to return back without minimizing all other applications. This bug is
    fixed.
 15.A space is added before "Default" word in automatic text in @param section.
 16.When nothing goes to compilation (empty documentation is generated),
    the compilation is finished correctly.
 17.When compiling HTML documentation, some files were not overwritten, if
    their older versions existed in the output directory. This bug is fixed.
 18.HTML documentation does not report "Cannot load class ..." when viewed from
    web server.
 19.The problem with executing the temporary batch file during compilation on
    some systems is fixed.
 20.Many limitations are removed from the trial version.

In version 1.1
 1. VBdocman should automatically appear in Add-Ins list under all logins. There is
    no need to write into registry for every user.
 2. VBdocman main dialog is modal now.
 3. When first opening the main dialog, output path displayed in directory view was
    not the same as last saved. The bug is fixed.
 4. When VB project contained some special files (in Related Documents there was a 
    file other than resource e.g. DLL), an access violation error occurred when
    attempting to load VBdocman. The bug is fixed.
 5. When statement in source code was broken into multiple lines, in very special
    cases VBdocman parsed definitions not properly. The bug is fixed.
 6. In some cases, when names of method arguments contained keywords as Optional,
    ByRef, ByVal and others, VBdocman parsed definitions not properly. The bug is 
    fixed.
 7. When logged without proper access rights, there was an access denied error during
    compilation because the system attempted to write some temporary files. The bug is 
    fixed.
 8. The 5-second countdown in trial version is removed.


7. CONTACT

Author: Peter Macej
E-mail: peter@vbdocman.com
Home page and registration information: http://www.vbdocman.com