Hello all,

I'm giving a try to Sphinx to autodoc some of my Python projects
because I've found this tool really amazing. But I'm having some
problems to generate auto-documentation, so I would to ask some
questions.

1. - Is there any way to create auto-documentation of a project
without generating the rst files and setting the auto-doc strings
(automodule, autoclass...) for each module and class manually? I've
been looking for it but in all examples I've found it is necessary to
specify which modules you want to autodoc (generating a rst file for
each) and, for each module, you must specify which classes you want to
add (I thought it would be made automatic, but it isn't). For large
projects it is really a pain and it would be necessary an algorithm to
generate the rst file for each module and its classes.

2. - Another thing. In some of my Python modules I import classes and
libraries that are not contained in the project and, when I try to
build the documentation, I receive some warnings about it (module xxxx
not found). The problem is that the html page of the module that
contains a reference of a not-found class/library, is generated in
blank. Is there any way to don't listen to the warnings and only
generate the help itself? I can't add those necessary modules to the
base path because they are not on my PC.

Thanks for your help.

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-dev@googlegroups.com
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to