cpython-lru_cache-weakref: Misc/python.man annotate

annotate Misc/python.man @ 75155:358aee0a9ad5 3.1

Remove reST markup from --help output. Also: O(n**2) is dict construction, not single insertion.

author	Georg Brandl <georg@python.org>
date	Tue, 21 Feb 2012 22:36:27 +0100
parents	f4b7ecf8a5f8
children	e832ffd0388f

rev	line source
19740 8e6e248dfdd8 Change the date field to use $Date$ so it won't be outrageously out of Guido van Rossum <guido@python.org> parents: 19739 diff changeset	1 .TH PYTHON "1" "$Date$"
33685 9a38625fa2b0 Add helpful comment Andrew M. Kuchling <amk@amk.ca> parents: 33684 diff changeset	2
52363 daf661d05442 Merged revisions 70518,70521,70590,70594-70595 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 51805 diff changeset	3 .\" To view this file while editing, run it through groff:
daf661d05442 Merged revisions 70518,70521,70590,70594-70595 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 51805 diff changeset	4 .\" groff -Tascii -man python.man \| less
33685 9a38625fa2b0 Add helpful comment Andrew M. Kuchling <amk@amk.ca> parents: 33684 diff changeset	5
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	6 .SH NAME
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	7 python \- an interpreted, interactive, object-oriented programming language
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	8 .SH SYNOPSIS
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	9 .B python
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	10 [
58612 ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	11 .B \-B
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	12 ]
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	13 [
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	14 .B \-d
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	15 ]
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	16 [
19739 8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	17 .B \-E
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	18 ]
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	19 [
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	20 .B \-h
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	21 ]
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	22 [
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	23 .B \-i
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	24 ]
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	25 [
33682 37c65a6b2ef7 Add -m to man page Andrew M. Kuchling <amk@amk.ca> parents: 29264 diff changeset	26 .B \-m
37c65a6b2ef7 Add -m to man page Andrew M. Kuchling <amk@amk.ca> parents: 29264 diff changeset	27 .I module-name
37c65a6b2ef7 Add -m to man page Andrew M. Kuchling <amk@amk.ca> parents: 29264 diff changeset	28 ]
58612 ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	29 .br
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	30 [
6273 4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	31 .B \-O
4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	32 ]
58612 ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	33 [
69733 c57fdce01eb8 #11971: fix man page; it's -OO not -O0 R David Murray <rdmurray@bitdance.com> parents: 65273 diff changeset	34 .B \-OO
58612 ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	35 ]
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	36 [
75066 f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	37 .B \-R
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	38 ]
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	39 [
19739 8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	40 .B -Q
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	41 .I argument
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	42 ]
6273 4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	43 [
58612 ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	44 .B \-s
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	45 ]
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	46 [
6273 4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	47 .B \-S
4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	48 ]
4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	49 [
1601 57b9b77da21b Documented -u (unbuffered), undocumented -k (killprint) Guido van Rossum <guido@python.org> parents: 1559 diff changeset	50 .B \-u
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	51 ]
19739 8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	52 .br
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	53 [
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	54 .B \-v
14602 24fbbf13daa5 Describe the -h and -V flags. Closes patch #101496 Barry Warsaw <barry@python.org> parents: 14360 diff changeset	55 ]
24fbbf13daa5 Describe the -h and -V flags. Closes patch #101496 Barry Warsaw <barry@python.org> parents: 14360 diff changeset	56 [
24fbbf13daa5 Describe the -h and -V flags. Closes patch #101496 Barry Warsaw <barry@python.org> parents: 14360 diff changeset	57 .B \-V
24fbbf13daa5 Describe the -h and -V flags. Closes patch #101496 Barry Warsaw <barry@python.org> parents: 14360 diff changeset	58 ]
15612 e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	59 [
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	60 .B \-W
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	61 .I argument
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	62 ]
19739 8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	63 [
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	64 .B \-x
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	65 ]
58612 ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	66 [
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	67 .B \-?
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	68 ]
6273 4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	69 .br
4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	70 [
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	71 .B \-c
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	72 .I command
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	73 \|
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	74 .I script
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	75 \|
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	76 \-
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	77 ]
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	78 [
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	79 .I arguments
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	80 ]
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	81 .SH DESCRIPTION
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	82 Python is an interpreted, interactive, object-oriented programming
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	83 language that combines remarkable power with very clear syntax.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	84 For an introduction to programming in Python you are referred to the
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	85 Python Tutorial.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	86 The Python Library Reference documents built-in and standard types,
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	87 constants, functions and modules.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	88 Finally, the Python Reference Manual describes the syntax and
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	89 semantics of the core language in (perhaps too) much detail.
14360 d1d5e2dc29db Clean up a bit. Drop -X option, update date, remove documentation Guido van Rossum <guido@python.org> parents: 13255 diff changeset	90 (These documents may be located via the
d1d5e2dc29db Clean up a bit. Drop -X option, update date, remove documentation Guido van Rossum <guido@python.org> parents: 13255 diff changeset	91 .B "INTERNET RESOURCES"
11214 96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	92 below; they may be installed on your system as well.)
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	93 .PP
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	94 Python's basic power can be extended with your own modules written in
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	95 C or C++.
3875 2838db83d0ed Got rid of all references to stdwin. Guido van Rossum <guido@python.org> parents: 2068 diff changeset	96 On most systems such modules may be dynamically loaded.
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	97 Python is also adaptable as an extension language for existing
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	98 applications.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	99 See the internal documentation for hints.
17315 6be8bb4808e1 Mention pydoc in the man page Andrew M. Kuchling <amk@amk.ca> parents: 15612 diff changeset	100 .PP
6be8bb4808e1 Mention pydoc in the man page Andrew M. Kuchling <amk@amk.ca> parents: 15612 diff changeset	101 Documentation for installed Python modules and packages can be
6be8bb4808e1 Mention pydoc in the man page Andrew M. Kuchling <amk@amk.ca> parents: 15612 diff changeset	102 viewed by running the
6be8bb4808e1 Mention pydoc in the man page Andrew M. Kuchling <amk@amk.ca> parents: 15612 diff changeset	103 .B pydoc
6be8bb4808e1 Mention pydoc in the man page Andrew M. Kuchling <amk@amk.ca> parents: 15612 diff changeset	104 program.
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	105 .SH COMMAND LINE OPTIONS
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	106 .TP
58612 ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	107 .B \-B
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	108 Don't write
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	109 .I .py[co]
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	110 files on import. See also PYTHONDONTWRITEBYTECODE.
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	111 .TP
19739 8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	112 .BI "\-c " command
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	113 Specify the command to execute (see next section).
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	114 This terminates the option list (following options are passed as
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	115 arguments to the command).
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	116 .TP
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	117 .B \-d
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	118 Turn on parser debugging output (for wizards only, depending on
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	119 compilation options).
1559 df0fb788c0c1 Fix weird messed up paragraphs Guido van Rossum <guido@python.org> parents: 1529 diff changeset	120 .TP
19739 8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	121 .B \-E
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	122 Ignore environment variables like PYTHONPATH and PYTHONHOME that modify
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	123 the behavior of the interpreter.
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	124 .TP
58612 ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	125 .B \-h ", " \-? ", "\-\-help
19739 8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	126 Prints the usage for the interpreter executable and exits.
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	127 .TP
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	128 .B \-i
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	129 When a script is passed as first argument or the \fB\-c\fP option is
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	130 used, enter interactive mode after executing the script or the
1559 df0fb788c0c1 Fix weird messed up paragraphs Guido van Rossum <guido@python.org> parents: 1529 diff changeset	131 command. It does not read the $PYTHONSTARTUP file. This can be
df0fb788c0c1 Fix weird messed up paragraphs Guido van Rossum <guido@python.org> parents: 1529 diff changeset	132 useful to inspect global variables or a stack trace when a script
df0fb788c0c1 Fix weird messed up paragraphs Guido van Rossum <guido@python.org> parents: 1529 diff changeset	133 raises an exception.
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	134 .TP
33682 37c65a6b2ef7 Add -m to man page Andrew M. Kuchling <amk@amk.ca> parents: 29264 diff changeset	135 .BI "\-m " module-name
37c65a6b2ef7 Add -m to man page Andrew M. Kuchling <amk@amk.ca> parents: 29264 diff changeset	136 Searches
37c65a6b2ef7 Add -m to man page Andrew M. Kuchling <amk@amk.ca> parents: 29264 diff changeset	137 .I sys.path
37c65a6b2ef7 Add -m to man page Andrew M. Kuchling <amk@amk.ca> parents: 29264 diff changeset	138 for the named module and runs the corresponding
37c65a6b2ef7 Add -m to man page Andrew M. Kuchling <amk@amk.ca> parents: 29264 diff changeset	139 .I .py
37c65a6b2ef7 Add -m to man page Andrew M. Kuchling <amk@amk.ca> parents: 29264 diff changeset	140 file as a script.
37c65a6b2ef7 Add -m to man page Andrew M. Kuchling <amk@amk.ca> parents: 29264 diff changeset	141 .TP
6273 4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	142 .B \-O
4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	143 Turn on basic optimizations. This changes the filename extension for
4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	144 compiled (bytecode) files from
4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	145 .I .pyc
11214 96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	146 to \fI.pyo\fP. Given twice, causes docstrings to be discarded.
6273 4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	147 .TP
69733 c57fdce01eb8 #11971: fix man page; it's -OO not -O0 R David Murray <rdmurray@bitdance.com> parents: 65273 diff changeset	148 .B \-OO
58612 ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	149 Discard docstrings in addition to the \fB-O\fP optimizations.
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	150 .TP
75066 f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	151 .B \-R
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	152 Turn on "hash randomization", so that the hash() values of str, bytes and
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	153 datetime objects are "salted" with an unpredictable pseudo-random value.
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	154 Although they remain constant within an individual Python process, they are
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	155 not predictable between repeated invocations of Python.
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	156 .IP
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	157 This is intended to provide protection against a denial of service
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	158 caused by carefully-chosen inputs that exploit the worst case performance
75155 358aee0a9ad5 Remove reST markup from --help output. Also: O(n*2) is dict construction, not single insertion. Georg Brandl <georg@python.org>* parents: 75066 diff changeset	159 of a dict construction, O(n^2) complexity. See
75066 f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	160 http://www.ocert.org/advisories/ocert-2011-003.html
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	161 for details.
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	162 .TP
19739 8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	163 .BI "\-Q " argument
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	164 Division control; see PEP 238. The argument must be one of "old" (the
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	165 default, int/int and long/long return an int or long), "new" (new
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	166 division semantics, i.e. int/int and long/long returns a float),
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	167 "warn" (old division semantics with a warning for int/int and
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	168 long/long), or "warnall" (old division semantics with a warning for
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	169 all use of the division operator). For a use of "warnall", see the
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	170 Tools/scripts/fixdiv.py script.
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	171 .TP
58612 ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	172 .B \-s
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	173 Don't add user site directory to sys.path.
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	174 .TP
6273 4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	175 .B \-S
4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	176 Disable the import of the module
4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	177 .I site
4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	178 and the site-dependent manipulations of
4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	179 .I sys.path
4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	180 that it entails.
4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	181 .TP
1601 57b9b77da21b Documented -u (unbuffered), undocumented -k (killprint) Guido van Rossum <guido@python.org> parents: 1559 diff changeset	182 .B \-u
65111 a4c9746cb03c Merged revisions 78959,79170,79175,79177,79180,79183,79186,79193,79581 via svnmerge from Georg Brandl <georg@python.org> parents: 58612 diff changeset	183 Force the binary I/O layers of stdin, stdout and stderr to be unbuffered.
a4c9746cb03c Merged revisions 78959,79170,79175,79177,79180,79183,79186,79193,79581 via svnmerge from Georg Brandl <georg@python.org> parents: 58612 diff changeset	184 The text I/O layer will still be line-buffered.
a4c9746cb03c Merged revisions 78959,79170,79175,79177,79180,79183,79186,79193,79581 via svnmerge from Georg Brandl <georg@python.org> parents: 58612 diff changeset	185 .\" Note that there is internal buffering in readlines() and
a4c9746cb03c Merged revisions 78959,79170,79175,79177,79180,79183,79186,79193,79581 via svnmerge from Georg Brandl <georg@python.org> parents: 58612 diff changeset	186 .\" file-object iterators ("for line in sys.stdin") which is not
a4c9746cb03c Merged revisions 78959,79170,79175,79177,79180,79183,79186,79193,79581 via svnmerge from Georg Brandl <georg@python.org> parents: 58612 diff changeset	187 .\" influenced by this option. To work around this, you will want to use
a4c9746cb03c Merged revisions 78959,79170,79175,79177,79180,79183,79186,79193,79581 via svnmerge from Georg Brandl <georg@python.org> parents: 58612 diff changeset	188 .\" "sys.stdin.readline()" inside a "while 1:" loop.
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	189 .TP
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	190 .B \-v
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	191 Print a message each time a module is initialized, showing the place
11214 96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	192 (filename or built-in module) from which it is loaded. When given
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	193 twice, print a message for each file that is checked for when
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	194 searching for a module. Also provides information on module cleanup
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	195 at exit.
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	196 .TP
58612 ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	197 .B \-V ", " \-\-version
14602 24fbbf13daa5 Describe the -h and -V flags. Closes patch #101496 Barry Warsaw <barry@python.org> parents: 14360 diff changeset	198 Prints the Python version number of the executable and exits.
24fbbf13daa5 Describe the -h and -V flags. Closes patch #101496 Barry Warsaw <barry@python.org> parents: 14360 diff changeset	199 .TP
15612 e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	200 .BI "\-W " argument
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	201 Warning control. Python sometimes prints warning message to
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	202 .IR sys.stderr .
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	203 A typical warning message has the following form:
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	204 .IB file ":" line ": " category ": " message.
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	205 By default, each warning is printed once for each source line where it
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	206 occurs. This option controls how often warnings are printed.
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	207 Multiple
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	208 .B \-W
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	209 options may be given; when a warning matches more than one
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	210 option, the action for the last matching option is performed.
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	211 Invalid
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	212 .B \-W
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	213 options are ignored (a warning message is printed about invalid
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	214 options when the first warning is issued). Warnings can also be
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	215 controlled from within a Python program using the
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	216 .I warnings
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	217 module.
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	218
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	219 The simplest form of
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	220 .I argument
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	221 is one of the following
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	222 .I action
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	223 strings (or a unique abbreviation):
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	224 .B ignore
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	225 to ignore all warnings;
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	226 .B default
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	227 to explicitly request the default behavior (printing each warning once
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	228 per source line);
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	229 .B all
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	230 to print a warning each time it occurs (this may generate many
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	231 messages if a warning is triggered repeatedly for the same source
18844 045f55135ad0 Document the PYTHONY2K environment variable that had been left out of this Fred Drake <fdrake@acm.org> parents: 18808 diff changeset	232 line, such as inside a loop);
15612 e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	233 .B module
54841 f6cb2932022c Merged revisions 73544 via svnmerge from Georg Brandl <georg@python.org> parents: 52363 diff changeset	234 to print each warning only the first time it occurs in each
15612 e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	235 module;
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	236 .B once
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	237 to print each warning only the first time it occurs in the program; or
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	238 .B error
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	239 to raise an exception instead of printing a warning message.
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	240
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	241 The full form of
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	242 .I argument
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	243 is
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	244 .IB action : message : category : module : line.
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	245 Here,
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	246 .I action
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	247 is as explained above but only applies to messages that match the
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	248 remaining fields. Empty fields match all values; trailing empty
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	249 fields may be omitted. The
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	250 .I message
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	251 field matches the start of the warning message printed; this match is
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	252 case-insensitive. The
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	253 .I category
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	254 field matches the warning category. This must be a class name; the
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	255 match test whether the actual warning category of the message is a
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	256 subclass of the specified warning category. The full class name must
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	257 be given. The
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	258 .I module
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	259 field matches the (fully-qualified) module name; this match is
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	260 case-sensitive. The
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	261 .I line
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	262 field matches the line number, where zero matches all line numbers and
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	263 is thus equivalent to an omitted line number.
e57f93ae4fe9 Document the -W option as best as I can. Guido van Rossum <guido@python.org> parents: 14602 diff changeset	264 .TP
19739 8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	265 .B \-x
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	266 Skip the first line of the source. This is intended for a DOS
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	267 specific hack only. Warning: the line numbers in error messages will
8d2c7436b9d2 Document -Q. Move arguments around to be in strict alphabetical Guido van Rossum <guido@python.org> parents: 18844 diff changeset	268 be off by one!
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	269 .SH INTERPRETER INTERFACE
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	270 The interpreter interface resembles that of the UNIX shell: when
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	271 called with standard input connected to a tty device, it prompts for
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	272 commands and executes them until an EOF is read; when called with a
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	273 file name argument or with a file as standard input, it reads and
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	274 executes a
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	275 .I script
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	276 from that file;
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	277 when called with
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	278 .B \-c
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	279 .I command,
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	280 it executes the Python statement(s) given as
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	281 .I command.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	282 Here
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	283 .I command
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	284 may contain multiple statements separated by newlines.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	285 Leading whitespace is significant in Python statements!
34779 997b255e1ccc fix two typos in python(1) Matthias Klose <doko@ubuntu.com> parents: 33685 diff changeset	286 In non-interactive mode, the entire input is parsed before it is
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	287 executed.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	288 .PP
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	289 If available, the script name and additional arguments thereafter are
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	290 passed to the script in the Python variable
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	291 .I sys.argv ,
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	292 which is a list of strings (you must first
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	293 .I import sys
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	294 to be able to access it).
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	295 If no script name is given,
14360 d1d5e2dc29db Clean up a bit. Drop -X option, update date, remove documentation Guido van Rossum <guido@python.org> parents: 13255 diff changeset	296 .I sys.argv[0]
d1d5e2dc29db Clean up a bit. Drop -X option, update date, remove documentation Guido van Rossum <guido@python.org> parents: 13255 diff changeset	297 is an empty string; if
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	298 .B \-c
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	299 is used,
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	300 .I sys.argv[0]
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	301 contains the string
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	302 .I '-c'.
3875 2838db83d0ed Got rid of all references to stdwin. Guido van Rossum <guido@python.org> parents: 2068 diff changeset	303 Note that options interpreted by the Python interpreter itself
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	304 are not placed in
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	305 .I sys.argv.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	306 .PP
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	307 In interactive mode, the primary prompt is `>>>'; the second prompt
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	308 (which appears when a command is not complete) is `...'.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	309 The prompts can be changed by assignment to
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	310 .I sys.ps1
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	311 or
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	312 .I sys.ps2.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	313 The interpreter quits when it reads an EOF at a prompt.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	314 When an unhandled exception occurs, a stack trace is printed and
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	315 control returns to the primary prompt; in non-interactive mode, the
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	316 interpreter exits after printing the stack trace.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	317 The interrupt signal raises the
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	318 .I Keyboard\%Interrupt
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	319 exception; other UNIX signals are not caught (except that SIGPIPE is
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	320 sometimes ignored, in favor of the
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	321 .I IOError
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	322 exception). Error messages are written to stderr.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	323 .SH FILES AND DIRECTORIES
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	324 These are subject to difference depending on local installation
11214 96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	325 conventions; ${prefix} and ${exec_prefix} are installation-dependent
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	326 and should be interpreted as for GNU software; they may be the same.
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	327 The default for both is \fI/usr/local\fP.
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	328 .IP \fI${exec_prefix}/bin/python\fP
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	329 Recommended location of the interpreter.
11214 96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	330 .PP
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	331 .I ${prefix}/lib/python<version>
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	332 .br
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	333 .I ${exec_prefix}/lib/python<version>
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	334 .RS
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	335 Recommended locations of the directories containing the standard
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	336 modules.
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	337 .RE
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	338 .PP
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	339 .I ${prefix}/include/python<version>
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	340 .br
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	341 .I ${exec_prefix}/include/python<version>
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	342 .RS
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	343 Recommended locations of the directories containing the include files
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	344 needed for developing Python extensions and embedding the
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	345 interpreter.
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	346 .RE
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	347 .SH ENVIRONMENT VARIABLES
6273 4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	348 .IP PYTHONHOME
4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	349 Change the location of the standard Python libraries. By default, the
11214 96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	350 libraries are searched in ${prefix}/lib/python<version> and
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	351 ${exec_prefix}/lib/python<version>, where ${prefix} and ${exec_prefix}
6273 4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	352 are installation-dependent directories, both defaulting to
11214 96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	353 \fI/usr/local\fP. When $PYTHONHOME is set to a single directory, its value
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	354 replaces both ${prefix} and ${exec_prefix}. To specify different values
96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	355 for these, set $PYTHONHOME to ${prefix}:${exec_prefix}.
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	356 .IP PYTHONPATH
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	357 Augments the default search path for module files.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	358 The format is the same as the shell's $PATH: one or more directory
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	359 pathnames separated by colons.
34779 997b255e1ccc fix two typos in python(1) Matthias Klose <doko@ubuntu.com> parents: 33685 diff changeset	360 Non-existent directories are silently ignored.
6273 4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	361 The default search path is installation dependent, but generally
11214 96501cc3a663 Various updates, mostly to add information to the SEE ALSO and Fred Drake <fdrake@acm.org> parents: 7968 diff changeset	362 begins with ${prefix}/lib/python<version> (see PYTHONHOME above).
6273 4333775b55fd Brought up to date with new options and env vars. Guido van Rossum <guido@python.org> parents: 5876 diff changeset	363 The default search path is always appended to $PYTHONPATH.
3875 2838db83d0ed Got rid of all references to stdwin. Guido van Rossum <guido@python.org> parents: 2068 diff changeset	364 If a script argument is given, the directory containing the script is
2838db83d0ed Got rid of all references to stdwin. Guido van Rossum <guido@python.org> parents: 2068 diff changeset	365 inserted in the path in front of $PYTHONPATH.
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	366 The search path can be manipulated from within a Python program as the
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	367 variable
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	368 .I sys.path .
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	369 .IP PYTHONSTARTUP
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	370 If this is the name of a readable file, the Python commands in that
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	371 file are executed before the first prompt is displayed in interactive
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	372 mode.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	373 The file is executed in the same name space where interactive commands
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	374 are executed so that objects defined or imported in it can be used
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	375 without qualification in the interactive session.
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	376 You can also change the prompts
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	377 .I sys.ps1
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	378 and
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	379 .I sys.ps2
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	380 in this file.
18844 045f55135ad0 Document the PYTHONY2K environment variable that had been left out of this Fred Drake <fdrake@acm.org> parents: 18808 diff changeset	381 .IP PYTHONY2K
045f55135ad0 Document the PYTHONY2K environment variable that had been left out of this Fred Drake <fdrake@acm.org> parents: 18808 diff changeset	382 Set this to a non-empty string to cause the \fItime\fP module to
045f55135ad0 Document the PYTHONY2K environment variable that had been left out of this Fred Drake <fdrake@acm.org> parents: 18808 diff changeset	383 require dates specified as strings to include 4-digit years, otherwise
045f55135ad0 Document the PYTHONY2K environment variable that had been left out of this Fred Drake <fdrake@acm.org> parents: 18808 diff changeset	384 2-digit years are converted based on rules described in the \fItime\fP
23406 e0ed68adba33 Fix typo Andrew M. Kuchling <amk@amk.ca> parents: 20401 diff changeset	385 module documentation.
20401 b74610c92d8b SF patch #467455 : Enhanced environment variables, by Toby Dickenson. Guido van Rossum <guido@python.org> parents: 19740 diff changeset	386 .IP PYTHONOPTIMIZE
b74610c92d8b SF patch #467455 : Enhanced environment variables, by Toby Dickenson. Guido van Rossum <guido@python.org> parents: 19740 diff changeset	387 If this is set to a non-empty string it is equivalent to specifying
b74610c92d8b SF patch #467455 : Enhanced environment variables, by Toby Dickenson. Guido van Rossum <guido@python.org> parents: 19740 diff changeset	388 the \fB\-O\fP option. If set to an integer, it is equivalent to
b74610c92d8b SF patch #467455 : Enhanced environment variables, by Toby Dickenson. Guido van Rossum <guido@python.org> parents: 19740 diff changeset	389 specifying \fB\-O\fP multiple times.
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	390 .IP PYTHONDEBUG
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	391 If this is set to a non-empty string it is equivalent to specifying
20401 b74610c92d8b SF patch #467455 : Enhanced environment variables, by Toby Dickenson. Guido van Rossum <guido@python.org> parents: 19740 diff changeset	392 the \fB\-d\fP option. If set to an integer, it is equivalent to
b74610c92d8b SF patch #467455 : Enhanced environment variables, by Toby Dickenson. Guido van Rossum <guido@python.org> parents: 19740 diff changeset	393 specifying \fB\-d\fP multiple times.
58612 ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	394 .IP PYTHONDONTWRITEBYTECODE
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	395 If this is set to a non-empty string it is equivalent to specifying
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	396 the \fB\-B\fP option (don't try to write
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	397 .I .py[co]
ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	398 files).
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	399 .IP PYTHONINSPECT
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	400 If this is set to a non-empty string it is equivalent to specifying
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	401 the \fB\-i\fP option.
65273 1f225d66941a Merged revisions 85436 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 65111 diff changeset	402 .IP PYTHONIOENCODING
1f225d66941a Merged revisions 85436 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 65111 diff changeset	403 If this is set before running the interpreter, it overrides the encoding used
1f225d66941a Merged revisions 85436 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 65111 diff changeset	404 for stdin/stdout/stderr, in the syntax
1f225d66941a Merged revisions 85436 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 65111 diff changeset	405 .IB encodingname ":" errorhandler
1f225d66941a Merged revisions 85436 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 65111 diff changeset	406 The
1f225d66941a Merged revisions 85436 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 65111 diff changeset	407 .IB errorhandler
1f225d66941a Merged revisions 85436 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 65111 diff changeset	408 part is optional and has the same meaning as in str.encode. For stderr, the
1f225d66941a Merged revisions 85436 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 65111 diff changeset	409 .IB errorhandler
1f225d66941a Merged revisions 85436 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 65111 diff changeset	410 part is ignored; the handler will always be \'backslashreplace\'.
58612 ce0d4dc488d2 Merged revisions 77877 via svnmerge from Matthias Klose <doko@ubuntu.com> parents: 55927 diff changeset	411 .IP PYTHONNOUSERSITE
65273 1f225d66941a Merged revisions 85436 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 65111 diff changeset	412 If this is set to a non-empty string it is equivalent to specifying the
1f225d66941a Merged revisions 85436 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 65111 diff changeset	413 \fB\-s\fP option (Don't add the user site directory to sys.path).
1601 57b9b77da21b Documented -u (unbuffered), undocumented -k (killprint) Guido van Rossum <guido@python.org> parents: 1559 diff changeset	414 .IP PYTHONUNBUFFERED
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	415 If this is set to a non-empty string it is equivalent to specifying
1601 57b9b77da21b Documented -u (unbuffered), undocumented -k (killprint) Guido van Rossum <guido@python.org> parents: 1559 diff changeset	416 the \fB\-u\fP option.
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	417 .IP PYTHONVERBOSE
c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	418 If this is set to a non-empty string it is equivalent to specifying
20401 b74610c92d8b SF patch #467455 : Enhanced environment variables, by Toby Dickenson. Guido van Rossum <guido@python.org> parents: 19740 diff changeset	419 the \fB\-v\fP option. If set to an integer, it is equivalent to
b74610c92d8b SF patch #467455 : Enhanced environment variables, by Toby Dickenson. Guido van Rossum <guido@python.org> parents: 19740 diff changeset	420 specifying \fB\-v\fP multiple times.
75066 f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	421 .IP PYTHONHASHSEED
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	422 If this variable is set to "random", the effect is the same as specifying
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	423 the \fB-R\fP option: a random value is used to seed the hashes of str,
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	424 bytes and datetime objects.
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	425
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	426 If PYTHONHASHSEED is set to an integer value, it is used as a fixed seed for
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	427 generating the hash() of the types covered by the hash randomization. Its
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	428 purpose is to allow repeatable hashing, such as for selftests for the
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	429 interpreter itself, or to allow a cluster of python processes to share hash
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	430 values.
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	431
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	432 The integer must be a decimal number in the range [0,4294967295]. Specifying
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	433 the value 0 will lead to the same hash values as when hash randomization is
f4b7ecf8a5f8 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime) Georg Brandl <georg@python.org> parents: 69733 diff changeset	434 disabled.
1529 c9b3f77e18ba Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	435 .SH AUTHOR
33684 3e6f56e8104a Take out Guido's name and put in the PSF Andrew M. Kuchling <amk@amk.ca> parents: 33683 diff changeset	436 The Python Software Foundation: http://www.python.org/psf
3875 2838db83d0ed Got rid of all references to stdwin. Guido van Rossum <guido@python.org> parents: 2068 diff changeset	437 .SH INTERNET RESOURCES
18844 045f55135ad0 Document the PYTHONY2K environment variable that had been left out of this Fred Drake <fdrake@acm.org> parents: 18808 diff changeset	438 Main website: http://www.python.org/
14360 d1d5e2dc29db Clean up a bit. Drop -X option, update date, remove documentation Guido van Rossum <guido@python.org> parents: 13255 diff changeset	439 .br
55927 8bc4c8cac7d7 Merged revisions 74759-74760 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 54841 diff changeset	440 Documentation: http://docs.python.org/py3k/
14360 d1d5e2dc29db Clean up a bit. Drop -X option, update date, remove documentation Guido van Rossum <guido@python.org> parents: 13255 diff changeset	441 .br
33683 fda36af226fb Update two URLs Andrew M. Kuchling <amk@amk.ca> parents: 33682 diff changeset	442 Developer resources: http://www.python.org/dev/
14360 d1d5e2dc29db Clean up a bit. Drop -X option, update date, remove documentation Guido van Rossum <guido@python.org> parents: 13255 diff changeset	443 .br
55927 8bc4c8cac7d7 Merged revisions 74759-74760 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 54841 diff changeset	444 Downloads: http://python.org/download/
14360 d1d5e2dc29db Clean up a bit. Drop -X option, update date, remove documentation Guido van Rossum <guido@python.org> parents: 13255 diff changeset	445 .br
55927 8bc4c8cac7d7 Merged revisions 74759-74760 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 54841 diff changeset	446 Module repository: http://pypi.python.org/
3875 2838db83d0ed Got rid of all references to stdwin. Guido van Rossum <guido@python.org> parents: 2068 diff changeset	447 .br
18844 045f55135ad0 Document the PYTHONY2K environment variable that had been left out of this Fred Drake <fdrake@acm.org> parents: 18808 diff changeset	448 Newsgroups: comp.lang.python, comp.lang.python.announce
14360 d1d5e2dc29db Clean up a bit. Drop -X option, update date, remove documentation Guido van Rossum <guido@python.org> parents: 13255 diff changeset	449 .SH LICENSING
d1d5e2dc29db Clean up a bit. Drop -X option, update date, remove documentation Guido van Rossum <guido@python.org> parents: 13255 diff changeset	450 Python is distributed under an Open Source license. See the file
d1d5e2dc29db Clean up a bit. Drop -X option, update date, remove documentation Guido van Rossum <guido@python.org> parents: 13255 diff changeset	451 "LICENSE" in the Python source distribution for information on terms &
d1d5e2dc29db Clean up a bit. Drop -X option, update date, remove documentation Guido van Rossum <guido@python.org> parents: 13255 diff changeset	452 conditions for accessing and otherwise using Python and for a
d1d5e2dc29db Clean up a bit. Drop -X option, update date, remove documentation Guido van Rossum <guido@python.org> parents: 13255 diff changeset	453 DISCLAIMER OF ALL WARRANTIES.

Mercurial > cpython-lru_cache-weakref

annotate Misc/python.man @ 75155:358aee0a9ad5 3.1