[issue32774] distutils: cyclic reference in the documentation

[Stéphane Wirtel]

Stéphane Wirtel  added the comment:

ok, it's fine for me, I close this issue

--
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

[issue32774] distutils: cyclic reference in the documentation

[R. David Murray]

R. David Murray  added the comment:

This is a common pattern in our documentation.  It is done because ":mod:`xxx`" 
means that xxx should be formatted as a module name, rather than anything else. 
 While it is true that the formatting for most such references is currently the 
same, it could be different in principle, and is for a few.  It is in some ways 
unfortunate that it also always results in a link, so you will indeed find a 
number of places where the prefix is omitted, mostly commonly when the same 
entity is referenced several times in the same paragraph.

So, it is not completely clear cut, but I would recommend rejecting this and 
leaving the docs as is.

--
nosy: +r.david.murray

___
Python tracker 

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

[issue32774] distutils: cyclic reference in the documentation

[Stéphane Wirtel]

New submission from Stéphane Wirtel :

in the documentation of the distutils module, there is a cyclic references, 
just remove them because I think it's useless.

--

___
Python tracker 

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

[issue32774] distutils: cyclic reference in the documentation

[Stéphane Wirtel]

Change by Stéphane Wirtel :


--
keywords: +patch
pull_requests: +5377
stage:  -> patch review

___
Python tracker 

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

[issue32774] distutils: cyclic reference in the documentation

[Stéphane Wirtel]

Change by Stéphane Wirtel :


--
assignee: docs@python
components: Documentation
nosy: docs@python, matrixise
priority: normal
severity: normal
status: open
title: distutils: cyclic reference in the documentation
versions: Python 2.7, Python 3.6, Python 3.7, Python 3.8

___
Python tracker 

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