[issue14870] os.utimensat's method description uses wrong notation
New submission from Hynek Schlawack <hs@ox.cx>: It says:
os.utimensat(dirfd, path[, atime=(atime_sec, atime_nsec), mtime=(mtime_sec, mtime_nsec), flags=0]) Updates the timestamps of a file with nanosecond precision. The atime and mtime tuples default to None, which sets those values to the current time.
It should be the other way around: atime=None, mtime=None in the signature and explain in the body how they look like. It looks like atime_sec and atime_nsec are some magic constants this way. ---------- assignee: docs@python components: Documentation keywords: easy messages: 161264 nosy: docs@python, eric.araujo, ezio.melotti, georg.brandl, hynek priority: low severity: normal status: open title: os.utimensat's method description uses wrong notation versions: Python 3.3 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue14870> _______________________________________
Petri Lehtinen <petri@digip.org> added the comment: os.utime() uses the same notation: os.utime(path[, times, *, ns=(atime_ns, mtime_ns)]) ---------- nosy: +petri.lehtinen title: os.utimensat's method description uses wrong notation -> Descriptions of os.utime() and os.utimensat() use wrong notation _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue14870> _______________________________________
Changes by Ezio Melotti <ezio.melotti@gmail.com>: ---------- stage: -> needs patch type: -> enhancement _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue14870> _______________________________________
Changes by Chris Rebert <pybugs@rebertia.com>: ---------- nosy: +cvrebert _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue14870> _______________________________________
Hynek Schlawack added the comment: Turns out, Larry fixed these two while working on #14626. ---------- resolution: -> fixed stage: needs patch -> committed/rejected status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue14870> _______________________________________
participants (4)
-
Chris Rebert
-
Ezio Melotti
-
Hynek Schlawack
-
Petri Lehtinen