Issue 19627: python open built-in function - "updating" is not defined (original) (raw)

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

Files
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 http://stackoverflow.com/questions/1466000/python-open-built-in-function-difference-between-modes-a-a-w-w-and-r - "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 (http://docs.python.org/3.4/library/functions.html#open) 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). http://hg.python.org/cpython/rev/1f823c1559bd
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?
History
Date User Action Args
2022-04-11 14:57:53 admin set github: 63826
2014-03-12 07:44:56 eric.araujo set status: open -> closed
2014-03-12 07:44:12 georg.brandl set nosy: + georg.brandlmessages: +
2014-03-12 06:23:19 eric.araujo set assignee: docs@python -> eric.araujoresolution: fixedmessages: + stage: needs patch -> resolved
2014-03-12 06:16:52 python-dev set nosy: + python-devmessages: +
2014-03-11 01:51:15 linaclark set files: + function_doc.patchnosy: + linaclarkmessages: + keywords: + patch
2014-02-14 04:57:39 ezio.melotti set keywords: + easystage: needs patchmessages: + versions: + Python 2.7
2013-11-25 07:50:55 Bulwersator set messages: +
2013-11-25 03:23:46 ezio.melotti set type: enhancementmessages: + nosy: + ezio.melotti
2013-11-22 20:58:48 eric.araujo set nosy: + eric.araujomessages: +
2013-11-16 22:37:55 martin.panter set nosy: + martin.panter
2013-11-16 18:53:01 Bulwersator create