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 [email protected] http://mailman.openchange.org/listinfo/devel
