Skip to content

Scripts to generate Doxygen pages from ADMB tpl files

License

Notifications You must be signed in to change notification settings

jimianelli/tpl2dox

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tpl2dox

A simple gawk script to interpret Doxygen comments in ADMB template files.

Requirements

Doxygen and gawk must be installed on your computer.

You will probably need a working version of ADMB, too.

Usage

  1. Include the following setting in your Doxyfile:

     FILTER_PATTERNS        = *.tpl=tpl2dox
    

and add your ADMB template file to the INPUT setting, e. g.,

	INPUT                  = simple.tpl
  1. Ensure the tpl2dox script is visible to doxygen.

  2. Block comments are not supported for variables. Use ///< to open an in line Doxygen comment to document variables in the DATA_SECTION and PARAMETER_SECTION.

  3. Doxygen comment blocks, such as those to document FUNCTIONs, should be opend with /** and closed with */. The other comment block delimiters are not supported.

  4. Comment blocks shoud start in column 3 in accordance with standard ADMB coding practice.

Caveats

  1. tpl2dox does not work correctly in all cases. Occasionally functions appear in places where variables should appear. The comment blocks for certaion FUNCTIONs do not appear.

  2. Run tpl2cpp to make sure your comments blocks have not buggered up the .tpl file format.

Examples

Here are a few examples drawn from the standard suite of ADMB examples. Some work well; some don't.

  1. Simple

  2. Catage

  3. Forest

  4. Pella-t

About

Scripts to generate Doxygen pages from ADMB tpl files

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published