Brad Hards a écrit : > G'day team, > > Right now, we generate our API documentation in HTML and man page formats. > > However I've discovered a problem - when we generate the man pages, we get > one > page in man3 for each function. One of those is "login", which will cause a > conflict with existing man page for the login() function that most unix > variants provide. > > We could potentially rename that particular man page, but I wonder if it is > worth providing at all. Does anyone use man pages as an API reference? I know > that I always use the HTML, which seems more useful with the > cross-referencing. > > Note that this is only for the automatically generated man3 docs. I'm not > suggesting removing anything in man1. > > Thoughts? > > Brad > _______________________________________________ > devel mailing list > devel@openchange.org > http://mailman.openchange.org/listinfo/devel >
I agree with that since API documentation is usually in html format. -- Ali Mdidech OpenChange Project http://www.openchange.org/ _______________________________________________ devel mailing list devel@openchange.org http://mailman.openchange.org/listinfo/devel
