bzr 2.1 retrospective

[Vincent Ladeuil]

>>>>> "Gordon" == Gordon Tyler <gordon at doxxx.net> writes:

    Gordon> On 22/02/2010 1:41 AM, Martin Pool wrote:
    >> So one thing we could do is just say "please deprecate things that
    >> were in the previous release rather than just removing them, if
    >> possible."  But perhaps someone has a better idea.

    Gordon> Take for example my recent mistake with the removal of
    Gordon> bzrlib.commands.shlex_split_unicode in bzr.dev when I implemented the
    Gordon> bzrlib.cmdline module. How would you suggest I should have deprecated
    Gordon> that function?


    Gordon> I know how to do it in Java: add "@deprecated blah blah use this other
    Gordon> method instead" in the Javadoc.

Pretty much the same:

 @deprecated_method(deprecated_in((2, 2, 0)))


    Gordon> But I don't actually know if there is a proper way of
    Gordon> doing it in Python / bzrlib.

All the details are in symbol_versioning.py, grepping for
deprecated_in will show you a lot of examples.

              Vincent