The FreeBSD documentation environment is lacking instructions on how to
create man page manuals. I have written a How To document titled;
Creating a manpage from scratch. Its too big for the FAQ list,
but fits nicely into the article size.
You can read it online at
I am donating it to the FreeBSD document team with the hopes you will take
the text file I have attached and convert it to SGML and add it as an article.
Fix: Patch attached with submission follows:
I'll work on converting this to SGML.
Just to submit a status report...
I'm still working on this. I had to take a break because of the
workload elsewhere, but I'll continue working on it during the summer.
I'm still working on this.
This article should mention /usr/share/examples/mdoc/
Change is hard.
Has there been any progress to date?
I submitted this PR.
Had to change email address because of to much spam.
For bugs matching the following criteria:
Status: In Progress Changed: (is less than) 2014-06-01
Reset to default assignee and clear in-progress tags.
Mail being skipped
We have a chapter about how to write man pages on the FDP primer for a good while now:
It contains pretty much everything that is in the submitted file.txt, so I think closing this PR is reasonable. If you find that there is something missing, please open a new PR.