diff -r ade839421b8f -r f074c54aea40 Misc/python.man --- a/Misc/python.man Thu May 19 13:11:17 2016 -0700 +++ b/Misc/python.man Fri May 20 22:38:04 2016 -0500 @@ -347,6 +347,39 @@ interpreter. .RE .SH ENVIRONMENT VARIABLES +.IP PYTHONASYNCIODEBUG +If this environment variable is set to a non-empty string, +enable the debug mode of the asyncio module. +.IP PYTHONCASEOK +If this is set, Python ignores case in import statements. +This only works on Windows and OS X. +.IP PYTHONDEBUG +If this is set to a non-empty string it is equivalent to specifying +the \fB\-d\fP option. If set to an integer, it is equivalent to +specifying \fB\-d\fP multiple times. +.IP PYTHONDONTWRITEBYTECODE +If this is set to a non-empty string it is equivalent to specifying +the \fB\-B\fP option (don't try to write +.I .py[co] +files). +.IP PYTHONFAULTHANDLER +If this environment variable is set to a non-empty string, +.IR faulthandler.enable() +is called at startup: install a handler +for SIGSEGV, SIGFPE, SIGABRT, SIGBUS and SIGILL signals to +dump the Python traceback. This is equivalent to -X "faulthandler" option. +.IP PYTHONHASHSEED +If this variable is set to "random", a random value is used to seed the hashes +of str, bytes and datetime objects. + +If PYTHONHASHSEED is set to an integer value, it is used as a fixed seed for +generating the hash() of the types covered by the hash randomization. Its +purpose is to allow repeatable hashing, such as for selftests for the +interpreter itself, or to allow a cluster of python processes to share hash +values. + +The integer must be a decimal number in the range [0,4294967295]. Specifying +the value 0 will disable hash randomization. .IP PYTHONHOME Change the location of the standard Python libraries. By default, the libraries are searched in ${prefix}/lib/python and @@ -355,6 +388,64 @@ \fI/usr/local\fP. When $PYTHONHOME is set to a single directory, its value replaces both ${prefix} and ${exec_prefix}. To specify different values for these, set $PYTHONHOME to ${prefix}:${exec_prefix}. +.IP PYTHONINSPECT +If this is set to a non-empty string it is equivalent to specifying +the \fB\-i\fP option. +.IP PYTHONIOENCODING +If this is set before running the interpreter, it overrides the encoding used +for stdin/stdout/stderr, in the syntax +.IB encodingname ":" errorhandler +The +.IB errorhandler +part is optional and has the same meaning as in str.encode. For stderr, the +.IB errorhandler + part is ignored; the handler will always be \'backslashreplace\'. +.IP PYTHONMALLOC +Set the Python memory allocators and/or install debug hooks. + +Set the family of memory allocators used by Python: + +* "malloc": use the malloc() function of the C library + for all domains ("PYMEM_DOMAIN_RAW", "PYMEM_DOMAIN_MEM", + "PYMEM_DOMAIN_OBJ"). + +* "pymalloc": use the "pymalloc allocator " for + "PYMEM_DOMAIN_MEM" and "PYMEM_DOMAIN_OBJ" domains and use + the "malloc" function for the "PYMEM_DOMAIN_RAW" domain. + +Install debug hooks: + +* "debug": install debug hooks on top of the default memory allocator + +* "malloc_debug": same as "malloc" but also install debug hooks + +* "pymalloc_debug": same as "pymalloc" but also install debug hooks + +When Python is compiled in release mode, the default is "pymalloc". When +compiled in debug mode, the default is "pymalloc_debug" and the debug hooks +are used automatically. + +If Python is configured without "pymalloc" support, "pymalloc" and +"pymalloc_debug" are not available, the default is "malloc" in release +mode and "malloc_debug" in debug mode. + +See the "PyMem_SetupDebugHooks" function for debug hooks on Python +memory allocators. +.IP PYTHONMALLOCSTATS +If set to a non-empty string, Python will print statistics of the +pymalloc memory allocator every time a new pymalloc object arena +is created, and on shutdown. + +This variable is ignored if the PYTHONMALLOC environment variable +is used to force the "malloc()" allocator of the C library, or if +Python is configured without pymalloc support. +.IP PYTHONNOUSERSITE +If this is set to a non-empty string it is equivalent to specifying the +\fB\-s\fP option (Don't add the user site directory to sys.path). +.IP PYTHONOPTIMIZE +If this is set to a non-empty string it is equivalent to specifying +the \fB\-O\fP option. If set to an integer, it is equivalent to +specifying \fB\-O\fP multiple times. .IP PYTHONPATH Augments the default search path for module files. The format is the same as the shell's $PATH: one or more directory @@ -379,38 +470,22 @@ .I sys.ps1 and .I sys.ps2 -in this file. -.IP PYTHONOPTIMIZE -If this is set to a non-empty string it is equivalent to specifying -the \fB\-O\fP option. If set to an integer, it is equivalent to -specifying \fB\-O\fP multiple times. -.IP PYTHONDEBUG -If this is set to a non-empty string it is equivalent to specifying -the \fB\-d\fP option. If set to an integer, it is equivalent to -specifying \fB\-d\fP multiple times. -.IP PYTHONDONTWRITEBYTECODE -If this is set to a non-empty string it is equivalent to specifying -the \fB\-B\fP option (don't try to write -.I .py[co] -files). -.IP PYTHONINSPECT -If this is set to a non-empty string it is equivalent to specifying -the \fB\-i\fP option. -.IP PYTHONIOENCODING -If this is set before running the interpreter, it overrides the encoding used -for stdin/stdout/stderr, in the syntax -.IB encodingname ":" errorhandler -The -.IB errorhandler -part is optional and has the same meaning as in str.encode. For stderr, the -.IB errorhandler - part is ignored; the handler will always be \'backslashreplace\'. -.IP PYTHONNOUSERSITE -If this is set to a non-empty string it is equivalent to specifying the -\fB\-s\fP option (Don't add the user site directory to sys.path). +in t his file. +.IP PYTHONTRACEMALLOC +If this environment variable is set to a non-empty string, +start tracing Python memory allocations using the tracemalloc +module. The value of the variable is the maximum number of frames +stored in a traceback of a trace. For example, "PYTHONTRACEMALLOC=1" +stores only the most recent frame. See the +.IR tracemalloc.start() + for more information. .IP PYTHONUNBUFFERED If this is set to a non-empty string it is equivalent to specifying the \fB\-u\fP option. +.IP PYTHONUSERBASE +Defines the user base directory, which is used to compute +the path of the user site-packages directory and Distutils +installation paths for "python setup.py install --user". .IP PYTHONVERBOSE If this is set to a non-empty string it is equivalent to specifying the \fB\-v\fP option. If set to an integer, it is equivalent to @@ -418,18 +493,6 @@ .IP PYTHONWARNINGS If this is set to a comma-separated string it is equivalent to specifying the \fB\-W\fP option for each separate value. -.IP PYTHONHASHSEED -If this variable is set to "random", a random value is used to seed the hashes -of str, bytes and datetime objects. - -If PYTHONHASHSEED is set to an integer value, it is used as a fixed seed for -generating the hash() of the types covered by the hash randomization. Its -purpose is to allow repeatable hashing, such as for selftests for the -interpreter itself, or to allow a cluster of python processes to share hash -values. - -The integer must be a decimal number in the range [0,4294967295]. Specifying -the value 0 will disable hash randomization. .SH AUTHOR The Python Software Foundation: https://www.python.org/psf/ .SH INTERNET RESOURCES