On Mon, Jul 04, 2005 at 05:58:55PM -0300, Bruno Negrão wrote: > >Sure I do. First of all update manpages are not some html wiki version > >but > >real mdoc formated pages. I told you that at least once. > >Generating html pages from manpages is no problem, the other way around > >is > >non trivial. > >Having the man pages online is in so far good as it can be done for free > >just use "groff -Thtml" and updates can be automated. Btw. these man > >pages > >would not be part of the wiki. > >Hmm. Your man pages are html formatted and in a wiki, IMO that is not a > >manpage but a homepage simulating a man page. > Claudio, tell me which of the following processes is the easiest: > > Option1: The process of converting existing manpages from wiki to mdoc. > Option2: The process of creating the manpages for Qmail-ldap. >
Option 2 is easier. > If you answered "Option2" - you're wrong. Thanks but that's your opinion and we slowly realize that you are somewhat biased and pigheaded. > Option1 is the easiest. After the > manpages exist in whatever format, it's relatively easy to convert them to > other format. But writing manpages that don't exist, this is really > difficult. I don't believe just one guy in this world would have > **knowledge and time** available to do all the qmail-ldap manpages alone, > in mdoc format, to gently send all them to you to incorporate in qmail-ldap > package. Some guys can have the knowledge, but don't have the time. While > the opposite is also true. > Writing man pages is not rocket science, I did it for other projects and I know a few guys that know mdoc better than html. There is no need to first write them in html especially because the conversion from mdoc to html is for free whereas the oposite is just as hard as starting from scratch. -- :wq Claudio
