[issue46884] [doc] msilib.rst uses data directive to document modules

[Irit Katriel]

Irit Katriel  added the comment:

msilib is deprecated as per PEP 594, so there won't be further enhancements to 
it.

--
nosy: +iritkatriel
resolution:  -> wont fix
stage: patch review -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46884] [doc] msilib.rst uses data directive to document modules

[Martin Fischer]

Martin Fischer  added the comment:

([2] was meant to be an online link: 
https://docs.python.org/3.9/py-modindex.html#cap-m)

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46884] [doc] msilib.rst uses data directive to document modules

[Martin Fischer]

Change by Martin Fischer :


--
keywords: +patch
pull_requests: +29744
stage:  -> patch review
pull_request: https://github.com/python/cpython/pull/31620

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46884] [doc] msilib.rst uses data directive to document modules

[Martin Fischer]

New submission from Martin Fischer :

As per [1] the py:data directive describes data in a module.
It should not be used for submodules, that's what the module directive is for. 
A side-effect that this is causing is that msilib.schema, msilib.sequence 
and msilib.text do not show up in the Python Module Index[2] as they should.

[1]: https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html
[2]: 
file:///home/martin/repos-contrib/cpython/Doc/build/html/py-modindex.html#cap-m

--
assignee: docs@python
components: Documentation
messages: 414209
nosy: docs@python, push-f
priority: normal
severity: normal
status: open
title: [doc] msilib.rst uses data directive to document modules
type: enhancement
versions: Python 3.10, Python 3.11, Python 3.7, Python 3.8, Python 3.9

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com