documentation_emacs_test/source/lispref/edebug.texi.fr.po

4346 lines
152 KiB
Plaintext
Raw Normal View History

2022-03-08 11:11:57 +01:00
# 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: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:13
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:14
#, no-wrap
msgid "Edebug"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:15
#, no-wrap
msgid "Edebug debugging facility"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:19
msgid ""
"Edebug is a source-level debugger for Emacs Lisp programs, with which you "
"can:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:23
msgid "Step through evaluation, stopping before and after each expression."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:26
msgid "Set conditional or unconditional breakpoints."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:29
msgid "Stop when a specified condition is true (the global break event)."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:33
msgid ""
"Trace slow or fast, stopping briefly at each stop point, or at each "
"breakpoint."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:37
msgid "Display expression results and evaluate expressions as if outside of Edebug."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:41
msgid ""
"Automatically re-evaluate a list of expressions and display their results "
"each time Edebug updates the display."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:44
msgid "Output trace information on function calls and returns."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:47
msgid "Stop when an error occurs."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:50
msgid "Display a backtrace, omitting Edebug's own frames."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:53
msgid "Specify argument evaluation for macros and defining forms."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:56
msgid "Obtain rudimentary coverage testing and frequency counts."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:60
msgid ""
"The first three sections below should tell you enough about Edebug to start "
"using it."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:82
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:83
#, no-wrap
msgid "Using Edebug"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Introduction to use of Edebug."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:152
#, no-wrap
msgid "Instrumenting"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "You must instrument your code in order to debug it with Edebug."
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Modes: Edebug Execution Modes"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Execution modes, stopping more or less often."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:344
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:345
#, no-wrap
msgid "Jumping"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Commands to jump to a specified place."
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Misc: Edebug Misc"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Miscellaneous commands."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:474
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:475
#, no-wrap
msgid "Breaks"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Setting breakpoints to make the program stop."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:613
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:614
#, no-wrap
msgid "Trapping Errors"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Trapping errors with Edebug."
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Views: Edebug Views"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Views inside and outside of Edebug."
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Eval: Edebug Eval"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Evaluating expressions within Edebug."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:724
#, no-wrap
msgid "Eval List"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Expressions whose values are displayed each time you enter Edebug."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:830
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:831
#, no-wrap
msgid "Printing in Edebug"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Customization of printing."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:883
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:884
#, no-wrap
msgid "Trace Buffer"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "How to produce trace output in a buffer."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:930
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:931
#, no-wrap
msgid "Coverage Testing"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "How to test evaluation coverage."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1001
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1002
#, no-wrap
msgid "The Outside Context"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Data that Edebug saves and restores."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1142
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1143
#, no-wrap
msgid "Edebug and Macros"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Specifying how to handle macro calls."
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Options: Edebug Options"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:80
msgid "Option variables for customizing Edebug."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:90
msgid ""
"To debug a Lisp program with Edebug, you must first @dfn{instrument} the "
"Lisp code that you want to debug. A simple way to do this is to first move "
"point into the definition of a function or macro and then do @kbd{C-u C-M-x} "
"(@code{eval-defun} with a prefix argument). See @ref{Instrumenting}, for "
"alternative ways to instrument code."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:97
msgid ""
"Once a function is instrumented, any call to the function activates Edebug. "
"Depending on which Edebug execution mode you have selected, activating "
"Edebug may stop execution and let you step through the function, or it may "
"update the display and continue execution while checking for debugging "
"commands. The default execution mode is step, which stops execution. "
"@xref{Edebug Execution Modes}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:101
msgid ""
"Within Edebug, you normally view an Emacs buffer showing the source of the "
"Lisp code you are debugging. This is referred to as the @dfn{source code "
"buffer}, and it is temporarily read-only."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:105
msgid ""
"An arrow in the left fringe indicates the line where the function is "
"executing. Point initially shows where within the line the function is "
"executing, but this ceases to be true if you move point yourself."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:109
msgid ""
"If you instrument the definition of @code{fac} (shown below) and then "
"execute @code{(fac 3)}, here is what you would normally see. Point is at "
"the open-parenthesis before @code{if}."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:115
#, no-wrap
msgid ""
"(defun fac (n)\n"
"=>@point{}(if (< 0 n)\n"
" (* n (fac (1- n)))\n"
" 1))\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:117
#, no-wrap
msgid "stop points"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:123
msgid ""
"The places within a function where Edebug can stop execution are called "
"@dfn{stop points}. These occur both before and after each subexpression "
"that is a list, and also after each variable reference. Here we use periods "
"to show the stop points in the function @code{fac}:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:129
#, no-wrap
msgid ""
"(defun fac (n)\n"
" .(if .(< 0 n.).\n"
" .(* n. .(fac .(1- n.).).).\n"
" 1).)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:136
msgid ""
"The special commands of Edebug are available in the source code buffer in "
"addition to the commands of Emacs Lisp mode. For example, you can type the "
"Edebug command @key{SPC} to execute until the next stop point. If you type "
"@key{SPC} once after entry to @code{fac}, here is the display you will see:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:142
#, no-wrap
msgid ""
"(defun fac (n)\n"
"=>(if @point{}(< 0 n)\n"
" (* n (fac (1- n)))\n"
" 1))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:146
msgid ""
"When Edebug stops execution after an expression, it displays the "
"expression's value in the echo area."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:151
msgid ""
"Other frequently used commands are @kbd{b} to set a breakpoint at a stop "
"point, @kbd{g} to execute until a breakpoint is reached, and @kbd{q} to exit "
"Edebug and return to the top-level command loop. Type @kbd{?} to display a "
"list of all Edebug commands."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:153
#, no-wrap
msgid "Instrumenting for Edebug"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:154
#, no-wrap
msgid "instrumenting for Edebug"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:159
msgid ""
"In order to use Edebug to debug Lisp code, you must first @dfn{instrument} "
"the code. Instrumenting code inserts additional code into it, to invoke "
"Edebug at the proper places."
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:160
#, no-wrap
msgid "C-M-x"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:161
#, no-wrap
msgid "eval-defun @r{(Edebug)}"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:171
msgid ""
"When you invoke command @kbd{C-M-x} (@code{eval-defun}) with a prefix "
"argument on a function definition, it instruments the definition before "
"evaluating it. (This does not modify the source code itself.) If the "
"variable @code{edebug-all-defs} is non-@code{nil}, that inverts the meaning "
"of the prefix argument: in this case, @kbd{C-M-x} instruments the definition "
"@emph{unless} it has a prefix argument. The default value of "
"@code{edebug-all-defs} is @code{nil}. The command @kbd{M-x edebug-all-defs} "
"toggles the value of the variable @code{edebug-all-defs}."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:172
#, no-wrap
msgid "eval-region @r{(Edebug)}"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:173
#, no-wrap
msgid "eval-buffer @r{(Edebug)}"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:174
#, no-wrap
msgid "eval-current-buffer @r{(Edebug)}"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:182
msgid ""
"If @code{edebug-all-defs} is non-@code{nil}, then the commands "
"@code{eval-region}, @code{eval-current-buffer}, and @code{eval-buffer} also "
"instrument any definitions they evaluate. Similarly, "
"@code{edebug-all-forms} controls whether @code{eval-region} should "
"instrument @emph{any} form, even non-defining forms. This doesn't apply to "
"loading or evaluations in the minibuffer. The command @kbd{M-x "
"edebug-all-forms} toggles this option."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:183
#, no-wrap
msgid "edebug-eval-top-level-form"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:184
#, no-wrap
msgid "edebug-defun"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:189
msgid ""
"Another command, @kbd{M-x edebug-eval-top-level-form}, is available to "
"instrument any top-level form regardless of the values of "
"@code{edebug-all-defs} and @code{edebug-all-forms}. @code{edebug-defun} is "
"an alias for @code{edebug-eval-top-level-form}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:199
msgid ""
"While Edebug is active, the command @kbd{I} "
"(@code{edebug-instrument-callee}) instruments the definition of the function "
"or macro called by the list form after point, if it is not already "
"instrumented. This is possible only if Edebug knows where to find the "
"source for that function; for this reason, after loading Edebug, "
"@code{eval-region} records the position of every definition it evaluates, "
"even if not instrumenting it. See also the @kbd{i} command "
"(@pxref{Jumping}), which steps into the call after instrumenting the "
"function."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:206
msgid ""
"Edebug knows how to instrument all the standard special forms, "
"@code{interactive} forms with an expression argument, anonymous lambda "
"expressions, and other defining forms. However, Edebug cannot determine on "
"its own what a user-defined macro will do with the arguments of a macro "
"call, so you must provide that information using Edebug specifications; for "
"details, @pxref{Edebug and Macros}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:211
msgid ""
"When Edebug is about to instrument code for the first time in a session, it "
"runs the hook @code{edebug-setup-hook}, then sets it to @code{nil}. You can "
"use this to load Edebug specifications associated with a package you are "
"using, but only when you use Edebug."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:212
#, no-wrap
msgid "edebug, failure to instrument"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:217
msgid ""
"If Edebug detects a syntax error while instrumenting, it leaves point at the "
"erroneous code and signals an @code{invalid-read-syntax} error. Example:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:220
#, no-wrap
msgid "@error{} Invalid read syntax: \"Expected lambda expression\"\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:225
msgid ""
"One potential reason for such a failure to instrument is that some macro "
"definitions are not yet known to Emacs. To work around this, load the file "
"which defines the function you are about to instrument."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:226
#, no-wrap
msgid "eval-expression @r{(Edebug)}"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:232
msgid ""
"To remove instrumentation from a definition, simply re-evaluate its "
"definition in a way that does not instrument. There are two ways of "
"evaluating forms that never instrument them: from a file with @code{load}, "
"and from the minibuffer with @code{eval-expression} (@kbd{M-:})."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:233
#, no-wrap
msgid "edebug-remove-instrumentation"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:238
msgid ""
"A different way to remove the instrumentation from a definition is to use "
"the @code{edebug-remove-instrumentation} command. It also allows removing "
"the instrumentation from everything that has been instrumented."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:241
msgid ""
"@xref{Edebug Eval}, for other evaluation functions available inside of "
"Edebug."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:242
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:243
#, no-wrap
msgid "Edebug Execution Modes"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:245
#, no-wrap
msgid "Edebug execution modes"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:253
msgid ""
"Edebug supports several execution modes for running the program you are "
"debugging. We call these alternatives @dfn{Edebug execution modes}; do not "
"confuse them with major or minor modes. The current Edebug execution mode "
"determines how far Edebug continues execution before stopping---whether it "
"stops at each stop point, or continues to the next breakpoint, for "
"example---and how much Edebug displays the progress of the evaluation before "
"it stops."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:258
msgid ""
"Normally, you specify the Edebug execution mode by typing a command to "
"continue the program in a certain mode. Here is a table of these commands; "
"all except for @kbd{S} resume execution of the program, at least for a "
"certain distance."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:260
#, no-wrap
msgid "S"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:264
msgid ""
"Stop: don't execute any more of the program, but wait for more Edebug "
"commands (@code{edebug-stop})."
msgstr ""
#. type: key{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:265
#, no-wrap
msgid "SPC"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:267
msgid "Step: stop at the next stop point encountered (@code{edebug-step-mode})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:268
#, no-wrap
msgid "n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:272
msgid ""
"Next: stop at the next stop point encountered after an expression "
"(@code{edebug-next-mode}). Also see @code{edebug-forward-sexp} in "
"@ref{Jumping}."
msgstr ""
#. type: code{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:273
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1217
#, no-wrap
msgid "t"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:276
msgid ""
"Trace: pause (normally one second) at each Edebug stop point "
"(@code{edebug-trace-mode})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:277
#, no-wrap
msgid "T"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:280
msgid ""
"Rapid trace: update the display at each stop point, but don't actually pause "
"(@code{edebug-Trace-fast-mode})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:281
#, no-wrap
msgid "g"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:283
msgid ""
"Go: run until the next breakpoint (@code{edebug-go-mode}). "
"@xref{Breakpoints}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:284
#, no-wrap
msgid "c"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:287
msgid ""
"Continue: pause one second at each breakpoint, and then continue "
"(@code{edebug-continue-mode})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:288
#, no-wrap
msgid "C"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:291
msgid ""
"Rapid continue: move point to each breakpoint, but don't pause "
"(@code{edebug-Continue-fast-mode})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:292
#, no-wrap
msgid "G"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:295
msgid ""
"Go non-stop: ignore breakpoints (@code{edebug-Go-nonstop-mode}). You can "
"still stop the program by typing @kbd{S}, or any editing command."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:299
msgid ""
"In general, the execution modes earlier in the above list run the program "
"more slowly or stop sooner than the modes later in the list."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:307
msgid ""
"When you enter a new Edebug level, Edebug will normally stop at the first "
"instrumented function it encounters. If you prefer to stop only at a break "
"point, or not at all (for example, when gathering coverage data), change the "
"value of @code{edebug-initial-mode} from its default @code{step} to "
"@code{go}, or @code{Go-nonstop}, or one of its other values (@pxref{Edebug "
"Options}). You can do this readily with @kbd{C-x C-a C-m} "
"(@code{edebug-set-initial-mode}):"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:308
#, no-wrap
msgid "Command edebug-set-initial-mode"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:309
#, no-wrap
msgid "C-x C-a C-m"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:314
msgid ""
"This command, bound to @kbd{C-x C-a C-m}, sets @code{edebug-initial-mode}. "
"It prompts you for a key to indicate the mode. You should enter one of the "
"eight keys listed above, which sets the corresponding mode."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:319
msgid ""
"Note that you may reenter the same Edebug level several times if, for "
"example, an instrumented function is called several times from one command."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:325
msgid ""
"While executing or tracing, you can interrupt the execution by typing any "
"Edebug command. Edebug stops the program at the next stop point and then "
"executes the command you typed. For example, typing @kbd{t} during "
"execution switches to trace mode at the next stop point. You can use "
"@kbd{S} to stop execution without doing anything else."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:330
msgid ""
"If your function happens to read input, a character you type intending to "
"interrupt execution may be read by the function instead. You can avoid such "
"unintended results by paying attention to when your program wants input."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:331
#, no-wrap
msgid "keyboard macros (Edebug)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:338
msgid ""
"Keyboard macros containing the commands in this section do not completely "
"work: exiting from Edebug, to resume the program, loses track of the "
"keyboard macro. This is not easy to fix. Also, defining or executing a "
"keyboard macro outside of Edebug does not affect commands inside Edebug. "
"This is usually an advantage. See also the @code{edebug-continue-kbd-macro} "
"option in @ref{Edebug Options}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:339
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1767
#, no-wrap
msgid "edebug-sit-for-seconds"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:342
msgid ""
"This option specifies how many seconds to wait between execution steps in "
"trace mode or continue mode. The default is 1 second."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:352
msgid ""
"The commands described in this section execute until they reach a specified "
"location. All except @kbd{i} make a temporary breakpoint to establish the "
"place to stop, then switch to go mode. Any other breakpoint reached before "
"the intended stop point will also stop execution. @xref{Breakpoints}, for "
"the details on breakpoints."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:356
msgid ""
"These commands may fail to work as expected in case of nonlocal exit, as "
"that can bypass the temporary breakpoint where you expected the program to "
"stop."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:358
#, no-wrap
msgid "h"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:360
msgid "Proceed to the stop point near where point is (@code{edebug-goto-here})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:361
#, no-wrap
msgid "f"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:364
msgid "Run the program for one expression (@code{edebug-forward-sexp})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:365
#, no-wrap
msgid "o"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:367
msgid ""
"Run the program until the end of the containing sexp "
"(@code{edebug-step-out})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:368
#, no-wrap
msgid "i"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:371
msgid ""
"Step into the function or macro called by the form after point "
"(@code{edebug-step-in})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:375
msgid ""
"The @kbd{h} command proceeds to the stop point at or after the current "
"location of point, using a temporary breakpoint."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:380
msgid ""
"The @kbd{f} command runs the program forward over one expression. More "
"precisely, it sets a temporary breakpoint at the position that "
"@code{forward-sexp} would reach, then executes in go mode so that the "
"program will stop at breakpoints."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:385
msgid ""
"With a prefix argument @var{n}, the temporary breakpoint is placed @var{n} "
"sexps beyond point. If the containing list ends before @var{n} more "
"elements, then the place to stop is after the containing expression."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:389
msgid ""
"You must check that the position @code{forward-sexp} finds is a place that "
"the program will really get to. In @code{cond}, for example, this may not "
"be true."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:394
msgid ""
"For flexibility, the @kbd{f} command does @code{forward-sexp} starting at "
"point, rather than at the stop point. If you want to execute one expression "
"@emph{from the current stop point}, first type @kbd{w} (@code{edebug-where}) "
"to move point there, and then type @kbd{f}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:402
msgid ""
"The @kbd{o} command continues out of an expression. It places a temporary "
"breakpoint at the end of the sexp containing point. If the containing sexp "
"is a function definition itself, @kbd{o} continues until just before the "
"last sexp in the definition. If that is where you are now, it returns from "
"the function and then stops. In other words, this command does not exit the "
"currently executing function unless you are positioned after the last sexp."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:407
msgid ""
"Normally, the @kbd{h}, @kbd{f}, and @kbd{o} commands display ``Break'' and "
"pause for @code{edebug-sit-for-seconds} before showing the result of the "
"form just evaluated. You can avoid this pause by setting "
"@code{edebug-sit-on-break} to @code{nil}. @xref{Edebug Options}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:413
msgid ""
"The @kbd{i} command steps into the function or macro called by the list form "
"after point, and stops at its first stop point. Note that the form need not "
"be the one about to be evaluated. But if the form is a function call about "
"to be evaluated, remember to use this command before any of the arguments "
"are evaluated, since otherwise it will be too late."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:418
msgid ""
"The @kbd{i} command instruments the function or macro it's supposed to step "
"into, if it isn't instrumented already. This is convenient, but keep in "
"mind that the function or macro remains instrumented unless you explicitly "
"arrange to deinstrument it."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:419
#, no-wrap
msgid "Edebug Misc"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:420
#, no-wrap
msgid "Miscellaneous Edebug Commands"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:423
msgid "Some miscellaneous Edebug commands are described here."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:425
#, no-wrap
msgid "?"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:427
msgid "Display the help message for Edebug (@code{edebug-help})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:428
#, no-wrap
msgid "a"
msgstr ""
#. type: itemx
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:429
#, no-wrap
msgid "C-]"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:432
msgid ""
"Abort one level back to the previous command level "
"(@code{abort-recursive-edit})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:433
#, no-wrap
msgid "q"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:439
msgid ""
"Return to the top level editor command loop (@code{top-level}). This exits "
"all recursive editing levels, including all levels of Edebug activity. "
"However, instrumented code protected with @code{unwind-protect} or "
"@code{condition-case} forms may resume debugging."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:440
#, no-wrap
msgid "Q"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:443
msgid ""
"Like @kbd{q}, but don't stop even for protected code "
"(@code{edebug-top-level-nonstop})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:444
#, no-wrap
msgid "r"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:447
msgid ""
"Redisplay the most recently known expression result in the echo area "
"(@code{edebug-previous-result})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:448
#, no-wrap
msgid "d"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:451
msgid ""
"Display a backtrace, excluding Edebug's own functions for clarity "
"(@code{edebug-pop-to-backtrace})."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:454
msgid ""
"@xref{Backtraces}, for a description of backtraces and the commands which "
"work on them."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:455
#, no-wrap
msgid "edebug-backtrace-show-instrumentation"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:456
#, no-wrap
msgid "edebug-backtrace-hide-instrumentation"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:460
msgid ""
"If you would like to see Edebug's functions in the backtrace, use @kbd{M-x "
"edebug-backtrace-show-instrumentation}. To hide them again use @kbd{M-x "
"edebug-backtrace-hide-instrumentation}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:464
msgid ""
"If a backtrace frame starts with @samp{>} that means that Edebug knows where "
"the source code for the frame is located. Use @kbd{s} to jump to the source "
"code for the current frame."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:467
msgid "The backtrace buffer is killed automatically when you continue execution."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:473
msgid ""
"You can invoke commands from Edebug that activate Edebug again recursively. "
"Whenever Edebug is active, you can quit to the top level with @kbd{q} or "
"abort one recursive edit level with @kbd{C-]}. You can display a backtrace "
"of all the pending evaluations with @kbd{d}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:480
msgid ""
"Edebug's step mode stops execution when the next stop point is reached. "
"There are three other ways to stop Edebug execution once it has started: "
"breakpoints, the global break condition, and source breakpoints."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:485
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:487
#, no-wrap
msgid "Breakpoints"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:485
msgid "Breakpoints at stop points."
msgstr ""
#. type: subsubsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:485
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:561
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:562
#, no-wrap
msgid "Global Break Condition"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:485
msgid "Breaking on an event."
msgstr ""
#. type: subsubsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:485
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:584
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:585
#, no-wrap
msgid "Source Breakpoints"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:485
msgid "Embedding breakpoints in source code."
msgstr ""
#. type: subsubsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:488
#, no-wrap
msgid "Edebug Breakpoints"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:490
#, no-wrap
msgid "breakpoints (Edebug)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:497
msgid ""
"While using Edebug, you can specify @dfn{breakpoints} in the program you are "
"testing: these are places where execution should stop. You can set a "
"breakpoint at any stop point, as defined in @ref{Using Edebug}. For setting "
"and unsetting breakpoints, the stop point that is affected is the first one "
"at or after point in the source code buffer. Here are the Edebug commands "
"for breakpoints:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:499
#, no-wrap
msgid "b"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:505
msgid ""
"Set a breakpoint at the stop point at or after point "
"(@code{edebug-set-breakpoint}). If you use a prefix argument, the "
"breakpoint is temporary---it turns off the first time it stops the program. "
"An overlay with the @code{edebug-enabled-breakpoint} or "
"@code{edebug-disabled-breakpoint} faces is put at the breakpoint."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:506
#, no-wrap
msgid "u"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:509
msgid ""
"Unset the breakpoint (if any) at the stop point at or after point "
"(@code{edebug-unset-breakpoint})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:510
#, no-wrap
msgid "U"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:513
msgid "Unset any breakpoints in the current form (@code{edebug-unset-breakpoints})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:514
#, no-wrap
msgid "D"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:519
msgid ""
"Toggle whether to disable the breakpoint near point "
"(@code{edebug-toggle-disable-breakpoint}). This command is mostly useful if "
"the breakpoint is conditional and it would take some work to recreate the "
"condition."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:520
#, no-wrap
msgid "x @var{condition} @key{RET}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:525
msgid ""
"Set a conditional breakpoint which stops the program only if evaluating "
"@var{condition} produces a non-@code{nil} value "
"(@code{edebug-set-conditional-breakpoint}). With a prefix argument, the "
"breakpoint is temporary."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:526
#, no-wrap
msgid "B"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:529
msgid ""
"Move point to the next breakpoint in the current definition "
"(@code{edebug-next-breakpoint})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:535
msgid ""
"While in Edebug, you can set a breakpoint with @kbd{b} and unset one with "
"@kbd{u}. First move point to the Edebug stop point of your choice, then "
"type @kbd{b} or @kbd{u} to set or unset a breakpoint there. Unsetting a "
"breakpoint where none has been set has no effect."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:538
msgid ""
"Re-evaluating or reinstrumenting a definition removes all of its previous "
"breakpoints."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:546
msgid ""
"A @dfn{conditional breakpoint} tests a condition each time the program gets "
"there. Any errors that occur as a result of evaluating the condition are "
"ignored, as if the result were @code{nil}. To set a conditional breakpoint, "
"use @kbd{x}, and specify the condition expression in the minibuffer. "
"Setting a conditional breakpoint at a stop point that has a previously "
"established conditional breakpoint puts the previous condition expression in "
"the minibuffer so you can edit it."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:551
msgid ""
"You can make a conditional or unconditional breakpoint @dfn{temporary} by "
"using a prefix argument with the command to set the breakpoint. When a "
"temporary breakpoint stops the program, it is automatically unset."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:554
msgid ""
"Edebug always stops or pauses at a breakpoint, except when the Edebug mode "
"is Go-nonstop. In that mode, it ignores breakpoints entirely."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:560
msgid ""
"To find out where your breakpoints are, use the @kbd{B} command, which moves "
"point to the next breakpoint following point, within the same function, or "
"to the first breakpoint if there are no following breakpoints. This command "
"does not continue execution---it just moves point in the buffer."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:564
#, no-wrap
msgid "stopping on events"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:565
#, no-wrap
msgid "global break condition"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:572
msgid ""
"A @dfn{global break condition} stops execution when a specified condition is "
"satisfied, no matter where that may occur. Edebug evaluates the global "
"break condition at every stop point; if it evaluates to a non-@code{nil} "
"value, then execution stops or pauses depending on the execution mode, as if "
"a breakpoint had been hit. If evaluating the condition gets an error, "
"execution does not stop."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:573
#, no-wrap
msgid "edebug-set-global-break-condition"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:579
msgid ""
"The condition expression is stored in @code{edebug-global-break-condition}. "
"You can specify a new expression using the @kbd{X} command from the source "
"code buffer while Edebug is active, or using @kbd{C-x X X} from any buffer "
"at any time, as long as Edebug is loaded "
"(@code{edebug-set-global-break-condition})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:583
msgid ""
"The global break condition is the simplest way to find where in your code "
"some event occurs, but it makes code run much more slowly. So you should "
"reset the condition to @code{nil} when not using it."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:587
#, no-wrap
msgid "edebug"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:588
#, no-wrap
msgid "source breakpoints"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:596
msgid ""
"All breakpoints in a definition are forgotten each time you reinstrument "
"it. If you wish to make a breakpoint that won't be forgotten, you can write "
"a @dfn{source breakpoint}, which is simply a call to the function "
"@code{edebug} in your source code. You can, of course, make such a call "
"conditional. For example, in the @code{fac} function, you can insert the "
"first line as shown below, to stop when the argument reaches zero:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:603
#, no-wrap
msgid ""
"(defun fac (n)\n"
" (if (= n 0) (edebug))\n"
" (if (< 0 n)\n"
" (* n (fac (1- n)))\n"
" 1))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:608
msgid ""
"When the @code{fac} definition is instrumented and the function is called, "
"the call to @code{edebug} acts as a breakpoint. Depending on the execution "
"mode, Edebug stops or pauses there."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:612
msgid ""
"If no instrumented code is being executed when @code{edebug} is called, that "
"function calls @code{debug}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:621
msgid ""
"Emacs normally displays an error message when an error is signaled and not "
"handled with @code{condition-case}. While Edebug is active and executing "
"instrumented code, it normally responds to all unhandled errors. You can "
"customize this with the options @code{edebug-on-error} and "
"@code{edebug-on-quit}; see @ref{Edebug Options}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:628
msgid ""
"When Edebug responds to an error, it shows the last stop point encountered "
"before the error. This may be the location of a call to a function which "
"was not instrumented, and within which the error actually occurred. For an "
"unbound variable error, the last known stop point might be quite distant "
"from the offending variable reference. In that case, you might want to "
"display a full backtrace (@pxref{Edebug Misc})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:634
msgid ""
"If you change @code{debug-on-error} or @code{debug-on-quit} while Edebug is "
"active, these changes will be forgotten when Edebug becomes inactive. "
"Furthermore, during Edebug's recursive edit, these variables are bound to "
"the values they had outside of Edebug."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:635
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:636
#, no-wrap
msgid "Edebug Views"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:642
msgid ""
"These Edebug commands let you view aspects of the buffer and window status "
"as they were before entry to Edebug. The outside window configuration is "
"the collection of windows and contents that were in effect outside of "
"Edebug."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:644
#, no-wrap
msgid "P"
msgstr ""
#. type: itemx
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:645
#, no-wrap
msgid "v"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:648
msgid ""
"Switch to viewing the outside window configuration "
"(@code{edebug-view-outside}). Type @kbd{C-x X w} to return to Edebug."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:649
#, no-wrap
msgid "p"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:654
msgid ""
"Temporarily display the outside current buffer with point at its outside "
"position (@code{edebug-bounce-point}), pausing for one second before "
"returning to Edebug. With a prefix argument @var{n}, pause for @var{n} "
"seconds instead."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:655
#, no-wrap
msgid "w"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:658
msgid ""
"Move point back to the current stop point in the source code buffer "
"(@code{edebug-where})."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:662
msgid ""
"If you use this command in a different window displaying the same buffer, "
"that window will be used instead to display the current definition in the "
"future."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:663
#, no-wrap
msgid "W"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:667
msgid ""
"Toggle whether Edebug saves and restores the outside window configuration "
"(@code{edebug-toggle-save-windows})."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:671
msgid ""
"With a prefix argument, @kbd{W} only toggles saving and restoring of the "
"selected window. To specify a window that is not displaying the source code "
"buffer, you must use @kbd{C-x X W} from the global keymap."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:676
msgid ""
"You can view the outside window configuration with @kbd{v} or just bounce to "
"the point in the current buffer with @kbd{p}, even if it is not normally "
"displayed."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:681
msgid ""
"After moving point, you may wish to jump back to the stop point. You can do "
"that with @kbd{w} from a source code buffer. You can jump back to the stop "
"point in the source code buffer from any buffer using @kbd{C-x X w}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:689
msgid ""
"Each time you use @kbd{W} to turn saving @emph{off}, Edebug forgets the "
"saved outside window configuration---so that even if you turn saving back "
"@emph{on}, the current window configuration remains unchanged when you next "
"exit Edebug (by continuing the program). However, the automatic redisplay "
"of @file{*edebug*} and @file{*edebug-trace*} may conflict with the buffers "
"you wish to see unless you have enough windows open."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:690
#, no-wrap
msgid "Edebug Eval"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:691
#, no-wrap
msgid "Evaluation"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:699
msgid ""
"While within Edebug, you can evaluate expressions as if Edebug were not "
"running. Edebug tries to be invisible to the expression's evaluation and "
"printing. Evaluation of expressions that cause side effects will work as "
"expected, except for changes to data that Edebug explicitly saves and "
"restores. @xref{The Outside Context}, for details on this process."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:701
#, no-wrap
msgid "e @var{exp} @key{RET}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:705
msgid ""
"Evaluate expression @var{exp} in the context outside of Edebug "
"(@code{edebug-eval-expression}). That is, Edebug tries to minimize its "
"interference with the evaluation."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:706
#, no-wrap
msgid "M-: @var{exp} @key{RET}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:709
msgid ""
"Evaluate expression @var{exp} in the context of Edebug itself "
"(@code{eval-expression})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:710
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:749
#, no-wrap
msgid "C-x C-e"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:715
msgid ""
"Evaluate the expression before point, in the context outside of Edebug "
"(@code{edebug-eval-last-sexp}). With the prefix argument of zero (@kbd{C-u "
"0 C-x C-e}), don't shorten long items (like strings and lists)."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:717
#, no-wrap
msgid "lexical binding (Edebug)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:723
msgid ""
"Edebug supports evaluation of expressions containing references to lexically "
"bound symbols created by the following constructs in @file{cl.el}: "
"@code{lexical-let}, @code{macrolet}, and @code{symbol-macrolet}."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:725
#, no-wrap
msgid "Evaluation List Buffer"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:731
msgid ""
"You can use the @dfn{evaluation list buffer}, called @file{*edebug*}, to "
"evaluate expressions interactively. You can also set up the @dfn{evaluation "
"list} of expressions to be evaluated automatically each time Edebug updates "
"the display."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:733
#, no-wrap
msgid "E"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:736
msgid ""
"Switch to the evaluation list buffer @file{*edebug*} "
"(@code{edebug-visit-eval-list})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:741
msgid ""
"In the @file{*edebug*} buffer you can use the commands of Lisp Interaction "
"mode (@pxref{Lisp Interaction,,, emacs, The GNU Emacs Manual}) as well as "
"these special commands:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:743
#, no-wrap
msgid "C-j"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:748
msgid ""
"Evaluate the expression before point, in the outside context, and insert the "
"value in the buffer (@code{edebug-eval-print-last-sexp}). With prefix "
"argument of zero (@kbd{C-u 0 C-j}), don't shorten long items (like strings "
"and lists)."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:752
msgid ""
"Evaluate the expression before point, in the context outside of Edebug "
"(@code{edebug-eval-last-sexp})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:753
#, no-wrap
msgid "C-c C-u"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:756
msgid ""
"Build a new evaluation list from the contents of the buffer "
"(@code{edebug-update-eval-list})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:757
#, no-wrap
msgid "C-c C-d"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:760
msgid ""
"Delete the evaluation list group that point is in "
"(@code{edebug-delete-eval-item})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:761
#, no-wrap
msgid "C-c C-w"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:764
msgid ""
"Switch back to the source code buffer at the current stop point "
"(@code{edebug-where})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:769
msgid ""
"You can evaluate expressions in the evaluation list window with @kbd{C-j} or "
"@kbd{C-x C-e}, just as you would in @file{*scratch*}; but they are evaluated "
"in the context outside of Edebug."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:773
msgid ""
"The expressions you enter interactively (and their results) are lost when "
"you continue execution; but you can set up an @dfn{evaluation list} "
"consisting of expressions to be evaluated each time execution stops."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:774
#, no-wrap
msgid "evaluation list group"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:778
msgid ""
"To do this, write one or more @dfn{evaluation list groups} in the evaluation "
"list buffer. An evaluation list group consists of one or more Lisp "
"expressions. Groups are separated by comment lines."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:783
msgid ""
"The command @kbd{C-c C-u} (@code{edebug-update-eval-list}) rebuilds the "
"evaluation list, scanning the buffer and using the first expression of each "
"group. (The idea is that the second expression of the group is the value "
"previously computed and displayed.)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:789
msgid ""
"Each entry to Edebug redisplays the evaluation list by inserting each "
"expression in the buffer, followed by its current value. It also inserts "
"comment lines so that each expression becomes its own group. Thus, if you "
"type @kbd{C-c C-u} again without changing the buffer text, the evaluation "
"list is effectively unchanged."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:794
msgid ""
"If an error occurs during an evaluation from the evaluation list, the error "
"message is displayed in a string as if it were the result. Therefore, "
"expressions using variables that are not currently valid do not interrupt "
"your debugging."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:797
msgid ""
"Here is an example of what the evaluation list window looks like after "
"several expressions have been added to it:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:817
#, no-wrap
msgid ""
"(current-buffer)\n"
"#<buffer *scratch*>\n"
";---------------------------------------------------------------\n"
"(selected-window)\n"
"#<window 16 on *scratch*>\n"
";---------------------------------------------------------------\n"
"(point)\n"
"196\n"
";---------------------------------------------------------------\n"
"bad-var\n"
"\"Symbol's value as variable is void: bad-var\"\n"
";---------------------------------------------------------------\n"
"(recursion-depth)\n"
"0\n"
";---------------------------------------------------------------\n"
"this-command\n"
"eval-last-sexp\n"
";---------------------------------------------------------------\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:825
msgid ""
"To delete a group, move point into it and type @kbd{C-c C-d}, or simply "
"delete the text for the group and update the evaluation list with @kbd{C-c "
"C-u}. To add a new expression to the evaluation list, insert the expression "
"at a suitable place, insert a new comment line, then type @kbd{C-c C-u}. "
"You need not insert dashes in the comment line---its contents don't matter."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:829
msgid ""
"After selecting @file{*edebug*}, you can return to the source code buffer "
"with @kbd{C-c C-w}. The @file{*edebug*} buffer is killed when you continue "
"execution, and recreated next time it is needed."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:833
#, no-wrap
msgid "printing (Edebug)"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:834
#, no-wrap
msgid "printing circular structures"
msgstr ""
#. type: pindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:835
#, no-wrap
msgid "cust-print"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:838
msgid ""
"If an expression in your program produces a value containing circular list "
"structure, you may get an error when Edebug attempts to print it."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:845
msgid ""
"One way to cope with circular structure is to set @code{print-length} or "
"@code{print-level} to truncate the printing. Edebug does this for you; it "
"binds @code{print-length} and @code{print-level} to the values of the "
"variables @code{edebug-print-length} and @code{edebug-print-level} (so long "
"as they have non-@code{nil} values). @xref{Output Variables}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:846
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1705
#, no-wrap
msgid "edebug-print-length"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:849
msgid ""
"If non-@code{nil}, Edebug binds @code{print-length} to this value while "
"printing results. The default value is @code{50}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:851
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1710
#, no-wrap
msgid "edebug-print-level"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:854
msgid ""
"If non-@code{nil}, Edebug binds @code{print-level} to this value while "
"printing results. The default value is @code{50}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:859
msgid ""
"You can also print circular structures and structures that share elements "
"more informatively by binding @code{print-circle} to a non-@code{nil} value."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:861
msgid "Here is an example of code that creates a circular structure:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:865
#, no-wrap
msgid ""
"(setq a (list 'x 'y))\n"
"(setcar a a)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:874
msgid ""
"If @code{print-circle} is non-@code{nil}, printing functions (e.g., "
"@code{prin1}) will print @code{a} as @samp{#1=(#1# y)}. The @samp{#1=} "
"notation labels the structure that follows it with the label @samp{1}, and "
"the @samp{#1#} notation references the previously labeled structure. This "
"notation is used for any shared elements of lists or vectors."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:875
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1715
#, no-wrap
msgid "edebug-print-circle"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:878
msgid ""
"If non-@code{nil}, Edebug binds @code{print-circle} to this value while "
"printing results. The default value is @code{t}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:882
msgid ""
"For further details about how printing can be customized, see @pxref{Output "
"Functions}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:885
#, no-wrap
msgid "trace buffer"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:891
msgid ""
"Edebug can record an execution trace, storing it in a buffer named "
"@file{*edebug-trace*}. This is a log of function calls and returns, showing "
"the function names and their arguments and values. To enable trace "
"recording, set @code{edebug-trace} to a non-@code{nil} value."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:894
msgid ""
"Making a trace buffer is not the same thing as using trace execution mode "
"(@pxref{Edebug Execution Modes})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:900
msgid ""
"When trace recording is enabled, each function entry and exit adds lines to "
"the trace buffer. A function entry record consists of @samp{::::@{}, "
"followed by the function name and argument values. A function exit record "
"consists of @samp{::::@}}, followed by the function name and result of the "
"function."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:904
msgid ""
"The number of @samp{:}s in an entry shows its recursion depth. You can use "
"the braces in the trace buffer to find the matching beginning or end of "
"function calls."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:905
#, no-wrap
msgid "edebug-print-trace-before"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:906
#, no-wrap
msgid "edebug-print-trace-after"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:910
msgid ""
"You can customize trace recording for function entry and exit by redefining "
"the functions @code{edebug-print-trace-before} and "
"@code{edebug-print-trace-after}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:911
#, no-wrap
msgid "edebug-tracing string body@dots{}"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:917
msgid ""
"This macro requests additional trace information around the execution of the "
"@var{body} forms. The argument @var{string} specifies text to put in the "
"trace buffer, after the @samp{@{} or @samp{@}}. All the arguments are "
"evaluated, and @code{edebug-tracing} returns the value of the last form in "
"@var{body}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:919
#, no-wrap
msgid "edebug-trace format-string &rest format-args"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:923
msgid ""
"This function inserts text in the trace buffer. It computes the text with "
"@code{(apply 'format @var{format-string} @var{format-args})}. It also "
"appends a newline to separate entries."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:929
msgid ""
"@code{edebug-tracing} and @code{edebug-trace} insert lines in the trace "
"buffer whenever they are called, even if Edebug is not active. Adding text "
"to the trace buffer also scrolls its window to show the last lines inserted."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:933
#, no-wrap
msgid "coverage testing (Edebug)"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:934
#, no-wrap
msgid "frequency counts"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:935
#, no-wrap
msgid "performance analysis (Edebug)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:938
msgid ""
"Edebug provides rudimentary coverage testing and display of execution "
"frequency."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:946
msgid ""
"Coverage testing works by comparing the result of each expression with the "
"previous result; each form in the program is considered covered if it has "
"returned two different values since you began testing coverage in the "
"current Emacs session. Thus, to do coverage testing on your program, "
"execute it under various conditions and note whether it behaves correctly; "
"Edebug will tell you when you have tried enough different conditions that "
"each form has returned two different values."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:952
msgid ""
"Coverage testing makes execution slower, so it is only done if "
"@code{edebug-test-coverage} is non-@code{nil}. Frequency counting is "
"performed for all executions of an instrumented function, even if the "
"execution mode is Go-nonstop, and regardless of whether coverage testing is "
"enabled."
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:953
#, no-wrap
msgid "C-x X ="
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:954
#, no-wrap
msgid "edebug-temp-display-freq-count"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:959
msgid ""
"Use @kbd{C-x X =} (@code{edebug-display-freq-count}) to display both the "
"coverage information and the frequency counts for a definition. Just "
"@kbd{=} (@code{edebug-temp-display-freq-count}) displays the same "
"information temporarily, only until you type another key."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:960
#, no-wrap
msgid "Command edebug-display-freq-count"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:963
msgid ""
"This command displays the frequency count data for each line of the current "
"definition."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:970
msgid ""
"It inserts frequency counts as comment lines after each line of code. You "
"can undo all insertions with one @code{undo} command. The counts appear "
"under the @samp{(} before an expression or the @samp{)} after an expression, "
"or on the last character of a variable. To simplify the display, a count is "
"not shown if it is equal to the count of an earlier expression on the same "
"line."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:974
msgid ""
"The character @samp{=} following the count for an expression says that the "
"expression has returned the same value each time it was evaluated. In other "
"words, it is not yet covered for coverage testing purposes."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:977
msgid ""
"To clear the frequency count and coverage data for a definition, simply "
"reinstrument it with @code{eval-defun}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:982
msgid ""
"For example, after evaluating @code{(fac 5)} with a source breakpoint, and "
"setting @code{edebug-test-coverage} to @code{t}, when the breakpoint is "
"reached, the frequency data looks like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:993
#, no-wrap
msgid ""
"(defun fac (n)\n"
" (if (= n 0) (edebug))\n"
";#6 1 = =5\n"
" (if (< 0 n)\n"
";#5 =\n"
" (* n (fac (1- n)))\n"
";# 5 0\n"
" 1))\n"
";# 0\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:999
msgid ""
"The comment lines show that @code{fac} was called 6 times. The first "
"@code{if} statement returned 5 times with the same result each time; the "
"same is true of the condition on the second @code{if}. The recursive call "
"of @code{fac} did not return at all."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1010
msgid ""
"Edebug tries to be transparent to the program you are debugging, but it does "
"not succeed completely. Edebug also tries to be transparent when you "
"evaluate expressions with @kbd{e} or with the evaluation list buffer, by "
"temporarily restoring the outside context. This section explains precisely "
"what context Edebug restores, and how Edebug fails to be completely "
"transparent."
msgstr ""
#. type: subsubsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1015
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1017
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1018
#, no-wrap
msgid "Checking Whether to Stop"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1015
msgid "When Edebug decides what to do."
msgstr ""
#. type: subsubsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1015
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1041
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1042
#, no-wrap
msgid "Edebug Display Update"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1015
msgid "When Edebug updates the display."
msgstr ""
#. type: subsubsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1015
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1096
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1097
#, no-wrap
msgid "Edebug Recursive Edit"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1015
msgid "When Edebug stops execution."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1023
msgid ""
"Whenever Edebug is entered, it needs to save and restore certain data before "
"even deciding whether to make trace information or stop the program."
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1026
#, no-wrap
msgid "edebug-max-depth"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1033
msgid ""
"@code{max-lisp-eval-depth} (@pxref{Eval}) and @code{max-specpdl-size} "
"(@pxref{Local Variables}) are both increased to reduce Edebug's impact on "
"the stack. You could, however, still run out of stack space when using "
"Edebug. You can also enlarge the value of @code{edebug-max-depth} if Edebug "
"reaches the limit of recursion depth instrumenting code that contains very "
"large quoted lists."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1038
msgid ""
"The state of keyboard macro execution is saved and restored. While Edebug "
"is active, @code{executing-kbd-macro} is bound to @code{nil} unless "
"@code{edebug-continue-kbd-macro} is non-@code{nil}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1050
msgid ""
"When Edebug needs to display something (e.g., in trace mode), it saves the "
"current window configuration from outside Edebug (@pxref{Window "
"Configurations}). When you exit Edebug, it restores the previous window "
"configuration."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1057
msgid ""
"Emacs redisplays only when it pauses. Usually, when you continue execution, "
"the program re-enters Edebug at a breakpoint or after stepping, without "
"pausing or reading input in between. In such cases, Emacs never gets a "
"chance to redisplay the outside configuration. Consequently, what you see "
"is the same window configuration as the last time Edebug was active, with no "
"interruption."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1061
msgid ""
"Entry to Edebug for displaying something also saves and restores the "
"following data (though some of them are deliberately not restored if an "
"error or quit signal occurs)."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1064
#, no-wrap
msgid "current buffer point and mark (Edebug)"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1067
msgid ""
"Which buffer is current, and the positions of point and the mark in the "
"current buffer, are saved and restored."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1069
#, no-wrap
msgid "window configuration (Edebug)"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1072
msgid ""
"The outside window configuration is saved and restored if "
"@code{edebug-save-windows} is non-@code{nil} (@pxref{Edebug Options})."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1078
msgid ""
"The window configuration is not restored on error or quit, but the outside "
"selected window @emph{is} reselected even on error or quit in case a "
"@code{save-excursion} is active. If the value of @code{edebug-save-windows} "
"is a list, only the listed windows are saved and restored."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1081
msgid ""
"The window start and horizontal scrolling of the source code buffer are not "
"restored, however, so that the display remains coherent within Edebug."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1085
msgid ""
"The value of point in each displayed buffer is saved and restored if "
"@code{edebug-save-displayed-buffer-points} is non-@code{nil}."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1090
msgid ""
"The variables @code{overlay-arrow-position} and @code{overlay-arrow-string} "
"are saved and restored, so you can safely invoke Edebug from the recursive "
"edit elsewhere in the same buffer."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1094
msgid ""
"@code{cursor-in-echo-area} is locally bound to @code{nil} so that the cursor "
"shows up in the window."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1101
msgid ""
"When Edebug is entered and actually reads commands from the user, it saves "
"(and later restores) these additional data:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1105
msgid "The current match data. @xref{Match Data}."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1112
msgid ""
"The variables @code{last-command}, @code{this-command}, "
"@code{last-command-event}, @code{last-input-event}, @code{last-event-frame}, "
"@code{last-nonmenu-event}, and @code{track-mouse}. Commands in Edebug do "
"not affect these variables outside of Edebug."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1116
msgid ""
"Executing commands within Edebug can change the key sequence that would be "
"returned by @code{this-command-keys}, and there is no way to reset the key "
"sequence from Lisp."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1121
msgid ""
"Edebug cannot save and restore the value of @code{unread-command-events}. "
"Entering Edebug while this variable has a nontrivial value can interfere "
"with execution of the program you are debugging."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1125
msgid ""
"Complex commands executed while in Edebug are added to the variable "
"@code{command-history}. In rare cases this can alter execution."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1130
msgid ""
"Within Edebug, the recursion depth appears one deeper than the recursion "
"depth outside Edebug. This is not true of the automatically updated "
"evaluation list window."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1135
msgid ""
"@code{standard-output} and @code{standard-input} are bound to @code{nil} by "
"the @code{recursive-edit}, but Edebug temporarily restores them during "
"evaluations."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1140
msgid ""
"The state of keyboard macro definition is saved and restored. While Edebug "
"is active, @code{defining-kbd-macro} is bound to "
"@code{edebug-continue-kbd-macro}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1147
msgid ""
"To make Edebug properly instrument expressions that call macros, some extra "
"care is needed. This subsection explains the details."
msgstr ""
#. type: subsubsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1153
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1155
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1156
#, no-wrap
msgid "Instrumenting Macro Calls"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1153
msgid "The basic problem."
msgstr ""
#. type: subsubsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1153
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1243
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1244
#, no-wrap
msgid "Specification List"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1153
msgid "How to specify complex patterns of evaluation."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1153
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1482
#, no-wrap
msgid "Backtracking"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1153
msgid "What Edebug does when matching fails."
msgstr ""
#. type: subsubsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1153
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1523
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1524
#, no-wrap
msgid "Specification Examples"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1153
msgid "To help understand specifications."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1164
msgid ""
"When Edebug instruments an expression that calls a Lisp macro, it needs "
"additional information about the macro to do the job properly. This is "
"because there is no a-priori way to tell which subexpressions of the macro "
"call are forms to be evaluated. (Evaluation may occur explicitly in the "
"macro body, or when the resulting expansion is evaluated, or any time "
"later.)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1170
msgid ""
"Therefore, you must define an Edebug specification for each macro that "
"Edebug will encounter, to explain the format of calls to that macro. To do "
"this, add a @code{debug} declaration to the macro definition. Here is a "
"simple example that shows the specification for the @code{for} example macro "
"(@pxref{Argument Evaluation})."
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1177
#, no-wrap
msgid ""
"(defmacro for (var from init to final do &rest body)\n"
" \"Execute a simple \\\"for\\\" loop.\n"
"For example, (for i from 1 to 10 do (print i)).\"\n"
" (declare (debug (symbolp \"from\" form \"to\" form \"do\" &rest form)))\n"
" ...)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1185
msgid ""
"The Edebug specification says which parts of a call to the macro are forms "
"to be evaluated. For simple macros, the specification often looks very "
"similar to the formal argument list of the macro definition, but "
"specifications are much more general than macro arguments. @xref{Defining "
"Macros}, for more explanation of the @code{declare} form."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1197
msgid ""
"Take care to ensure that the specifications are known to Edebug when you "
"instrument code. If you are instrumenting a function which uses a macro "
"defined in another file, you may first need to either evaluate the "
"@code{require} forms in the file containing your function, or explicitly "
"load the file containing the macro. If the definition of a macro is wrapped "
"by @code{eval-when-compile}, you may need to evaluate it."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1203
msgid ""
"You can also define an edebug specification for a macro separately from the "
"macro definition with @code{def-edebug-spec}. Adding @code{debug} "
"declarations is preferred, and more convenient, for macro definitions in "
"Lisp, but @code{def-edebug-spec} makes it possible to define Edebug "
"specifications for special forms implemented in C."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1204
#, no-wrap
msgid "def-edebug-spec macro specification"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1208
msgid ""
"Specify which expressions of a call to macro @var{macro} are forms to be "
"evaluated. @var{specification} should be the Edebug specification. Neither "
"argument is evaluated."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1211
msgid "The @var{macro} argument can actually be any symbol, not just a macro name."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1215
msgid ""
"Here is a table of the possibilities for @var{specification} and how each "
"directs processing of arguments."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1220
msgid ""
"All arguments are instrumented for evaluation. This is short for "
"@code{(body)}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1221
#, no-wrap
msgid "a symbol"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1225
msgid ""
"The symbol must have an Edebug specification, which is used instead. This "
"indirection is repeated until another kind of specification is found. This "
"allows you to inherit the specification from another macro."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1226
#, no-wrap
msgid "a list"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1230
msgid ""
"The elements of the list describe the types of the arguments of a calling "
"form. The possible elements of a specification list are described in the "
"following sections."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1235
msgid ""
"If a macro has no Edebug specification, neither through a @code{debug} "
"declaration nor through a @code{def-edebug-spec} call, the variable "
"@code{edebug-eval-macro-args} comes into play."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1236
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1639
#, no-wrap
msgid "edebug-eval-macro-args"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1241
msgid ""
"This controls the way Edebug treats macro arguments with no explicit Edebug "
"specification. If it is @code{nil} (the default), none of the arguments is "
"instrumented for evaluation. Otherwise, all arguments are instrumented."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1246
#, no-wrap
msgid "Edebug specification list"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1253
msgid ""
"A @dfn{specification list} is required for an Edebug specification if some "
"arguments of a macro call are evaluated while others are not. Some elements "
"in a specification list match one or more arguments, but others modify the "
"processing of all following elements. The latter, called @dfn{specification "
"keywords}, are symbols beginning with @samp{&} (such as @code{&optional})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1259
msgid ""
"A specification list may contain sublists, which match arguments that are "
"themselves lists, or it may contain vectors used for grouping. Sublists and "
"groups thus subdivide the specification list into a hierarchy of levels. "
"Specification keywords apply only to the remainder of the sublist or group "
"they are contained in."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1263
msgid ""
"When a specification list involves alternatives or repetition, matching it "
"against an actual macro call may require backtracking. For more details, "
"@pxref{Backtracking}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1268
msgid ""
"Edebug specifications provide the power of regular expression matching, plus "
"some context-free grammar constructs: the matching of sublists with balanced "
"parentheses, recursive processing of forms, and recursion via indirect "
"specifications."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1272
msgid ""
"Here's a table of the possible elements of a specification list, with their "
"meanings (see @ref{Specification Examples}, for the referenced examples):"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1274
#, no-wrap
msgid "sexp"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1277
msgid "A single unevaluated Lisp object, which is not instrumented."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1278
#, no-wrap
msgid "form"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1282
msgid ""
"A single evaluated expression, which is instrumented. If your macro wraps "
"the expression with @code{lambda} before it is evaluated, use "
"@code{def-form} instead. See @code{def-form} below."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1283
#, no-wrap
msgid "place"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1285
msgid "A generalized variable. @xref{Generalized Variables}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1286
#, no-wrap
msgid "body"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1290
msgid ""
"Short for @code{&rest form}. See @code{&rest} below. If your macro wraps "
"its body of code with @code{lambda} before it is evaluated, use "
"@code{def-body} instead. See @code{def-body} below."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1291
#, no-wrap
msgid "lambda-expr"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1293
msgid "A lambda expression with no quoting."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1294
#, no-wrap
msgid "&optional"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1298
msgid ""
"All following elements in the specification list are optional; as soon as "
"one does not match, Edebug stops matching at this level."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1303
msgid ""
"To make just a few elements optional, followed by non-optional elements, use "
"@code{[&optional @var{specs}@dots{}]}. To specify that several elements "
"must all match or none, use @code{&optional [@var{specs}@dots{}]}. See the "
"@code{defun} example."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1304
#, no-wrap
msgid "&rest"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1310
msgid ""
"All following elements in the specification list are repeated zero or more "
"times. In the last repetition, however, it is not a problem if the "
"expression runs out before matching all of the elements of the specification "
"list."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1314
msgid ""
"To repeat only a few elements, use @code{[&rest @var{specs}@dots{}]}. To "
"specify several elements that must all match on every repetition, use "
"@code{&rest [@var{specs}@dots{}]}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1315
#, no-wrap
msgid "&or"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1320
msgid ""
"Each of the following elements in the specification list is an alternative. "
"One of the alternatives must match, or the @code{&or} specification fails."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1324
msgid ""
"Each list element following @code{&or} is a single alternative. To group "
"two or more list elements as a single alternative, enclose them in "
"@code{[@dots{}]}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1325
#, no-wrap
msgid "&not"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1331
msgid ""
"Each of the following elements is matched as alternatives as if by using "
"@code{&or}, but if any of them match, the specification fails. If none of "
"them match, nothing is matched, but the @code{&not} specification succeeds."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1334
#, no-wrap
msgid "&define"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1340
msgid ""
"Indicates that the specification is for a defining form. Edebug's "
"definition of a defining form is a form containing one or more code forms "
"which are saved and executed later, after the execution of the defining "
"form."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1345
msgid ""
"The defining form itself is not instrumented (that is, Edebug does not stop "
"before and after the defining form), but forms inside it typically will be "
"instrumented. The @code{&define} keyword should be the first element in a "
"list specification."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1346
#, no-wrap
msgid "nil"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1350
msgid ""
"This is successful when there are no more arguments to match at the current "
"argument list level; otherwise it fails. See sublist specifications and the "
"backquote example."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1351
#, no-wrap
msgid "gate"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1352
#, no-wrap
msgid "preventing backtracking"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1357
msgid ""
"No argument is matched but backtracking through the gate is disabled while "
"matching the remainder of the specifications at this level. This is "
"primarily used to generate more specific syntax error messages. See "
"@ref{Backtracking}, for more details. Also see the @code{let} example."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1358
#, no-wrap
msgid "&error"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1362
msgid ""
"@code{&error} should be followed by a string, an error message, in the "
"edebug-spec; it aborts the instrumentation, displaying the message in the "
"minibuffer."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1363
#, no-wrap
msgid "&interpose"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1377
msgid ""
"Lets a function control the parsing of the remaining code. It takes the "
"form @code{&interpose @var{spec} @var{fun} @var{args...}} and means that "
"Edebug will first match @var{spec} against the code and then call @var{fun} "
"with the code that matched @code{spec}, a parsing function @var{pf}, and "
"finally @var{args...}. The parsing function expects a single argument "
"indicating the specification list to use to parse the remaining code. It "
"should be called exactly once and returns the instrumented code that "
"@var{fun} is expected to return. For example @code{(&interpose symbolp "
"pcase--match-pat-args)} matches sexps whose first element is a symbol and "
"then lets @code{pcase--match-pat-args} lookup the specs associated with that "
"head symbol according to @code{pcase--match-pat-args} and pass them to the "
"@var{pf} it received as argument."
msgstr ""
#. type: var{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1378
#, no-wrap
msgid "other-symbol"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1379
#, no-wrap
msgid "indirect specifications"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1382
msgid ""
"Any other symbol in a specification list may be a predicate or an indirect "
"specification."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1388
msgid ""
"If the symbol has an Edebug specification, this @dfn{indirect specification} "
"should be either a list specification that is used in place of the symbol, "
"or a function that is called to process the arguments. The specification "
"may be defined with @code{def-edebug-elem-spec}:"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1389
#, no-wrap
msgid "def-edebug-elem-spec element specification"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1392
msgid ""
"Define the @var{specification} to use in place of the symbol @var{element}. "
"@var{specification} has to be a list."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1397
msgid ""
"Otherwise, the symbol should be a predicate. The predicate is called with "
"the argument, and if the predicate returns @code{nil}, the specification "
"fails and the argument is not instrumented."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1400
msgid ""
"Some suitable predicates include @code{symbolp}, @code{integerp}, "
"@code{stringp}, @code{vectorp}, and @code{atom}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1401
#, no-wrap
msgid "[@var{elements}@dots{}]"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1402
#, no-wrap
msgid "[@dots{}] (Edebug)"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1405
msgid ""
"A vector of elements groups the elements into a single @dfn{group "
"specification}. Its meaning has nothing to do with vectors."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1406
#, no-wrap
msgid "\"@var{string}\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1410
msgid ""
"The argument should be a symbol named @var{string}. This specification is "
"equivalent to the quoted symbol, @code{'@var{symbol}}, where the name of "
"@var{symbol} is the @var{string}, but the string form is preferred."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1411
#, no-wrap
msgid "(vector @var{elements}@dots{})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1414
msgid ""
"The argument should be a vector whose elements must match the @var{elements} "
"in the specification. See the backquote example."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1415
#, no-wrap
msgid "(@var{elements}@dots{})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1418
msgid ""
"Any other list is a @dfn{sublist specification} and the argument must be a "
"list whose elements match the specification @var{elements}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1419
#, no-wrap
msgid "dotted lists (Edebug)"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1428
msgid ""
"A sublist specification may be a dotted list and the corresponding list "
"argument may then be a dotted list. Alternatively, the last @sc{cdr} of a "
"dotted list specification may be another sublist specification (via a "
"grouping or an indirect specification, e.g., @code{(spec . [(more "
"specs@dots{})])}) whose elements match the non-dotted list arguments. This "
"is useful in recursive specifications such as in the backquote example. "
"Also see the description of a @code{nil} specification above for terminating "
"such recursion."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1433
msgid ""
"Note that a sublist specification written as @code{(specs . nil)} is "
"equivalent to @code{(specs)}, and @code{(specs . "
"(sublist-elements@dots{}))} is equivalent to @code{(specs "
"sublist-elements@dots{})}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1439
msgid ""
"Here is a list of additional specifications that may appear only after "
"@code{&define}. See the @code{defun} example."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1441
#, no-wrap
msgid "&name"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1450
msgid ""
"Extracts the name of the current defining form from the code. It takes the "
"form @code{&name [@var{prestring}] @var{spec} [@var{poststring}] @var{fun} "
"@var{args...}} and means that Edebug will match @var{spec} against the code "
"and then call @var{fun} with the concatenation of the current name, "
"@var{args...}, @var{prestring}, the code that matched @code{spec}, and "
"@var{poststring}. If @var{fun} is absent, it defaults to a function that "
"concatenates the arguments (with an @code{@@} between the previous name and "
"the new)."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1451
#, no-wrap
msgid "name"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1454
msgid ""
"The argument, a symbol, is the name of the defining form. Shorthand for "
"@code{[&name symbolp]}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1457
msgid ""
"A defining form is not required to have a name field; and it may have "
"multiple name fields."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1458
#, no-wrap
msgid "arg"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1462
msgid ""
"The argument, a symbol, is the name of an argument of the defining form. "
"However, lambda-list keywords (symbols starting with @samp{&}) are not "
"allowed."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1463
#, no-wrap
msgid "lambda-list"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1464
#, no-wrap
msgid "lambda-list (Edebug)"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1466
msgid "This matches a lambda list---the argument list of a lambda expression."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1467
#, no-wrap
msgid "def-body"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1473
msgid ""
"The argument is the body of code in a definition. This is like @code{body}, "
"described above, but a definition body must be instrumented with a different "
"Edebug call that looks up information associated with the definition. Use "
"@code{def-body} for the highest level list of forms within the definition."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1474
#, no-wrap
msgid "def-form"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1480
msgid ""
"The argument is a single, highest-level form in a definition. This is like "
"@code{def-body}, except it is used to match a single form rather than a list "
"of forms. As a special case, @code{def-form} also means that tracing "
"information is not output when the form is executed. See the "
"@code{interactive} example."
msgstr ""
#. type: subsubsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1483
#, no-wrap
msgid "Backtracking in Specifications"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1485
#, no-wrap
msgid "backtracking"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1486
#, no-wrap
msgid "syntax error (Edebug)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1493
msgid ""
"If a specification fails to match at some point, this does not necessarily "
"mean a syntax error will be signaled; instead, @dfn{backtracking} will take "
"place until all alternatives have been exhausted. Eventually every element "
"of the argument list must be matched by some element in the specification, "
"and every required element in the specification must match some argument."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1504
msgid ""
"When a syntax error is detected, it might not be reported until much later, "
"after higher-level alternatives have been exhausted, and with the point "
"positioned further from the real error. But if backtracking is disabled "
"when an error occurs, it can be reported immediately. Note that "
"backtracking is also reenabled automatically in several situations; when a "
"new alternative is established by @code{&optional}, @code{&rest}, or "
"@code{&or}, or at the start of processing a sublist, group, or indirect "
"specification. The effect of enabling or disabling backtracking is limited "
"to the remainder of the level currently being processed and lower levels."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1509
msgid ""
"Backtracking is disabled while matching any of the form specifications (that "
"is, @code{form}, @code{body}, @code{def-form}, and @code{def-body}). These "
"specifications will match any form so any error must be in the form itself "
"rather than at a higher level."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1516
msgid ""
"Backtracking is also disabled after successfully matching a quoted symbol, "
"string specification, or @code{&define} keyword, since this usually "
"indicates a recognized construct. But if you have a set of alternative "
"constructs that all begin with the same symbol, you can usually work around "
"this constraint by factoring the symbol out of the alternatives, e.g., "
"@code{[\"foo\" &or [first case] [second case] ...]}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1522
msgid ""
"Most needs are satisfied by these two ways that backtracking is "
"automatically disabled, but occasionally it is useful to explicitly disable "
"backtracking by using the @code{gate} specification. This is useful when "
"you know that no higher alternatives could apply. See the example of the "
"@code{let} specification."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1528
msgid ""
"It may be easier to understand Edebug specifications by studying the "
"examples provided here."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1534
msgid ""
"Consider a hypothetical macro @code{my-test-generator} that runs tests on "
"supplied lists of data. Although it is Edebug's default behavior to not "
"instrument arguments as code, as controlled by @code{edebug-eval-macro-args} "
"(@pxref{Instrumenting Macro Calls}), it can be useful to explicitly document "
"that the arguments are data:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1537
#, no-wrap
msgid "(def-edebug-spec my-test-generator (&rest sexp))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1543
msgid ""
"A @code{let} special form has a sequence of bindings and a body. Each of "
"the bindings is either a symbol or a sublist with a symbol and optional "
"expression. In the specification below, notice the @code{gate} inside of "
"the sublist to prevent backtracking once a sublist is found."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1558
#, no-wrap
msgid ""
"(def-edebug-spec let\n"
" ((&rest\n"
" &or symbolp (gate symbolp &optional form))\n"
" body))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1566
msgid ""
"Edebug uses the following specifications for @code{defun} and the associated "
"argument list and @code{interactive} specifications. It is necessary to "
"handle interactive forms specially since an expression argument is actually "
"evaluated outside of the function body. (The specification for "
"@code{defmacro} is very similar to that for @code{defun}, but allows for the "
"@code{declare} statement.)"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1573
#, no-wrap
msgid ""
"(def-edebug-spec defun\n"
" (&define name lambda-list\n"
" [&optional stringp] ; @r{Match the doc string, if present.}\n"
" [&optional (\"interactive\" interactive)]\n"
" def-body))\n"
"\n"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1579
#, no-wrap
msgid ""
"(def-edebug-elem-spec 'lambda-list\n"
" '(([&rest arg]\n"
" [&optional [\"&optional\" arg &rest arg]]\n"
" &optional [\"&rest\" arg]\n"
" )))\n"
"\n"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1582
#, no-wrap
msgid ""
"(def-edebug-elem-spec 'interactive\n"
" '(&optional &or stringp def-form)) ; @r{Notice: @code{def-form}}\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1590
msgid ""
"The specification for backquote below illustrates how to match dotted lists "
"and use @code{nil} to terminate recursion. It also illustrates how "
"components of a vector may be matched. (The actual specification defined by "
"Edebug is a little different, and does not support dotted lists because "
"doing so causes very deep recursion that could fail.)"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1593
#, no-wrap
msgid ""
"(def-edebug-spec \\` (backquote-form)) ; @r{Alias just for clarity.}\n"
"\n"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1599
#, no-wrap
msgid ""
"(def-edebug-elem-spec 'backquote-form\n"
" '(&or ([&or \",\" \",@@\"] &or (\"quote\" backquote-form) form)\n"
" (backquote-form . [&or nil backquote-form])\n"
" (vector &rest backquote-form)\n"
" sexp))\n"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1602
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1603
#, no-wrap
msgid "Edebug Options"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1609
msgid "These options affect the behavior of Edebug:"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1610
#, no-wrap
msgid "edebug-setup-hook"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1617
msgid ""
"Functions to call before Edebug is used. Each time it is set to a new "
"value, Edebug will call those functions once and then reset "
"@code{edebug-setup-hook} to @code{nil}. You could use this to load up "
"Edebug specifications associated with a package you are using, but only when "
"you also use Edebug. @xref{Instrumenting}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1619
#, no-wrap
msgid "edebug-all-defs"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1624
msgid ""
"If this is non-@code{nil}, normal evaluation of defining forms such as "
"@code{defun} and @code{defmacro} instruments them for Edebug. This applies "
"to @code{eval-defun}, @code{eval-region}, @code{eval-buffer}, and "
"@code{eval-current-buffer}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1627
msgid ""
"Use the command @kbd{M-x edebug-all-defs} to toggle the value of this "
"option. @xref{Instrumenting}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1629
#, no-wrap
msgid "edebug-all-forms"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1634
msgid ""
"If this is non-@code{nil}, the commands @code{eval-defun}, "
"@code{eval-region}, @code{eval-buffer}, and @code{eval-current-buffer} "
"instrument all forms, even those that don't define anything. This doesn't "
"apply to loading or evaluations in the minibuffer."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1637
msgid ""
"Use the command @kbd{M-x edebug-all-forms} to toggle the value of this "
"option. @xref{Instrumenting}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1645
msgid ""
"When this is non-@code{nil}, all macro arguments will be instrumented in the "
"generated code. For any macro, the @code{debug} declaration overrides this "
"option. So to specify exceptions for macros that have some arguments "
"evaluated and some not, use the @code{debug} declaration specify an Edebug "
"form specification."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1647
#, no-wrap
msgid "edebug-save-windows"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1652
msgid ""
"If this is non-@code{nil}, Edebug saves and restores the window "
"configuration. That takes some time, so if your program does not care what "
"happens to the window configurations, it is better to set this variable to "
"@code{nil}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1655
msgid "If the value is a list, only the listed windows are saved and restored."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1658
msgid ""
"You can use the @kbd{W} command in Edebug to change this variable "
"interactively. @xref{Edebug Display Update}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1660
#, no-wrap
msgid "edebug-save-displayed-buffer-points"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1663
msgid ""
"If this is non-@code{nil}, Edebug saves and restores point in all displayed "
"buffers."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1668
msgid ""
"Saving and restoring point in other buffers is necessary if you are "
"debugging code that changes the point of a buffer that is displayed in a "
"non-selected window. If Edebug or the user then selects the window, point "
"in that buffer will move to the window's value of point."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1672
msgid ""
"Saving and restoring point in all buffers is expensive, since it requires "
"selecting each window twice, so enable this only if you need it. "
"@xref{Edebug Display Update}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1674
#, no-wrap
msgid "edebug-initial-mode"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1679
msgid ""
"If this variable is non-@code{nil}, it specifies the initial execution mode "
"for Edebug when it is first activated. Possible values are @code{step}, "
"@code{next}, @code{go}, @code{Go-nonstop}, @code{trace}, @code{Trace-fast}, "
"@code{continue}, and @code{Continue-fast}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1683
msgid ""
"The default value is @code{step}. This variable can be set interactively "
"with @kbd{C-x C-a C-m} (@code{edebug-set-initial-mode}). @xref{Edebug "
"Execution Modes}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1685
#, no-wrap
msgid "edebug-trace"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1689
msgid ""
"If this is non-@code{nil}, trace each function entry and exit. Tracing "
"output is displayed in a buffer named @file{*edebug-trace*}, one function "
"entry or exit per line, indented by the recursion level."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1691
msgid "Also see @code{edebug-tracing}, in @ref{Trace Buffer}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1693
#, no-wrap
msgid "edebug-test-coverage"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1696
msgid ""
"If non-@code{nil}, Edebug tests coverage of all expressions debugged. "
"@xref{Coverage Testing}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1698
#, no-wrap
msgid "edebug-continue-kbd-macro"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1703
msgid ""
"If non-@code{nil}, continue defining or executing any keyboard macro that is "
"executing outside of Edebug. Use this with caution since it is not "
"debugged. @xref{Edebug Execution Modes}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1708
msgid ""
"If non-@code{nil}, the default value of @code{print-length} for printing "
"results in Edebug. @xref{Output Variables}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1713
msgid ""
"If non-@code{nil}, the default value of @code{print-level} for printing "
"results in Edebug. @xref{Output Variables}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1718
msgid ""
"If non-@code{nil}, the default value of @code{print-circle} for printing "
"results in Edebug. @xref{Output Variables}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1720
#, no-wrap
msgid "edebug-unwrap-results"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1727
msgid ""
"If non-@code{nil}, Edebug tries to remove any of its own instrumentation "
"when showing the results of expressions. This is relevant when debugging "
"macros where the results of expressions are themselves instrumented "
"expressions. As a very artificial example, suppose that the example "
"function @code{fac} has been instrumented, and consider a macro of the form:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1733
#, no-wrap
msgid ""
"(defmacro test () \"Edebug example.\"\n"
" (if (symbol-function 'fac)\n"
" @dots{}))\n"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1741
msgid ""
"If you instrument the @code{test} macro and step through it, then by default "
"the result of the @code{symbol-function} call has numerous "
"@code{edebug-after} and @code{edebug-before} forms, which can make it "
"difficult to see the actual result. If @code{edebug-unwrap-results} is "
"non-@code{nil}, Edebug tries to remove these forms from the result."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1743
#, no-wrap
msgid "edebug-on-error"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1747
msgid ""
"Edebug binds @code{debug-on-error} to this value, if @code{debug-on-error} "
"was previously @code{nil}. @xref{Trapping Errors}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1749
#, no-wrap
msgid "edebug-on-quit"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1753
msgid ""
"Edebug binds @code{debug-on-quit} to this value, if @code{debug-on-quit} was "
"previously @code{nil}. @xref{Trapping Errors}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1760
msgid ""
"If you change the values of @code{edebug-on-error} or @code{edebug-on-quit} "
"while Edebug is active, their values won't be used until the @emph{next} "
"time Edebug is invoked via a new command."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1761
#, no-wrap
msgid "edebug-global-break-condition"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1765
msgid ""
"If non-@code{nil}, an expression to test for at every stop point. If the "
"result is non-@code{nil}, then break. Errors are ignored. @xref{Global "
"Break Condition}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1770
msgid ""
"Number of seconds to pause when a breakpoint is reached and the execution "
"mode is trace or continue. @xref{Edebug Execution Modes}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1772
#, no-wrap
msgid "edebug-sit-on-break"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1776
msgid ""
"Whether or not to pause for @code{edebug-sit-for-seconds} on reaching a "
"breakpoint. Set to @code{nil} to prevent the pause, non-@code{nil} to allow "
"it."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1778
#, no-wrap
msgid "edebug-behavior-alist"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1784
msgid ""
"By default, this alist contains one entry with the key @code{edebug} and a "
"list of three functions, which are the default implementations of the "
"functions inserted in instrumented code: @code{edebug-enter}, "
"@code{edebug-before} and @code{edebug-after}. To change Edebug's behavior "
"globally, modify the default entry."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1790
msgid ""
"Edebug's behavior may also be changed on a per-definition basis by adding an "
"entry to this alist, with a key of your choice and three functions. Then "
"set the @code{edebug-behavior} symbol property of an instrumented definition "
"to the key of the new entry, and Edebug will call the new functions in place "
"of its own for that definition."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1792
#, no-wrap
msgid "edebug-new-definition-function"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1799
msgid ""
"A function run by Edebug after it wraps the body of a definition or "
"closure. After Edebug has initialized its own data, this function is called "
"with one argument, the symbol associated with the definition, which may be "
"the actual symbol defined or one generated by Edebug. This function may be "
"used to set the @code{edebug-behavior} symbol property of each definition "
"instrumented by Edebug."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1801
#, no-wrap
msgid "edebug-after-instrumentation-function"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/edebug.texi:1806
msgid ""
"To inspect or modify Edebug's instrumentation before it is used, set this "
"variable to a function which takes one argument, an instrumented top-level "
"form, and returns either the same or a replacement form, which Edebug will "
"then use as the final result of instrumentation."
msgstr ""