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.
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.
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?
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).
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.
Asked: 2018-02-25 14:35:22 +0100
Seen: 670 times
Last updated: Feb 26 '18
Copyright Sage, 2010. Some rights reserved under creative commons license. Content on this site is licensed under a Creative Commons Attribution Share Alike 3.0 license.
