💾 Archived View for republic.circumlunar.space › users › flexibeast › gemlog › 2022-04-19.gmi captured on 2023-04-19 at 22:57:39. Gemini links have been rewritten to link to archived content

View Raw

More Information

⬅️ Previous capture (2023-01-29)

➡️ Next capture (2023-05-24)

-=-=-=-=-=-=-

Authoring man pages with mdoc(7)

Further to my post “Why i like mdoc(7) for man pages”[a], i've now written a quickstart guide to encourage people to use mdoc(7)[b] when authoring man pages.

“Writing man pages with mdoc(7): a quickstart guide”

The guide gives some historical background, explains why the mdoc(7) language should be preferred over the man(7) language (and why Markdown is a bad language for man page authoring), briefly covers the existence of both groff and mandoc, then systematically works through a small example that (hopefully!) shows how easy it us to use mdoc(7). Finally, it finishes off with information about where to find more detailed documentation.

--

🏷 dev,documentation,ict

Glossary

Gemlog Home

--

[a] “Why i like mdoc(7) for man pages”

Man page: mdoc(7)