#325 "shadowed by a variable with the same name" warnings

[Vince Boros]

Our software build produces many warnings of the kind:

"'Warning: Module esys.lsm.vis.core.Camera is shadowed by a variable with the same name."

These warnings result in duplicated entries in the API documentation:

esys.lsm.vis.core.Camera
esys.lsm.vis.core.Camera': Defines the Camera base class

The second entry, in which "Camera" is followed by a single quote, contains the link.

Is this an Epydoc bug? I have found similar duplicated and semi-single-quoted entries at http://epydoc.sourceforge.net/stdlib/:

bsddb.db'
curses.wrapper
curses.wrapper': curses.wrapper

The commands in our Python/Makefile.am used to generate the documentation are:

if test -f "$(LSMDIR)/__init__.py"; then cd $(PYTHONAPIDOCDIR) && \
$(EPYDOC_EXE) --html --no-sourcecode --top "esys.lsm.LsmPy" --css accessBlue.css --name "$(PACKAGE_NAME) $(VERSION)" --url "$(PACKAGE_HOMEPAGE)" `${FIND} $(ESYSDIR) -name *.py` `${FIND} $(ESYSDIR) -name [^lib]*Py$(PYTHON_DLL_EXT)`; fi

[Vince Boros]

Python Makefile.am