[issue27036] Mark up of references in different form

Serhiy Storchaka added the comment: Pushed a part about "bytes-like objects". Here is a patch that adds explicit labels for referencing without changing the style. -- Added file: http://bugs.python.org/file42890/refs_forms3.patch ___ Python tracker

[issue27036] Mark up of references in different form

Roundup Robot added the comment: New changeset ef6d3a537cf5 by Serhiy Storchaka in branch '3.5': Issue #27036: Fixed formatting references to "bytes-like object" in plural. https://hg.python.org/cpython/rev/ef6d3a537cf5 New changeset d6b9a4c3f8ef by Serhiy Storchaka in branch 'default': Issue

[issue27036] Mark up of references in different form

Georg Brandl added the comment: Not really, no. You have to add a :ref: target label for the function. If it's only a few instances, that should be manageable. -- ___ Python tracker

[issue27036] Mark up of references in different form

Serhiy Storchaka added the comment: Georg, is it possible to refer to function without changing a style? Something like :ref:`evaluated `? -- ___ Python tracker

[issue27036] Mark up of references in different form

Serhiy Storchaka added the comment: I think you make an accent on wrong thing. All these sentences look correct to me if remove any hyperlinks. Hyperlinks are optional. In the phrase "Level values are evaluated" the reference is to the term "evaluating", not to the eval() function. But since

[issue27036] Mark up of references in different form

Martin Panter added the comment: It _would_ be nice to sort out the SyntaxErrors problem as well, but don’t let that stop fixing the easier problems. I would be interested in other people’s thoughts. My problem with things like :func:`evaluated ` is that the meaning is less clear, and it is

[issue27036] Mark up of references in different form

Serhiy Storchaka added the comment: Thank you for your review Martin! Absolutely agreed with you about references to classes and exceptions. I have removed this from the next version of the patch. I left your idea about ":exc:`SyntaxError` exceptions" for other patch. “evaluated with

[issue27036] Mark up of references in different form

Martin Panter added the comment: These bug me too. For the changes like the bytes-like objects example, you have my full support. But for the changes that modify identifier names, I think the both the old and the new versions are pretty bad. Example: - . . . for some :exc:`SyntaxError`\ s. +

[issue27036] Mark up of references in different form

New submission from Serhiy Storchaka: When there is a reference from the term in different form (e.g. in plural), the modified part can be appended outside of the reference: ":term:`bytes-like object`\ s". But this looks not very nice in rendered document, since only a part of the word is