Perhaps... a very *quick* look at mdoc looks ... promising.
I'm not sure that we really need to replace our current man package though. We'd have to weight the benefits against any cost of effort.
March 15, 2011 at 3:16 PM
With this integration:
changeset: 13304:b54231762cfa tag: tip user: Richard Lowe date: Mon Mar 14 14:05:30 2011 -0400
description: 243 system manual pages should live with the software Reviewed by: garrett@nexenta.com Reviewed by: gwr@nexenta.com Reviewed by: trisk@opensolaris.org Approved by: gwr@nexenta.com
We now have manual pages in illumos. (Only the English pages -- POSIX locale -- are kept in the illumos code repository.)
This is key because it means that code and documentation can be maintained together, which is how some other projects (but not Solaris) manage it.
So, got a problem with the man(1) pages on illumos? File a bug! There is a category called "manpage"... please let us know, or even better, contribute a fix!
posted by Garrett D'Amore at 1:57 PM on Mar 14, 2011
"illumos gets documentation!"
2 Comments -
Would there be any benefit to jumping to mandoc from the current renderer?
http://mdocml.bsd.lv/
March 15, 2011 at 2:56 PM
Perhaps... a very *quick* look at mdoc looks ... promising.
I'm not sure that we really need to replace our current man package though. We'd have to weight the benefits against any cost of effort.
March 15, 2011 at 3:16 PM