[issue19627] python open built-in function - "updating" is not defined
New submission from Bulwersator: see http://stackoverflow.com/questions/1466000/python-open-built-in-function-dif... - "The Python docs conveniently leave out the crucial explanation that "open the file for updating" means "opens the file for both reading and writing", which answers my question." ---------- assignee: docs@python components: Documentation messages: 203075 nosy: Bulwersator, docs@python priority: normal severity: normal status: open title: python open built-in function - "updating" is not defined _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue19627> _______________________________________
Changes by Martin Panter <vadmium+py@gmail.com>: ---------- nosy: +vadmium _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue19627> _______________________________________
Éric Araujo added the comment: Would you like to propose a patch to the documentation? It’s possible that “updating” is explained in one place but not everywhere (doc for open, doc for io, doc about file objects). ---------- nosy: +eric.araujo _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue19627> _______________________________________
Ezio Melotti added the comment: Is the doc in 3.4 (http://docs.python.org/3.4/library/functions.html#open) clear enough? If so it could be backported on 2.7/3.3. ---------- nosy: +ezio.melotti type: -> enhancement _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue19627> _______________________________________
Bulwersator added the comment: yes, "open a disk file for updating (reading and writing)" is a good explanation ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue19627> _______________________________________
Ezio Melotti added the comment: This seems to be in 3.3 already, so only 2.7 is left. ---------- keywords: +easy stage: -> needs patch versions: +Python 2.7 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue19627> _______________________________________
Lina Clark added the comment: I uploaded a patch to reflect reading and writing in the python 2.7 documentation for 'updating'. ---------- keywords: +patch nosy: +linaclark Added file: http://bugs.python.org/file34347/function_doc.patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue19627> _______________________________________
Roundup Robot added the comment: New changeset 1f823c1559bd by Éric Araujo in branch '2.7': Define what “updating” means in docs for open (#19627). http://hg.python.org/cpython/rev/1f823c1559bd ---------- nosy: +python-dev _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue19627> _______________________________________
Éric Araujo added the comment: Edited slightly and committed, thank you! ---------- assignee: docs@python -> eric.araujo resolution: -> fixed stage: needs patch -> committed/rejected _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue19627> _______________________________________
Georg Brandl added the comment: Can this be closed? ---------- nosy: +georg.brandl _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue19627> _______________________________________
Changes by Éric Araujo <merwok@netwok.org>: ---------- status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue19627> _______________________________________
participants (7)
-
Bulwersator -
Ezio Melotti
-
Georg Brandl
-
Lina Clark
-
Martin Panter
-
Roundup Robot
-
Éric Araujo