[issue38788] Inconsistent documentation of tell/seek on textiobase/textiowrapper

2019-11-13 Thread Ulrik Haugen
New submission from Ulrik Haugen : The class hierarchy suggests the only tell/seek implementations one needs to look up are in iobase and those have the semantics i was expecting: https://docs.python.org/3.8/library/io.html#class-hierarchy Plowing on one might discover that there are separate

[issue16113] Add SHA-3 (Keccak) support

2013-02-27 Thread Ulrik Sverdrup
Ulrik Sverdrup added the comment: Please do not go forward until NIST publishes its SHA-3 specification document. We don't know yet what parameters they will finally choose when making Keccak SHA-3. -- nosy: +englabenny ___ Python tracker rep

[issue7417] open builtin has no signature in docstring

2009-12-02 Thread Ulrik Sverdrup
Ulrik Sverdrup ulrik.sverd...@gmail.com added the comment: import builtins; help(builtins) Looking around, the new suggestion is absolutely unconventional. The signature must be on the first line. One builtin function even uses two lines; min: min(iterable[, key=func]) - value

[issue7417] open builtin has no signature in docstring

2009-12-01 Thread ulrik
New submission from ulrik ulrik.sverd...@gmail.com: Python 3.1.1's open has no signature in the docstring so the documentation for this builtin function is unfortunately very confusing (IMO is missing the most important part). help(open) open(...) Open file and return a stream. Raise

[issue7303] pkgutil lacks documentation for useful functions

2009-11-10 Thread ulrik
New submission from ulrik ulrik.sverd...@gmail.com: The module pkgutil has no documentation of functions added after its introduction, in the official python documentation collection. http://docs.python.org/dev/py3k/library/pkgutil.html The module is well documented with docstrings. I assume