[issue12301] Use :role:`sys.thing` instead of ``sys.thing`` throughout

Changes by Éric Araujo : -- resolution: -> rejected stage: patch review -> resolved status: pending -> closed ___ Python tracker ___

[issue12301] Use :role:`sys.thing` instead of ``sys.thing`` throughout

Éric Araujo added the comment: Inclined to reject this, given the general dislike of huge low-value patches. -- keywords: -easy status: open -> pending versions: -Python 2.7, Python 3.2, Python 3.3, Python 3.4 ___ Python tracker

[issue12301] Use :role:`sys.thing` instead of ``sys.thing`` throughout

Changes by Ezio Melotti ezio.melo...@gmail.com: -- type: - enhancement versions: +Python 3.4 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue12301 ___

[issue12301] Use :role:`sys.thing` instead of ``sys.thing`` throughout

Éric Araujo mer...@netwok.org added the comment: Alright, I’ll propose piecemeal patches. Georg, two questions: 1) In the tutorial, should classes with no target use ``MyClass`` or :class:`!MyClass`? 2) Should file extensions use ``.py`` or :file:`.py`? We currently have both. --

[issue12301] Use :role:`sys.thing` instead of ``sys.thing`` throughout

Georg Brandl ge...@python.org added the comment: Basically, :class:`!Foo` has no advantage over ``Foo``. The no-linking syntax is really only there for completeness, but I would prefer the plainer and easier to read (in source) ``Foo``. For files, :file: really only has an advantage if you do

[issue12301] Use :role:`sys.thing` instead of ``sys.thing`` throughout

Éric Araujo mer...@netwok.org added the comment: Thanks Bryce, I will start from your patch. (BTW, you used func instead of data for sys.stdout.) -- stage: needs patch - patch review title: Use :data:`sys.thing` instead of ``sys.thing`` throughout - Use :role:`sys.thing` instead of

[issue12301] Use :role:`sys.thing` instead of ``sys.thing`` throughout

Raymond Hettinger raymond.hettin...@gmail.com added the comment: It would be best to think about each of the new links individually rather than making blanket changes. The new links need to have relevance and add value to the topic; otherwise, they are just distractions from the more

[issue12301] Use :role:`sys.thing` instead of ``sys.thing`` throughout

Georg Brandl ge...@python.org added the comment: I agree. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue12301 ___ ___ Python-bugs-list mailing