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
