Add comments
- Last Updated: January 17, 2024
- 1 minute read
- OpenEdge
- Version 12.8
- Documentation
You can add comments to your source files so that the comments are published to the ABLDoc
document. While adding comments, you can use HTML tags as follows to structure the
comments in the generated
output:
/*------------------------------------------------------------------------
File : <h1><i>GenericDataExporter</i></h1>
Purpose :
Syntax :
Description :
Author(s) : abc
Created : <pre>Tue Nov 19 21:16:10 CET</pre>
Notes :
----------------------------------------------------------------------*/
Note: The comments that you add must be in the format that Developer Studio
generates. To generate ABLDoc for any other format, use the ABL custom parser. For
more information, see Customize tag parser.
The comment can have a tag section. You can also add tags to comments to add metadata. These tags are applicable only to methods, functions, and internal procedures. Place the tags after the main description. You can add the following tags:
@param: Adds a parameter with a specified name and description.@return: Adds a return section to the document with the description that you provide.