Ok - I can look at updating builddist script to build PETSc and PETSc4py [with python2 - and prerequistes installed] before attempting to build python docs [and petsc4py tarball] Satish On Mon, 15 Mar 2021, Barry Smith wrote:

Satish,

I think some of the python documentation tools used, epydoc, require that the python package it is documenting exists and is run-able since it probably uses the self-documenting features of Python. This makes perfect sense for Python. A python package cannot provide help messages unless you can import it.

Barry

Maybe it could be rigged that petsc4py would allow itself to be imported and produce help messages without loading the PETSc libraries, this would require digging around a bit in how petsc4py loads the PETSc dynamic library.

...

On Mar 15, 2021, at 10:42 AM, Satish Balay via petsc-dev <[email protected]> wrote:

On Mon, 15 Mar 2021, Satish Balay wrote:

...

...

and run "make sdist".

Ah - ok. Will check this to see if I can generate the tarball in sync with petsc tarball. What source files need updating for release/version info?

Is it required to build PETSc library - to build petsc4py tarball?

Satish

-----

balay@sb /home/balay/tmp/petsc/src/binding/petsc4py (main=) $ make sdist python setup.py build_src running build_src cythonizing 'petsc4py.PETSc.pyx' -> 'petsc4py.PETSc.c' cythonizing 'libpetsc4py/libpetsc4py.pyx' -> 'libpetsc4py/libpetsc4py.c' /usr/bin/rst2html --input-encoding=utf-8 --no-compact-lists --cloak-email-addresses ./LICENSE.rst > docs/LICENSE.html /usr/bin/rst2html --input-encoding=utf-8 --no-compact-lists --cloak-email-addresses ./CHANGES.rst > docs/CHANGES.html /usr/bin/rst2html --input-encoding=utf-8 --no-compact-lists --cloak-email-addresses docs/index.rst > docs/index.html mkdir -p build/doctrees docs/usrman sphinx-build -b html -d build/doctrees \ docs/source docs/usrman Running Sphinx v3.2.1 building [mo]: targets for 0 po files that are out of date building [html]: targets for 6 source files that are out of date updating environment: [new config] 6 added, 0 changed, 0 removed reading sources... [100%] tutorial looking for now-outdated files... none found pickling environment... done checking consistency... /home/balay/tmp/petsc/src/binding/petsc4py/docs/source/manual.rst: WARNING: document isn't included in any toctree done preparing documents... done writing output... [100%] tutorial generating indices... genindexdone writing additional pages... searchdone copying static files... ... done copying extra files... done dumping search index in English (code: en)... done dumping object inventory... done build succeeded, 1 warning.

The HTML pages are in docs/usrman. rm -f docs/usrman/.buildinfo mkdir -p docs/apiref env CFLAGS=-O0 python2 setup.py -q build --build-lib build/lib.py2 /usr/bin/ld: cannot find -lpetsc collect2: error: ld returned 1 exit status error: command 'gcc' failed with exit status 1 make: *** [makefile:110: epydoc-html] Error 1