Path: csiph.com!aioe.org!bofh.it!news.nic.it!robomod
From: PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr>
Newsgroups: linux.debian.maint.python
Subject: RE:building manpages via setup.py
Date: Wed, 02 Aug 2017 12:10:01 +0200
Message-ID: <u9YLf-8vK-1@gated-at.bofh.it>
References: <u9GEH-5cQ-19@gated-at.bofh.it> <u9Hr4-5Jr-23@gated-at.bofh.it> <u9W6J-6Ni-3@gated-at.bofh.it> <u9Wgq-6Qo-9@gated-at.bofh.it> <u9WzL-6Xn-9@gated-at.bofh.it> <u9WzL-6Xn-7@gated-at.bofh.it> <u9WzM-6Xn-25@gated-at.bofh.it> <u9X2O-7mD-23@gated-at.bofh.it> <u9X2O-7mD-21@gated-at.bofh.it> <u9Xmb-7tc-27@gated-at.bofh.it> <u9Xmb-7tc-37@gated-at.bofh.it> <u9YLf-8vK-3@gated-at.bofh.it> <u9Y8x-83f-13@gated-at.bofh.it>
Old-Return-Path: <frederic-emmanuel.picca@synchrotron-soleil.fr>
Thread-Topic: building manpages via setup.py
Thread-Index: AdMKnYeNbtHGA2ChRMa/5+FgMHXlSAALU42AACRWRyD//+WzAIAAIkd1///kXwCAAAEXAIAAJXaV///iEoCAACJ29f//4toAAAS5p7UAAwPEAAABSiC/
Accept-Language: fr-FR, en-US
Content-Language: fr-FR
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
Approved: robomod@news.nic.it
Lines: 52
Organization: linux.* mail to news gateway
Sender: robomod@news.nic.it
Xref: csiph.com linux.debian.maint.python:9676

> First, that's very speculative. Second, that's upstream's problem.

> The upstream Makefile and conf.py are likely generated by Sphinx itself
> via sphinx-quickstart. Did your upstream tinker with them that much that
> they cannot be trusted?

No this is just that does not fit well with extension.

> Some upstream do use a build_sphinx command, but it is far from common
> and it does not solve the extension module problem.

Yes this is what they are doing. extension are part of the python ec-system=
 but it seems thaht this is not well suported out of the box by sphinx.

# If extensions (or modules to document with autodoc) are in another direct=
ory,
# add these directories to sys.path here. If the directory is relative to t=
he
# documentation root, use os.path.abspath to make it absolute, like shown h=
ere.
#
# import os
# import sys
# sys.path.insert(0, os.path.abspath('.'))

You need to customize the sys.path in order to find the extensions.

This path can change depending on the setup.py build options so this is not=
 reliable.

> Why? All you need is *one* occurrence of the extension modules somewhere
> in the PYTHONPATH in order to generate the docs. Chances are that's how
> upstream generates them.

Because by experience I find issue in the build system and the python code =
when building the doc for multiple
interpreter (python2/python3 differences...)

> > Found a total of 643 reverse build-depend(s) for python-all-dev.
> >
> > not that small

> How is the ratio over all the Python packages? I suspect very small.

Found a total of 1968 reverse build-depend(s) for python-all.

not that small 32 % ;)


Cheers

Fred