On Mon, 06 Dec 2004 12:12:48 +0000, Michael Hudson <[EMAIL PROTECTED]> wrote: > "Martin v. Löwis" <[EMAIL PROTECTED]> 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: [EMAIL PROTECTED] mail: [EMAIL PROTECTED] _______________________________________________ Python-Dev mailing list [EMAIL PROTECTED] http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
