3 ms·
You're absolutely right, and the syntax is even worse, but the real issue is that we have a standards problem. There's incredible value in having a standard for
by Spivak 11y ago
You're absolutely right, and the syntax is even worse, but the real issue is that we have a standards problem. There's incredible value in having a standard format for technical documentation which is small, concise, easily accessible to everyone, and most importantly has the same layout. If we abandon man pages then every project will ship a different incompatible documentation system which would make the Linux ecosystem overall worse off.
More and more documentation is being pushed to the web and/or the offline version is just a dump of the website. It's not bad but everyone has a different interpretation of what good documentation looks like and it requires a relatively modern web browser to view, users have to relearn how it's organized, and projects take the mentality that complete documentation isn't something that should be part of a release rather than the thing that's updated every now and then.
- eru 11y agoOh, I like man pages, and have written some for my own little projects. I wish we had more man pages for our internal tools at Google. Gnu's `info' was supposed to be the replacement. But I seldom look at their documentation.