2645 lines
93 KiB
Plaintext
2645 lines
93 KiB
Plaintext
# SOME DESCRIPTIVE TITLE
|
|
# Copyright (C) YEAR Free Software Foundation, Inc.
|
|
# This file is distributed under the same license as the PACKAGE package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: PACKAGE VERSION\n"
|
|
"POT-Creation-Date: 2021-11-07 12:11+0900\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"Language: \n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:6
|
|
#, no-wrap
|
|
msgid "Debugging"
|
|
msgstr ""
|
|
|
|
#. type: chapter
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:7
|
|
#, no-wrap
|
|
msgid "Debugging Lisp Programs"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:8
|
|
#, no-wrap
|
|
msgid "debugging lisp programs"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:12
|
|
msgid ""
|
|
"There are several ways to find and investigate problems in an Emacs Lisp "
|
|
"program."
|
|
msgstr ""
|
|
|
|
#. type: itemize
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:18
|
|
msgid ""
|
|
"If a problem occurs when you run the program, you can use the built-in Emacs "
|
|
"Lisp debugger to suspend the Lisp evaluator, and examine and/or alter its "
|
|
"internal state."
|
|
msgstr ""
|
|
|
|
#. type: itemize
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:21
|
|
msgid "You can use Edebug, a source-level debugger for Emacs Lisp."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:23
|
|
#, no-wrap
|
|
msgid "tracing Lisp programs"
|
|
msgstr ""
|
|
|
|
#. type: itemize
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:31
|
|
msgid ""
|
|
"You can trace the execution of functions involved in the problem using the "
|
|
"tracing facilities provided by the @file{trace.el} package. This package "
|
|
"provides the functions @code{trace-function-foreground} and "
|
|
"@code{trace-function-background} for tracing function calls, and "
|
|
"@code{trace-values} for adding values of select variables to the trace. For "
|
|
"the details, see the documentation of these facilities in @file{trace.el}."
|
|
msgstr ""
|
|
|
|
#. type: itemize
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:35
|
|
msgid ""
|
|
"If a syntactic problem is preventing Lisp from even reading the program, you "
|
|
"can locate it using Lisp editing commands."
|
|
msgstr ""
|
|
|
|
#. type: itemize
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:39
|
|
msgid ""
|
|
"You can look at the error and warning messages produced by the byte compiler "
|
|
"when it compiles the program. @xref{Compiler Errors}."
|
|
msgstr ""
|
|
|
|
#. type: itemize
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:43
|
|
msgid ""
|
|
"You can use the Testcover package to perform coverage testing on the "
|
|
"program."
|
|
msgstr ""
|
|
|
|
#. type: itemize
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:47
|
|
msgid ""
|
|
"You can use the ERT package to write regression tests for the program. "
|
|
"@xref{Top,the ERT manual,, ert, ERT: Emacs Lisp Regression Testing}."
|
|
msgstr ""
|
|
|
|
#. type: itemize
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:50
|
|
msgid ""
|
|
"You can profile the program to get hints about how to make it more "
|
|
"efficient."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:55
|
|
msgid ""
|
|
"Other useful tools for debugging input and output problems are the dribble "
|
|
"file (@pxref{Terminal Input}) and the @code{open-termscript} function "
|
|
"(@pxref{Terminal Output})."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:62
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:64
|
|
#, no-wrap
|
|
msgid "Debugger"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:62
|
|
msgid "A debugger for the Emacs Lisp evaluator."
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:62
|
|
msgid "Edebug"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:62
|
|
msgid "A source-level Emacs Lisp debugger."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:62
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:841
|
|
#, no-wrap
|
|
msgid "Syntax Errors"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:62
|
|
msgid "How to find syntax errors."
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:62
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:939
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:940
|
|
#, no-wrap
|
|
msgid "Test Coverage"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:62
|
|
msgid "Ensuring you have tested all branches in your code."
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:62
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:981
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:982
|
|
#, no-wrap
|
|
msgid "Profiling"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:62
|
|
msgid "Measuring the resources that your code uses."
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:65
|
|
#, no-wrap
|
|
msgid "The Lisp Debugger"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:66
|
|
#, no-wrap
|
|
msgid "debugger for Emacs Lisp"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:67
|
|
#, no-wrap
|
|
msgid "Lisp debugger"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:68
|
|
#, no-wrap
|
|
msgid "break"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:77
|
|
msgid ""
|
|
"The ordinary @dfn{Lisp debugger} provides the ability to suspend evaluation "
|
|
"of a form. While evaluation is suspended (a state that is commonly known as "
|
|
"a @dfn{break}), you may examine the run time stack, examine the values of "
|
|
"local or global variables, or change those values. Since a break is a "
|
|
"recursive edit, all the usual editing facilities of Emacs are available; you "
|
|
"can even run programs that will enter the debugger recursively. "
|
|
"@xref{Recursive Editing}."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:91
|
|
#, no-wrap
|
|
msgid "Error Debugging"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
msgid "Entering the debugger when an error happens."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:205
|
|
#, no-wrap
|
|
msgid "Infinite Loops"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
msgid "Stopping and debugging a program that doesn't exit."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:235
|
|
#, no-wrap
|
|
msgid "Function Debugging"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
msgid "Entering it when a certain function is called."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:305
|
|
#, no-wrap
|
|
msgid "Variable Debugging"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
msgid "Entering it when a variable is modified."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:335
|
|
#, no-wrap
|
|
msgid "Explicit Debug"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
msgid "Entering it at a certain point in the program."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:359
|
|
#, no-wrap
|
|
msgid "Using Debugger"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
msgid "What the debugger does."
|
|
msgstr ""
|
|
|
|
#. type: subsection
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:400
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:401
|
|
#, no-wrap
|
|
msgid "Backtraces"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
msgid "What you see while in the debugger."
|
|
msgstr ""
|
|
|
|
#. type: subsection
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:468
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:469
|
|
#, no-wrap
|
|
msgid "Debugger Commands"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
msgid "Commands used while in the debugger."
|
|
msgstr ""
|
|
|
|
#. type: subsection
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:566
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:567
|
|
#, no-wrap
|
|
msgid "Invoking the Debugger"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
msgid "How to call the function @code{debug}."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:662
|
|
#, no-wrap
|
|
msgid "Internals of Debugger"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:89
|
|
msgid "Subroutines of the debugger, and global variables."
|
|
msgstr ""
|
|
|
|
#. type: subsection
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:92
|
|
#, no-wrap
|
|
msgid "Entering the Debugger on an Error"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:93
|
|
#, no-wrap
|
|
msgid "error debugging"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:94
|
|
#, no-wrap
|
|
msgid "debugging errors"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:99
|
|
msgid ""
|
|
"The most important time to enter the debugger is when a Lisp error happens. "
|
|
"This allows you to investigate the immediate causes of the error."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:107
|
|
msgid ""
|
|
"However, entry to the debugger is not a normal consequence of an error. "
|
|
"Many commands signal Lisp errors when invoked inappropriately, and during "
|
|
"ordinary editing it would be very inconvenient to enter the debugger each "
|
|
"time this happens. So if you want errors to enter the debugger, set the "
|
|
"variable @code{debug-on-error} to non-@code{nil}. (The command "
|
|
"@code{toggle-debug-on-error} provides an easy way to do this.)"
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:108
|
|
#, no-wrap
|
|
msgid "debug-on-error"
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:114
|
|
msgid ""
|
|
"This variable determines whether the debugger is called when an error is "
|
|
"signaled and not handled. If @code{debug-on-error} is @code{t}, all kinds "
|
|
"of errors call the debugger, except those listed in "
|
|
"@code{debug-ignored-errors} (see below). If it is @code{nil}, none call the "
|
|
"debugger."
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:121
|
|
msgid ""
|
|
"The value can also be a list of error conditions (@pxref{Signaling "
|
|
"Errors}). Then the debugger is called only for error conditions in this "
|
|
"list (except those also listed in @code{debug-ignored-errors}). For "
|
|
"example, if you set @code{debug-on-error} to the list "
|
|
"@code{(void-variable)}, the debugger is only called for errors about a "
|
|
"variable that has no value."
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:124
|
|
msgid ""
|
|
"Note that @code{eval-expression-debug-on-error} overrides this variable in "
|
|
"some cases; see below."
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:128
|
|
msgid ""
|
|
"When this variable is non-@code{nil}, Emacs does not create an error handler "
|
|
"around process filter functions and sentinels. Therefore, errors in these "
|
|
"functions also invoke the debugger. @xref{Processes}."
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:130
|
|
#, no-wrap
|
|
msgid "debug-ignored-errors"
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:137
|
|
msgid ""
|
|
"This variable specifies errors which should not enter the debugger, "
|
|
"regardless of the value of @code{debug-on-error}. Its value is a list of "
|
|
"error condition symbols and/or regular expressions. If the error has any of "
|
|
"those condition symbols, or if the error message matches any of the regular "
|
|
"expressions, then that error does not enter the debugger."
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:144
|
|
msgid ""
|
|
"The normal value of this variable includes @code{user-error}, as well as "
|
|
"several errors that happen often during editing but rarely result from bugs "
|
|
"in Lisp programs. However, ``rarely'' is not ``never''; if your program "
|
|
"fails with an error that matches this list, you may try changing this list "
|
|
"to debug the error. The easiest way is usually to set "
|
|
"@code{debug-ignored-errors} to @code{nil}."
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:146
|
|
#, no-wrap
|
|
msgid "eval-expression-debug-on-error"
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:151
|
|
msgid ""
|
|
"If this variable has a non-@code{nil} value (the default), running the "
|
|
"command @code{eval-expression} causes @code{debug-on-error} to be "
|
|
"temporarily bound to @code{t}. @xref{Lisp Eval,, Evaluating Emacs Lisp "
|
|
"Expressions, emacs, The GNU Emacs Manual}."
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:154
|
|
msgid ""
|
|
"If @code{eval-expression-debug-on-error} is @code{nil}, then the value of "
|
|
"@code{debug-on-error} is not changed during @code{eval-expression}."
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:156
|
|
#, no-wrap
|
|
msgid "debug-on-signal"
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:160
|
|
msgid ""
|
|
"Normally, errors caught by @code{condition-case} never invoke the debugger. "
|
|
"The @code{condition-case} gets a chance to handle the error before the "
|
|
"debugger gets a chance."
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:166
|
|
msgid ""
|
|
"If you change @code{debug-on-signal} to a non-@code{nil} value, the debugger "
|
|
"gets the first chance at every error, regardless of the presence of "
|
|
"@code{condition-case}. (To invoke the debugger, the error must still "
|
|
"fulfill the criteria specified by @code{debug-on-error} and "
|
|
"@code{debug-ignored-errors}.)"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:167
|
|
#, no-wrap
|
|
msgid "emacsclient, getting a backtrace"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:168
|
|
#, no-wrap
|
|
msgid "backtrace from emacsclient's @option{--eval}"
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:173
|
|
msgid ""
|
|
"For example, setting this variable is useful to get a backtrace from code "
|
|
"evaluated by emacsclient's @option{--eval} option. If Lisp code evaluated "
|
|
"by emacsclient signals an error while this variable is non-@code{nil}, the "
|
|
"backtrace will popup in the running Emacs."
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:180
|
|
msgid ""
|
|
"@strong{Warning:} Setting this variable to non-@code{nil} may have annoying "
|
|
"effects. Various parts of Emacs catch errors in the normal course of "
|
|
"affairs, and you may not even realize that errors happen there. If you need "
|
|
"to debug code wrapped in @code{condition-case}, consider using "
|
|
"@code{condition-case-unless-debug} (@pxref{Handling Errors})."
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:182
|
|
#, no-wrap
|
|
msgid "debug-on-event"
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:189
|
|
msgid ""
|
|
"If you set @code{debug-on-event} to a special event (@pxref{Special "
|
|
"Events}), Emacs will try to enter the debugger as soon as it receives this "
|
|
"event, bypassing @code{special-event-map}. At present, the only supported "
|
|
"values correspond to the signals @code{SIGUSR1} and @code{SIGUSR2} (this is "
|
|
"the default). This can be helpful when @code{inhibit-quit} is set and Emacs "
|
|
"is not otherwise responding."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:191
|
|
#, no-wrap
|
|
msgid "message, finding what causes a particular message"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:192
|
|
#, no-wrap
|
|
msgid "debug-on-message"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:197
|
|
msgid ""
|
|
"If you set @code{debug-on-message} to a regular expression, Emacs will enter "
|
|
"the debugger if it displays a matching message in the echo area. For "
|
|
"example, this can be useful when trying to find the cause of a particular "
|
|
"message."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:204
|
|
msgid ""
|
|
"To debug an error that happens during loading of the init file, use the "
|
|
"option @samp{--debug-init}. This binds @code{debug-on-error} to @code{t} "
|
|
"while loading the init file, and bypasses the @code{condition-case} which "
|
|
"normally catches errors in the init file."
|
|
msgstr ""
|
|
|
|
#. type: subsection
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:206
|
|
#, no-wrap
|
|
msgid "Debugging Infinite Loops"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:207
|
|
#, no-wrap
|
|
msgid "infinite loops"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:208
|
|
#, no-wrap
|
|
msgid "loops, infinite"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:209
|
|
#, no-wrap
|
|
msgid "quitting from infinite loop"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:210
|
|
#, no-wrap
|
|
msgid "stopping an infinite loop"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:215
|
|
msgid ""
|
|
"When a program loops infinitely and fails to return, your first problem is "
|
|
"to stop the loop. On most operating systems, you can do this with "
|
|
"@kbd{C-g}, which causes a @dfn{quit}. @xref{Quitting}."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:222
|
|
msgid ""
|
|
"Ordinary quitting gives no information about why the program was looping. "
|
|
"To get more information, you can set the variable @code{debug-on-quit} to "
|
|
"non-@code{nil}. Once you have the debugger running in the middle of the "
|
|
"infinite loop, you can proceed from the debugger using the stepping "
|
|
"commands. If you step through the entire loop, you may get enough "
|
|
"information to solve the problem."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:226
|
|
msgid ""
|
|
"Quitting with @kbd{C-g} is not considered an error, and "
|
|
"@code{debug-on-error} has no effect on the handling of @kbd{C-g}. Likewise, "
|
|
"@code{debug-on-quit} has no effect on errors."
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:227
|
|
#, no-wrap
|
|
msgid "debug-on-quit"
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:233
|
|
msgid ""
|
|
"This variable determines whether the debugger is called when @code{quit} is "
|
|
"signaled and not handled. If @code{debug-on-quit} is non-@code{nil}, then "
|
|
"the debugger is called whenever you quit (that is, type @kbd{C-g}). If "
|
|
"@code{debug-on-quit} is @code{nil} (the default), then the debugger is not "
|
|
"called when you quit."
|
|
msgstr ""
|
|
|
|
#. type: subsection
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:236
|
|
#, no-wrap
|
|
msgid "Entering the Debugger on a Function Call"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:237
|
|
#, no-wrap
|
|
msgid "function call debugging"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:238
|
|
#, no-wrap
|
|
msgid "debugging specific functions"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:246
|
|
msgid ""
|
|
"To investigate a problem that happens in the middle of a program, one useful "
|
|
"technique is to enter the debugger whenever a certain function is called. "
|
|
"You can do this to the function in which the problem occurs, and then step "
|
|
"through the function, or you can do this to a function called shortly before "
|
|
"the problem, step quickly over the call to that function, and then step "
|
|
"through its caller."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:247
|
|
#, no-wrap
|
|
msgid "Command debug-on-entry function-name"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:250
|
|
msgid ""
|
|
"This function requests @var{function-name} to invoke the debugger each time "
|
|
"it is called."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:259
|
|
msgid ""
|
|
"Any function or macro defined as Lisp code may be set to break on entry, "
|
|
"regardless of whether it is interpreted code or compiled code. If the "
|
|
"function is a command, it will enter the debugger when called from Lisp and "
|
|
"when called interactively (after the reading of the arguments). You can "
|
|
"also set debug-on-entry for primitive functions (i.e., those written in C) "
|
|
"this way, but it only takes effect when the primitive is called from Lisp "
|
|
"code. Debug-on-entry is not allowed for special forms."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:264
|
|
msgid ""
|
|
"When @code{debug-on-entry} is called interactively, it prompts for "
|
|
"@var{function-name} in the minibuffer. If the function is already set up to "
|
|
"invoke the debugger on entry, @code{debug-on-entry} does nothing. "
|
|
"@code{debug-on-entry} always returns @var{function-name}."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:266
|
|
msgid "Here's an example to illustrate use of this function:"
|
|
msgstr ""
|
|
|
|
#. type: group
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:273
|
|
#, no-wrap
|
|
msgid ""
|
|
"(defun fact (n)\n"
|
|
" (if (zerop n) 1\n"
|
|
" (* n (fact (1- n)))))\n"
|
|
" @result{} fact\n"
|
|
msgstr ""
|
|
|
|
#. type: group
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:277
|
|
#, no-wrap
|
|
msgid ""
|
|
"(debug-on-entry 'fact)\n"
|
|
" @result{} fact\n"
|
|
msgstr ""
|
|
|
|
#. type: group
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:280
|
|
#, no-wrap
|
|
msgid "(fact 3)\n"
|
|
msgstr ""
|
|
|
|
#. type: group
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:291
|
|
#, no-wrap
|
|
msgid ""
|
|
"------ Buffer: *Backtrace* ------\n"
|
|
"Debugger entered--entering a function:\n"
|
|
"* fact(3)\n"
|
|
" eval((fact 3))\n"
|
|
" eval-last-sexp-1(nil)\n"
|
|
" eval-last-sexp(nil)\n"
|
|
" call-interactively(eval-last-sexp)\n"
|
|
"------ Buffer: *Backtrace* ------\n"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:296
|
|
#, no-wrap
|
|
msgid "Command cancel-debug-on-entry &optional function-name"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:303
|
|
msgid ""
|
|
"This function undoes the effect of @code{debug-on-entry} on "
|
|
"@var{function-name}. When called interactively, it prompts for "
|
|
"@var{function-name} in the minibuffer. If @var{function-name} is omitted or "
|
|
"@code{nil}, it cancels break-on-entry for all functions. Calling "
|
|
"@code{cancel-debug-on-entry} does nothing to a function which is not "
|
|
"currently set up to break on entry."
|
|
msgstr ""
|
|
|
|
#. type: subsection
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:306
|
|
#, no-wrap
|
|
msgid "Entering the debugger when a variable is modified"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:307
|
|
#, no-wrap
|
|
msgid "variable write debugging"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:308
|
|
#, no-wrap
|
|
msgid "debugging changes to variables"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:313
|
|
msgid ""
|
|
"Sometimes a problem with a function is due to a wrong setting of a "
|
|
"variable. Setting up the debugger to trigger whenever the variable is "
|
|
"changed is a quick way to find the origin of the setting."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:314
|
|
#, no-wrap
|
|
msgid "Command debug-on-variable-change variable"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:317
|
|
msgid ""
|
|
"This function arranges for the debugger to be called whenever @var{variable} "
|
|
"is modified."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:323
|
|
msgid ""
|
|
"It is implemented using the watchpoint mechanism, so it inherits the same "
|
|
"characteristics and limitations: all aliases of @var{variable} will be "
|
|
"watched together, only dynamic variables can be watched, and changes to the "
|
|
"objects referenced by variables are not detected. For details, see "
|
|
"@ref{Watching Variables}."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:325
|
|
#, no-wrap
|
|
msgid "Command cancel-debug-on-variable-change &optional variable"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:332
|
|
msgid ""
|
|
"This function undoes the effect of @code{debug-on-variable-change} on "
|
|
"@var{variable}. When called interactively, it prompts for @var{variable} in "
|
|
"the minibuffer. If @var{variable} is omitted or @code{nil}, it cancels "
|
|
"break-on-change for all variables. Calling "
|
|
"@code{cancel-debug-on-variable-change} does nothing to a variable which is "
|
|
"not currently set up to break on change."
|
|
msgstr ""
|
|
|
|
#. type: subsection
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:336
|
|
#, no-wrap
|
|
msgid "Explicit Entry to the Debugger"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:337
|
|
#, no-wrap
|
|
msgid "debugger, explicit entry"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:338
|
|
#, no-wrap
|
|
msgid "force entry to debugger"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:340
|
|
#, no-wrap
|
|
msgid "@code{eval-defun}, and explicit entry to debugger"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:347
|
|
msgid ""
|
|
"You can cause the debugger to be called at a certain point in your program "
|
|
"by writing the expression @code{(debug)} at that point. To do this, visit "
|
|
"the source file, insert the text @samp{(debug)} at the proper place, and "
|
|
"type @kbd{C-M-x} (@code{eval-defun}, a Lisp mode key binding). "
|
|
"@strong{Warning:} if you do this for temporary debugging purposes, be sure "
|
|
"to undo this insertion before you save the file!"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:353
|
|
msgid ""
|
|
"The place where you insert @samp{(debug)} must be a place where an "
|
|
"additional form can be evaluated and its value ignored. (If the value of "
|
|
"@code{(debug)} isn't ignored, it will alter the execution of the program!) "
|
|
"The most common suitable places are inside a @code{progn} or an implicit "
|
|
"@code{progn} (@pxref{Sequencing})."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:358
|
|
msgid ""
|
|
"If you don't know exactly where in the source code you want to put the debug "
|
|
"statement, but you want to display a backtrace when a certain message is "
|
|
"displayed, you can set @code{debug-on-message} to a regular expression "
|
|
"matching the desired message."
|
|
msgstr ""
|
|
|
|
#. type: subsection
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:360
|
|
#, no-wrap
|
|
msgid "Using the Debugger"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:369
|
|
msgid ""
|
|
"When the debugger is entered, it displays the previously selected buffer in "
|
|
"one window and a buffer named @file{*Backtrace*} in another window. The "
|
|
"backtrace buffer contains one line for each level of Lisp function execution "
|
|
"currently going on. At the beginning of this buffer is a message describing "
|
|
"the reason that the debugger was invoked (such as the error message and "
|
|
"associated data, if it was invoked due to an error)."
|
|
msgstr ""
|
|
|
|
#. type: vindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:370
|
|
#, no-wrap
|
|
msgid "debugger-bury-or-kill"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:385
|
|
msgid ""
|
|
"The backtrace buffer is read-only and uses a special major mode, Debugger "
|
|
"mode, in which letters are defined as debugger commands. The usual Emacs "
|
|
"editing commands are available; thus, you can switch windows to examine the "
|
|
"buffer that was being edited at the time of the error, switch buffers, visit "
|
|
"files, or do any other sort of editing. However, the debugger is a "
|
|
"recursive editing level (@pxref{Recursive Editing}) and it is wise to go "
|
|
"back to the backtrace buffer and exit the debugger (with the @kbd{q} "
|
|
"command) when you are finished with it. Exiting the debugger gets out of "
|
|
"the recursive edit and buries the backtrace buffer. (You can customize what "
|
|
"the @kbd{q} command does with the backtrace buffer by setting the variable "
|
|
"@code{debugger-bury-or-kill}. For example, set it to @code{kill} if you "
|
|
"prefer to kill the buffer rather than bury it. Consult the variable's "
|
|
"documentation for more possibilities.)"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:395
|
|
msgid ""
|
|
"When the debugger has been entered, the @code{debug-on-error} variable is "
|
|
"temporarily set according to @code{eval-expression-debug-on-error}. If the "
|
|
"latter variable is non-@code{nil}, @code{debug-on-error} will temporarily be "
|
|
"set to @code{t}. This means that any further errors that occur while doing "
|
|
"a debugging session will (by default) trigger another backtrace. If this is "
|
|
"not what you want, you can either set @code{eval-expression-debug-on-error} "
|
|
"to @code{nil}, or set @code{debug-on-error} to @code{nil} in "
|
|
"@code{debugger-mode-hook}."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:399
|
|
msgid ""
|
|
"The debugger itself must be run byte-compiled, since it makes assumptions "
|
|
"about the state of the Lisp interpreter. These assumptions are false if the "
|
|
"debugger is running interpreted."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:402
|
|
#, no-wrap
|
|
msgid "backtrace buffer"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:407
|
|
msgid ""
|
|
"Debugger mode is derived from Backtrace mode, which is also used to show "
|
|
"backtraces by Edebug and ERT@. (@pxref{Edebug}, and @ref{Top,the ERT "
|
|
"manual,, ert, ERT: Emacs Lisp Regression Testing}.)"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:408
|
|
#, no-wrap
|
|
msgid "stack frame"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:415
|
|
msgid ""
|
|
"The backtrace buffer shows you the functions that are executing and their "
|
|
"argument values. When a backtrace buffer is created, it shows each stack "
|
|
"frame on one, possibly very long, line. (A stack frame is the place where "
|
|
"the Lisp interpreter records information about a particular invocation of a "
|
|
"function.) The most recently called function will be at the top."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:416
|
|
#, no-wrap
|
|
msgid "current stack frame"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:420
|
|
msgid ""
|
|
"In a backtrace you can specify a stack frame by moving point to a line "
|
|
"describing that frame. The frame whose line point is on is considered the "
|
|
"@dfn{current frame}."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:429
|
|
msgid ""
|
|
"If a function name is underlined, that means Emacs knows where its source "
|
|
"code is located. You can click with the mouse on that name, or move to it "
|
|
"and type @key{RET}, to visit the source code. You can also type @key{RET} "
|
|
"while point is on any name of a function or variable which is not "
|
|
"underlined, to see help information for that symbol in a help buffer, if any "
|
|
"exists. The @code{xref-find-definitions} command, bound to @kbd{M-.}, can "
|
|
"also be used on any identifier in a backtrace (@pxref{Looking Up "
|
|
"Identifiers,,,emacs, The GNU Emacs Manual})."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:436
|
|
msgid ""
|
|
"In backtraces, the tails of long lists and the ends of long strings, vectors "
|
|
"or structures, as well as objects which are deeply nested, will be printed "
|
|
"as underlined ``...''. You can click with the mouse on a ``...'', or type "
|
|
"@key{RET} while point is on it, to show the part of the object that was "
|
|
"hidden. To control how much abbreviation is done, customize "
|
|
"@code{backtrace-line-length}."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:438
|
|
msgid "Here is a list of commands for navigating and viewing backtraces:"
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:440
|
|
#, no-wrap
|
|
msgid "v"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:442
|
|
msgid "Toggle the display of local variables of the current stack frame."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:443
|
|
#, no-wrap
|
|
msgid "p"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:446
|
|
msgid ""
|
|
"Move to the beginning of the frame, or to the beginning of the previous "
|
|
"frame."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:447
|
|
#, no-wrap
|
|
msgid "n"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:449
|
|
msgid "Move to the beginning of the next frame."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:450
|
|
#, no-wrap
|
|
msgid "+"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:453
|
|
msgid ""
|
|
"Add line breaks and indentation to the top-level Lisp form at point to make "
|
|
"it more readable."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:454
|
|
#, no-wrap
|
|
msgid "-"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:456
|
|
msgid "Collapse the top-level Lisp form at point back to a single line."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:457
|
|
#, no-wrap
|
|
msgid "#"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:459
|
|
msgid "Toggle @code{print-circle} for the frame at point."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:460
|
|
#, no-wrap
|
|
msgid ":"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:462
|
|
msgid "Toggle @code{print-gensym} for the frame at point."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:463
|
|
#, no-wrap
|
|
msgid "."
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:465
|
|
msgid "Expand all the forms abbreviated with ``...'' in the frame at point."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:470
|
|
#, no-wrap
|
|
msgid "debugger command list"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:483
|
|
msgid ""
|
|
"The debugger buffer (in Debugger mode) provides special commands in addition "
|
|
"to the usual Emacs commands and to the Backtrace mode commands described in "
|
|
"the previous section. The most important use of debugger commands is for "
|
|
"stepping through code, so that you can see how control flows. The debugger "
|
|
"can step through the control structures of an interpreted function, but "
|
|
"cannot do so in a byte-compiled function. If you would like to step through "
|
|
"a byte-compiled function, replace it with an interpreted definition of the "
|
|
"same function. (To do this, visit the source for the function and type "
|
|
"@kbd{C-M-x} on its definition.) You cannot use the Lisp debugger to step "
|
|
"through a primitive function."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:488
|
|
msgid ""
|
|
"Some of the debugger commands operate on the current frame. If a frame "
|
|
"starts with a star, that means that exiting that frame will call the "
|
|
"debugger again. This is useful for examining the return value of a "
|
|
"function."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:491
|
|
msgid "Here is a list of Debugger mode commands:"
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:493
|
|
#, no-wrap
|
|
msgid "c"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:498
|
|
msgid ""
|
|
"Exit the debugger and continue execution. This resumes execution of the "
|
|
"program as if the debugger had never been entered (aside from any "
|
|
"side-effects that you caused by changing variable values or data structures "
|
|
"while inside the debugger)."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:499
|
|
#, no-wrap
|
|
msgid "d"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:504
|
|
msgid ""
|
|
"Continue execution, but enter the debugger the next time any Lisp function "
|
|
"is called. This allows you to step through the subexpressions of an "
|
|
"expression, seeing what values the subexpressions compute, and what else "
|
|
"they do."
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:509
|
|
msgid ""
|
|
"The stack frame made for the function call which enters the debugger in this "
|
|
"way will be flagged automatically so that the debugger will be called again "
|
|
"when the frame is exited. You can use the @kbd{u} command to cancel this "
|
|
"flag."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:510
|
|
#, no-wrap
|
|
msgid "b"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:514
|
|
msgid ""
|
|
"Flag the current frame so that the debugger will be entered when the frame "
|
|
"is exited. Frames flagged in this way are marked with stars in the "
|
|
"backtrace buffer."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:515
|
|
#, no-wrap
|
|
msgid "u"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:519
|
|
msgid ""
|
|
"Don't enter the debugger when the current frame is exited. This cancels a "
|
|
"@kbd{b} command on that frame. The visible effect is to remove the star "
|
|
"from the line in the backtrace buffer."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:520
|
|
#, no-wrap
|
|
msgid "j"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:524
|
|
msgid ""
|
|
"Flag the current frame like @kbd{b}. Then continue execution like @kbd{c}, "
|
|
"but temporarily disable break-on-entry for all functions that are set up to "
|
|
"do so by @code{debug-on-entry}."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:525
|
|
#, no-wrap
|
|
msgid "e"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:534
|
|
msgid ""
|
|
"Read a Lisp expression in the minibuffer, evaluate it (with the relevant "
|
|
"lexical environment, if applicable), and print the value in the echo area. "
|
|
"The debugger alters certain important variables, and the current buffer, as "
|
|
"part of its operation; @kbd{e} temporarily restores their values from "
|
|
"outside the debugger, so you can examine and change them. This makes the "
|
|
"debugger more transparent. By contrast, @kbd{M-:} does nothing special in "
|
|
"the debugger; it shows you the variable values within the debugger."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:535
|
|
#, no-wrap
|
|
msgid "R"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:538
|
|
msgid ""
|
|
"Like @kbd{e}, but also save the result of evaluation in the buffer "
|
|
"@file{*Debugger-record*}."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:539
|
|
#, no-wrap
|
|
msgid "q"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:542
|
|
msgid ""
|
|
"Terminate the program being debugged; return to top-level Emacs command "
|
|
"execution."
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:545
|
|
msgid ""
|
|
"If the debugger was entered due to a @kbd{C-g} but you really want to quit, "
|
|
"and not debug, use the @kbd{q} command."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:546
|
|
#, no-wrap
|
|
msgid "r"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:549
|
|
msgid ""
|
|
"Return a value from the debugger. The value is computed by reading an "
|
|
"expression with the minibuffer and evaluating it."
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:556
|
|
msgid ""
|
|
"The @kbd{r} command is useful when the debugger was invoked due to exit from "
|
|
"a Lisp call frame (as requested with @kbd{b} or by entering the frame with "
|
|
"@kbd{d}); then the value specified in the @kbd{r} command is used as the "
|
|
"value of that frame. It is also useful if you call @code{debug} and use its "
|
|
"return value. Otherwise, @kbd{r} has the same effect as @kbd{c}, and the "
|
|
"specified return value does not matter."
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:558
|
|
msgid "You can't use @kbd{r} when the debugger was entered due to an error."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:559
|
|
#, no-wrap
|
|
msgid "l"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:563
|
|
msgid ""
|
|
"Display a list of functions that will invoke the debugger when called. This "
|
|
"is a list of functions that are set to break on entry by means of "
|
|
"@code{debug-on-entry}."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:568
|
|
#, no-wrap
|
|
msgid "invoking lisp debugger"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:572
|
|
msgid ""
|
|
"Here we describe in full detail the function @code{debug} that is used to "
|
|
"invoke the debugger."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:573
|
|
#, no-wrap
|
|
msgid "Command debug &rest debugger-args"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:579
|
|
msgid ""
|
|
"This function enters the debugger. It switches buffers to a buffer named "
|
|
"@file{*Backtrace*} (or @file{*Backtrace*<2>} if it is the second recursive "
|
|
"entry to the debugger, etc.), and fills it with information about the stack "
|
|
"of Lisp function calls. It then enters a recursive edit, showing the "
|
|
"backtrace buffer in Debugger mode."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:584
|
|
msgid ""
|
|
"The Debugger mode @kbd{c}, @kbd{d}, @kbd{j}, and @kbd{r} commands exit the "
|
|
"recursive edit; then @code{debug} switches back to the previous buffer and "
|
|
"returns to whatever called @code{debug}. This is the only way the function "
|
|
"@code{debug} can return to its caller."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:589
|
|
msgid ""
|
|
"The use of the @var{debugger-args} is that @code{debug} displays the rest of "
|
|
"its arguments at the top of the @file{*Backtrace*} buffer, so that the user "
|
|
"can see them. Except as described below, this is the @emph{only} way these "
|
|
"arguments are used."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:594
|
|
msgid ""
|
|
"However, certain values for first argument to @code{debug} have a special "
|
|
"significance. (Normally, these values are used only by the internals of "
|
|
"Emacs, and not by programmers calling @code{debug}.) Here is a table of "
|
|
"these special values:"
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:596
|
|
#, no-wrap
|
|
msgid "lambda"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:597
|
|
#, no-wrap
|
|
msgid "@code{lambda} in debug"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:603
|
|
msgid ""
|
|
"A first argument of @code{lambda} means @code{debug} was called because of "
|
|
"entry to a function when @code{debug-on-next-call} was non-@code{nil}. The "
|
|
"debugger displays @samp{Debugger entered--entering a function:} as a line of "
|
|
"text at the top of the buffer."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:604
|
|
#, no-wrap
|
|
msgid "debug"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:610
|
|
msgid ""
|
|
"@code{debug} as first argument means @code{debug} was called because of "
|
|
"entry to a function that was set to debug on entry. The debugger displays "
|
|
"the string @samp{Debugger entered--entering a function:}, just as in the "
|
|
"@code{lambda} case. It also marks the stack frame for that function so that "
|
|
"it will invoke the debugger when exited."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:611
|
|
#, no-wrap
|
|
msgid "t"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:617
|
|
msgid ""
|
|
"When the first argument is @code{t}, this indicates a call to @code{debug} "
|
|
"due to evaluation of a function call form when @code{debug-on-next-call} is "
|
|
"non-@code{nil}. The debugger displays @samp{Debugger entered--beginning "
|
|
"evaluation of function call form:} as the top line in the buffer."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:618
|
|
#, no-wrap
|
|
msgid "exit"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:625
|
|
msgid ""
|
|
"When the first argument is @code{exit}, it indicates the exit of a stack "
|
|
"frame previously marked to invoke the debugger on exit. The second argument "
|
|
"given to @code{debug} in this case is the value being returned from the "
|
|
"frame. The debugger displays @samp{Debugger entered--returning value:} in "
|
|
"the top line of the buffer, followed by the value being returned."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:626
|
|
#, no-wrap
|
|
msgid "error"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:627
|
|
#, no-wrap
|
|
msgid "@code{error} in debug"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:633
|
|
msgid ""
|
|
"When the first argument is @code{error}, the debugger indicates that it is "
|
|
"being entered because an error or @code{quit} was signaled and not handled, "
|
|
"by displaying @samp{Debugger entered--Lisp error:} followed by the error "
|
|
"signaled and any arguments to @code{signal}. For example,"
|
|
msgstr ""
|
|
|
|
#. type: group
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:638
|
|
#, no-wrap
|
|
msgid ""
|
|
"(let ((debug-on-error t))\n"
|
|
" (/ 1 0))\n"
|
|
msgstr ""
|
|
|
|
#. type: group
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:646
|
|
#, no-wrap
|
|
msgid ""
|
|
"------ Buffer: *Backtrace* ------\n"
|
|
"Debugger entered--Lisp error: (arith-error)\n"
|
|
" /(1 0)\n"
|
|
"...\n"
|
|
"------ Buffer: *Backtrace* ------\n"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:652
|
|
msgid ""
|
|
"If an error was signaled, presumably the variable @code{debug-on-error} is "
|
|
"non-@code{nil}. If @code{quit} was signaled, then presumably the variable "
|
|
"@code{debug-on-quit} is non-@code{nil}."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:653
|
|
#, no-wrap
|
|
msgid "nil"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:659
|
|
msgid ""
|
|
"Use @code{nil} as the first of the @var{debugger-args} when you want to "
|
|
"enter the debugger explicitly. The rest of the @var{debugger-args} are "
|
|
"printed on the top line of the buffer. You can use this feature to display "
|
|
"messages---for example, to remind yourself of the conditions under which "
|
|
"@code{debug} is called."
|
|
msgstr ""
|
|
|
|
#. type: subsection
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:663
|
|
#, no-wrap
|
|
msgid "Internals of the Debugger"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:667
|
|
msgid ""
|
|
"This section describes functions and variables used internally by the "
|
|
"debugger."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:668
|
|
#, no-wrap
|
|
msgid "debugger"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:674
|
|
msgid ""
|
|
"The value of this variable is the function to call to invoke the debugger. "
|
|
"Its value must be a function of any number of arguments, or, more typically, "
|
|
"the name of a function. This function should invoke some kind of debugger. "
|
|
"The default value of the variable is @code{debug}."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:678
|
|
msgid ""
|
|
"The first argument that Lisp hands to the function indicates why it was "
|
|
"called. The convention for arguments is detailed in the description of "
|
|
"@code{debug} (@pxref{Invoking the Debugger})."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:680
|
|
#, no-wrap
|
|
msgid "backtrace"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:681
|
|
#, no-wrap
|
|
msgid "run time stack"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:682
|
|
#, no-wrap
|
|
msgid "call stack"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:686
|
|
msgid ""
|
|
"This function prints a trace of Lisp function calls currently active. The "
|
|
"trace is identical to the one that @code{debug} would show in the "
|
|
"@file{*Backtrace*} buffer. The return value is always nil."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:691
|
|
msgid ""
|
|
"In the following example, a Lisp expression calls @code{backtrace} "
|
|
"explicitly. This prints the backtrace to the stream @code{standard-output}, "
|
|
"which, in this case, is the buffer @samp{backtrace-output}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:697
|
|
msgid ""
|
|
"Each line of the backtrace represents one function call. The line shows the "
|
|
"function followed by a list of the values of the function's arguments if "
|
|
"they are all known; if they are still being computed, the line consists of a "
|
|
"list containing the function and its unevaluated arguments. Long lists or "
|
|
"deeply nested structures may be elided."
|
|
msgstr ""
|
|
|
|
#. type: group
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:706
|
|
#, no-wrap
|
|
msgid ""
|
|
"(with-output-to-temp-buffer \"backtrace-output\"\n"
|
|
" (let ((var 1))\n"
|
|
" (save-excursion\n"
|
|
" (setq var (eval '(progn\n"
|
|
" (1+ var)\n"
|
|
" (list 'testing (backtrace))))))))\n"
|
|
"\n"
|
|
msgstr ""
|
|
|
|
#. type: group
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:708
|
|
#, no-wrap
|
|
msgid " @result{} (testing nil)\n"
|
|
msgstr ""
|
|
|
|
#. type: group
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:714
|
|
#, no-wrap
|
|
msgid ""
|
|
"----------- Buffer: backtrace-output ------------\n"
|
|
" backtrace()\n"
|
|
" (list 'testing (backtrace))\n"
|
|
msgstr ""
|
|
|
|
#. type: smallexample
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:723
|
|
#, no-wrap
|
|
msgid ""
|
|
" (progn ...)\n"
|
|
" eval((progn (1+ var) (list 'testing (backtrace))))\n"
|
|
" (setq ...)\n"
|
|
" (save-excursion ...)\n"
|
|
" (let ...)\n"
|
|
" (with-output-to-temp-buffer ...)\n"
|
|
" eval((with-output-to-temp-buffer ...))\n"
|
|
" eval-last-sexp-1(nil)\n"
|
|
msgstr ""
|
|
|
|
#. type: group
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:727
|
|
#, no-wrap
|
|
msgid ""
|
|
" eval-last-sexp(nil)\n"
|
|
" call-interactively(eval-last-sexp)\n"
|
|
"----------- Buffer: backtrace-output ------------\n"
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:731
|
|
#, no-wrap
|
|
msgid "debugger-stack-frame-as-list"
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:736
|
|
msgid ""
|
|
"If this variable is non-@code{nil}, every stack frame of the backtrace is "
|
|
"displayed as a list. This aims at improving the backtrace readability at "
|
|
"the cost of special forms no longer being visually different from regular "
|
|
"function calls."
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:739
|
|
msgid ""
|
|
"With @code{debugger-stack-frame-as-list} non-@code{nil}, the above example "
|
|
"would look as follows:"
|
|
msgstr ""
|
|
|
|
#. type: group
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:745
|
|
#, no-wrap
|
|
msgid ""
|
|
"----------- Buffer: backtrace-output ------------\n"
|
|
" (backtrace)\n"
|
|
" (list 'testing (backtrace))\n"
|
|
msgstr ""
|
|
|
|
#. type: smallexample
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:754
|
|
#, no-wrap
|
|
msgid ""
|
|
" (progn ...)\n"
|
|
" (eval (progn (1+ var) (list 'testing (backtrace))))\n"
|
|
" (setq ...)\n"
|
|
" (save-excursion ...)\n"
|
|
" (let ...)\n"
|
|
" (with-output-to-temp-buffer ...)\n"
|
|
" (eval (with-output-to-temp-buffer ...))\n"
|
|
" (eval-last-sexp-1 nil)\n"
|
|
msgstr ""
|
|
|
|
#. type: group
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:758
|
|
#, no-wrap
|
|
msgid ""
|
|
" (eval-last-sexp nil)\n"
|
|
" (call-interactively eval-last-sexp)\n"
|
|
"----------- Buffer: backtrace-output ------------\n"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:762
|
|
#, no-wrap
|
|
msgid "debug-on-next-call"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:763
|
|
#, no-wrap
|
|
msgid "@code{eval}, and debugging"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:764
|
|
#, no-wrap
|
|
msgid "@code{apply}, and debugging"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:765
|
|
#, no-wrap
|
|
msgid "@code{funcall}, and debugging"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:769
|
|
msgid ""
|
|
"If this variable is non-@code{nil}, it says to call the debugger before the "
|
|
"next @code{eval}, @code{apply} or @code{funcall}. Entering the debugger "
|
|
"sets @code{debug-on-next-call} to @code{nil}."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:771
|
|
msgid "The @kbd{d} command in the debugger works by setting this variable."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:773
|
|
#, no-wrap
|
|
msgid "backtrace-debug level flag"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:779
|
|
msgid ""
|
|
"This function sets the debug-on-exit flag of the stack frame @var{level} "
|
|
"levels down the stack, giving it the value @var{flag}. If @var{flag} is "
|
|
"non-@code{nil}, this will cause the debugger to be entered when that frame "
|
|
"later exits. Even a nonlocal exit through that frame will enter the "
|
|
"debugger."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:781
|
|
msgid "This function is used only by the debugger."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:783
|
|
#, no-wrap
|
|
msgid "command-debug-status"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:789
|
|
msgid ""
|
|
"This variable records the debugging status of the current interactive "
|
|
"command. Each time a command is called interactively, this variable is "
|
|
"bound to @code{nil}. The debugger can set this variable to leave "
|
|
"information for future debugger invocations during the same command "
|
|
"invocation."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:793
|
|
msgid ""
|
|
"The advantage of using this variable rather than an ordinary global variable "
|
|
"is that the data will never carry over to a subsequent command invocation."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:795
|
|
msgid "This variable is obsolete and will be removed in future versions."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:797
|
|
#, no-wrap
|
|
msgid "backtrace-frame frame-number &optional base"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:801
|
|
msgid ""
|
|
"The function @code{backtrace-frame} is intended for use in Lisp debuggers. "
|
|
"It returns information about what computation is happening in the stack "
|
|
"frame @var{frame-number} levels down."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:804
|
|
msgid ""
|
|
"If that frame has not evaluated the arguments yet, or is a special form, the "
|
|
"value is @code{(nil @var{function} @var{arg-forms}@dots{})}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:808
|
|
msgid ""
|
|
"If that frame has evaluated its arguments and called its function already, "
|
|
"the return value is @code{(t @var{function} @var{arg-values}@dots{})}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:813
|
|
msgid ""
|
|
"In the return value, @var{function} is whatever was supplied as the @sc{car} "
|
|
"of the evaluated list, or a @code{lambda} expression in the case of a macro "
|
|
"call. If the function has a @code{&rest} argument, that is represented as "
|
|
"the tail of the list @var{arg-values}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:816
|
|
msgid ""
|
|
"If @var{base} is specified, @var{frame-number} counts relative to the "
|
|
"topmost frame whose @var{function} is @var{base}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:819
|
|
msgid ""
|
|
"If @var{frame-number} is out of range, @code{backtrace-frame} returns "
|
|
"@code{nil}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:821
|
|
#, no-wrap
|
|
msgid "mapbacktrace function &optional base"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:825
|
|
msgid ""
|
|
"The function @code{mapbacktrace} calls @var{function} once for each frame in "
|
|
"the backtrace, starting at the first frame whose function is @var{base} (or "
|
|
"from the top if @var{base} is omitted or @code{nil})."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:828
|
|
msgid ""
|
|
"@var{function} is called with four arguments: @var{evald}, @var{func}, "
|
|
"@var{args}, and @var{flags}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:831
|
|
msgid ""
|
|
"If a frame has not evaluated its arguments yet or is a special form, "
|
|
"@var{evald} is @code{nil} and @var{args} is a list of forms."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:837
|
|
msgid ""
|
|
"If a frame has evaluated its arguments and called its function already, "
|
|
"@var{evald} is @code{t} and @var{args} is a list of values. @var{flags} is "
|
|
"a plist of properties of the current frame: currently, the only supported "
|
|
"property is @code{:debug-on-exit}, which is @code{t} if the stack frame's "
|
|
"@code{debug-on-exit} flag is set."
|
|
msgstr ""
|
|
|
|
#. type: include
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:839
|
|
#, no-wrap
|
|
msgid "edebug.texi"
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:842
|
|
#, no-wrap
|
|
msgid "Debugging Invalid Lisp Syntax"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:843
|
|
#, no-wrap
|
|
msgid "debugging invalid Lisp syntax"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:853
|
|
msgid ""
|
|
"The Lisp reader reports invalid syntax, but cannot say where the real "
|
|
"problem is. For example, the error @samp{End of file during parsing} in "
|
|
"evaluating an expression indicates an excess of open parentheses (or square "
|
|
"brackets). The reader detects this imbalance at the end of the file, but it "
|
|
"cannot figure out where the close parenthesis should have been. Likewise, "
|
|
"@samp{Invalid read syntax: \")\"} indicates an excess close parenthesis or "
|
|
"missing open parenthesis, but does not say where the missing parenthesis "
|
|
"belongs. How, then, to find what to change?"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:859
|
|
msgid ""
|
|
"If the problem is not simply an imbalance of parentheses, a useful technique "
|
|
"is to try @kbd{C-M-e} (@code{end-of-defun}, @pxref{Moving by Defuns,,,emacs, "
|
|
"The GNU Emacs Manual}) at the beginning of each defun, and see if it goes to "
|
|
"the place where that defun appears to end. If it does not, there is a "
|
|
"problem in that defun."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:860
|
|
#, no-wrap
|
|
msgid "unbalanced parentheses"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:861
|
|
#, no-wrap
|
|
msgid "parenthesis mismatch, debugging"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:866
|
|
msgid ""
|
|
"However, unmatched parentheses are the most common syntax errors in Lisp, "
|
|
"and we can give further advice for those cases. (In addition, just moving "
|
|
"point through the code with Show Paren mode enabled might find the "
|
|
"mismatch.)"
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:870
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:872
|
|
#, no-wrap
|
|
msgid "Excess Open"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:870
|
|
msgid "How to find a spurious open paren or missing close."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:870
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:910
|
|
#, no-wrap
|
|
msgid "Excess Close"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:870
|
|
msgid "How to find a spurious close paren or missing open."
|
|
msgstr ""
|
|
|
|
#. type: subsection
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:873
|
|
#, no-wrap
|
|
msgid "Excess Open Parentheses"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:874
|
|
#, no-wrap
|
|
msgid "excess open parentheses"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:881
|
|
msgid ""
|
|
"The first step is to find the defun that is unbalanced. If there is an "
|
|
"excess open parenthesis, the way to do this is to go to the end of the file "
|
|
"and type @kbd{C-u C-M-u} (@code{backward-up-list}, @pxref{Moving by "
|
|
"Parens,,,emacs, The GNU Emacs Manual}). This will move you to the beginning "
|
|
"of the first defun that is unbalanced."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:889
|
|
msgid ""
|
|
"The next step is to determine precisely what is wrong. There is no way to "
|
|
"be sure of this except by studying the program, but often the existing "
|
|
"indentation is a clue to where the parentheses should have been. The "
|
|
"easiest way to use this clue is to reindent with @kbd{C-M-q} "
|
|
"(@code{indent-pp-sexp}, @pxref{Multi-line Indent,,,emacs, The GNU Emacs "
|
|
"Manual}) and see what moves. @strong{But don't do this yet!} Keep reading, "
|
|
"first."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:895
|
|
msgid ""
|
|
"Before you do this, make sure the defun has enough close parentheses. "
|
|
"Otherwise, @kbd{C-M-q} will get an error, or will reindent all the rest of "
|
|
"the file until the end. So move to the end of the defun and insert a close "
|
|
"parenthesis there. Don't use @kbd{C-M-e} (@code{end-of-defun}) to move "
|
|
"there, since that too will fail to work until the defun is balanced."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:904
|
|
msgid ""
|
|
"Now you can go to the beginning of the defun and type @kbd{C-M-q}. Usually "
|
|
"all the lines from a certain point to the end of the function will shift to "
|
|
"the right. There is probably a missing close parenthesis, or a superfluous "
|
|
"open parenthesis, near that point. (However, don't assume this is true; "
|
|
"study the code to make sure.) Once you have found the discrepancy, undo the "
|
|
"@kbd{C-M-q} with @kbd{C-_} (@code{undo}), since the old indentation is "
|
|
"probably appropriate to the intended parentheses."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:909
|
|
msgid ""
|
|
"After you think you have fixed the problem, use @kbd{C-M-q} again. If the "
|
|
"old indentation actually fit the intended nesting of parentheses, and you "
|
|
"have put back those parentheses, @kbd{C-M-q} should not change anything."
|
|
msgstr ""
|
|
|
|
#. type: subsection
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:911
|
|
#, no-wrap
|
|
msgid "Excess Close Parentheses"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:912
|
|
#, no-wrap
|
|
msgid "excess close parentheses"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:918
|
|
msgid ""
|
|
"To deal with an excess close parenthesis, first go to the beginning of the "
|
|
"file, then type @kbd{C-u -1 C-M-u} (@code{backward-up-list} with an argument "
|
|
"of @minus{}1) to find the end of the first unbalanced defun."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:924
|
|
msgid ""
|
|
"Then find the actual matching close parenthesis by typing @kbd{C-M-f} "
|
|
"(@code{forward-sexp}, @pxref{Expressions,,,emacs, The GNU Emacs Manual}) at "
|
|
"the beginning of that defun. This will leave you somewhere short of the "
|
|
"place where the defun ought to end. It is possible that you will find a "
|
|
"spurious close parenthesis in that vicinity."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:933
|
|
msgid ""
|
|
"If you don't see a problem at that point, the next thing to do is to type "
|
|
"@kbd{C-M-q} (@code{indent-pp-sexp}) at the beginning of the defun. A range "
|
|
"of lines will probably shift left; if so, the missing open parenthesis or "
|
|
"spurious close parenthesis is probably near the first of those lines. "
|
|
"(However, don't assume this is true; study the code to make sure.) Once you "
|
|
"have found the discrepancy, undo the @kbd{C-M-q} with @kbd{C-_} "
|
|
"(@code{undo}), since the old indentation is probably appropriate to the "
|
|
"intended parentheses."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:938
|
|
msgid ""
|
|
"After you think you have fixed the problem, use @kbd{C-M-q} again. If the "
|
|
"old indentation actually fits the intended nesting of parentheses, and you "
|
|
"have put back those parentheses, @kbd{C-M-q} should not change anything."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:941
|
|
#, no-wrap
|
|
msgid "coverage testing"
|
|
msgstr ""
|
|
|
|
#. type: findex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:943
|
|
#, no-wrap
|
|
msgid "testcover-start"
|
|
msgstr ""
|
|
|
|
#. type: findex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:944
|
|
#, no-wrap
|
|
msgid "testcover-mark-all"
|
|
msgstr ""
|
|
|
|
#. type: findex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:945
|
|
#, no-wrap
|
|
msgid "testcover-next-mark"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:954
|
|
msgid ""
|
|
"You can do coverage testing for a file of Lisp code by loading the "
|
|
"@code{testcover} library and using the command @kbd{M-x testcover-start "
|
|
"@key{RET} @var{file} @key{RET}} to instrument the code. Then test your code "
|
|
"by calling it one or more times. Then use the command @kbd{M-x "
|
|
"testcover-mark-all} to display colored highlights on the code to show where "
|
|
"coverage is insufficient. The command @kbd{M-x testcover-next-mark} will "
|
|
"move point forward to the next highlighted spot."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:962
|
|
msgid ""
|
|
"Normally, a red highlight indicates the form was never completely evaluated; "
|
|
"a brown highlight means it always evaluated to the same value (meaning there "
|
|
"has been little testing of what is done with the result). However, the red "
|
|
"highlight is skipped for forms that can't possibly complete their "
|
|
"evaluation, such as @code{error}. The brown highlight is skipped for forms "
|
|
"that are expected to always evaluate to the same value, such as @code{(setq "
|
|
"x 14)}."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:965
|
|
msgid ""
|
|
"For difficult cases, you can add do-nothing macros to your code to give "
|
|
"advice to the test coverage tool."
|
|
msgstr ""
|
|
|
|
#. type: defmac
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:966
|
|
#, no-wrap
|
|
msgid "1value form"
|
|
msgstr ""
|
|
|
|
#. type: defmac
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:969
|
|
msgid ""
|
|
"Evaluate @var{form} and return its value, but inform coverage testing that "
|
|
"@var{form}'s value should always be the same."
|
|
msgstr ""
|
|
|
|
#. type: defmac
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:971
|
|
#, no-wrap
|
|
msgid "noreturn form"
|
|
msgstr ""
|
|
|
|
#. type: defmac
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:974
|
|
msgid ""
|
|
"Evaluate @var{form}, informing coverage testing that @var{form} should never "
|
|
"return. If it ever does return, you get a run-time error."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:979
|
|
msgid ""
|
|
"Edebug also has a coverage testing feature (@pxref{Coverage Testing}). "
|
|
"These features partly duplicate each other, and it would be cleaner to "
|
|
"combine them."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:983
|
|
#, no-wrap
|
|
msgid "profiling"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:984
|
|
#, no-wrap
|
|
msgid "profile"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:985
|
|
#, no-wrap
|
|
msgid "performance analysis"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:986
|
|
#, no-wrap
|
|
msgid "measuring resource usage"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:987
|
|
#, no-wrap
|
|
msgid "memory usage"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:995
|
|
msgid ""
|
|
"If your program is working correctly, but not fast enough, and you want to "
|
|
"make it run more quickly or efficiently, the first thing to do is "
|
|
"@dfn{profile} your code so that you know where it spends most of the "
|
|
"execution time. If you find that one particular function is responsible for "
|
|
"a significant portion of the execution time, you can start looking for ways "
|
|
"to optimize that piece."
|
|
msgstr ""
|
|
|
|
#. type: findex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:996
|
|
#, no-wrap
|
|
msgid "profiler-start"
|
|
msgstr ""
|
|
|
|
#. type: findex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:997
|
|
#, no-wrap
|
|
msgid "profiler-report"
|
|
msgstr ""
|
|
|
|
#. type: findex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:998
|
|
#, no-wrap
|
|
msgid "profiler-stop"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:1011
|
|
msgid ""
|
|
"Emacs has built-in support for this. To begin profiling, type @w{@kbd{M-x "
|
|
"profiler-start}}. You can choose to sample CPU usage periodically "
|
|
"(@code{cpu}), when memory is allocated (@code{memory}), or both. Then run "
|
|
"the code you'd like to speed up. After that, type @kbd{M-x profiler-report} "
|
|
"to display a summary buffer for CPU usage sampled by each type (cpu and "
|
|
"memory) that you chose to profile. The names of the report buffers include "
|
|
"the times at which the reports were generated, so you can generate another "
|
|
"report later on without erasing previous results. When you have finished "
|
|
"profiling, type @kbd{M-x profiler-stop} (there is a small overhead "
|
|
"associated with profiling, so we don't recommend leaving it active except "
|
|
"when you are actually running the code you want to examine)."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:1021
|
|
msgid ""
|
|
"The profiler report buffer shows, on each line, a function that was called, "
|
|
"preceded by how much CPU resources it used in absolute and percentage terms "
|
|
"since profiling started. If a given line has a @samp{+} symbol to the left "
|
|
"of the function name, you can expand that line by typing @kbd{@key{RET}}, in "
|
|
"order to see the function(s) called by the higher-level function. Use a "
|
|
"prefix argument (@kbd{C-u @key{RET}}) to see the whole call tree below a "
|
|
"function. Pressing @kbd{@key{RET}} again will collapse back to the original "
|
|
"state."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:1026
|
|
msgid ""
|
|
"Press @kbd{j} or @kbd{mouse-2} to jump to the definition of a function at "
|
|
"point. Press @kbd{d} to view a function's documentation. You can save a "
|
|
"profile to a file using @kbd{C-x C-w}. You can compare two profiles using "
|
|
"@kbd{=}."
|
|
msgstr ""
|
|
|
|
#. type: file{#1}
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:1029
|
|
#, no-wrap
|
|
msgid "elp.el"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:1030
|
|
#, no-wrap
|
|
msgid "timing programs"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:1041
|
|
msgid ""
|
|
"The @file{elp} library offers an alternative approach, which is useful when "
|
|
"you know in advance which Lisp function(s) you want to profile. Using that "
|
|
"library, you begin by setting @code{elp-function-list} to the list of "
|
|
"function symbols---those are the functions you want to profile. Then type "
|
|
"@w{@kbd{M-x elp-instrument-list @key{RET} nil @key{RET}}} to arrange for "
|
|
"profiling those functions. After running the code you want to profile, "
|
|
"invoke @w{@kbd{M-x elp-results}} to display the current results. See the "
|
|
"file @file{elp.el} for more detailed instructions. This approach is limited "
|
|
"to profiling functions written in Lisp, it cannot profile Emacs primitives."
|
|
msgstr ""
|
|
|
|
#. type: file{#1}
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:1042
|
|
#, no-wrap
|
|
msgid "benchmark.el"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:1043
|
|
#, no-wrap
|
|
msgid "benchmarking"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:1050
|
|
msgid ""
|
|
"You can measure the time it takes to evaluate individual Emacs Lisp forms "
|
|
"using the @file{benchmark} library. See the function @code{benchmark-call} "
|
|
"as well as the macros @code{benchmark-run}, @code{benchmark-run-compiled}, "
|
|
"@code{benchmark-progn} and @code{benchmark-call} in @file{benchmark.el}. "
|
|
"You can also use the @code{benchmark} command for timing forms "
|
|
"interactively."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:1053
|
|
#, no-wrap
|
|
msgid "--enable-profiling option of configure"
|
|
msgstr ""
|
|
|
|
#. type: ifnottex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/debugging.texi:1060
|
|
msgid ""
|
|
"To profile Emacs at the level of its C code, you can build it using the "
|
|
"@option{--enable-profiling} option of @command{configure}. When Emacs "
|
|
"exits, it generates a file @file{gmon.out} that you can examine using the "
|
|
"@command{gprof} utility. This feature is mainly useful for debugging "
|
|
"Emacs. It actually stops the Lisp-level @kbd{M-x profiler-@dots{}} commands "
|
|
"described above from working."
|
|
msgstr ""
|