[Python-checkins] cpython (3.6): massage English for -X descriptions a bit

Fri Feb 10 01:35:30 EST 2017

https://hg.python.org/cpython/rev/59e54de17dd8
changeset: 106483:59e54de17dd8
branch: 3.6
parent: 106477:4e3a16bdadae
user: Benjamin Peterson <benjamin at python.org>
date: Thu Feb 09 22:31:17 2017 -0800
summary:
 massage English for -X descriptions a bit
files:
 Doc/using/cmdline.rst | 12 +++++++-----
 1 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst
--- a/Doc/using/cmdline.rst
+++ b/Doc/using/cmdline.rst
@@ -396,21 +396,23 @@
 defines the following possible values:
 
 * ``-X faulthandler`` to enable :mod:`faulthandler`;
- * ``-X showrefcount`` to enable the output of the total reference count
- and memory blocks (only works on debug builds);
+ * ``-X showrefcount`` to output the total reference count and number of used
+ memory blocks when the program finishes or after each statement in the
+ interactive interpreter. This only works on debug builds.
 * ``-X tracemalloc`` to start tracing Python memory allocations using the
 :mod:`tracemalloc` module. By default, only the most recent frame is
 stored in a traceback of a trace. Use ``-X tracemalloc=NFRAME`` to start
 tracing with a traceback limit of *NFRAME* frames. See the
 :func:`tracemalloc.start` for more information.
- * ``-X showalloccount`` to enable the output of the total count of allocated
- objects for each type (only works when built with ``COUNT_ALLOCS`` defined);
+ * ``-X showalloccount`` to output the total count of allocated objects for
+ each type when the program finishes. This only works when Python was built with
+ ``COUNT_ALLOCS`` defined.
 
 It also allows passing arbitrary values and retrieving them through the
 :data:`sys._xoptions` dictionary.
 
 .. versionchanged:: 3.2
- It is now allowed to pass :option:`-X` with CPython.
+ The :option:`-X` option was added.
 
 .. versionadded:: 3.3
 The ``-X faulthandler`` option.
-- 
Repository URL: https://hg.python.org/cpython
