El Lun 04 Jul 2005 17:39, escribió: > > I'm lost in what is the point here, what-way-to-do-it vs what? > > Claudio thinks doing manpages in wiki format is silly. I'm showing him that > what is silly is to convert them to mdoc after they already exist. >
I think man pages should be written originally not in wiki format, but in some format made for unix documentation. > Also we are debating is how to do manpages for the ~control/files. In stock > > > Claudio thinks is better to create one manpage for each control file. By > grouping the way I'm suggesting the reader will understand what is the main > purpose of those files, for example, in qmail-control-ldap-access(5) are IMHO doing a man page for every ~control file is better, it'll be more easy to find. If you want to teach people about the architecture, I'd extend "The big qmail picture" and turn it into a more in depth qmail-ldap architecture doc. We should think in making life easier for new people and sysadmins. Most people will not look for man pages in wiki, but in shell. Omar -- Omar Armas MPSNet Tel:5604-4655 ext. 110 Movil: 04455-1867-8953
