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 >
