UPDATE: Last night, I found the utility and hacked up a few improvements to make it a bit friendlier. I only played with it for a few minutes so I’ll have to find more time in the very near future to get it to a point of general use. However, does this sound like something that could/would be used?
The following markdown writeup can be converted to mdoc (reminder mdoc can be converted to a number of different formats so that is why I pose the question). So, again, would it be a good idea to support simple documentation/writeups in this manner or would it be too constrained?
title: progname 7
author: John
# NAME
progname -- a program to change the world.
# SYNOPSIS
progname <inpputfile> <outputfile>
# DESCRIPTION
This utility will change the world because
it will remove all leading spaces from lines
in a text file.
# OPTIONS
-a
Append to the outout file.
-B
Use backward searching patterns (?...?).
-d
Parse `#defines` that don't take arguments.
-
# CODE EXAMPLE
<c
unsigned long str_version; /* version number */
unsigned long str_numstr; /* # of strings in the file */
unsigned long str_longlen; /* length of longest string */
>
# HISTORY
Created for personal use.