1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
From 1afe878ce77c1208e66501b0a05ae8ae3a94d1ac Mon Sep 17 00:00:00 2001
From: Stefano Rivera <stefano@rivera.za.net>
Date: Wed, 9 Apr 2025 19:57:08 -0400
Subject: [PATCH] Manpage formatting tweaks
Following on from GH-132291 this is the second part of the patch from
https://bugs.debian.org/1101406
This tweaks the formatting of a few bits of the manpage.
Forwarded: https://github.com/python/cpython/pull/132338
Bug-Debian: https://bugs.debian.org/1101406
---
Misc/python.man | 36 +++++++++++++++++++-----------------
1 file changed, 19 insertions(+), 17 deletions(-)
--- a/Misc/python.man
+++ b/Misc/python.man
@@ -162,7 +162,7 @@
Ignore environment variables like PYTHONPATH and PYTHONHOME that modify
the behavior of the interpreter.
.TP
-.B \-h ", " \-? ", "\-\-help
+.BR \-h ", " \-? ", " \-\-help
Prints the usage for the interpreter executable and exits.
.TP
.B "\-\-help\-env"
@@ -171,7 +171,6 @@
.B "\-\-help\-xoptions"
Prints help about implementation-specific \fB\-X\fP options and exits.
.TP
-.TP
.B "\-\-help\-all"
Prints complete usage information and exits.
.TP
@@ -243,7 +242,7 @@
searching for a module. Also provides information on module cleanup
at exit.
.TP
-.B \-V ", " \-\-version
+.BR \-V ", " \-\-version
Prints the Python version number of the executable and exits. When given
twice, print more information about the build.
@@ -256,22 +255,24 @@
The simplest settings apply a particular action unconditionally to all warnings
emitted by a process (even those that are otherwise ignored by default):
- -Wdefault # Warn once per call location
- -Werror # Convert to exceptions
- -Walways # Warn every time
- -Wall # Same as -Walways
- -Wmodule # Warn once per calling module
- -Wonce # Warn once per Python process
- -Wignore # Never warn
+.nf
+ \-Wdefault # Warn once per call location
+ \-Werror # Convert to exceptions
+ \-Walways # Warn every time
+ \-Wall # Same as \-Walways
+ \-Wmodule # Warn once per calling module
+ \-Wonce # Warn once per Python process
+ \-Wignore # Never warn
+.fi
The action names can be abbreviated as desired and the interpreter will resolve
them to the appropriate action name. For example,
.B \-Wi
is the same as
-.B \-Wignore .
+.BR \-Wignore .
The full form of argument is:
-.IB action:message:category:module:lineno
+.IB action : message : category : module : lineno
Empty fields match all values; trailing empty fields may be omitted. For
example
@@ -320,7 +321,7 @@
.TP
.BI "\-X " option
Set implementation-specific option. The following options are available:
-
+.nf
\fB\-X cpu_count=\fIN\fR: override the return value of \fIos.cpu_count()\fR;
\fB\-X cpu_count=default\fR cancels overriding; also \fBPYTHON_CPU_COUNT\fI
@@ -395,6 +396,7 @@
automatically). See \fBPYTHONUTF8\fR for more details
\fB\-X warn_default_encoding\fR: enable opt-in EncodingWarning for 'encoding=None'
+.fi
.TP
.B \-x
@@ -434,7 +436,7 @@
is used,
.I sys.argv[0]
contains the string
-.I '\-c'.
+.RI ' \-c "' ."
Note that options interpreted by the Python interpreter itself
are not placed in
.IR sys.argv .
@@ -561,8 +563,8 @@
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.
+The integer must be a decimal number in the range [0,4\|294\|967\|295].
+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<version> and
@@ -584,7 +586,7 @@
.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
+.IB encodingname : errorhandler
The
.IB errorhandler
part is optional and has the same meaning as in str.encode. For stderr, the
|
