[issue26011] Document necesities for cmp argument of sorted

2016-01-04 Thread Karl Richter
New submission from Karl Richter: The docstring of `sorted` doesn't explain what can be passed to the `cmp` and `key` argument of `sorted`. -- assignee: docs@python components: Documentation messages: 257505 nosy: docs@python, krichter priority: normal severity: normal status:

[issue25946] configure should pick /usr/bin/g++ automatically if present

2015-12-24 Thread Karl Richter
New submission from Karl Richter: `./configure` both prints `checking for g++... no` and WARNING: By default, distutils will build C++ extension modules with "g++". If this is not intended, then set CXX on the configure command line. if `/usr/bin/g++` is p

[issue25787] Add an explanation what happens with subprocess parent and child processes when signals are sent

2015-12-03 Thread Karl Richter
Karl Richter added the comment: Please also explain how to deal with process replacement in child processes (assuming that http://stackoverflow.com/questions/34059576/how-to-register-a-signal-handler-for-a-subprocess/34065587#34065587 is correct

[issue25787] Add an explanation what happens with subprocess parent and child processes when signals are sent

2015-12-02 Thread Karl Richter
New submission from Karl Richter: The [documentation of subprocess](https://docs.python.org/3.6/library/subprocess.html) doesn't contain a substantial statement how signals are handled which are send to the python interpreter. After reading the referenced docs it should be clear * wh

[issue25377] Mention octal format of mode argument of os.chmod

2015-10-11 Thread Karl Richter
New submission from Karl Richter: `help(os.chmod)` doesn't explain that it expects an octal number for its `mode` argument. This is very confusing for beginners and people who are not involved with filesystems and permissions every day. It doesn't need to be explained, just mentio

[issue24506] make fails with gcc 4.9 due to fatal warning of unused variable and empty macro in Parser/pgen.c

2015-06-24 Thread Karl Richter
Karl Richter added the comment: It's a fatal warning of `gcc 4.9.2`, not an error (my bad) for `int i;` in `Parser/pgen.c` line 227. It might be ignored as well, but I think my approach is more elegant and deals with issues sooner than

[issue24506] make fails with gcc 4.9 due to fatal warning of unused variable and empty macro in Parser/pgen.c

2015-06-24 Thread Karl Richter
New submission from Karl Richter: `gcc` 4.9 is more restictive and recognizes that the empty definition of the `REQN` macro doesn't use some variables. It's more suitable to wrap the usage of the macro in the same preprocessor conditionals like the macro definition. experi

[issue24331] *** Error in `/usr/bin/python': double free or corruption (!prev): 0x0000000000f5c760 *** when cloning hg repository into directory on cifs

2015-05-30 Thread Karl Richter
New submission from Karl Richter: I experience the error in the title exclusive when invoking `hg clone` (e.g. `hg clone https://bitbucket.org/Coin3D/coin` or `hg clone http://hg.netbeans.org/main-golden/ netbeans-main-golden`) when the target directory is on a cifs mount. `gdb` backtrace

[issue24143] Makefile in tarball don't provide make uninstall target

2015-05-07 Thread Karl Richter
Changes by Karl Richter : -- components: Build nosy: krichter priority: normal severity: normal status: open title: Makefile in tarball don't provide make uninstall target versions: Python 2.7 ___ Python tracker <http://bugs.python.org/is

[issue24060] Clearify necessities for logging with timestamps

2015-04-25 Thread Karl Richter
New submission from Karl Richter: The `Formatter` section of the `logging` module at https://docs.python.org/2/library/logging.html#formatter-objects reads like it's sufficient to create an instance of `Formatter` with default arguments (and set it as formatter of the `Handler` of a `L

[issue24021] document urllib.urlretrieve

2015-04-22 Thread Karl Richter
Karl Richter added the comment: > I suspect the complaint might be about the lack of doc string Exactly. It'd be helpful to figure out the return value and the means of the function arguments in a more compact form than the referenced website docs and to have it available in the int

[issue24021] document urllib.urlretrieve

2015-04-21 Thread Karl Richter
Changes by Karl Richter : -- assignee: docs@python components: Documentation nosy: docs@python, krichter priority: normal severity: normal status: open title: document urllib.urlretrieve versions: Python 2.7 ___ Python tracker <h

[issue23174] shelve.open fails with error "anydbm.error: db type could not be determined"

2015-02-07 Thread Karl Richter
Karl Richter added the comment: After checking the code, I think that it'd make more sense to document `whichdb.py`. It needs to be enhanced with references to criteria for the determination of the database type. Currently there're only function comments and the fact that some var

[issue23174] shelve.open fails with error "anydbm.error: db type could not be determined"

2015-02-07 Thread Karl Richter
Karl Richter added the comment: For example, it should be clear why `shelve.open(tempfile.mkstemp()[1])` fails with the mentioned exception and `shelve.open("/tmp/bla")` fails. I still haven't figured out the constraints to create a working `shelve.Shelve` at all. It shou

[issue23163] pdb docs need to contain a statement on threads/multithreaded debugging

2015-01-11 Thread Karl Richter
Karl Richter added the comment: Sorry, I mean #!/usr/bin/python import threading def debugging(): def __a_thread__(): print("2") a_thread = threading.Thread(target=__a_thread__) a_thread.start() a_thread.join()

[issue23163] pdb docs need to contain a statement on threads/multithreaded debugging

2015-01-11 Thread Karl Richter
Karl Richter added the comment: My initial description was imprecise. Clearification: The fact that in #!/usr/bin/python import threading def debugging(): def __a_thread__(): print("2") a_thread = threading.Thread(target=__a_thread__)

[issue23174] shelve.open fails with error "anydbm.error: db type could not be determined"

2015-01-06 Thread Karl Richter
Karl Richter added the comment: That's nice, thanks. Considering your last comment, some points * If the issue can't go into the error message, than the essence of the discussion here should go into the docs (in 0.5 to 1.5 sentences). * It'd be nice if it was clear from th

[issue23174] shelve.open fails with error "anydbm.error: db type could not be determined"

2015-01-05 Thread Karl Richter
Karl Richter added the comment: Then, let the error message say "You are opening a just-created empty file. The db type of the file cannot, therefore, be determined." which is much clearer than "anydbm.error: db type could not be determined" which sounds like a generic fa

[issue23174] shelve.open fails with error "anydbm.error: db type could not be determined"

2015-01-05 Thread Karl Richter
Karl Richter added the comment: EDIT 1: other examples, e.g. import os import shelve curdir = os.path.dirname(__file__) passwords = shelve.open(os.path.join(curdir, 'password_db')) work, so there's need for usable

[issue23174] shelve.open fails with error "anydbm.error: db type could not be determined"

2015-01-05 Thread Karl Richter
New submission from Karl Richter: `shelve.open(tempfile.mkstemp()[1])` fails with error "anydbm.error: db type could not be determined" which is not explainable with the docs. Traceback is Traceback (most recent call last): File "./cudaminer_param_checker.py

[issue23163] pdb docs need to contain a statement on threads/multithreaded debugging

2015-01-04 Thread Karl Richter
New submission from Karl Richter: Due to the fact that `pdb` currently simply ignores breakpoints which are set and hit in another than the main thread the docs need to contain a statement on behavior in a multithreaded environment. -- components: Library (Lib) messages: 233409 nosy

[issue21889] https://docs.python.org/2/library/multiprocessing.html#process-and-exceptions doesn't explain exception

2014-06-30 Thread Karl Richter
New submission from Karl Richter: Although the section https://docs.python.org/2/library/multiprocessing.html#process-and-exceptions (of the multiprocessing module documentation) is titled "... and exceptions" it doesn't say anything about exceptions. I assume that it behaves

[issue21885] shutil.copytree hangs (on copying root directory of a lxc container) (should succeed or raise exception nested)

2014-06-30 Thread Karl Richter
New submission from Karl Richter: reproduction (on Ubuntu 14.04 amd64 with lxc 1.0.4) (with python 2.7.6 and 3.4.0) # as root/with privileges lxc-create -n ubuntu-trusty-amd64 -t ubuntu -- --arch amd64 --release trusty lxc-stop -n ubuntu-trusty-amd64 # assert container isn&#

[issue21739] Add hint about expression in list comprehensions (https://docs.python.org/2/tutorial/datastructures.html#list-comprehensions)

2014-06-12 Thread Karl Richter
New submission from Karl Richter: It would be useful to have a short statement in the docs (https://docs.python.org/2/tutorial/datastructures.html#list-comprehensions) that the expression in a list comprehension isn't put into a block, but evaluated against the same block where it is lo

[issue21208] Change default behavior of arguments with type bool when options are specified

2014-05-28 Thread Karl Richter
Karl Richter added the comment: @paul.j3 That's interesting [1]. Documenting argparse.register seems crucial to me (-> reopen or file a new request?). After dealing more with the very sophisticated and complex functionality of argparse I'm sure that this is the only use case

[issue21208] Change default behavior of arguments with type bool when options are specified

2014-04-13 Thread Karl Richter
Karl Richter added the comment: That's a pity, I still think it's confusing. Thanks for your feedback! -- ___ Python tracker <http://bugs.python.o

[issue21208] Change default behavior of arguments with type bool when options are specified

2014-04-12 Thread Karl Richter
Karl Richter added the comment: I've been mistaken about the behavior if no argument is specified (then the argument value is None), so this is a bug! -- ___ Python tracker <http://bugs.python.org/is

[issue21208] Change default behavior of arguments with type bool when options are specified

2014-04-12 Thread Karl Richter
New submission from Karl Richter: As arguments with type bool are the only ones whose values can be manipulated without passing an option to the argument on CLI, the default behavior for those should be changed from ignoring options to failing when options are specified. Consider the

[issue20683] [doc] Ease comprehension of section 9.2 of docs for Python 2 and 3 with example

2014-02-19 Thread Karl Richter
New submission from Karl Richter: The explanation of namespaces in section 9.2 in documentation (http://docs.python.org/3/tutorial/classes.html#python-scopes-and-namespaces) is just so complicated without (at least one tiny) example. The example would ease the comprehension of the section by