66msgstr ""
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 <adrianliaw2000@gmail.com>\n "
1212"Language-Team :Chinese - TAIWAN (https://github.com/python/python-docs-zh- "
@@ -25,215 +25,216 @@ msgstr ""
2525msgid ""
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 bysetting 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."
3333msgstr ""
3434
35- #: ../../library/faulthandler.rst:18
35+ #: ../../library/faulthandler.rst:19
3636msgid ""
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."
4141msgstr ""
4242
43- #: ../../library/faulthandler.rst:23
43+ #: ../../library/faulthandler.rst:24
4444msgid ""
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:"
4949msgstr ""
5050
51- #: ../../library/faulthandler.rst:28
51+ #: ../../library/faulthandler.rst:29
5252msgid ""
5353"Only ASCII is supported. The ``backslashreplace`` error handler is used on "
5454"encoding."
5555msgstr ""
5656
57- #: ../../library/faulthandler.rst:30
57+ #: ../../library/faulthandler.rst:31
5858msgid "Each string is limited to 500 characters."
5959msgstr ""
6060
61- #: ../../library/faulthandler.rst:31
61+ #: ../../library/faulthandler.rst:32
6262msgid ""
6363"Only the filename, the function name and the line number are displayed. (no "
6464"source code)"
6565msgstr ""
6666
67- #: ../../library/faulthandler.rst:33
67+ #: ../../library/faulthandler.rst:34
6868msgid "It is limited to 100 frames and 100 threads."
6969msgstr ""
7070
71- #: ../../library/faulthandler.rst:34
71+ #: ../../library/faulthandler.rst:35
7272msgid "The order is reversed: the most recent call is shown first."
7373msgstr ""
7474
75- #: ../../library/faulthandler.rst:36
75+ #: ../../library/faulthandler.rst:37
7676msgid ""
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`."
8080msgstr ""
8181
82- #: ../../library/faulthandler.rst:40
82+ #: ../../library/faulthandler.rst:41
8383msgid ""
8484"The module is implemented in C, so tracebacks can be dumped on a crash or "
8585"when Python is deadlocked."
8686msgstr ""
8787
88- #: ../../library/faulthandler.rst:43
88+ #: ../../library/faulthandler.rst:44
8989msgid ""
9090"The :ref:`Python Development Mode <devmode>` calls :func:`faulthandler."
9191"enable` at Python startup."
9292msgstr ""
9393
94- #: ../../library/faulthandler.rst:48
94+ #: ../../library/faulthandler.rst:49
9595msgid "Module :mod:`pdb`"
9696msgstr ":mod:`pdb` 模組"
9797
98- #: ../../library/faulthandler.rst:49
98+ #: ../../library/faulthandler.rst:50
9999msgid "Interactive source code debugger for Python programs."
100100msgstr ""
101101
102- #: ../../library/faulthandler.rst:51
102+ #: ../../library/faulthandler.rst:52
103103msgid "Module :mod:`traceback`"
104104msgstr ":mod:`traceback` 模組"
105105
106- #: ../../library/faulthandler.rst:52
106+ #: ../../library/faulthandler.rst:53
107107msgid ""
108108"Standard interface to extract, format and print stack traces of Python "
109109"programs."
110110msgstr ""
111111
112- #: ../../library/faulthandler.rst:55
112+ #: ../../library/faulthandler.rst:56
113113msgid "Dumping the traceback"
114114msgstr ""
115115
116- #: ../../library/faulthandler.rst:59
116+ #: ../../library/faulthandler.rst:60
117117msgid ""
118118"Dump the tracebacks of all threads into *file*. If *all_threads* is "
119119"``False``, dump only the current thread."
120120msgstr ""
121121
122- #: ../../library/faulthandler.rst:62
122+ #: ../../library/faulthandler.rst:63
123123msgid ""
124124":func:`traceback.print_tb`, which can be used to print a traceback object."
125125msgstr ""
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
129129msgid "Added support for passing file descriptor to this function."
130130msgstr ""
131131
132- #: ../../library/faulthandler.rst:69
132+ #: ../../library/faulthandler.rst:70
133133msgid "Fault handler state"
134134msgstr ""
135135
136- #: ../../library/faulthandler.rst:73
136+ #: ../../library/faulthandler.rst:74
137137msgid ""
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."
142143msgstr ""
143144
144- #: ../../library/faulthandler.rst:79
145+ #: ../../library/faulthandler.rst:81
145146msgid ""
146147"The *file* must be kept open until the fault handler is disabled: see :ref:"
147148"`issue with file descriptors <faulthandler-fd>`."
148149msgstr ""
149150
150- #: ../../library/faulthandler.rst:85
151+ #: ../../library/faulthandler.rst:87
151152msgid "On Windows, a handler for Windows exception is also installed."
152153msgstr ""
153154
154- #: ../../library/faulthandler.rst:88
155+ #: ../../library/faulthandler.rst:90
155156msgid ""
156157"The dump now mentions if a garbage collector collection is running if "
157158"*all_threads* is true."
158159msgstr ""
159160
160- #: ../../library/faulthandler.rst:94
161+ #: ../../library/faulthandler.rst:96
161162msgid ""
162163"Disable the fault handler: uninstall the signal handlers installed by :func:"
163164"`enable`."
164165msgstr ""
165166
166- #: ../../library/faulthandler.rst:99
167+ #: ../../library/faulthandler.rst:101
167168msgid "Check if the fault handler is enabled."
168169msgstr ""
169170
170- #: ../../library/faulthandler.rst:103
171+ #: ../../library/faulthandler.rst:105
171172msgid "Dumping the tracebacks after a timeout"
172173msgstr ""
173174
174- #: ../../library/faulthandler.rst:107
175+ #: ../../library/faulthandler.rst:109
175176msgid ""
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."
183184msgstr ""
184185
185- #: ../../library/faulthandler.rst:115
186+ #: ../../library/faulthandler.rst:117
186187msgid ""
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>`."
190191msgstr ""
191192
192- #: ../../library/faulthandler.rst:119
193+ #: ../../library/faulthandler.rst:121
193194msgid "This function is implemented using a watchdog thread."
194195msgstr ""
195196
196- #: ../../library/faulthandler.rst:124
197+ #: ../../library/faulthandler.rst:126
197198msgid "This function is now always available."
198199msgstr ""
199200
200- #: ../../library/faulthandler.rst:129
201+ #: ../../library/faulthandler.rst:131
201202msgid "Cancel the last call to :func:`dump_traceback_later`."
202203msgstr ""
203204
204- #: ../../library/faulthandler.rst:133
205+ #: ../../library/faulthandler.rst:135
205206msgid "Dumping the traceback on a user signal"
206207msgstr ""
207208
208- #: ../../library/faulthandler.rst:137
209+ #: ../../library/faulthandler.rst:139
209210msgid ""
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``."
213214msgstr ""
214215
215- #: ../../library/faulthandler.rst:141
216+ #: ../../library/faulthandler.rst:143
216217msgid ""
217218"The *file* must be kept open until the signal is unregistered by :func:"
218219"`unregister`: see :ref:`issue with file descriptors <faulthandler-fd>`."
219220msgstr ""
220221
221- #: ../../library/faulthandler.rst:144 ../../library/faulthandler.rst:155
222+ #: ../../library/faulthandler.rst:146 ../../library/faulthandler.rst:157
222223msgid "Not available on Windows."
223224msgstr ""
224225
225- #: ../../library/faulthandler.rst:151
226+ #: ../../library/faulthandler.rst:153
226227msgid ""
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."
230231msgstr ""
231232
232- #: ../../library/faulthandler.rst:161
233+ #: ../../library/faulthandler.rst:163
233234msgid "Issue with file descriptors"
234235msgstr ""
235236
236- #: ../../library/faulthandler.rst:163
237+ #: ../../library/faulthandler.rst:165
237238msgid ""
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."
243244msgstr ""
244245
245- #: ../../library/faulthandler.rst:171
246+ #: ../../library/faulthandler.rst:173
246247msgid "Example"
247248msgstr "範例"
248249
249- #: ../../library/faulthandler.rst:173
250+ #: ../../library/faulthandler.rst:175
250251msgid ""
251252"Example of a segmentation fault on Linux with and without enabling the fault "
252253"handler:"