This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author ezio.melotti
Recipients Tony R., docs@python, eric.araujo, ezio.melotti, georg.brandl
Date 2015-10-26.13:11:00
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1445865060.5.0.385670324933.issue25467@psf.upfronthosting.co.za>
In-reply-to
Content
> I’m not sure I understand what you mean by “tag”.

>> funcname(args)  [new in 3.2] [deprecated in 3.5]
>>   Func description here.

I mean some kind of tag/label next to the name of the function in the documentation (red/orange for deprecations, green for new-in)  -- it's not a Sphinx-specific term.
I saw it in some other documentation but I can't find it anymore, however if you look at the [task] and [assigned] tags/labels at the top of https://twistedmatrix.com/trac/ticket/5000 you can get a pretty close idea of what I'm thinking about.

> Are you saying that the source documentation would remain as-is,
> but something during the Sphinx _transformation_ would generate
> the new/deprecated tags?  

That's the idea.  Ideally the func/meth/class directives [0] would add the tags/labels if they contain version-added/version-changed/deprecated/deprecated-remove directives.

[0]: directives look like ".. function:: foo(args)", whereas roles look like :func:`foo`.  Functions are defined using directives.  In the previous message I mistakenly said "roles".  See also https://docs.python.org/devguide/documenting.html#directives
History
Date User Action Args
2015-10-26 13:11:00ezio.melottisetrecipients: + ezio.melotti, georg.brandl, eric.araujo, docs@python, Tony R.
2015-10-26 13:11:00ezio.melottisetmessageid: <1445865060.5.0.385670324933.issue25467@psf.upfronthosting.co.za>
2015-10-26 13:11:00ezio.melottilinkissue25467 messages
2015-10-26 13:11:00ezio.melotticreate