While browsing the results of the integration of patch #53 (?), I said this on the patch list about lib* man pages:
On Wed, Jul 17, 2013 at 8:56 AM, Tom Browder <[email protected]> wrote: ... > ./doc/docbook/system/man3/en/librt.xml > >I have the first three files cleaned up I think rather nicely, but the >last, for librt, is a mess. Apparently when it was originated librt >had only a few variables and functions, but now the header is over >8,000 lines! Maintaining it manually (if it could be made current) >would be a nightmare. > >I know there are plans for a new doc system but I think we should look > at one of several options for the lib* man pages (xml source) now. > >1. Delete the current lib* docs. >2. If we want lib* docs, create a semi-auto-generated set consisting >of several parts. Possibly something like: ... >+ an auto-generated list of the headers associated with each lib (and >maybe links to the man page for each header--which could be generated >by Doxygen) Well, I just found that we have a dox/doygen target and gave it a try and it looks good for a start. Is anyone working on it? Maybe a limited Doxy output could generate the man pages for the libs? Best, -Tom ------------------------------------------------------------------------------ See everything from the browser to the database with AppDynamics Get end-to-end visibility with application monitoring from AppDynamics Isolate bottlenecks and diagnose root cause in seconds. Start your free trial of AppDynamics Pro today! http://pubads.g.doubleclick.net/gampad/clk?id=48808831&iu=/4140/ostg.clktrk _______________________________________________ BRL-CAD Developer mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/brlcad-devel
