Monday, March 14, 2011

illumos gets documentation!

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!

2 comments:

zdw said...

Would there be any benefit to jumping to mandoc from the current renderer?

http://mdocml.bsd.lv/

Garrett D'Amore said...

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.