> Hi Steven, > > There are some conversion tools, and there was a Release Engineer (prior > to last RIF) who was helping automate the conversion of the man pages > from their source format (SGML) into nroff. I do not know if there are > any issues with making any of these more generally available, but I will > find out. > > There's quite a bit of discussion about how to handle the man pages > going forward and there's already a fair amount of organic growth in > efforts to put man pages with their respective packages, so good timing > on your question. Out of curiosity, what do you think is the preferred > source form for the man pages?
I may not be the best person to ask :) Driver man pages tend to be pretty terse, so writing them in nroff is not that big of a hassle, just an ugly one. I imagine someone whose job is to write non-trivial documentation will probably have a different opinion! Currently we leverage Makefiles present in uts for both compilation and packaging; I was hoping there may be something similar that could be used for document generation. Thanks, Steve
