Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 575e4ca

Browse files
github-actions[bot]mattwang44
authored andcommitted
sync with cpython 817190c3
1 parent 0f7f31f commit 575e4ca

File tree

4 files changed

+169
-147
lines changed

4 files changed

+169
-147
lines changed

library/faulthandler.po

Lines changed: 55 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ msgid ""
66
msgstr ""
77
"Project-Id-Version: Python 3.12\n"
88
"Report-Msgid-Bugs-To: \n"
9-
"POT-Creation-Date: 2024-04-18 00:04+0000\n"
9+
"POT-Creation-Date: 2024-04-29 00:04+0000\n"
1010
"PO-Revision-Date: 2018-05-23 16:01+0000\n"
1111
"Last-Translator: Adrian Liaw <[email protected]>\n"
1212
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -25,215 +25,216 @@ msgstr ""
2525
msgid ""
2626
"This module contains functions to dump Python tracebacks explicitly, on a "
2727
"fault, after a timeout, or on a user signal. Call :func:`faulthandler."
28-
"enable` to install fault handlers for the :const:`SIGSEGV`, :const:"
29-
"`SIGFPE`, :const:`SIGABRT`, :const:`SIGBUS`, and :const:`SIGILL` signals. "
30-
"You can also enable them at startup by setting the :envvar:"
31-
"`PYTHONFAULTHANDLER` environment variable or by using the :option:`-X` "
32-
"``faulthandler`` command line option."
28+
"enable` to install fault handlers for the :const:`~signal.SIGSEGV`, :const:"
29+
"`~signal.SIGFPE`, :const:`~signal.SIGABRT`, :const:`~signal.SIGBUS`, and :"
30+
"const:`~signal.SIGILL` signals. You can also enable them at startup by "
31+
"setting the :envvar:`PYTHONFAULTHANDLER` environment variable or by using "
32+
"the :option:`-X` ``faulthandler`` command line option."
3333
msgstr ""
3434

35-
#: ../../library/faulthandler.rst:18
35+
#: ../../library/faulthandler.rst:19
3636
msgid ""
3737
"The fault handler is compatible with system fault handlers like Apport or "
3838
"the Windows fault handler. The module uses an alternative stack for signal "
39-
"handlers if the :c:func:`sigaltstack` function is available. This allows it "
39+
"handlers if the :c:func:`!sigaltstack` function is available. This allows it "
4040
"to dump the traceback even on a stack overflow."
4141
msgstr ""
4242

43-
#: ../../library/faulthandler.rst:23
43+
#: ../../library/faulthandler.rst:24
4444
msgid ""
4545
"The fault handler is called on catastrophic cases and therefore can only use "
4646
"signal-safe functions (e.g. it cannot allocate memory on the heap). Because "
4747
"of this limitation traceback dumping is minimal compared to normal Python "
4848
"tracebacks:"
4949
msgstr ""
5050

51-
#: ../../library/faulthandler.rst:28
51+
#: ../../library/faulthandler.rst:29
5252
msgid ""
5353
"Only ASCII is supported. The ``backslashreplace`` error handler is used on "
5454
"encoding."
5555
msgstr ""
5656

57-
#: ../../library/faulthandler.rst:30
57+
#: ../../library/faulthandler.rst:31
5858
msgid "Each string is limited to 500 characters."
5959
msgstr ""
6060

61-
#: ../../library/faulthandler.rst:31
61+
#: ../../library/faulthandler.rst:32
6262
msgid ""
6363
"Only the filename, the function name and the line number are displayed. (no "
6464
"source code)"
6565
msgstr ""
6666

67-
#: ../../library/faulthandler.rst:33
67+
#: ../../library/faulthandler.rst:34
6868
msgid "It is limited to 100 frames and 100 threads."
6969
msgstr ""
7070

71-
#: ../../library/faulthandler.rst:34
71+
#: ../../library/faulthandler.rst:35
7272
msgid "The order is reversed: the most recent call is shown first."
7373
msgstr ""
7474

75-
#: ../../library/faulthandler.rst:36
75+
#: ../../library/faulthandler.rst:37
7676
msgid ""
7777
"By default, the Python traceback is written to :data:`sys.stderr`. To see "
7878
"tracebacks, applications must be run in the terminal. A log file can "
7979
"alternatively be passed to :func:`faulthandler.enable`."
8080
msgstr ""
8181

82-
#: ../../library/faulthandler.rst:40
82+
#: ../../library/faulthandler.rst:41
8383
msgid ""
8484
"The module is implemented in C, so tracebacks can be dumped on a crash or "
8585
"when Python is deadlocked."
8686
msgstr ""
8787

