3 ms·
> I love man pages they are often easy to read, but roff is not that easy to author To be fair, writing the programs or functions that the manual page is purpo
by clort 9y ago
> I love man pages they are often easy to read, but roff is not that easy to author
To be fair, writing the programs or functions that the manual page is purporting to document isn't easy either. I have written manpages (and plenty of code) and in my experience, the hardest part is not the markup but getting the actual content right.
- emj 9y agoThere are badly written documentation out there, and they will not be better just because they are formated as a man page instead of Microsoft Word, but the worst kind are the ones which are never written and that syntax is quite a blocker. Your comment highlights my bias for man pages, I forgive a lot more when it's read in prefered format rather than .docs.