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.

Author cheryl.sabella
Recipients cheryl.sabella, docs@python, eric.araujo, ezio.melotti, pitrou, willingc
Date 2018-02-21.00:46:26
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1519173987.04.0.467229070634.issue32017@psf.upfronthosting.co.za>
In-reply-to
Content
I started taking a look at this and discovered a few things.  There are four methods in the C module `_lsprof` that are within the Profiler class - `enable`, `disable`, `getstats`, and `clear` and which are all available through cProfile.Profile.  These aren't available in profile.py.  Also, `getstats` and `clear` aren't in the documentation and `enable` takes two optional parameters that aren't mentioned in the documentation.  There are also many methods in profile.py that aren't documented.

What would be the preferred approach to fixing the documentation?  It seems that the documentation currently focuses on trying to make profile and cProfile as similar as possible.  Should they have separate sections that define the differences?  Or should `enable` and `disable` be removed since they aren't in profile?  The example under https://docs.python.org/3.8/library/profile.html#profile.Profile  uses `enable` and `disable` and seems to be a helpful example.
History
Date User Action Args
2018-02-21 00:46:27cheryl.sabellasetrecipients: + cheryl.sabella, pitrou, ezio.melotti, eric.araujo, docs@python, willingc
2018-02-21 00:46:27cheryl.sabellasetmessageid: <1519173987.04.0.467229070634.issue32017@psf.upfronthosting.co.za>
2018-02-21 00:46:27cheryl.sabellalinkissue32017 messages
2018-02-21 00:46:26cheryl.sabellacreate