Groups > linux.debian.maint.python > #8829

Re: how to build sphinx doc when there is extension

Path	csiph.com!news.mixmin.net!aioe.org!bofh.it!news.nic.it!robomod
From	Ben Finney <ben+debian@benfinney.id.au>
Newsgroups	linux.debian.maint.python
Subject	Re: how to build sphinx doc when there is extension
Date	Tue, 30 Aug 2016 23:10:02 +0200
Message-ID	<sbYsa-1JI-21@gated-at.bofh.it> (permalink)
References	<sbLOi-1No-21@gated-at.bofh.it> <sbMqZ-2gM-1@gated-at.bofh.it> <sbMKl-2qE-9@gated-at.bofh.it>
X-Original-To	debian-python@lists.debian.org
X-Mailbox-Line	From debian-python-request@lists.debian.org Tue Aug 30 21:02:05 2016
Old-Return-Path	<debian-python@m.gmane.org>
X-Amavis-Spam-Status	No, score=-6.206 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, HEADER_FROM_DIFFERENT_DOMAINS=0.001, LDO_WHITELIST=-5, RDNS_NONE=0.793] autolearn=no autolearn_force=no
X-Policyd-Weight	using cached result; rate: -6.1
X-Injected-Via-Gmane	http://gmane.org/
Lines	33
MIME-Version	1.0
Content-Type	text/plain; charset=utf-8
Content-Transfer-Encoding	8bit
User-Agent	Gnus/5.13 (Gnus v5.13) Emacs/24.4 (gnu/linux)
X-Public-Key-ID	0xAC128405
X-Public-Key-Fingerprint	517C F14B B2F3 98B0 CB35 4855 B8B2 4C06 AC12 8405
X-Public-Key-URL	http://www.benfinney.id.au/contact/bfinney-pubkey.asc
X-Post-From	Ben Finney <bignose+hates-spam@benfinney.id.au>
Cancel-Lock	sha1:zBIvjK2V7OLgTuXKqItE7mb3zhY=
X-Mailing-List	<debian-python@lists.debian.org> archive/latest/14170
List-ID	<debian-python.lists.debian.org>
List-URL	<https://lists.debian.org/debian-python/>
List-Archive	https://lists.debian.org/msgid-search/85eg56ug28.fsf@benfinney.id.au
Approved	robomod@news.nic.it
Organization	linux.* mail to news gateway
Sender	robomod@news.nic.it
X-Original-Date	Wed, 31 Aug 2016 07:01:35 +1000
X-Original-Message-ID	<85eg56ug28.fsf@benfinney.id.au>
X-Original-References	<A2A20EC3B8560D408356CAC2FC148E53BB2C8491@SUN-DAG3.synchrotron-soleil.fr> <20160830081441.7qi5at5jps52qga7@sar0.p1otr.com> <A2A20EC3B8560D408356CAC2FC148E53BB2C855D@SUN-DAG3.synchrotron-soleil.fr>
X-Original-X-Complaints-To	usenet@blaine.gmane.org
Xref	csiph.com linux.debian.maint.python:8829

Show key headers only | View raw

PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr>
writes:

> > how about doing it outside pybuild? Do you really need to build it for
> > each interpreter / version?
>
>
> It is a sort of unit test during the build that auto-doc works for all
> versions of the interpreter.

You're only installing one version of the documentation, though.
Correct?

If so, this package is not a good place to do the test you describe.

> th eunit test is
> try to import all the modules provided by a packages.

That isn't a good fit for “build the documentation”. It also does not
explain why you try to do it with every interpreter.

> Is there something whcih can be automatise at the autodep8 level for
> python ?

You can start with the tests I have in ‘python-coverage’
<URL:https://sources.debian.net/src/python-coverage/4.2%2Bdfsg.1-1/debian/tests/>
which allows you to specify the module names to test.

-- 
 \         “Education is learning what you didn't even know you didn't |
  `\                  know.” —Daniel J. Boorstin, historian, 1914–2004 |
_o__)                                                                  |
Ben Finney

Thread

how to build sphinx doc when there is extension PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2016-08-30 09:40 +0200
  Re: how to build sphinx doc when there is extension Piotr Ożarowski <piotr@debian.org> - 2016-08-30 10:20 +0200
    RE:how to build sphinx doc when there is extension PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2016-08-30 10:40 +0200
      Re: how to build sphinx doc when there is extension Ben Finney <ben+debian@benfinney.id.au> - 2016-08-30 23:10 +0200
  Re: how to build sphinx doc when there is extension Dmitry Shachnev <mitya57@debian.org> - 2016-08-31 20:10 +0200
    RE:how to build sphinx doc when there is extension PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr> - 2016-08-31 21:00 +0200

csiph-web