<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, 15 Mar 2021 at 18:26, Satish Balay <<a href="mailto:balay@mcs.anl.gov">balay@mcs.anl.gov</a>> wrote:</div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
But epydoc can be installed with python3. </blockquote><div><br></div><div>Maybe. Have you tried to actually run it after installation? :-)</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">So this is more of petsc4py code that uses epydoc - than epydoc code?<br>
<br></blockquote><div><br></div><div>I did not understand your question. Epidoc is just an external tool required to build a piece of the documentation. It only runs on Python 2. And to build documentation, it uses introspection, so whatever you want to document has to be installed alongside with epydoc such that epidoc is able to "import petsc4py.PETSc" and proceed to generate the API reference by traversing classes, methods, functions, etc.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
> I have not found a nice replacement for epydoc-generated documentation.<br>
> If Python 2 is an annoyance, then just remove, comment-out anything related<br>
> to epydoc in "makefile"<br>
<br>
Well I can work around it. [by installing both python2 and python3 versions of epydoc via pip]<br></blockquote><div><br></div><div>Don't bother about installing Epydoc in Python 3, it does not work. You only need it in Python 2, also install petsc4py, run "make install py=2" (petsc4py will go to ~/.local)</div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
However its not clear to me where the python2 requirement is coming<br>
from - and if things can be unified using python3<br></blockquote><div><br></div><div>I hope it is clear now. A piece of the documentation requires epydoc, which in turns only works on Python 2.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><br></blockquote><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
> and run "make sdist".<br>
<br>
Ah - ok. Will check this to see if I can generate the tarball in sync<br>
with petsc tarball. What source files need updating for<br>
release/version info?<br>
<br></blockquote><div><br></div><div>CHANGES.rst (add entry for new release)</div><div>src/__init__.py (update __version__ to "3.15.0" )<br></div><div><br></div><div><br></div><div>$ git grep "PETSc Users Manual"<br>DESCRIPTION.rst:  *PETSc Users Manual*, ANL-95/11 - Revision 3.14, 2020.<br>docs/index.rst:  *PETSc Users Manual*, ANL-95/11 - Revision 3.14, 2020.<br>docs/source/citing.rst:  *PETSc Users Manual*, ANL-95/11 - Revision 3.14, 2020.<br>docs/source/overview.rst:   *PETSc Users Manual*, ANL-95/11 - Revision 3.14, 2020.<br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
> But this way the tarball will miss the API reference.<br>
<br>
> PS: All this could be converted to a script that installs petsc4py and<br>
> epydoc in a Python 2 virtual environment, and next users another venv for<br>
> the Python 3 Sphinx stuff.<br>
<br>
One issue: Fedora-33 does not have 'python2-pip' anymore. I was able<br>
to manually install it.  However this might become an issue for others<br>
who want to build docs [even if we automate the docs build to<br>
install/use pyton2-venv]<br>
<br></blockquote><div><br></div><div>Yes, Satish I know. The long term solution is to get rid of Epydoc and replace it for something else, most likely Sphinx-based.</div><div>If generating this epydoc stuff is too much of an annoyance for you, just kill it for good and let's forget about it.</div><div><br></div><div><br></div></div>-- <br><div dir="ltr" class="gmail_signature"><div dir="ltr"><div>Lisandro Dalcin<br>============<br>Senior Research Scientist<br>Extreme Computing Research Center (ECRC)<br>King Abdullah University of Science and Technology (KAUST)<br><a href="http://ecrc.kaust.edu.sa/" target="_blank">http://ecrc.kaust.edu.sa/</a><br></div></div></div></div>