Python demo docs
================

Python docs for demos are generated using jupytext from the python
demo scripts.  Debian has not yet packaged jupytext (see Bug) so the
source doc files (.md) have been generated manually by locally
installing jupytext and running
  PYTHONPATH=${SRCDIR}/debian/tmp-real/usr/lib/python3/dist-packages \
    PKG_CONFIG_PATH=`pwd`/build/pkgconfig:${PKG_CONFIG_PATH} \
    LD_LIBRARY_PATH=${SRCDIR}/debian/tmp-real/usr/lib/x86_64-linux-gnu/:${LD_LIBRARY_PATH} \
    RDMAV_FORK_SAFE=1 \
  python3 jupytext_process.py
is the python/doc/source subdir. i.e. using the same environment variables that
are used when building the docs with `make html`

The resulting demos subdir, containing *.md doc files, has then been
copied to debian/doc.  A symlink is created with building docs to
access these demo source files.
