Comment 1 for bug 35947

Revision history for this message
Aaron Bentley (abentley) wrote : Re: [Bug 35947] deprecated_function should offer an explanation

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Ian Bicking wrote:
| Public bug reported:
| https://launchpad.net/malone/bugs/35947
|
| 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
deprecation/alternatives to examine in the doctext of the deprecated
function.

Deprecations are for development versions only. Released versions
should produce no deprecation warnings.

Aaron

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.1 (GNU/Linux)
Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org

iD8DBQFEIMmp0F+nu1YWqI0RAsmHAJwOeMCHCn2Rtc4P4i0nKlYyuh6D5ACfbJNC
K0r3dt7R6ra9/QKof9/NCjU=
=1/yp
-----END PGP SIGNATURE-----