Raymond Hettinger <[EMAIL PROTECTED]> added the comment: General comment:
Stylistically, the docs should mostly be stated in a positive manner, stating what a tool does, how it should be used, and what is left undefined. IMO, it is harmful to fill the docs with CAVEATS and WARNINGS. ---------- nosy: +rhettinger _______________________________________ Python tracker <[EMAIL PROTECTED]> <http://bugs.python.org/issue4118> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