88-
#: ../../library/faulthandler.rst:43
88+
#: ../../library/faulthandler.rst:44
8989
msgid ""
9090
"The :ref:`Python Development Mode <devmode>` calls :func:`faulthandler."
9191
"enable` at Python startup."
9292
msgstr ""
9393

94-
#: ../../library/faulthandler.rst:48
94+
#: ../../library/faulthandler.rst:49
9595
msgid "Module :mod:`pdb`"
9696
msgstr ":mod:`pdb` 模組"
9797

98-
#: ../../library/faulthandler.rst:49
98+
#: ../../library/faulthandler.rst:50
9999
msgid "Interactive source code debugger for Python programs."
100100
msgstr ""
101101

102-
#: ../../library/faulthandler.rst:51
102+
#: ../../library/faulthandler.rst:52
103103
msgid "Module :mod:`traceback`"
104104
msgstr ":mod:`traceback` 模組"
105105

106-
#: ../../library/faulthandler.rst:52
106+
#: ../../library/faulthandler.rst:53
107107
msgid ""
108108
"Standard interface to extract, format and print stack traces of Python "
109109
"programs."
110110
msgstr ""
111111

112-
#: ../../library/faulthandler.rst:55
112+
#: ../../library/faulthandler.rst:56
113113
msgid "Dumping the traceback"
114114
msgstr ""
115115

116-
#: ../../library/faulthandler.rst:59
116+
#: ../../library/faulthandler.rst:60
117117
msgid ""
118118
"Dump the tracebacks of all threads into *file*. If *all_threads* is "
119119
"``False``, dump only the current thread."
120120
msgstr ""
121121

122-
#: ../../library/faulthandler.rst:62
122+
#: ../../library/faulthandler.rst:63
123123
msgid ""
124124
":func:`traceback.print_tb`, which can be used to print a traceback object."
125125
msgstr ""
126126

127-
#: ../../library/faulthandler.rst:64 ../../library/faulthandler.rst:82
128-
#: ../../library/faulthandler.rst:121 ../../library/faulthandler.rst:146
127+
#: ../../library/faulthandler.rst:65 ../../library/faulthandler.rst:84
128+
#: ../../library/faulthandler.rst:123 ../../library/faulthandler.rst:148
129129
msgid "Added support for passing file descriptor to this function."
130130
msgstr ""
131131

132-
#: ../../library/faulthandler.rst:69
132+
#: ../../library/faulthandler.rst:70
133133
msgid "Fault handler state"
134134
msgstr ""
135135

136-
#: ../../library/faulthandler.rst:73
136+
#: ../../library/faulthandler.rst:74
137137
msgid ""
138-
"Enable the fault handler: install handlers for the :const:`SIGSEGV`, :const:"
139-
"`SIGFPE`, :const:`SIGABRT`, :const:`SIGBUS` and :const:`SIGILL` signals to "
140-
"dump the Python traceback. If *all_threads* is ``True``, produce tracebacks "
141-
"for every running thread. Otherwise, dump only the current thread."
138+
"Enable the fault handler: install handlers for the :const:`~signal."
139+
"SIGSEGV`, :const:`~signal.SIGFPE`, :const:`~signal.SIGABRT`, :const:`~signal."
140+
"SIGBUS` and :const:`~signal.SIGILL` signals to dump the Python traceback. If "
141+
"*all_threads* is ``True``, produce tracebacks for every running thread. "
142+
"Otherwise, dump only the current thread."
142143
msgstr ""
143144

144-
#: ../../library/faulthandler.rst:79
145+
#: ../../library/faulthandler.rst:81
145146
msgid ""
146147
"The *file* must be kept open until the fault handler is disabled: see :ref:"
147148
"`issue with file descriptors <faulthandler-fd>`."
148149
msgstr ""
149150

150-
#: ../../library/faulthandler.rst:85
151+
#: ../../library/faulthandler.rst:87
151152
msgid "On Windows, a handler for Windows exception is also installed."
152153
msgstr ""
153154

154-
#: ../../library/faulthandler.rst:88
155+
#: ../../library/faulthandler.rst:90
155156
msgid ""
156157
"The dump now mentions if a garbage collector collection is running if "
157158
"*all_threads* is true."
158159
msgstr ""
159160

160-
#: ../../library/faulthandler.rst:94
161+
#: ../../library/faulthandler.rst:96
161162
msgid ""
162163
"Disable the fault handler: uninstall the signal handlers installed by :func:"
163164
"`enable`."
164165
msgstr ""
165166

166-
#: ../../library/faulthandler.rst:99
167+
#: ../../library/faulthandler.rst:101
167168
msgid "Check if the fault handler is enabled."
168169
msgstr ""
169170

