http://bugs.python.org/review/24459/diff/17478/Misc/python.man File Misc/python.man (right): http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode434 Misc/python.man:434: Set the Python memory allocators and/or install debug hooks. I think we can make the PYTHONMALLOC documention a bit shorter. Detailed descriptions of memory allocations and debug hooks can be removed. It would more than enough to just say "these are the available memory allocatos and those are the available debug hooks". If people need more more information about what pymalloc or malloc_debug does they should read the online documentation. http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode454 Misc/python.man:454: When Python is compiled in release mode, the default is "pymalloc". When This paragraph can stay. http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode458 Misc/python.man:458: If Python is configured without "pymalloc" support, "pymalloc" and This paragraph can stay. http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode469 Misc/python.man:469: This variable is ignored if the PYTHONMALLOC environment variable $PYTHONMALLOC http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode479 Misc/python.man:479: stored in a traceback of a trace. For example, "PYTHONTRACEMALLOC=1" .IB PYTHONTRACEMALLOC=1 http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode481 Misc/python.man:481: .IR tracemalloc.start() I think this is missing "documentation" here. http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode488 Misc/python.man:488: dump the Python traceback. This is equivalent to -X "faulthandler" option. Move "This is equivalent ..." part to a new paragraph. http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode490 Misc/python.man:490: If this environment variable is set, "sys.argv[0]" will be set to its value instead of the value got through the C runtime. Only works on Mac OS X. .IB sys.argv[0} http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode490 Misc/python.man:490: If this environment variable is set, "sys.argv[0]" will be set to its value instead of the value got through the C runtime. Only works on Mac OS X. Please also wrap these long lines. http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode493 Misc/python.man:493: Setting these variables only has an effect in a debug build of Python, that is, if Python was configured with the --with-pydebug build option. fB\--with-pydebug\fP http://bugs.python.org/review/24459/