Ask Your Question
2

Commands that changed expression

asked 2018-02-25 07:35:22 -0500

isaia.ismaele gravatar image

Hello! Following a recent question about the new expressions for "find_minimum/maximum_on_interval", I have a more general concern: are commands that changed name across versions documented and collected in some form? So that old documentation and books aren't rendered irremediably obsolete by Sage's evolution.

edit retag flag offensive close merge delete

1 answer

Sort by ยป oldest newest most voted
1

answered 2018-02-25 11:25:57 -0500

tmonteil gravatar image

updated 2018-02-26 05:35:52 -0500

When the name of a function or a method changes, there is a one-year deprecation warning (meaning that during at least one year, when you use an old method, you will get a warning pointing yo to the new one), but there is no long-term centralized tool.

Your suggestion of keeping such a long-term "dictionary" of such evolutions is a very good idea however.

EDIT Regarding books, it is possible to add the code that belongs to the book in the doctests of Sage so that changes are detected and the book can be updated, see the $SAGE_LOCAL/src/sage/tests.

edit flag offensive delete link more

Comments

Thank you very much for your answer! Is there a changelog of such changes, or a list of such warnings, for each version? Is there a file, somewhere in the install folder, that lists all methods that get you a warning? Or, anyway, I would very much like to help construct such "dictionary", but is there a way to do so?

isaia.ismaele gravatar imageisaia.ismaele ( 2018-02-26 03:01:57 -0500 )edit

There are changelogs here : http://www.sagemath.org/changelogs/in... but there are not precise and parsable enough to extract what you want. A possiblilty could be to integrate all the deprecation warnings along all Sage version (within th source code).

tmonteil gravatar imagetmonteil ( 2018-02-26 05:22:25 -0500 )edit

I'm going to look into the "deprecation warnings" way, to see if I'd be able to collect data from that. In the meantime, could you please explain more in detail what you mean by "add the code that belongs to the book in the doctests"? Is it something to do with existing, and as of now outdated code from books, or with new books, as they are published? I apologize for this need for clarification, but sometimes the language gets in the way for me.

isaia.ismaele gravatar imageisaia.ismaele ( 2018-02-26 07:30:44 -0500 )edit

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer

Question Tools

1 follower

Stats

Asked: 2018-02-25 07:35:22 -0500

Seen: 42 times

Last updated: Feb 26