From 626d92aaea9dbbdd7310682ae8104184e7e5b028 Mon Sep 17 00:00:00 2001
From: Matthias Klose <doko@ubuntu.com>
Date: Sun, 31 Jan 2010 16:05:13 +0000
Subject: - Update python manual page (options -B, -O0, -s, environment
 variables   PYTHONDONTWRITEBYTECODE, PYTHONNOUSERSITE).

---
 Misc/NEWS       |  6 ++++++
 Misc/python.man | 41 ++++++++++++++++++++++++++++++++++++-----
 2 files changed, 42 insertions(+), 5 deletions(-)

diff --git a/Misc/NEWS b/Misc/NEWS
index 056614d..fd99685 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -123,6 +123,12 @@ Tools/Demos
   added to the `Tools/` directory.  They were previously living in the
   sandbox.
 
+Documentation
+-------------
+ 
+- Update python manual page (options -B, -O0, -s, environment variables
+  PYTHONDONTWRITEBYTECODE, PYTHONNOUSERSITE).
+
 
 What's New in Python 2.7 alpha 2?
 =================================
diff --git a/Misc/python.man b/Misc/python.man
index fd9ed45..d981fba 100644
--- a/Misc/python.man
+++ b/Misc/python.man
@@ -8,6 +8,9 @@ python \- an interpreted, interactive, object-oriented programming language
 .SH SYNOPSIS
 .B python
 [
+.B \-B
+]
+[
 .B \-d
 ]
 [
@@ -23,15 +26,21 @@ python \- an interpreted, interactive, object-oriented programming language
 .B \-m 
 .I module-name
 ]
-[
-.B \-O
-]
 .br
        [
+.B \-O
+]
+[
+.B \-O0
+]
+[
 .B -Q
 .I argument
 ]
 [
+.B \-s
+]
+[
 .B \-S
 ]
 [
@@ -57,6 +66,9 @@ python \- an interpreted, interactive, object-oriented programming language
 [
 .B \-3
 ]
+[
+.B \-?
+]
 .br
        [
 .B \-c
@@ -95,6 +107,11 @@ viewed by running the
 program.  
 .SH COMMAND LINE OPTIONS
 .TP
+.B \-B
+Don't write
+.I .py[co]
+files on import. See also PYTHONDONTWRITEBYTECODE.
+.TP
 .BI "\-c " command
 Specify the command to execute (see next section).
 This terminates the option list (following options are passed as
@@ -108,7 +125,7 @@ compilation options).
 Ignore environment variables like PYTHONPATH and PYTHONHOME that modify
 the behavior of the interpreter.
 .TP
-.B \-h
+.B \-h ", " \-? ", "\-\-help
 Prints the usage for the interpreter executable and exits.
 .TP
 .B \-i
@@ -131,6 +148,9 @@ compiled (bytecode) files from
 .I .pyc
 to \fI.pyo\fP.  Given twice, causes docstrings to be discarded.
 .TP
+.B \-O0
+Discard docstrings in addition to the \fB-O\fP optimizations.
+.TP
 .BI "\-Q " argument
 Division control; see PEP 238.  The argument must be one of "old" (the
 default, int/int and long/long return an int or long), "new" (new
@@ -140,6 +160,9 @@ long/long), or "warnall" (old division semantics with a warning for
 all use of the division operator).  For a use of "warnall", see the
 Tools/scripts/fixdiv.py script.
 .TP
+.B \-s
+Don't add user site directory to sys.path.
+.TP
 .B \-S
 Disable the import of the module
 .I site
@@ -167,7 +190,7 @@ twice, print a message for each file that is checked for when
 searching for a module.  Also provides information on module cleanup
 at exit.
 .TP
-.B \-V
+.B \-V ", " \-\-version
 Prints the Python version number of the executable and exits.
 .TP
 .BI "\-W " argument
@@ -370,9 +393,17 @@ specifying \fB\-O\fP multiple times.
 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 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 PYTHONUNBUFFERED
 If this is set to a non-empty string it is equivalent to specifying
 the \fB\-u\fP option.
-- 
cgit v0.12