[docs] [issue34895] Mark optional stdlib modules in documentation

Marcus report at bugs.python.org
Thu Oct 4 12:33:38 EDT 2018


New submission from Marcus <of4tvziy at online.de>:

Some stdlib modules have external build time dependencies and will be automatically disabled if the dependencies can't be met (cf. detect_modules() in setup.py).
>From a user's perspective there is no reason to assume that the presence of a stdlib module may not be relied upon. See also the discussion on python-ideas (https://mail.python.org/pipermail/python-ideas/2018-October/054008.html).
A rather simple to implement debugging aid would be to add a note to the affected modules' documentation, stating that these modules may not be available on all systems.

----------
assignee: docs at python
components: Documentation
messages: 327065
nosy: docs at python, of4tvziy
priority: normal
severity: normal
status: open
title: Mark optional stdlib modules in documentation
type: enhancement
versions: Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue34895>
_______________________________________


More information about the docs mailing list