Follow this procedure to produce the source documentation.
Follow this procedure to produce the source documentation.
- Go to the top directory of your sources.
- Create a file named
overview.4gl, with a #+ comment
describing your project. - Go to the subdirectories and create files named
package-info.4gl with a
#+ comment describing the package. - Edit the .4gl modules to add
#+ comments to functions that must be
documented. - Go back to the top directory of your sources.
- Run
fglcomp --build-doc overview.4gl
Use the -W apidoc compiler option to get warnings for invalid comment tags.
For example, when a @param tag is missing for a function parameter.
- To test the result, load the generated
index.html file in your preferred
browser.