deprecated_function should offer an explanation
Bug #35947 reported by
Ian Bicking
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
Bazaar |
Confirmed
|
Low
|
Unassigned | ||
Breezy |
Triaged
|
Low
|
Unassigned |
Bug Description
There should be an optional (but generally used) second argument to deprecated_function that suggests what should be used in lieu of the deprecated function.
My first thought seeing a deprecation: deprecated for what?
Changed in bzr: | |
status: | Unconfirmed → Confirmed |
tags: | added: api deprecation |
tags: | added: api-versioning |
Changed in brz: | |
status: | New → Triaged |
importance: | Undecided → Low |
To post a comment you must log in.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Ian Bicking wrote: /launchpad. net/malone/ bugs/35947
| Public bug reported:
| https:/
|
| Affects: bzr (upstream)
| Severity: Normal
| Priority: (none set)
| Status: Unconfirmed
|
| Description:
| There should be an optional (but generally used) second argument to
| deprecated_function that suggests what should be used in lieu of the
| deprecated function.
|
| My first thought seeing a deprecation: deprecated for what?
Our style is to put an explanation of the reasons for alternatives to examine in the doctext of the deprecated
deprecation/
function.
Deprecations are for development versions only. Released versions
should produce no deprecation warnings.
Aaron
-----BEGIN PGP SIGNATURE----- enigmail. mozdev. org
nu1YWqI0RAsmHAJ wOeMCHCn2Rtc4P4 i0nKlYyuh6D5ACf bJNC QKof9/NCjU=
Version: GnuPG v1.4.1 (GNU/Linux)
Comment: Using GnuPG with Thunderbird - http://
iD8DBQFEIMmp0F+
K0r3dt7R6ra9/
=1/yp
-----END PGP SIGNATURE-----