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_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
output_dir target directory.