On Wed, Jun 19, 2013 at 1:43 PM, Jim Mooney <[email protected]> wrote: > Here's a peeve of mine about Python help - it often has zero examples. > I printed help(zip) to see what it does and got this: > --snip-- > > Not understandable right off, IMHO, unless you're already hardcore.
help() is outright harmful to people that don't already know what they're doing -- it omits things like advice to do with security, including neglecting to declare that functions are not safe and can execute arbitrary Python code, that sort of thing, but also the more common case of just minor security "footnotes" that are nonetheless important for every user to know. Definitely use the HTML docs. -- Devin _______________________________________________ Tutor maillist - [email protected] To unsubscribe or change subscription options: http://mail.python.org/mailman/listinfo/tutor
