[sphinx-users] sphinx-apidoc and the `__init__.py` files

[Luc Saffre]

Hi all,

first of all, thanks for the `sphinx-apidoc` script, which is really 
very useful when developing and documenting large projects.

I noticed a subtle problem: it generates the wrong automodule directive 
for the `__init__.py` file of a package. I solved it for myself by 
adding a ``.replace('.__init__','')`` to line 73 of file `apidoc.py`:

before:

directive = '.. automodule:: %s\n' % makename(package, module)

after:

directive = '.. automodule:: %s\n' % \
  makename(package, module).replace('.__init__','')

I also wrote a blog entry about this problem:
http://lino-framework.org/blog/2013/0329.html#sphinx-apidoc-and-the-init-py-files

Luc

--
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at http://groups.google.com/group/sphinx-users?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.