ProgenetixInfo::podmd.pl Perl Code Documentation

The “podmd.pl” script parses inline documentation from - now various - code files and writes it to a given output directory, in the format of Jekyll-compatible Markdown files, i.e. including a YAML header.

Processing the input files is based on parameters provided in the “podmd.yaml” configuration file. Please have a look for examples there.

For now, the functions of the script are optimised for use in the Progenetix documentation environment but may be adapted for other purposes.

For the scanned files, comment lines are read in if they are between one of the md_starts and md_stops markers, which can be defined as global parameters or package specific.

No file is created if there isn’t any content in the text buffer.

If documentation has been found, the YAML-prefixed markdown file is created in the output_dir target directory.

The YAML header contains directives and parameters for the processing of the page through the Jekyll website generation engine.

2019-07-04