> One way to handle this might be to > > a) create a new module "_cbook.py" for internal use. > b) move everything used internally into there > c) in cbook.py, put "from _cbook import *" and include all of these other > functions in there > d) emit a MatplotlibDeprecationWarning at the top level of cbook.py so > there's a deprecation warning about the entire module. > > I'm not sure this is the best approach, but it's an easy way to deprecate a > lot of things at once. Comments from other are appreciated.
I think it is going to be slightly more complicated than that, as there are method that are meant for public use (such as get_sample_data). I think indeed it would be nice to deprecate most of the methods that aren't use in matplotlib, and make private the ones that aren't useful to users (that would make refactoring easier), but that needs to be done cases by cases. I can work on that and submit a PR. > > Cheers, > Mike > > >> >> Thanks, >> N >> >>> Mike >>> >>> >>> On 01/07/2013 10:24 AM, Nelle Varoquaux wrote: >>>> >>>> Hello everyone, >>>> >>>> I was recently looking at the cbook module, and I was wondering >>>> whether this module was public or not. I think there are several >>>> unused method in it, such as ``unmasked_index_ranges``. If this isn't >>>> public, it may be worth cleaning the module a bit and removing the >>>> unused method. >>>> >>>> Cheers, >>>> Nelle >>>> >>>> >>>> ------------------------------------------------------------------------------ >>>> Master Visual Studio, SharePoint, SQL, ASP.NET, C# 2012, HTML5, CSS, >>>> MVC, Windows 8 Apps, JavaScript and much more. Keep your skills current >>>> with LearnDevNow - 3,200 step-by-step video tutorials by Microsoft >>>> MVPs and experts. SALE $99.99 this month only -- learn more at: >>>> http://p.sf.net/sfu/learnmore_122412 >>>> _______________________________________________ >>>> Matplotlib-devel mailing list >>>> Matplotlib-devel@lists.sourceforge.net >>>> https://lists.sourceforge.net/lists/listinfo/matplotlib-devel >>> >>> >>> >>> ------------------------------------------------------------------------------ >>> Master Visual Studio, SharePoint, SQL, ASP.NET, C# 2012, HTML5, CSS, >>> MVC, Windows 8 Apps, JavaScript and much more. Keep your skills current >>> with LearnDevNow - 3,200 step-by-step video tutorials by Microsoft >>> MVPs and experts. SALE $99.99 this month only -- learn more at: >>> http://p.sf.net/sfu/learnmore_122412 >>> _______________________________________________ >>> Matplotlib-devel mailing list >>> Matplotlib-devel@lists.sourceforge.net >>> https://lists.sourceforge.net/lists/listinfo/matplotlib-devel > > ------------------------------------------------------------------------------ Master SQL Server Development, Administration, T-SQL, SSAS, SSIS, SSRS and more. Get SQL Server skills now (including 2012) with LearnDevNow - 200+ hours of step-by-step video tutorials by Microsoft MVPs and experts. SALE $99.99 this month only - learn more at: http://p.sf.net/sfu/learnmore_122512 _______________________________________________ Matplotlib-devel mailing list Matplotlib-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/matplotlib-devel
