On Mon, 06 Dec 2004 12:12:48 +0000, Michael Hudson <mwh at python.net> wrote: > "Martin v. Löwis" <martin at v.loewis.de> writes: > > > Anthony Baxter wrote: > >> The library docs for, e.g. xmllib already say deprecated at the top - maybe > >> it should be larger? > > > > I think it would be better to *remove* the xmllib documentation. > > Existing code which needs the module will continue to work even > > without documentation, and new code is unlikely to be written for > > a module that has no documentation, and where importing the module > > gives a DeprecationWarning. > > +1, at least for *hiding* the documentation of xmllib + similar > modules. I'm not sure wholesale removal is really a good idea. 1) Move the deprecated documentation into a separate book. 2) Don't include the "Deprecated Modules Reference" in the standard distribution, but make it available as a separate download. -- Carlos Ribeiro Consultoria em Projetos blog: http://rascunhosrotos.blogspot.com blog: http://pythonnotes.blogspot.com mail: carribeiro at gmail.com mail: carribeiro at yahoo.com
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4