Document the -W option as best as I can.
Get rid of BeOpen references.
diff --git a/Misc/python.man b/Misc/python.man
index a23ae0e..529046f 100644
--- a/Misc/python.man
+++ b/Misc/python.man
@@ -33,6 +33,10 @@
[
.B \-V
]
+[
+.B \-W
+.I argument
+]
.br
[
.B \-c
@@ -116,6 +120,71 @@
.B \-V
Prints the Python version number of the executable and exits.
.TP
+.BI "\-W " argument
+Warning control. Python sometimes prints warning message to
+.IR sys.stderr .
+A typical warning message has the following form:
+.IB file ":" line ": " category ": " message.
+By default, each warning is printed once for each source line where it
+occurs. This option controls how often warnings are printed.
+Multiple
+.B \-W
+options may be given; when a warning matches more than one
+option, the action for the last matching option is performed.
+Invalid
+.B \-W
+options are ignored (a warning message is printed about invalid
+options when the first warning is issued). Warnings can also be
+controlled from within a Python program using the
+.I warnings
+module.
+
+The simplest form of
+.I argument
+is one of the following
+.I action
+strings (or a unique abbreviation):
+.B ignore
+to ignore all warnings;
+.B default
+to explicitly request the default behavior (printing each warning once
+per source line);
+.B all
+to print a warning each time it occurs (this may generate many
+messages if a warning is triggered repeatedly for the same source
+line, e.g. inside a loop);
+.B module
+to print each warning only only the first time it occurs in each
+module;
+.B once
+to print each warning only the first time it occurs in the program; or
+.B error
+to raise an exception instead of printing a warning message.
+
+The full form of
+.I argument
+is
+.IB action : message : category : module : line.
+Here,
+.I action
+is as explained above but only applies to messages that match the
+remaining fields. Empty fields match all values; trailing empty
+fields may be omitted. The
+.I message
+field matches the start of the warning message printed; this match is
+case-insensitive. The
+.I category
+field matches the warning category. This must be a class name; the
+match test whether the actual warning category of the message is a
+subclass of the specified warning category. The full class name must
+be given. The
+.I module
+field matches the (fully-qualified) module name; this match is
+case-sensitive. The
+.I line
+field matches the line number, where zero matches all line numbers and
+is thus equivalent to an omitted line number.
+.TP
.BI "\-c " command
Specify the command to execute (see next section).
This terminates the option list (following options are passed as
@@ -250,20 +319,14 @@
.SH AUTHOR
.nf
Guido van Rossum
-BeOpen.com
-160 Saratoga Avenue
-Santa Clara, CA 95051
-USA
.PP
-E-mail: guido@beopen.com, guido@python.org
+E-mail: guido@python.org
.fi
.PP
And a cast of thousands.
.SH INTERNET RESOURCES
Main website: http://www.python.org
.br
-BeOpen development team: http://pythonlabs.com
-.br
Community website: http://starship.python.net
.br
Developer resources: