Table of Contents
Description
I want to create a documentation for all my projects.
Some functionality can be automated. So I started a bash script to parse a given bash script and read all its functions and their doc blocks.
The output is in markdown format to create a documentation for a single file below the docs folder.
Example
If I use a doc block for each function lik this:
# Find all functions with long and short and create a uniq list
# it returns lines [LINE]:[FUNCTION_NAME]. It is called by
#
# see getbashdoc()
#
# global string PARSED_SCRIPT nane of the bash script to parse
#
# param string scriptname to parse
# return string
getFunctions(){
...
}
Then it renders a markdown file … that is rendered in a webpage like this: