This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Title: python open built-in function - "updating" is not defined
Type: enhancement Stage: resolved
Components: Documentation Versions: Python 2.7
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: eric.araujo Nosy List: Bulwersator, docs@python, eric.araujo, ezio.melotti, georg.brandl, linaclark, martin.panter, python-dev
Priority: normal Keywords: easy, patch

Created on 2013-11-16 18:53 by Bulwersator, last changed 2022-04-11 14:57 by admin. This issue is now closed.

File name Uploaded Description Edit
function_doc.patch linaclark, 2014-03-11 01:51 patch for documentation in 2.7 review
Messages (9)
msg203075 - (view) Author: (Bulwersator) Date: 2013-11-16 18:53
see - "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."
msg203873 - (view) Author: Éric Araujo (eric.araujo) * (Python committer) Date: 2013-11-22 20:58
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).
msg204289 - (view) Author: Ezio Melotti (ezio.melotti) * (Python committer) Date: 2013-11-25 03:23
Is the doc in 3.4 ( clear enough?

If so it could be backported on 2.7/3.3.
msg204304 - (view) Author: (Bulwersator) Date: 2013-11-25 07:50
yes, "open a disk file for updating (reading and writing)" is a good explanation
msg211198 - (view) Author: Ezio Melotti (ezio.melotti) * (Python committer) Date: 2014-02-14 04:57
This seems to be in 3.3 already, so only 2.7 is left.
msg213111 - (view) Author: Lina Clark (linaclark) * Date: 2014-03-11 01:51
I uploaded a patch to reflect reading and writing in the python 2.7 documentation for 'updating'.
msg213202 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2014-03-12 06:16
New changeset 1f823c1559bd by Éric Araujo in branch '2.7':
Define what “updating” means in docs for open (#19627).
msg213203 - (view) Author: Éric Araujo (eric.araujo) * (Python committer) Date: 2014-03-12 06:23
Edited slightly and committed, thank you!
msg213210 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2014-03-12 07:44
Can this be closed?
Date User Action Args
2022-04-11 14:57:53adminsetgithub: 63826
2014-03-12 07:44:56eric.araujosetstatus: open -> closed
2014-03-12 07:44:12georg.brandlsetnosy: + georg.brandl
messages: + msg213210
2014-03-12 06:23:19eric.araujosetassignee: docs@python -> eric.araujo
resolution: fixed
messages: + msg213203
stage: needs patch -> resolved
2014-03-12 06:16:52python-devsetnosy: + python-dev
messages: + msg213202
2014-03-11 01:51:15linaclarksetfiles: + function_doc.patch

nosy: + linaclark
messages: + msg213111

keywords: + patch
2014-02-14 04:57:39ezio.melottisetkeywords: + easy

stage: needs patch
messages: + msg211198
versions: + Python 2.7
2013-11-25 07:50:55Bulwersatorsetmessages: + msg204304
2013-11-25 03:23:46ezio.melottisettype: enhancement

messages: + msg204289
nosy: + ezio.melotti
2013-11-22 20:58:48eric.araujosetnosy: + eric.araujo
messages: + msg203873
2013-11-16 22:37:55martin.pantersetnosy: + martin.panter
2013-11-16 18:53:01Bulwersatorcreate