170-
#: ../../library/faulthandler.rst:103
171+
#: ../../library/faulthandler.rst:105
171172
msgid "Dumping the tracebacks after a timeout"
172173
msgstr ""
173174

174-
#: ../../library/faulthandler.rst:107
175+
#: ../../library/faulthandler.rst:109
175176
msgid ""
176177
"Dump the tracebacks of all threads, after a timeout of *timeout* seconds, or "
177178
"every *timeout* seconds if *repeat* is ``True``. If *exit* is ``True``, "
178-
"call :c:func:`_exit` with status=1 after dumping the tracebacks. (Note :c:"
179-
"func:`_exit` exits the process immediately, which means it doesn't do any "
179+
"call :c:func:`!_exit` with status=1 after dumping the tracebacks. (Note :c:"
180+
"func:`!_exit` exits the process immediately, which means it doesn't do any "
180181
"cleanup like flushing file buffers.) If the function is called twice, the "
181182
"new call replaces previous parameters and resets the timeout. The timer has "
182183
"a sub-second resolution."
183184
msgstr ""
184185

185-
#: ../../library/faulthandler.rst:115
186+
#: ../../library/faulthandler.rst:117
186187
msgid ""
187188
"The *file* must be kept open until the traceback is dumped or :func:"
188189
"`cancel_dump_traceback_later` is called: see :ref:`issue with file "
189190
"descriptors <faulthandler-fd>`."
190191
msgstr ""
191192

192-
#: ../../library/faulthandler.rst:119
193+
#: ../../library/faulthandler.rst:121
193194
msgid "This function is implemented using a watchdog thread."
194195
msgstr ""
195196

196-
#: ../../library/faulthandler.rst:124
197+
#: ../../library/faulthandler.rst:126
197198
msgid "This function is now always available."
198199
msgstr ""
199200

200-
#: ../../library/faulthandler.rst:129
201+
#: ../../library/faulthandler.rst:131
201202
msgid "Cancel the last call to :func:`dump_traceback_later`."
202203
msgstr ""
203204

204-
#: ../../library/faulthandler.rst:133
205+
#: ../../library/faulthandler.rst:135
205206
msgid "Dumping the traceback on a user signal"
206207
msgstr ""
207208

208-
#: ../../library/faulthandler.rst:137
209+
#: ../../library/faulthandler.rst:139
209210
msgid ""
210211
"Register a user signal: install a handler for the *signum* signal to dump "
211212
"the traceback of all threads, or of the current thread if *all_threads* is "
212213
"``False``, into *file*. Call the previous handler if chain is ``True``."
213214
msgstr ""
214215

215-
#: ../../library/faulthandler.rst:141
216+
#: ../../library/faulthandler.rst:143
216217
msgid ""
217218
"The *file* must be kept open until the signal is unregistered by :func:"
218219
"`unregister`: see :ref:`issue with file descriptors <faulthandler-fd>`."
219220
msgstr ""
220221

221-
#: ../../library/faulthandler.rst:144 ../../library/faulthandler.rst:155
222+
#: ../../library/faulthandler.rst:146 ../../library/faulthandler.rst:157
222223
msgid "Not available on Windows."
223224
msgstr ""
224225

225-
#: ../../library/faulthandler.rst:151
226+
#: ../../library/faulthandler.rst:153
226227
msgid ""
227228
"Unregister a user signal: uninstall the handler of the *signum* signal "
228229
"installed by :func:`register`. Return ``True`` if the signal was registered, "
229230
"``False`` otherwise."
230231
msgstr ""
231232

232-
#: ../../library/faulthandler.rst:161
233+
#: ../../library/faulthandler.rst:163
233234
msgid "Issue with file descriptors"
234235
msgstr ""
235236

236-
#: ../../library/faulthandler.rst:163
237+
#: ../../library/faulthandler.rst:165
237238
msgid ""
238239
":func:`enable`, :func:`dump_traceback_later` and :func:`register` keep the "
239240
"file descriptor of their *file* argument. If the file is closed and its file "
@@ -242,11 +243,11 @@ msgid ""
242243
"Call these functions again each time that the file is replaced."
243244
msgstr ""
244245

245-
#: ../../library/faulthandler.rst:171
246+
#: ../../library/faulthandler.rst:173
246247
msgid "Example"
247248
msgstr "範例"
248249

249-
#: ../../library/faulthandler.rst:173
250+
#: ../../library/faulthandler.rst:175
250251
msgid ""
251252
"Example of a segmentation fault on Linux with and without enabling the fault "
252253
"handler:"

0 commit comments

Comments
 (0)