[issue20468] resource module documentation is incorrect

Greg Lindahl added the comment: I just tripped on the bug that the maxrss field is kilobytes on Linux and bytes on Darwin. I don't think referring to the C manpages is sufficient to prevent confusion. I don't actually use my package on a Mac, I just use Travis-CI to test it. --

[issue20468] resource module documentation is incorrect

John Runyon added the comment: *bump*. This flat-out wrong documentation has already misled several people, and has had a proposed patch with no comments for over a year. -- nosy: +jrunyon ___ Python tracker

[issue20468] resource module documentation is incorrect

Martin Panter added the comment: I committed the text removal for getpagesize(). For the getrusage() table, I wonder if it is good enough as it already is. Otherwise, it opens questions about the units for all the other fields, and which platforms they are supported on. -- versions:

[issue20468] resource module documentation is incorrect

Roundup Robot added the comment: New changeset 5e8b06ac7c97 by Martin Panter in branch '3.4': Issue #20468: Remove incorrect information about maxrss and page size https://hg.python.org/cpython/rev/5e8b06ac7c97 New changeset 1579de0b72f6 by Martin Panter in branch '3.5': Issue #20468: Merge

[issue20468] resource module documentation is incorrect

Martin Panter added the comment: Python’s getrusage() calls the C-level getrusage() function. Man pages for reference: http://man7.org/linux/man-pages/man2/getrusage.2.html https://www.freebsd.org/cgi/man.cgi?query=getrusage=2

[issue20468] resource module documentation is incorrect

Changes by Terry J. Reedy tjre...@udel.edu: -- versions: -Python 3.1, Python 3.2, Python 3.3 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue20468 ___

[issue20468] resource module documentation is incorrect

Ronald Oussoren added the comment: The attached patch (for the default branch) adds information about the unit of maxrss to the documentation, and removes the sentences about calculating the total memory size from the getpagesize documentation. -- assignee: ronaldoussoren -

[issue20468] resource module documentation is incorrect

New submission from Kurt Rose: The documentation in the resource module for get_page_size() is incorrect. resource.getpagesize() Returns the number of bytes in a system page. (This need not be the same as the hardware page size.) This function is useful for determining the number of bytes of