[Matplotlib-users] missing module docs
I noticed that there are many modules in the current code base that are not listed at: http://matplotlib.sourceforge.net/modindex.html. I understand that a few are new files and that the documentation for these will be generated during the next release. But I know that most of these were in the last release so should have had their documentation generated. Am I missing something? Can the documentation for these modules be found somewhere else? bezier blocking_input contour docstring finance hatch image mlab mpl offsetbox patheffects pylab pyparsing quiver rcsetup table texmanager textpath tight_bbox units widgets windowing Thanks, -Ben Ben Axelrod Robotics Engineer (800) 641-2676 x737 [cid:281553619@22022010-0FB8] www.coroware.comhttp://www.coroware.com/ www.corobot.nethttp://www.corobot.net/ inline: image002.gif-- Download Intel#174; Parallel Studio Eval Try the new software tools for yourself. Speed compiling, find bugs proactively, and fine-tune applications for parallel performance. See why Intel Parallel Studio got high marks during beta. http://p.sf.net/sfu/intel-sw-dev___ Matplotlib-users mailing list Matplotlib-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/matplotlib-users
Re: [Matplotlib-users] missing module docs
On Mon, Feb 22, 2010 at 1:44 PM, Ben Axelrod baxel...@coroware.com wrote: I noticed that there are many modules in the current code base that are not listed at: http://matplotlib.sourceforge.net/modindex.html. I understand that a few are new files and that the documentation for these will be generated during the next release. But I know that most of these were in the last release so should have had their documentation generated. Am I missing something? Can the documentation for these modules be found somewhere else? You're not missing anything in terms of the html/pdf docs. When we converted our documentation build system to sphinx/rest, we had to convert our docstrings to rest as well. We made good headway for a while but the progress has stalled. To add a module to the documentation system, you need to * make sure the docstrings are ReST compliant * add a stub in doc/api (eg see figure_api.rst * add your new rst file to doc/api/index.rst We'd like to see all of the user facing modules converted, so contributions are welcome. See also http://matplotlib.sourceforge.net/faq/howto_faq.html?highlight=contributing#contribute-to-matplotlib-documentation http://matplotlib.sourceforge.net/devel/documenting_mpl.html http://matplotlib.sourceforge.net/sampledoc/ In the meantime, you can always use pydoc or help from the interactive shell, eg:: pydoc matplotlib.patheffects pydoc also has flags for generating html, etc. or from the shell (ipython here):: In [3]: import matplotlib.patheffects In [4]: help matplotlib.patheffects -- help(matplotlib.patheffects) JDH -- Download Intel#174; Parallel Studio Eval Try the new software tools for yourself. Speed compiling, find bugs proactively, and fine-tune applications for parallel performance. See why Intel Parallel Studio got high marks during beta. http://p.sf.net/sfu/intel-sw-dev___ Matplotlib-users mailing list Matplotlib-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/matplotlib-users
Re: [Matplotlib-users] missing module docs
John Hunter wrote: On Mon, Feb 22, 2010 at 1:44 PM, Ben Axelrod baxel...@coroware.com mailto:baxel...@coroware.com wrote: I noticed that there are many modules in the current code base that are not listed at: http://matplotlib.sourceforge.net/modindex.html. I understand that a few are new files and that the documentation for these will be generated during the next release. But I know that most of these were in the last release so should have had their documentation generated. Am I missing something? Can the documentation for these modules be found somewhere else? You're not missing anything in terms of the html/pdf docs. When we converted our documentation build system to sphinx/rest, we had to convert our docstrings to rest as well. We made good headway for a while but the progress has stalled. To add a module to the documentation system, you need to Also, it's worth nothing that the docs from svn head are automatically compiled and uploaded from svn on each commit: HTML: http://matplotlib.sourceforge.net/trunk-docs/index.html PDF: http://matplotlib.sourceforge.net/trunk-docs/Matplotlib.pdf -Andrew -- Download Intel#174; Parallel Studio Eval Try the new software tools for yourself. Speed compiling, find bugs proactively, and fine-tune applications for parallel performance. See why Intel Parallel Studio got high marks during beta. http://p.sf.net/sfu/intel-sw-dev ___ Matplotlib-users mailing list Matplotlib-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/matplotlib-users