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

7068 lines
248 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: chapter
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:5
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:6
#, no-wrap
msgid "Keymaps"
msgstr ""
#. type: var{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:7
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1069
#, no-wrap
msgid "keymap"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:15
msgid ""
"The command bindings of input events are recorded in data structures called "
"@dfn{keymaps}. Each entry in a keymap associates (or @dfn{binds}) an "
"individual event type, either to another keymap or to a command. When an "
"event type is bound to a keymap, that keymap is used to look up the next "
"input event; this continues until a command is found. The whole process is "
"called @dfn{key lookup}."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:40
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:41
#, no-wrap
msgid "Key Sequences"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "Key sequences as Lisp objects."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:116
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:117
#, no-wrap
msgid "Keymap Basics"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "Basic concepts of keymaps."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:168
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:169
#, no-wrap
msgid "Format of Keymaps"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "What a keymap looks like as a Lisp object."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:320
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:321
#, no-wrap
msgid "Creating Keymaps"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "Functions to create and copy keymaps."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:414
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:415
#, no-wrap
msgid "Inheritance and Keymaps"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "How one keymap can inherit the bindings of another keymap."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:502
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:503
#, no-wrap
msgid "Prefix Keys"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "Defining a key with a keymap as its definition."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:661
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:662
#, no-wrap
msgid "Active Keymaps"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "How Emacs searches the active keymaps for a key binding."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:771
#, no-wrap
msgid "Searching Keymaps"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "A pseudo-Lisp summary of searching active maps."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:822
#, no-wrap
msgid "Controlling Active Maps"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid ""
"Each buffer has a local keymap to override the standard (global) bindings. "
"A minor mode can also override them."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1016
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1017
#, no-wrap
msgid "Key Lookup"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "Finding a key's binding in one keymap."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1128
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1129
#, no-wrap
msgid "Functions for Key Lookup"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "How to request key lookup."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1277
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1278
#, no-wrap
msgid "Changing Key Bindings"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "Redefining a key in a keymap."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1627
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1628
#, no-wrap
msgid "Remapping Commands"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "A keymap can translate one command to another."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1689
#, no-wrap
msgid "Translation Keymaps"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "Keymaps for translating sequences of events."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1831
#, no-wrap
msgid "Key Binding Commands"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "Interactive interfaces for redefining keys."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1964
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1965
#, no-wrap
msgid "Scanning Keymaps"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "Looking through all keymaps, for printing help."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2138
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2139
#, no-wrap
msgid "Menu Keymaps"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:38
msgid "Defining a menu as a keymap."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:42
#, no-wrap
msgid "key"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:43
#, no-wrap
msgid "keystroke"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:44
#, no-wrap
msgid "key sequence"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:53
msgid ""
"A @dfn{key sequence}, or @dfn{key} for short, is a sequence of one or more "
"input events that form a unit. Input events include characters, function "
"keys, mouse actions, or system events external to Emacs, such as "
"@code{iconify-frame} (@pxref{Input Events}). The Emacs Lisp representation "
"for a key sequence is a string or vector. Unless otherwise stated, any "
"Emacs Lisp function that accepts a key sequence as an argument can handle "
"both representations."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:65
msgid ""
"In the string representation, alphanumeric characters ordinarily stand for "
"themselves; for example, @code{\"a\"} represents @kbd{a} and @code{\"2\"} "
"represents @kbd{2}. Control character events are prefixed by the substring "
"@code{\"\\C-\"}, and meta characters by @code{\"\\M-\"}; for example, "
"@code{\"\\C-x\"} represents the key @kbd{C-x}. In addition, the @key{TAB}, "
"@key{RET}, @key{ESC}, and @key{DEL} events are represented by "
"@code{\"\\t\"}, @code{\"\\r\"}, @code{\"\\e\"}, and @code{\"\\d\"} "
"respectively. The string representation of a complete key sequence is the "
"concatenation of the string representations of the constituent events; thus, "
"@code{\"\\C-xl\"} represents the key sequence @kbd{C-x l}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:70
msgid ""
"Key sequences containing function keys, mouse button events, system events, "
"or non-@acronym{ASCII} characters such as @kbd{C-=} or @kbd{H-a} cannot be "
"represented as strings; they have to be represented as vectors."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:74
msgid ""
"In the vector representation, each element of the vector represents an input "
"event, in its Lisp form. @xref{Input Events}. For example, the vector "
"@code{[?\\C-x ?l]} represents the key sequence @kbd{C-x l}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:77
msgid ""
"For examples of key sequences written in string and vector representations, "
"@ref{Init Rebinding,,, emacs, The GNU Emacs Manual}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:78
#, no-wrap
msgid "kbd keyseq-text"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:86
msgid ""
"This function converts the text @var{keyseq-text} (a string constant) into "
"a key sequence (a string or vector constant). The contents of "
"@var{keyseq-text} should use the same syntax as in the buffer invoked by the "
"@kbd{C-x C-k @key{RET}} (@code{kmacro-edit-macro}) command; in particular, "
"you must surround function key names with @samp{<@dots{}>}. @xref{Edit "
"Keyboard Macro,,, emacs, The GNU Emacs Manual}."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:96
#, no-wrap
msgid ""
"(kbd \"C-x\") @result{} \"\\C-x\"\n"
"(kbd \"C-x C-f\") @result{} \"\\C-x\\C-f\"\n"
"(kbd \"C-x 4 C-f\") @result{} \"\\C-x4\\C-f\"\n"
"(kbd \"X\") @result{} \"X\"\n"
"(kbd \"RET\") @result{} \"\\^M\"\n"
"(kbd \"C-c SPC\") @result{} \"\\C-c@ \"\n"
"(kbd \"<f1> SPC\") @result{} [f1 32]\n"
"(kbd \"C-M-<down>\") @result{} [C-M-down]\n"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:98
#, no-wrap
msgid "kbd-valid-p"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:103
msgid ""
"The @code{kbd} function is very permissive, and will try to return something "
"sensible even if the syntax used isn't completely conforming. To check "
"whether the syntax is actually valid, use the @code{kbd-valid-p} function."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:108
msgid ""
"@code{define-key} also supports using the shorthand syntax @samp{[\"...\"]} "
"syntax to define a key. The string has to be a strictly valid @code{kbd} "
"sequence, and if it's not valid, an error will be signalled. For instance, "
"to bind @key{C-c f}, you can say:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:111
#, no-wrap
msgid "(define-key global-map [\"C-c f\"] #'find-file-literally)\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:118
#, no-wrap
msgid "key binding"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:119
#, no-wrap
msgid "binding of a key"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:120
#, no-wrap
msgid "complete key"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:121
#, no-wrap
msgid "undefined key"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:125
msgid ""
"A keymap is a Lisp data structure that specifies @dfn{key bindings} for "
"various key sequences."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:133
msgid ""
"A single keymap directly specifies definitions for individual events. When "
"a key sequence consists of a single event, its binding in a keymap is the "
"keymap's definition for that event. The binding of a longer key sequence is "
"found by an iterative process: first find the definition of the first event "
"(which must itself be a keymap); then find the second event's definition in "
"that keymap, and so on until all the events in the key sequence have been "
"processed."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:142
msgid ""
"If the binding of a key sequence is a keymap, we call the key sequence a "
"@dfn{prefix key}. Otherwise, we call it a @dfn{complete key} (because no "
"more events can be added to it). If the binding is @code{nil}, we call the "
"key @dfn{undefined}. Examples of prefix keys are @kbd{C-c}, @kbd{C-x}, and "
"@kbd{C-x 4}. Examples of defined complete keys are @kbd{X}, @key{RET}, and "
"@kbd{C-x 4 C-f}. Examples of undefined complete keys are @kbd{C-x C-g}, and "
"@kbd{C-c 3}. @xref{Prefix Keys}, for more details."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:151
msgid ""
"The rule for finding the binding of a key sequence assumes that the "
"intermediate bindings (found for the events before the last) are all "
"keymaps; if this is not so, the sequence of events does not form a unit---it "
"is not really one key sequence. In other words, removing one or more events "
"from the end of any valid key sequence must always yield a prefix key. For "
"example, @kbd{C-f C-n} is not a key sequence; @kbd{C-f} is not a prefix key, "
"so a longer sequence starting with @kbd{C-f} cannot be a key sequence."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:157
msgid ""
"The set of possible multi-event key sequences depends on the bindings for "
"prefix keys; therefore, it can be different for different keymaps, and can "
"change when bindings are changed. However, a one-event sequence is always a "
"key sequence, because it does not depend on any prefix keys for its "
"well-formedness."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:167
msgid ""
"At any time, several primary keymaps are @dfn{active}---that is, in use for "
"finding key bindings. These are the @dfn{global map}, which is shared by "
"all buffers; the @dfn{local keymap}, which is usually associated with a "
"specific major mode; and zero or more @dfn{minor mode keymaps}, which belong "
"to currently enabled minor modes. (Not all minor modes have keymaps.) The "
"local keymap bindings shadow (i.e., take precedence over) the corresponding "
"global bindings. The minor mode keymaps shadow both local and global "
"keymaps. @xref{Active Keymaps}, for details."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:170
#, no-wrap
msgid "format of keymaps"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:171
#, no-wrap
msgid "keymap format"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:172
#, no-wrap
msgid "full keymap"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:173
#, no-wrap
msgid "sparse keymap"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:180
msgid ""
"Each keymap is a list whose @sc{car} is the symbol @code{keymap}. The "
"remaining elements of the list define the key bindings of the keymap. A "
"symbol whose function definition is a keymap is also a keymap. Use the "
"function @code{keymapp} (see below) to test whether an object is a keymap."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:183
msgid ""
"Several kinds of elements may appear in a keymap, after the symbol "
"@code{keymap} that begins it:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:185
#, no-wrap
msgid "(@var{type} .@: @var{binding})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:190
msgid ""
"This specifies one binding, for events of type @var{type}. Each ordinary "
"binding applies to events of a particular @dfn{event type}, which is always "
"a character or a symbol. @xref{Classifying Events}. In this kind of "
"binding, @var{binding} is a command."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:191
#, no-wrap
msgid "(@var{type} @var{item-name} .@: @var{binding})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:194
msgid ""
"This specifies a binding which is also a simple menu item that displays as "
"@var{item-name} in the menu. @xref{Simple Menu Items}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:195
#, no-wrap
msgid "(@var{type} @var{item-name} @var{help-string} .@: @var{binding})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:197
msgid "This is a simple menu item with help string @var{help-string}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:198
#, no-wrap
msgid "(@var{type} menu-item .@: @var{details})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:201
msgid ""
"This specifies a binding which is also an extended menu item. This allows "
"use of other features. @xref{Extended Menu Items}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:202
#, no-wrap
msgid "(t .@: @var{binding})"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:203
#, no-wrap
msgid "default key binding"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:210
msgid ""
"This specifies a @dfn{default key binding}; any event not bound by other "
"elements of the keymap is given @var{binding} as its binding. Default "
"bindings allow a keymap to bind all possible event types without having to "
"enumerate all of them. A keymap that has a default binding completely masks "
"any lower-precedence keymap, except for events explicitly bound to "
"@code{nil} (see below)."
msgstr ""
#. type: var{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:211
#, no-wrap
msgid "char-table"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:218
msgid ""
"If an element of a keymap is a char-table, it counts as holding bindings for "
"all character events with no modifier bits (@pxref{modifier bits}): the "
"element whose index is @var{c} is the binding for the character @var{c}. "
"This is a compact way to record lots of bindings. A keymap with such a "
"char-table is called a @dfn{full keymap}. Other keymaps are called "
"@dfn{sparse keymaps}."
msgstr ""
#. type: var{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:219
#, no-wrap
msgid "vector"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:227
msgid ""
"This kind of element is similar to a char-table: the element whose index is "
"@var{c} is the binding for the character @var{c}. Since the range of "
"characters that can be bound this way is limited by the vector size, and "
"vector creation allocates space for all character codes from 0 up, this "
"format should not be used except for creating menu keymaps (@pxref{Menu "
"Keymaps}), where the bindings themselves don't matter."
msgstr ""
#. type: var{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:228
#, no-wrap
msgid "string"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:229
#, no-wrap
msgid "keymap prompt string"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:230
#, no-wrap
msgid "overall prompt string"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:231
#, no-wrap
msgid "prompt string of keymap"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:236
msgid ""
"Aside from elements that specify bindings for keys, a keymap can also have a "
"string as an element. This is called the @dfn{overall prompt string} and "
"makes it possible to use the keymap as a menu. @xref{Defining Menus}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:237
#, no-wrap
msgid "(keymap @dots{})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:241
msgid ""
"If an element of a keymap is itself a keymap, it counts as if this inner "
"keymap were inlined in the outer keymap. This is used for "
"multiple-inheritance, such as in @code{make-composed-keymap}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:249
msgid ""
"When the binding is @code{nil}, it doesn't constitute a definition but it "
"does take precedence over a default binding or a binding in the parent "
"keymap. On the other hand, a binding of @code{nil} does @emph{not} override "
"lower-precedence keymaps; thus, if the local map gives a binding of "
"@code{nil}, Emacs uses the binding from the global map."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:250
#, no-wrap
msgid "meta characters lookup"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:258
msgid ""
"Keymaps do not directly record bindings for the meta characters. Instead, "
"meta characters are regarded for purposes of key lookup as sequences of two "
"characters, the first of which is @key{ESC} (or whatever is currently the "
"value of @code{meta-prefix-char}). Thus, the key @kbd{M-a} is internally "
"represented as @kbd{@key{ESC} a}, and its global binding is found at the "
"slot for @kbd{a} in @code{esc-map} (@pxref{Prefix Keys})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:262
msgid ""
"This conversion applies only to characters, not to function keys or other "
"input events; thus, @kbd{M-@key{end}} has nothing to do with @kbd{@key{ESC} "
"@key{end}}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:267
msgid ""
"Here as an example is the local keymap for Lisp mode, a sparse keymap. It "
"defines bindings for @key{DEL}, @kbd{C-c C-z}, @kbd{C-M-q}, and @kbd{C-M-x} "
"(the actual value also contains a menu binding, which is omitted here for "
"the sake of brevity)."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:272
#, no-wrap
msgid ""
"lisp-mode-map\n"
"@result{}\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:278
#, no-wrap
msgid ""
"(keymap\n"
" (3 keymap\n"
" ;; @kbd{C-c C-z}\n"
" (26 . run-lisp))\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:283
#, no-wrap
msgid ""
" (27 keymap\n"
" ;; @r{@kbd{C-M-x}, treated as @kbd{@key{ESC} C-x}}\n"
" (24 . lisp-send-defun))\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:289
#, no-wrap
msgid ""
" ;; @r{This part is inherited from @code{lisp-mode-shared-map}.}\n"
" keymap\n"
" ;; @key{DEL}\n"
" (127 . backward-delete-char-untabify)\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:294
#, no-wrap
msgid ""
" (27 keymap\n"
" ;; @r{@kbd{C-M-q}, treated as @kbd{@key{ESC} C-q}}\n"
" (17 . indent-sexp)))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:297
#, no-wrap
msgid "keymapp object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:302
msgid ""
"This function returns @code{t} if @var{object} is a keymap, @code{nil} "
"otherwise. More precisely, this function tests for a list whose @sc{car} is "
"@code{keymap}, or for a symbol whose function definition satisfies "
"@code{keymapp}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:307
#, no-wrap
msgid ""
"(keymapp '(keymap))\n"
" @result{} t\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:312
#, no-wrap
msgid ""
"(fset 'foo '(keymap))\n"
"(keymapp 'foo)\n"
" @result{} t\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:316
#, no-wrap
msgid ""
"(keymapp (current-global-map))\n"
" @result{} t\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:322
#, no-wrap
msgid "creating keymaps"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:325
msgid "Here we describe the functions for creating keymaps."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:326
#, no-wrap
msgid "make-sparse-keymap &optional prompt"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:331
msgid ""
"This function creates and returns a new sparse keymap with no entries. (A "
"sparse keymap is the kind of keymap you usually want.) The new keymap does "
"not contain a char-table, unlike @code{make-keymap}, and does not bind any "
"events."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:336
#, no-wrap
msgid ""
"(make-sparse-keymap)\n"
" @result{} (keymap)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:346
msgid ""
"If you specify @var{prompt}, that becomes the overall prompt string for the "
"keymap. You should specify this only for menu keymaps (@pxref{Defining "
"Menus}). A keymap with an overall prompt string will always present a mouse "
"menu or a keyboard menu if it is active for looking up the next input "
"event. Don't specify an overall prompt string for the main map of a major "
"or minor mode, because that would cause the command loop to present a "
"keyboard menu every time."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:348
#, no-wrap
msgid "make-keymap &optional prompt"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:355
msgid ""
"This function creates and returns a new full keymap. That keymap contains a "
"char-table (@pxref{Char-Tables}) with slots for all characters without "
"modifiers. The new keymap initially binds all these characters to "
"@code{nil}, and does not bind any other kind of event. The argument "
"@var{prompt} specifies a prompt string, as in @code{make-sparse-keymap}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:362
#, no-wrap
msgid ""
"(make-keymap)\n"
" @result{} (keymap #^[nil nil keymap nil nil nil @dots{}])\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:367
msgid ""
"A full keymap is more efficient than a sparse keymap when it holds lots of "
"bindings; for just a few, the sparse keymap is better."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:369
#, no-wrap
msgid "copy-keymap keymap"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:374
msgid ""
"This function returns a copy of @var{keymap}. This is almost never needed. "
"If you want a keymap that's like another yet with a few changes, you should "
"use map inheritance rather than copying. I.e., something like:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:381
#, no-wrap
msgid ""
"(let ((map (make-sparse-keymap)))\n"
" (set-keymap-parent map <theirmap>)\n"
" (define-key map ...)\n"
" ...)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:389
msgid ""
"When performing @code{copy-keymap}, any keymaps that appear directly as "
"bindings in @var{keymap} are also copied recursively, and so on to any "
"number of levels. However, recursive copying does not take place when the "
"definition of a character is a symbol whose function definition is a keymap; "
"the same symbol appears in the new copy."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:394
#, no-wrap
msgid ""
"(setq map (copy-keymap (current-local-map)))\n"
"@result{} (keymap\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:401
#, no-wrap
msgid ""
" ;; @r{(This implements meta characters.)}\n"
" (27 keymap\n"
" (83 . center-paragraph)\n"
" (115 . center-line))\n"
" (9 . tab-to-tab-stop))\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:406
#, no-wrap
msgid ""
"(eq map (current-local-map))\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:410
#, no-wrap
msgid ""
"(equal map (current-local-map))\n"
" @result{} t\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:416
#, no-wrap
msgid "keymap inheritance"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:417
#, no-wrap
msgid "inheritance, keymap"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:421
msgid ""
"A keymap can inherit the bindings of another keymap, which we call the "
"@dfn{parent keymap}. Such a keymap looks like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:424
#, no-wrap
msgid "(keymap @var{elements}@dots{} . @var{parent-keymap})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:430
msgid ""
"The effect is that this keymap inherits all the bindings of "
"@var{parent-keymap}, whatever they may be at the time a key is looked up, "
"but can add to them or override them with @var{elements}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:438
msgid ""
"If you change the bindings in @var{parent-keymap} using @code{define-key} or "
"other key-binding functions, these changed bindings are visible in the "
"inheriting keymap, unless shadowed by the bindings made by @var{elements}. "
"The converse is not true: if you use @code{define-key} to change bindings in "
"the inheriting keymap, these changes are recorded in @var{elements}, but "
"have no effect on @var{parent-keymap}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:443
msgid ""
"The proper way to construct a keymap with a parent is to use "
"@code{set-keymap-parent}; if you have code that directly constructs a keymap "
"with a parent, please convert the program to use @code{set-keymap-parent} "
"instead."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:444
#, no-wrap
msgid "keymap-parent keymap"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:447
msgid ""
"This returns the parent keymap of @var{keymap}. If @var{keymap} has no "
"parent, @code{keymap-parent} returns @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:449
#, no-wrap
msgid "set-keymap-parent keymap parent"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:453
msgid ""
"This sets the parent keymap of @var{keymap} to @var{parent}, and returns "
"@var{parent}. If @var{parent} is @code{nil}, this function gives "
"@var{keymap} no parent at all."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:457
msgid ""
"If @var{keymap} has submaps (bindings for prefix keys), they too receive new "
"parent keymaps that reflect what @var{parent} specifies for those prefix "
"keys."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:461
msgid ""
"Here is an example showing how to make a keymap that inherits from "
"@code{text-mode-map}:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:466
#, no-wrap
msgid ""
"(let ((map (make-sparse-keymap)))\n"
" (set-keymap-parent map text-mode-map)\n"
" map)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:473
msgid ""
"A non-sparse keymap can have a parent too, but this is not very useful. A "
"non-sparse keymap always specifies something as the binding for every "
"numeric character code without modifier bits, even if it is @code{nil}, so "
"these character's bindings are never inherited from the parent keymap."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:474
#, no-wrap
msgid "keymap inheritance from multiple maps"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:477
msgid ""
"Sometimes you want to make a keymap that inherits from more than one map. "
"You can use the function @code{make-composed-keymap} for this."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:478
#, no-wrap
msgid "make-composed-keymap maps &optional parent"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:487
msgid ""
"This function returns a new keymap composed of the existing keymap(s) "
"@var{maps}, and optionally inheriting from a parent keymap @var{parent}. "
"@var{maps} can be a single keymap or a list of more than one. When looking "
"up a key in the resulting new map, Emacs searches in each of the @var{maps} "
"in turn, and then in @var{parent}, stopping at the first match. A "
"@code{nil} binding in any one of @var{maps} overrides any binding in "
"@var{parent}, but it does not override any non-@code{nil} binding in any "
"other of the @var{maps}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:492
msgid ""
"@code{help-mode-map}, such that it inherits from both "
"@code{button-buffer-map} and @code{special-mode-map}:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:499
#, no-wrap
msgid ""
"(defvar help-mode-map\n"
" (let ((map (make-sparse-keymap)))\n"
" (set-keymap-parent map\n"
" (make-composed-keymap button-buffer-map special-mode-map))\n"
" ... map) ... )\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:504
#, no-wrap
msgid "prefix key"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:511
msgid ""
"A @dfn{prefix key} is a key sequence whose binding is a keymap. The keymap "
"defines what to do with key sequences that extend the prefix key. For "
"example, @kbd{C-x} is a prefix key, and it uses a keymap that is also stored "
"in the variable @code{ctl-x-map}. This keymap defines bindings for key "
"sequences starting with @kbd{C-x}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:514
msgid ""
"Some of the standard Emacs prefix keys use keymaps that are also found in "
"Lisp variables:"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:517
#, no-wrap
msgid "esc-map"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:518
#, no-wrap
msgid "ESC-prefix"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:522
msgid ""
"@code{esc-map} is the global keymap for the @key{ESC} prefix key. Thus, the "
"global definitions of all meta characters are actually found here. This map "
"is also the function definition of @code{ESC-prefix}."
msgstr ""
#. type: kbd{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:524
#, no-wrap
msgid "C-h"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:526
msgid "@code{help-map} is the global keymap for the @kbd{C-h} prefix key."
msgstr ""
#. type: kbd{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:528
#, no-wrap
msgid "C-c"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:529
#, no-wrap
msgid "mode-specific-map"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:535
msgid ""
"@code{mode-specific-map} is the global keymap for the prefix key @kbd{C-c}. "
"This map is actually global, not mode-specific, but its name provides useful "
"information about @kbd{C-c} in the output of @kbd{C-h b} "
"(@code{display-bindings}), since the main use of this prefix key is for "
"mode-specific bindings."
msgstr ""
#. type: kbd{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:537
#, no-wrap
msgid "C-x"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:538
#, no-wrap
msgid "ctl-x-map"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:539
#, no-wrap
msgid "Control-X-prefix"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:543
msgid ""
"@code{ctl-x-map} is the global keymap used for the @kbd{C-x} prefix key. "
"This map is found via the function cell of the symbol "
"@code{Control-X-prefix}."
msgstr ""
#. type: kbd{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:545
#, no-wrap
msgid "C-x @key{RET}"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:546
#, no-wrap
msgid "mule-keymap"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:549
msgid ""
"@code{mule-keymap} is the global keymap used for the @kbd{C-x @key{RET}} "
"prefix key."
msgstr ""
#. type: kbd{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:551
#, no-wrap
msgid "C-x 4"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:552
#, no-wrap
msgid "ctl-x-4-map"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:555
msgid "@code{ctl-x-4-map} is the global keymap used for the @kbd{C-x 4} prefix key."
msgstr ""
#. type: kbd{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:557
#, no-wrap
msgid "C-x 5"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:558
#, no-wrap
msgid "ctl-x-5-map"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:561
msgid "@code{ctl-x-5-map} is the global keymap used for the @kbd{C-x 5} prefix key."
msgstr ""
#. type: kbd{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:563
#, no-wrap
msgid "C-x 6"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:564
#, no-wrap
msgid "2C-mode-map"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:567
msgid "@code{2C-mode-map} is the global keymap used for the @kbd{C-x 6} prefix key."
msgstr ""
#. type: kbd{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:569
#, no-wrap
msgid "C-x t"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:570
#, no-wrap
msgid "tab-prefix-map"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:573
msgid ""
"@code{tab-prefix-map} is the global keymap used for the @kbd{C-x t} prefix "
"key."
msgstr ""
#. type: kbd{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:575
#, no-wrap
msgid "C-x v"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:576
#, no-wrap
msgid "vc-prefix-map"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:579
msgid ""
"@code{vc-prefix-map} is the global keymap used for the @kbd{C-x v} prefix "
"key."
msgstr ""
#. type: kbd{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:581
#, no-wrap
msgid "M-g"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:582
#, no-wrap
msgid "goto-map"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:585
msgid "@code{goto-map} is the global keymap used for the @kbd{M-g} prefix key."
msgstr ""
#. type: kbd{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:587
#, no-wrap
msgid "M-s"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:588
#, no-wrap
msgid "search-map"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:591
msgid "@code{search-map} is the global keymap used for the @kbd{M-s} prefix key."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:596
msgid ""
"The other Emacs prefix keys are @kbd{C-x @@}, @kbd{C-x a i}, @kbd{C-x "
"@key{ESC}} and @kbd{@key{ESC} @key{ESC}}. They use keymaps that have no "
"special names."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:605
msgid ""
"The keymap binding of a prefix key is used for looking up the event that "
"follows the prefix key. (It may instead be a symbol whose function "
"definition is a keymap. The effect is the same, but the symbol serves as a "
"name for the prefix key.) Thus, the binding of @kbd{C-x} is the symbol "
"@code{Control-X-prefix}, whose function cell holds the keymap for @kbd{C-x} "
"commands. (The same keymap is also the value of @code{ctl-x-map}.)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:612
msgid ""
"Prefix key definitions can appear in any active keymap. The definitions of "
"@kbd{C-c}, @kbd{C-x}, @kbd{C-h} and @key{ESC} as prefix keys appear in the "
"global map, so these prefix keys are always available. Major and minor "
"modes can redefine a key as a prefix by putting a prefix key definition for "
"it in the local map or the minor mode's map. @xref{Active Keymaps}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:617
msgid ""
"If a key is defined as a prefix in more than one active map, then its "
"various definitions are in effect merged: the commands defined in the minor "
"mode keymaps come first, followed by those in the local map's prefix "
"definition, and then by those from the global map."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:623
msgid ""
"In the following example, we make @kbd{C-p} a prefix key in the local "
"keymap, in such a way that @kbd{C-p} is identical to @kbd{C-x}. Then the "
"binding for @kbd{C-p C-f} is the function @code{find-file}, just like "
"@kbd{C-x C-f}. The key sequence @kbd{C-p 6} is not found in any active "
"keymap."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:628
#, no-wrap
msgid ""
"(use-local-map (make-sparse-keymap))\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:632
#, no-wrap
msgid ""
"(local-set-key \"\\C-p\" ctl-x-map)\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:636
#, no-wrap
msgid ""
"(key-binding \"\\C-p\\C-f\")\n"
" @result{} find-file\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:641
#, no-wrap
msgid ""
"(key-binding \"\\C-p6\")\n"
" @result{} nil\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:644
#, no-wrap
msgid "define-prefix-command symbol &optional mapvar prompt"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:645
#, no-wrap
msgid "prefix command"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:651
msgid "Definition of define-prefix-command"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:651
msgid ""
"This function prepares @var{symbol} for use as a prefix key's binding: it "
"creates a sparse keymap and stores it as @var{symbol}'s function "
"definition. Subsequently binding a key sequence to @var{symbol} will make "
"that key sequence into a prefix key. The return value is @code{symbol}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:655
msgid ""
"This function also sets @var{symbol} as a variable, with the keymap as its "
"value. But if @var{mapvar} is non-@code{nil}, it sets @var{mapvar} as a "
"variable instead."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:659
msgid ""
"If @var{prompt} is non-@code{nil}, that becomes the overall prompt string "
"for the keymap. The prompt string should be given for menu keymaps "
"(@pxref{Defining Menus})."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:663
#, no-wrap
msgid "active keymap"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:669
msgid ""
"Emacs contains many keymaps, but at any time only a few keymaps are "
"@dfn{active}. When Emacs receives user input, it translates the input event "
"(@pxref{Translation Keymaps}), and looks for a key binding in the active "
"keymaps."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:675
msgid ""
"Usually, the active keymaps are: (i) the keymap specified by the "
"@code{keymap} property, (ii) the keymaps of enabled minor modes, (iii) the "
"current buffer's local keymap, and (iv) the global keymap, in that order. "
"Emacs searches for each input key sequence in all these keymaps."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:679
msgid ""
"Of these usual keymaps, the highest-precedence one is specified by the "
"@code{keymap} text or overlay property at point, if any. (For a mouse input "
"event, Emacs uses the event position instead of point;"
msgstr ""
#. type: iftex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:681
msgid "see the next section for details.)"
msgstr ""
#. type: ifnottex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:684
msgid "@pxref{Searching Keymaps}.)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:691
msgid ""
"Next in precedence are keymaps specified by enabled minor modes. These "
"keymaps, if any, are specified by the variables "
"@code{emulation-mode-map-alists}, @code{minor-mode-overriding-map-alist}, "
"and @code{minor-mode-map-alist}. @xref{Controlling Active Maps}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:692
#, no-wrap
msgid "local keymap"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:698
msgid ""
"Next in precedence is the buffer's @dfn{local keymap}, containing key "
"bindings specific to the buffer. The minibuffer also has a local keymap "
"(@pxref{Intro to Minibuffers}). If there is a @code{local-map} text or "
"overlay property at point, that specifies the local keymap to use, in place "
"of the buffer's default local keymap."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:699
#, no-wrap
msgid "major mode keymap"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:705
msgid ""
"The local keymap is normally set by the buffer's major mode, and every "
"buffer with the same major mode shares the same local keymap. Hence, if you "
"call @code{local-set-key} (@pxref{Key Binding Commands}) to change the "
"local keymap in one buffer, that also affects the local keymaps in other "
"buffers with the same major mode."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:706
#, no-wrap
msgid "global keymap"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:710
msgid ""
"Finally, the @dfn{global keymap} contains key bindings that are defined "
"regardless of the current buffer, such as @kbd{C-f}. It is always active, "
"and is bound to the variable @code{global-map}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:721
msgid ""
"Apart from the above usual keymaps, Emacs provides special ways for programs "
"to make other keymaps active. Firstly, the variable "
"@code{overriding-local-map} specifies a keymap that replaces the usual "
"active keymaps, except for the global keymap. Secondly, the terminal-local "
"variable @code{overriding-terminal-local-map} specifies a keymap that takes "
"precedence over @emph{all} other keymaps (including "
"@code{overriding-local-map}); this is normally used for modal/transient "
"keybindings (the function @code{set-transient-map} provides a convenient "
"interface for this). @xref{Controlling Active Maps}, for details."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:725
msgid ""
"Making keymaps active is not the only way to use them. Keymaps are also "
"used in other ways, such as for translating events within "
"@code{read-key-sequence}. @xref{Translation Keymaps}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:727
msgid "@xref{Standard Keymaps}, for a list of some standard keymaps."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:728
#, no-wrap
msgid "current-active-maps &optional olp position"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:737
msgid ""
"This returns the list of active keymaps that would be used by the command "
"loop in the current circumstances to look up a key sequence. Normally it "
"ignores @code{overriding-local-map} and "
"@code{overriding-terminal-local-map}, but if @var{olp} is non-@code{nil} "
"then it pays attention to them. @var{position} can optionally be either an "
"event position as returned by @code{event-start} or a buffer position, and "
"may change the keymaps as described for @code{key-binding}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:739
#, no-wrap
msgid "key-binding key &optional accept-defaults no-remap position"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:743
msgid ""
"This function returns the binding for @var{key} according to the current "
"active keymaps. The result is @code{nil} if @var{key} is undefined in the "
"keymaps."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:746
msgid ""
"The argument @var{accept-defaults} controls checking for default bindings, "
"as in @code{lookup-key} (@pxref{Functions for Key Lookup})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:752
msgid ""
"When commands are remapped (@pxref{Remapping Commands}), @code{key-binding} "
"normally processes command remappings so as to return the remapped command "
"that will actually be executed. However, if @var{no-remap} is "
"non-@code{nil}, @code{key-binding} ignores remappings and returns the "
"binding directly specified for @var{key}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:760
msgid ""
"If @var{key} starts with a mouse event (perhaps following a prefix event), "
"the maps to be consulted are determined based on the event's position. "
"Otherwise, they are determined based on the value of point. However, you "
"can override either of them by specifying @var{position}. If @var{position} "
"is non-@code{nil}, it should be either a buffer position or an event "
"position like the value of @code{event-start}. Then the maps consulted are "
"determined based on @var{position}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:762
msgid "Emacs signals an error if @var{key} is not a string or a vector."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:767
#, no-wrap
msgid ""
"(key-binding \"\\C-x\\C-f\")\n"
" @result{} find-file\n"
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:772
#, no-wrap
msgid "Searching the Active Keymaps"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:773
#, no-wrap
msgid "searching active keymaps for keys"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:777
msgid "Here is a pseudo-Lisp summary of how Emacs searches the active keymaps:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:791
#, no-wrap
msgid ""
"(or (if overriding-terminal-local-map\n"
" (@var{find-in} overriding-terminal-local-map))\n"
" (if overriding-local-map\n"
" (@var{find-in} overriding-local-map)\n"
" (or (@var{find-in} (get-char-property (point) 'keymap))\n"
" (@var{find-in-any} emulation-mode-map-alists)\n"
" (@var{find-in-any} minor-mode-overriding-map-alist)\n"
" (@var{find-in-any} minor-mode-map-alist)\n"
" (if (get-text-property (point) 'local-map)\n"
" (@var{find-in} (get-char-property (point) 'local-map))\n"
" (@var{find-in} (current-local-map)))))\n"
" (@var{find-in} (current-global-map)))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:799
msgid ""
"Here, @var{find-in} and @var{find-in-any} are pseudo functions that search "
"in one keymap and in an alist of keymaps, respectively. Note that the "
"@code{set-transient-map} function works by setting "
"@code{overriding-terminal-local-map} (@pxref{Controlling Active Maps})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:811
msgid ""
"In the above pseudo-code, if a key sequence starts with a mouse event "
"(@pxref{Mouse Events}), that event's position is used instead of point, and "
"the event's buffer is used instead of the current buffer. In particular, "
"this affects how the @code{keymap} and @code{local-map} properties are "
"looked up. If a mouse event occurs on a string embedded with a "
"@code{display}, @code{before-string}, or @code{after-string} property "
"(@pxref{Special Properties}), and the string has a non-@code{nil} "
"@code{keymap} or @code{local-map} property, that overrides the corresponding "
"property in the underlying buffer text (i.e., the property specified by the "
"underlying text is ignored)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:818
msgid ""
"When a key binding is found in one of the active keymaps, and that binding "
"is a command, the search is over---the command is executed. However, if the "
"binding is a symbol with a value or a string, Emacs replaces the input key "
"sequences with the variable's value or the string, and restarts the search "
"of the active keymaps. @xref{Key Lookup}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:821
msgid ""
"The command which is finally found might also be remapped. @xref{Remapping "
"Commands}."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:823
#, no-wrap
msgid "Controlling the Active Keymaps"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:824
#, no-wrap
msgid "active keymap, controlling"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:826
#, no-wrap
msgid "global-map"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:831
msgid ""
"This variable contains the default global keymap that maps Emacs keyboard "
"input to commands. The global keymap is normally this keymap. The default "
"global keymap is a full keymap that binds @code{self-insert-command} to all "
"of the printing characters."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:835
msgid ""
"It is normal practice to change the bindings in the global keymap, but you "
"should not assign this variable any value other than the keymap it starts "
"out with."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:837
#, no-wrap
msgid "current-global-map"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:843
msgid ""
"This function returns the current global keymap. This is the same as the "
"value of @code{global-map} unless you change one or the other. The return "
"value is a reference, not a copy; if you use @code{define-key} or other "
"functions on it you will alter global bindings."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:849
#, no-wrap
msgid ""
"(current-global-map)\n"
"@result{} (keymap [set-mark-command beginning-of-line @dots{}\n"
" delete-backward-char])\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:853
#, no-wrap
msgid "current-local-map"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:859
msgid ""
"This function returns the current buffer's local keymap, or @code{nil} if it "
"has none. In the following example, the keymap for the @file{*scratch*} "
"buffer (using Lisp Interaction mode) is a sparse keymap in which the entry "
"for @key{ESC}, @acronym{ASCII} code 27, is another sparse keymap."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:867
#, no-wrap
msgid ""
"(current-local-map)\n"
"@result{} (keymap\n"
" (10 . eval-print-last-sexp)\n"
" (9 . lisp-indent-line)\n"
" (127 . backward-delete-char-untabify)\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:872
#, no-wrap
msgid ""
" (27 keymap\n"
" (24 . eval-defun)\n"
" (17 . indent-sexp)))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:879
msgid ""
"@code{current-local-map} returns a reference to the local keymap, not a copy "
"of it; if you use @code{define-key} or other functions on it you will alter "
"local bindings."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:880
#, no-wrap
msgid "current-minor-mode-maps"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:882
msgid ""
"This function returns a list of the keymaps of currently enabled minor "
"modes."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:884
#, no-wrap
msgid "use-global-map keymap"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:887
msgid ""
"This function makes @var{keymap} the new current global keymap. It returns "
"@code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:889
msgid "It is very unusual to change the global keymap."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:891
#, no-wrap
msgid "use-local-map keymap"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:896
msgid ""
"This function makes @var{keymap} the new local keymap of the current "
"buffer. If @var{keymap} is @code{nil}, then the buffer has no local "
"keymap. @code{use-local-map} returns @code{nil}. Most major mode commands "
"use this function."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:898
#, no-wrap
msgid "minor-mode-map-alist"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:903
msgid "Definition of minor-mode-map-alist"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:903
msgid ""
"This variable is an alist describing keymaps that may or may not be active "
"according to the values of certain variables. Its elements look like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:906
#, no-wrap
msgid "(@var{variable} . @var{keymap})\n"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:911
msgid ""
"The keymap @var{keymap} is active whenever @var{variable} has a "
"non-@code{nil} value. Typically @var{variable} is the variable that enables "
"or disables a minor mode. @xref{Keymaps and Minor Modes}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:917
msgid ""
"Note that elements of @code{minor-mode-map-alist} do not have the same "
"structure as elements of @code{minor-mode-alist}. The map must be the "
"@sc{cdr} of the element; a list with the map as the second element will not "
"do. The @sc{cdr} can be either a keymap (a list) or a symbol whose function "
"definition is a keymap."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:922
msgid ""
"When more than one minor mode keymap is active, the earlier one in "
"@code{minor-mode-map-alist} takes priority. But you should design minor "
"modes so that they don't interfere with each other. If you do this "
"properly, the order will not matter."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:926
msgid ""
"See @ref{Keymaps and Minor Modes}, for more information about minor modes. "
"See also @code{minor-mode-key-binding} (@pxref{Functions for Key Lookup})."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:928
#, no-wrap
msgid "minor-mode-overriding-map-alist"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:933
msgid ""
"This variable allows major modes to override the key bindings for particular "
"minor modes. The elements of this alist look like the elements of "
"@code{minor-mode-map-alist}: @code{(@var{variable} . @var{keymap})}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:938
msgid ""
"If a variable appears as an element of "
"@code{minor-mode-overriding-map-alist}, the map specified by that element "
"totally replaces any map specified for the same variable in "
"@code{minor-mode-map-alist}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:941
msgid ""
"@code{minor-mode-overriding-map-alist} is automatically buffer-local in all "
"buffers."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:943
#, no-wrap
msgid "overriding-local-map"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:948
msgid ""
"If non-@code{nil}, this variable holds a keymap to use instead of the "
"buffer's local keymap, any text property or overlay keymaps, and any minor "
"mode keymaps. This keymap, if specified, overrides all other maps that "
"would have been active, except for the current global map."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:950
#, no-wrap
msgid "overriding-terminal-local-map"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:954
msgid ""
"If non-@code{nil}, this variable holds a keymap to use instead of "
"@code{overriding-local-map}, the buffer's local keymap, text property or "
"overlay keymaps, and all the minor mode keymaps."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:958
msgid ""
"This variable is always local to the current terminal and cannot be "
"buffer-local. @xref{Multiple Terminals}. It is used to implement "
"incremental search mode."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:960
#, no-wrap
msgid "overriding-local-map-menu-flag"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:965
msgid ""
"If this variable is non-@code{nil}, the value of @code{overriding-local-map} "
"or @code{overriding-terminal-local-map} can affect the display of the menu "
"bar. The default value is @code{nil}, so those map variables have no effect "
"on the menu bar."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:973
msgid ""
"Note that these two map variables do affect the execution of key sequences "
"entered using the menu bar, even if they do not affect the menu bar "
"display. So if a menu bar key sequence comes in, you should clear the "
"variables before looking up and executing that key sequence. Modes that use "
"the variables would typically do this anyway; normally they respond to "
"events that they do not handle by ``unreading'' them and exiting."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:975
#, no-wrap
msgid "special-event-map"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:979
msgid ""
"This variable holds a keymap for special events. If an event type has a "
"binding in this keymap, then it is special, and the binding for the event is "
"run directly by @code{read-event}. @xref{Special Events}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:981
#, no-wrap
msgid "emulation-mode-map-alists"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:989
msgid ""
"This variable holds a list of keymap alists to use for emulation modes. It "
"is intended for modes or packages using multiple minor-mode keymaps. Each "
"element is a keymap alist which has the same format and meaning as "
"@code{minor-mode-map-alist}, or a symbol with a variable binding which is "
"such an alist. The active keymaps in each alist are used before "
"@code{minor-mode-map-alist} and @code{minor-mode-overriding-map-alist}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:991
#, no-wrap
msgid "transient keymap"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:992
#, no-wrap
msgid "set-transient-map keymap &optional keep-pred on-exit"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:995
msgid ""
"This function adds @var{keymap} as a @dfn{transient} keymap, which takes "
"precedence over other keymaps for one (or more) subsequent keys."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1001
msgid ""
"Normally, @var{keymap} is used just once, to look up the very next key. If "
"the optional argument @var{keep-pred} is @code{t}, the map stays active as "
"long as the user types keys defined in @var{keymap}; when the user types a "
"key that is not in @var{keymap}, the transient keymap is deactivated and "
"normal key lookup continues for that key."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1006
msgid ""
"The @var{keep-pred} argument can also be a function. In that case, the "
"function is called with no arguments, prior to running each command, while "
"@var{keymap} is active; it should return non-@code{nil} if @var{keymap} "
"should stay active."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1010
msgid ""
"The optional argument @var{on-exit}, if non-@code{nil}, specifies a function "
"that is called, with no arguments, after @var{keymap} is deactivated."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1014
msgid ""
"This function works by adding and removing @var{keymap} from the variable "
"@code{overriding-terminal-local-map}, which takes precedence over all other "
"active keymaps (@pxref{Searching Keymaps})."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1018
#, no-wrap
msgid "key lookup"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1019
#, no-wrap
msgid "keymap entry"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1024
msgid ""
"@dfn{Key lookup} is the process of finding the binding of a key sequence "
"from a given keymap. The execution or use of the binding is not part of key "
"lookup."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1031
msgid ""
"Key lookup uses just the event type of each event in the key sequence; the "
"rest of the event is ignored. In fact, a key sequence used for key lookup "
"may designate a mouse event with just its types (a symbol) instead of the "
"entire event (a list). @xref{Input Events}. Such a key sequence is "
"insufficient for @code{command-execute} to run, but it is sufficient for "
"looking up or rebinding a key."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1041
msgid ""
"When the key sequence consists of multiple events, key lookup processes the "
"events sequentially: the binding of the first event is found, and must be a "
"keymap; then the second event's binding is found in that keymap, and so on "
"until all the events in the key sequence are used up. (The binding thus "
"found for the last event may or may not be a keymap.) Thus, the process of "
"key lookup is defined in terms of a simpler process for looking up a single "
"event in a keymap. How that is done depends on the type of object "
"associated with the event in that keymap."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1049
msgid ""
"Let's use the term @dfn{keymap entry} to describe the value found by looking "
"up an event type in a keymap. (This doesn't include the item string and "
"other extra elements in a keymap element for a menu item, because "
"@code{lookup-key} and other key lookup functions don't include them in the "
"returned value.) While any Lisp object may be stored in a keymap as a "
"keymap entry, not all make sense for key lookup. Here is a table of the "
"meaningful types of keymap entries:"
msgstr ""
#. type: code{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1051
#, no-wrap
msgid "nil"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1052
#, no-wrap
msgid "@code{nil} in keymap"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1057
msgid ""
"@code{nil} means that the events used so far in the lookup form an undefined "
"key. When a keymap fails to mention an event type at all, and has no "
"default binding, that is equivalent to a binding of @code{nil} for that "
"event type."
msgstr ""
#. type: var{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1058
#, no-wrap
msgid "command"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1059
#, no-wrap
msgid "command in keymap"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1062
msgid ""
"The events used so far in the lookup form a complete key, and @var{command} "
"is its binding. @xref{What Is a Function}."
msgstr ""
#. type: var{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1063
#, no-wrap
msgid "array"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1064
#, no-wrap
msgid "string in keymap"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1068
msgid ""
"The array (either a string or a vector) is a keyboard macro. The events "
"used so far in the lookup form a complete key, and the array is its "
"binding. See @ref{Keyboard Macros}, for more information."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1070
#, no-wrap
msgid "keymap in keymap"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1073
msgid ""
"The events used so far in the lookup form a prefix key. The next event of "
"the key sequence is looked up in @var{keymap}."
msgstr ""
#. type: var{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1074
#, no-wrap
msgid "list"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1075
#, no-wrap
msgid "list in keymap"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1077
msgid "The meaning of a list depends on what it contains:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1082
msgid ""
"If the @sc{car} of @var{list} is the symbol @code{keymap}, then the list is "
"a keymap, and is treated as a keymap (see above)."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1084
#, no-wrap
msgid "@code{lambda} in keymap"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1090
msgid ""
"If the @sc{car} of @var{list} is @code{lambda}, then the list is a lambda "
"expression. This is presumed to be a function, and is treated as such (see "
"above). In order to execute properly as a key binding, this function must "
"be a command---it must have an @code{interactive} specification. "
"@xref{Defining Commands}."
msgstr ""
#. type: var{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1092
#, no-wrap
msgid "symbol"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1093
#, no-wrap
msgid "symbol in keymap"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1098
msgid ""
"The function definition of @var{symbol} is used in place of @var{symbol}. "
"If that too is a symbol, then this process is repeated, any number of "
"times. Ultimately this should lead to an object that is a keymap, a "
"command, or a keyboard macro."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1105
msgid ""
"Note that keymaps and keyboard macros (strings and vectors) are not valid "
"functions, so a symbol with a keymap, string, or vector as its function "
"definition is invalid as a function. It is, however, valid as a key "
"binding. If the definition is a keyboard macro, then the symbol is also "
"valid as an argument to @code{command-execute} (@pxref{Interactive Call})."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1106
#, no-wrap
msgid "@code{undefined} in keymap"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1112
msgid ""
"The symbol @code{undefined} is worth special mention: it means to treat the "
"key as undefined. Strictly speaking, the key is defined, and its binding is "
"the command @code{undefined}; but that command does the same thing that is "
"done automatically for an undefined key: it rings the bell (by calling "
"@code{ding}) but does not signal an error."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1113
#, no-wrap
msgid "preventing prefix key"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1118
msgid ""
"@code{undefined} is used in local keymaps to override a global key binding "
"and make the key undefined locally. A local binding of @code{nil} would "
"fail to do this because it would not override the global binding."
msgstr ""
#. type: var{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1119
#, no-wrap
msgid "anything else"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1123
msgid ""
"If any other type of object is found, the events used so far in the lookup "
"form a complete key, and the object is its binding, but the binding is not "
"executable as a command."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1127
msgid ""
"In short, a keymap entry may be a keymap, a command, a keyboard macro, a "
"symbol that leads to one of them, or @code{nil}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1132
msgid "Here are the functions and variables pertaining to key lookup."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1133
#, no-wrap
msgid "lookup-key keymap key &optional accept-defaults"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1137
msgid ""
"This function returns the definition of @var{key} in @var{keymap}. All the "
"other functions described in this chapter that look up keys use "
"@code{lookup-key}. Here are examples:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1142
#, no-wrap
msgid ""
"(lookup-key (current-global-map) \"\\C-x\\C-f\")\n"
" @result{} find-file\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1146
#, no-wrap
msgid ""
"(lookup-key (current-global-map) (kbd \"C-x C-f\"))\n"
" @result{} find-file\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1150
#, no-wrap
msgid ""
"(lookup-key (current-global-map) \"\\C-x\\C-f12345\")\n"
" @result{} 2\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1158
msgid ""
"If the string or vector @var{key} is not a valid key sequence according to "
"the prefix keys specified in @var{keymap}, it must be too long and have "
"extra events at the end that do not fit into a single key sequence. Then "
"the value is a number, the number of events at the front of @var{key} that "
"compose a complete key."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1165
msgid ""
"If @var{accept-defaults} is non-@code{nil}, then @code{lookup-key} considers "
"default bindings as well as bindings for the specific events in @var{key}. "
"Otherwise, @code{lookup-key} reports only bindings for the specific sequence "
"@var{key}, ignoring default bindings except when you explicitly ask about "
"them. (To do this, supply @code{t} as an element of @var{key}; see "
"@ref{Format of Keymaps}.)"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1171
msgid ""
"If @var{key} contains a meta character (not a function key), that character "
"is implicitly replaced by a two-character sequence: the value of "
"@code{meta-prefix-char}, followed by the corresponding non-meta character. "
"Thus, the first example below is handled by conversion into the second "
"example."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1176
#, no-wrap
msgid ""
"(lookup-key (current-global-map) \"\\M-f\")\n"
" @result{} forward-word\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1180
#, no-wrap
msgid ""
"(lookup-key (current-global-map) \"\\ef\")\n"
" @result{} forward-word\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1184
msgid "The @var{keymap} argument can also be a list of keymaps."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1189
msgid ""
"Unlike @code{read-key-sequence}, this function does not modify the specified "
"events in ways that discard information (@pxref{Key Sequence Input}). In "
"particular, it does not convert letters to lower case and it does not change "
"drag events to clicks."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1191
#, no-wrap
msgid "Command undefined"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1194
msgid ""
"Used in keymaps to undefine keys. It calls @code{ding}, but does not cause "
"an error."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1196
#, no-wrap
msgid "local-key-binding key &optional accept-defaults"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1199
msgid ""
"This function returns the binding for @var{key} in the current local keymap, "
"or @code{nil} if it is undefined there."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1202
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1210
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1227
msgid ""
"The argument @var{accept-defaults} controls checking for default bindings, "
"as in @code{lookup-key} (above)."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1204
#, no-wrap
msgid "global-key-binding key &optional accept-defaults"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1207
msgid ""
"This function returns the binding for command @var{key} in the current "
"global keymap, or @code{nil} if it is undefined there."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1212
#, no-wrap
msgid "minor-mode-key-binding key &optional accept-defaults"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1219
msgid ""
"This function returns a list of all the active minor mode bindings of "
"@var{key}. More precisely, it returns an alist of pairs "
"@code{(@var{modename} . @var{binding})}, where @var{modename} is the "
"variable that enables the minor mode, and @var{binding} is @var{key}'s "
"binding in that mode. If @var{key} has no minor-mode bindings, the value is "
"@code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1224
msgid ""
"If the first binding found is not a prefix definition (a keymap or a symbol "
"defined as a keymap), all subsequent bindings from other minor modes are "
"omitted, since they would be completely shadowed. Similarly, the list omits "
"non-prefix bindings that follow prefix bindings."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1229
#, no-wrap
msgid "meta-prefix-char"
msgstr ""
#. type: key{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1230
#, no-wrap
msgid "ESC"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1236
msgid ""
"This variable is the meta-prefix character code. It is used for translating "
"a meta character to a two-character sequence so it can be looked up in a "
"keymap. For useful results, the value should be a prefix event "
"(@pxref{Prefix Keys}). The default value is 27, which is the "
"@acronym{ASCII} code for @key{ESC}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1244
msgid ""
"As long as the value of @code{meta-prefix-char} remains 27, key lookup "
"translates @kbd{M-b} into @kbd{@key{ESC} b}, which is normally defined as "
"the @code{backward-word} command. However, if you were to set "
"@code{meta-prefix-char} to 24, the code for @kbd{C-x}, then Emacs will "
"translate @kbd{M-b} into @kbd{C-x b}, whose standard binding is the "
"@code{switch-to-buffer} command. (Don't actually do this!) Here is an "
"illustration of what would happen:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1249
#, no-wrap
msgid ""
"meta-prefix-char ; @r{The default value.}\n"
" @result{} 27\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1253
#, no-wrap
msgid ""
"(key-binding \"\\M-b\")\n"
" @result{} backward-word\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1257
#, no-wrap
msgid ""
"?\\C-x ; @r{The print representation}\n"
" @result{} 24 ; @r{of a character.}\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1261
#, no-wrap
msgid ""
"(setq meta-prefix-char 24)\n"
" @result{} 24\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1266
#, no-wrap
msgid ""
"(key-binding \"\\M-b\")\n"
" @result{} switch-to-buffer ; @r{Now, typing @kbd{M-b} is}\n"
" ; @r{like typing @kbd{C-x b}.}\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1269
#, no-wrap
msgid ""
"(setq meta-prefix-char 27) ; @r{Avoid confusion!}\n"
" @result{} 27 ; @r{Restore the default "
"value!}\n"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1275
msgid ""
"This translation of one event into two happens only for characters, not for "
"other kinds of input events. Thus, @kbd{M-@key{F1}}, a function key, is not "
"converted into @kbd{@key{ESC} @key{F1}}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1279
#, no-wrap
msgid "changing key bindings"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1280
#, no-wrap
msgid "rebinding"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1291
msgid ""
"The way to rebind a key is to change its entry in a keymap. If you change a "
"binding in the global keymap, the change is effective in all buffers (though "
"it has no direct effect in buffers that shadow the global binding with a "
"local one). If you change the current buffer's local map, that usually "
"affects all buffers using the same major mode. The @code{global-set-key} "
"and @code{local-set-key} functions are convenient interfaces for these "
"operations (@pxref{Key Binding Commands}). You can also use "
"@code{define-key}, a more general function; then you must explicitly specify "
"the map to change."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1295
msgid ""
"When choosing the key sequences for Lisp programs to rebind, please follow "
"the Emacs conventions for use of various keys (@pxref{Key Binding "
"Conventions})."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1296
#, no-wrap
msgid "meta character key constants"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1297
#, no-wrap
msgid "control character key constants"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1300
msgid ""
"@code{define-key} (and other functions that are used to rebind keys) "
"understand a number of different syntaxes for the keys."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1302
#, no-wrap
msgid "A vector containing a single string."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1305
msgid ""
"This is the preferred way to represent a key sequence. Here's a couple of "
"examples:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1309
#, no-wrap
msgid ""
"[\"C-c M-f\"]\n"
"[\"S-<home>\"]\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1313
msgid ""
"The syntax is the same as the one used by Emacs when displaying key "
"bindings, for instance in @samp{*Help*} buffers and help texts."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1316
msgid ""
"If the syntax isn't valid, an error will be raised when running "
"@code{define-key}, or when byte-compiling code that has these calls."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1317
#, no-wrap
msgid "A vector containing lists of keys."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1322
msgid ""
"You can use a list containing modifier names plus one base event (a "
"character or function key name). For example, @code{[(control ?a) (meta "
"b)]} is equivalent to @kbd{C-a M-b} and @code{[(hyper control left)]} is "
"equivalent to @kbd{C-H-left}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1323
#, no-wrap
msgid "A string with control and meta characters."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1331
msgid ""
"Internally, key sequences are often represented as strings using the special "
"escape sequences for control and meta characters (@pxref{String Type}), but "
"this representation can also be used by users when rebinding keys. A string "
"like @code{\"\\M-x\"} is read as containing a single @kbd{M-x}, "
"@code{\"\\C-f\"} is read as containing a single @kbd{C-f}, and "
"@code{\"\\M-\\C-x\"} and @code{\"\\C-\\M-x\"} are both read as containing a "
"single @kbd{C-M-x}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1332
#, no-wrap
msgid "a vector of characters."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1337
msgid ""
"This is the other internal representation of key sequences, and supports a "
"fuller range of modifiers than the string representation. One example is "
"@samp{[?\\C-\\H-x home]}, which represents the @kbd{C-H-x home} key "
"sequence. @xref{Character Type}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1344
msgid ""
"The functions below signal an error if @var{keymap} is not a keymap, or if "
"@var{key} is not a string or vector representing a key sequence. You can "
"use event types (symbols) as shorthand for events that are lists. The "
"@code{kbd} function (@pxref{Key Sequences}) is a convenient way to specify "
"the key sequence."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1345
#, no-wrap
msgid "define-key keymap key binding"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1352
msgid ""
"This function sets the binding for @var{key} in @var{keymap}. (If @var{key} "
"is more than one event long, the change is actually made in another keymap "
"reached from @var{keymap}.) The argument @var{binding} can be any Lisp "
"object, but only certain types are meaningful. (For a list of meaningful "
"types, see @ref{Key Lookup}.) The value returned by @code{define-key} is "
"@var{binding}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1356
msgid ""
"If @var{key} is @code{[t]}, this sets the default binding in @var{keymap}. "
"When an event has no binding of its own, the Emacs command loop uses the "
"keymap's default binding, if there is one."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1357
#, no-wrap
msgid "invalid prefix key error"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1358
#, no-wrap
msgid "key sequence error"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1363
msgid ""
"Every prefix of @var{key} must be a prefix key (i.e., bound to a keymap) or "
"undefined; otherwise an error is signaled. If some prefix of @var{key} is "
"undefined, then @code{define-key} defines it as a prefix key so that the "
"rest of @var{key} can be defined as specified."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1368
msgid ""
"If there was previously no binding for @var{key} in @var{keymap}, the new "
"binding is added at the beginning of @var{keymap}. The order of bindings in "
"a keymap makes no difference for keyboard input, but it does matter for menu "
"keymaps (@pxref{Menu Keymaps})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1372
msgid "This example creates a sparse keymap and makes a number of bindings in it:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1377
#, no-wrap
msgid ""
"(setq map (make-sparse-keymap))\n"
" @result{} (keymap)\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1381
#, no-wrap
msgid ""
"(define-key map [\"C-f\"] 'forward-char)\n"
" @result{} forward-char\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1385
#, no-wrap
msgid ""
"map\n"
" @result{} (keymap (6 . forward-char))\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1391
#, no-wrap
msgid ""
";; @r{Build sparse submap for @kbd{C-x} and bind @kbd{f} in that.}\n"
"(define-key map [\"C-x f\"] 'forward-word)\n"
" @result{} forward-word\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1398
#, no-wrap
msgid ""
"map\n"
"@result{} (keymap\n"
" (24 keymap ; @kbd{C-x}\n"
" (102 . forward-word)) ; @kbd{f}\n"
" (6 . forward-char)) ; @kbd{C-f}\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1405
#, no-wrap
msgid ""
";; @r{Bind @kbd{C-p} to the @code{ctl-x-map}.}\n"
"(define-key map [\"C-p\"] ctl-x-map)\n"
";; @code{ctl-x-map}\n"
"@result{} [nil @dots{} find-file @dots{} backward-kill-sentence]\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1411
#, no-wrap
msgid ""
";; @r{Bind @kbd{C-f} to @code{foo} in the @code{ctl-x-map}.}\n"
"(define-key map [\"C-p C-f\"] 'foo)\n"
"@result{} 'foo\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1419
#, no-wrap
msgid ""
"map\n"
"@result{} (keymap ; @r{Note @code{foo} in @code{ctl-x-map}.}\n"
" (16 keymap [nil @dots{} foo @dots{} backward-kill-sentence])\n"
" (24 keymap\n"
" (102 . forward-word))\n"
" (6 . forward-char))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1427
msgid ""
"Note that storing a new binding for @kbd{C-p C-f} actually works by changing "
"an entry in @code{ctl-x-map}, and this has the effect of changing the "
"bindings of both @kbd{C-p C-f} and @kbd{C-x C-f} in the default global map."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1428
#, no-wrap
msgid "define-keymap &key options... &rest pairs..."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1435
msgid ""
"@code{define-key} is the general work horse for defining a key in a keymap. "
"When writing modes, however, you frequently have to bind a large number of "
"keys at once, and using @code{define-key} on them all can be tedious and "
"error-prone. Instead you can use @code{define-keymap}, which creates a "
"keymaps and binds a number of keys. Here's a very basic example:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1441
#, no-wrap
msgid ""
"(define-keymap\n"
" \"n\" #'forward-line\n"
" \"f\" #'previous-line\n"
" [\"C-c C-c\"] #'quit-window)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1445
msgid ""
"This function creates a new sparse keymap, defines the two keystrokes in "
"@var{pairs}, and returns the new keymap."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1451
msgid ""
"@var{pairs} is a list of alternating key bindings and key definitions, as "
"accepted by @code{define-key}. In addition the key can be the special "
"symbol @code{:menu}, in which case the definition should be a menu "
"definition as accepted by @code{easy-menu-define} (@pxref{Easy Menu}). "
"Here's a brief example:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1458
#, no-wrap
msgid ""
"(define-keymap :full t\n"
" \"g\" #'eww-reload\n"
" :menu '(\"Eww\"\n"
" [\"Exit\" quit-window t]\n"
" [\"Reload\" eww-reload t]))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1464
msgid ""
"A number of keywords can be used before the key/definition pairs to changes "
"features of the new keymap. If the keyword is missing, the default value "
"for the feature is @code{nil}. Here's a list of the available keywords:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1466
#, no-wrap
msgid ":full"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1471
msgid ""
"If non-@code{nil}, create a chartable keymap (as from @code{make-keymap}) "
"instead of a sparse keymap (as from @code{make-sparse-keymap} "
"(@pxref{Creating Keymaps}). A sparse keymap is the default."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1472
#, no-wrap
msgid ":parent"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1475
msgid ""
"If non-@code{nil}, this should be a keymap to use as the parent "
"(@pxref{Inheritance and Keymaps})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1476
#, no-wrap
msgid ":keymap"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1479
msgid ""
"If non-@code{nil}, this should be a keymap. Instead of creating a new "
"keymap, this keymap is modified instead."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1480
#, no-wrap
msgid ":suppress"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1484
msgid ""
"If non-@code{nil}, the keymap will be suppressed with @code{suppress-keymap} "
"(@pxref{Changing Key Bindings}). If @code{nodigits}, treat digits like "
"other chars."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1485
#, no-wrap
msgid ":name"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1489
msgid ""
"If non-@code{nil}, this should be a string to use as the menu for the keymap "
"if you use it as a menu with @code{x-popup-menu} (@pxref{Pop-Up Menus})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1490
#, no-wrap
msgid ":prefix"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1494
msgid ""
"If non-@code{nil}, this should be a symbol to be used as a prefix command "
"(@pxref{Prefix Keys}). If this is the case, this symbol is returned by "
"@code{define-keymap} instead of the map itself."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1498
#, no-wrap
msgid "defvar-keymap name &key options... &rest pairs..."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1502
msgid ""
"By far, the most common thing to do with a keymap is to bind it to a "
"variable. This is what virtually all modes do---a mode called @code{foo} "
"almost always has a variable called @code{foo-mode-map}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1506
msgid ""
"This macro defines @var{name} as a variable, and passes @var{options} and "
"@var{pars} to @code{define-keymap}, and uses the result as the default value "
"for the variable."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1510
msgid ""
"@var{options} is like the keywords in @code{define-keymap}, but adds a "
"@code{:doc} keyword that says what the doc string for the @var{name} "
"variable should be."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1512
msgid "Here's an example:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1518
#, no-wrap
msgid ""
"(defvar-keymap eww-textarea-map\n"
" :parent text-mode-map\n"
" \"\\r\" #'forward-line\n"
" [?\\t] #'shr-next-link)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1526
msgid ""
"The function @code{substitute-key-definition} scans a keymap for keys that "
"have a certain binding and rebinds them with a different binding. Another "
"feature which is cleaner and can often produce the same results is to remap "
"one command into another (@pxref{Remapping Commands})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1527
#, no-wrap
msgid "substitute-key-definition olddef newdef keymap &optional oldmap"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1528
#, no-wrap
msgid "replace bindings"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1533
msgid ""
"This function replaces @var{olddef} with @var{newdef} for any keys in "
"@var{keymap} that were bound to @var{olddef}. In other words, @var{olddef} "
"is replaced with @var{newdef} wherever it appears. The function returns "
"@code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1536
msgid ""
"For example, this redefines @kbd{C-x C-f}, if you do it in an Emacs with "
"standard bindings:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1541
#, no-wrap
msgid ""
"(substitute-key-definition\n"
" 'find-file 'find-file-read-only (current-global-map))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1549
msgid ""
"If @var{oldmap} is non-@code{nil}, that changes the behavior of "
"@code{substitute-key-definition}: the bindings in @var{oldmap} determine "
"which keys to rebind. The rebindings still happen in @var{keymap}, not in "
"@var{oldmap}. Thus, you can change one map under the control of the "
"bindings in another. For example,"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1554
#, no-wrap
msgid ""
"(substitute-key-definition\n"
" 'delete-backward-char 'my-funny-delete\n"
" my-map global-map)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1559
msgid ""
"puts the special deletion command in @code{my-map} for whichever keys are "
"globally bound to the standard deletion command."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1561
msgid "Here is an example showing a keymap before and after substitution:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1569
#, no-wrap
msgid ""
"(setq map (list 'keymap\n"
" (cons ?1 olddef-1)\n"
" (cons ?2 olddef-2)\n"
" (cons ?3 olddef-1)))\n"
"@result{} (keymap (49 . olddef-1) (50 . olddef-2) (51 . olddef-1))\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1574
#, no-wrap
msgid ""
"(substitute-key-definition 'olddef-1 'newdef map)\n"
"@result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1578
#, no-wrap
msgid ""
"map\n"
"@result{} (keymap (49 . newdef) (50 . olddef-2) (51 . newdef))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1582
#, no-wrap
msgid "suppress-keymap keymap &optional nodigits"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1583
#, no-wrap
msgid "@code{self-insert-command} override"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1589
msgid ""
"This function changes the contents of the full keymap @var{keymap} by "
"remapping @code{self-insert-command} to the command @code{undefined} "
"(@pxref{Remapping Commands}). This has the effect of undefining all "
"printing characters, thus making ordinary insertion of text impossible. "
"@code{suppress-keymap} returns @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1594
msgid ""
"If @var{nodigits} is @code{nil}, then @code{suppress-keymap} defines digits "
"to run @code{digit-argument}, and @kbd{-} to run @code{negative-argument}. "
"Otherwise it makes them undefined like the rest of the printing characters."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1595
#, no-wrap
msgid "yank suppression"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1596
#, no-wrap
msgid "@code{quoted-insert} suppression"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1601
msgid ""
"The @code{suppress-keymap} function does not make it impossible to modify a "
"buffer, as it does not suppress commands such as @code{yank} and "
"@code{quoted-insert}. To prevent any modification of a buffer, make it "
"read-only (@pxref{Read Only Buffers})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1607
msgid ""
"Since this function modifies @var{keymap}, you would normally use it on a "
"newly created keymap. Operating on an existing keymap that is used for some "
"other purpose is likely to cause trouble; for example, suppressing "
"@code{global-map} would make it impossible to use most of Emacs."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1614
msgid ""
"This function can be used to initialize the local keymap of a major mode for "
"which insertion of text is not desirable. But usually such a mode should be "
"derived from @code{special-mode} (@pxref{Basic Major Modes}); then its "
"keymap will automatically inherit from @code{special-mode-map}, which is "
"already suppressed. Here is how @code{special-mode-map} is defined:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1623
#, no-wrap
msgid ""
"(defvar special-mode-map\n"
" (let ((map (make-sparse-keymap)))\n"
" (suppress-keymap map)\n"
" (define-key map \"q\" 'quit-window)\n"
" @dots{}\n"
" map))\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1629
#, no-wrap
msgid "remapping commands"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1638
msgid ""
"A special kind of key binding can be used to @dfn{remap} one command to "
"another, without having to refer to the key sequence(s) bound to the "
"original command. To use this feature, make a key binding for a key "
"sequence that starts with the dummy event @code{remap}, followed by the "
"command name you want to remap; for the binding, specify the new definition "
"(usually a command name, but possibly any other valid definition for a key "
"binding)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1643
msgid ""
"For example, suppose My mode provides a special command @code{my-kill-line}, "
"which should be invoked instead of @code{kill-line}. To establish this, its "
"mode keymap should contain the following remapping:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1646
#, no-wrap
msgid "(define-key my-mode-map [remap kill-line] 'my-kill-line)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1652
msgid ""
"Then, whenever @code{my-mode-map} is active, if the user types @kbd{C-k} "
"(the default global key sequence for @code{kill-line}) Emacs will instead "
"run @code{my-kill-line}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1658
msgid ""
"Note that remapping only takes place through active keymaps; for example, "
"putting a remapping in a prefix keymap like @code{ctl-x-map} typically has "
"no effect, as such keymaps are not themselves active. In addition, "
"remapping only works through a single level; in the following example,"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1662
#, no-wrap
msgid ""
"(define-key my-mode-map [remap kill-line] 'my-kill-line)\n"
"(define-key my-mode-map [remap my-kill-line] 'my-other-kill-line)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1669
msgid ""
"@code{kill-line} is @emph{not} remapped to @code{my-other-kill-line}. "
"Instead, if an ordinary key binding specifies @code{kill-line}, it is "
"remapped to @code{my-kill-line}; if an ordinary binding specifies "
"@code{my-kill-line}, it is remapped to @code{my-other-kill-line}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1671
msgid "To undo the remapping of a command, remap it to @code{nil}; e.g.,"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1674
#, no-wrap
msgid "(define-key my-mode-map [remap kill-line] nil)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1676
#, no-wrap
msgid "command-remapping command &optional position keymaps"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1683
msgid ""
"This function returns the remapping for @var{command} (a symbol), given the "
"current active keymaps. If @var{command} is not remapped (which is the "
"usual situation), or not a symbol, the function returns @code{nil}. "
"@code{position} can optionally specify a buffer position or an event "
"position to determine the keymaps to use, as in @code{key-binding}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1687
msgid ""
"If the optional argument @code{keymaps} is non-@code{nil}, it specifies a "
"list of keymaps to search in. This argument is ignored if @code{position} "
"is non-@code{nil}."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1690
#, no-wrap
msgid "Keymaps for Translating Sequences of Events"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1691
#, no-wrap
msgid "translation keymap"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1692
#, no-wrap
msgid "keymaps for translating events"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1699
msgid ""
"When the @code{read-key-sequence} function reads a key sequence (@pxref{Key "
"Sequence Input}), it uses @dfn{translation keymaps} to translate certain "
"event sequences into others. The translation keymaps are "
"@code{input-decode-map}, @code{local-function-key-map}, and "
"@code{key-translation-map} (in order of priority)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1708
msgid ""
"Translation keymaps have the same structure as other keymaps, but are used "
"differently: they specify translations to make while reading key sequences, "
"rather than bindings for complete key sequences. As each key sequence is "
"read, it is checked against each translation keymap. If one of the "
"translation keymaps binds @var{k} to a vector @var{v}, then whenever @var{k} "
"appears as a sub-sequence @emph{anywhere} in a key sequence, that "
"sub-sequence is replaced with the events in @var{v}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1717
msgid ""
"For example, VT100 terminals send @kbd{@key{ESC} O P} when the keypad key "
"@key{PF1} is pressed. On such terminals, Emacs must translate that sequence "
"of events into a single event @code{pf1}. This is done by binding "
"@kbd{@key{ESC} O P} to @code{[pf1]} in @code{input-decode-map}. Thus, when "
"you type @kbd{C-c @key{PF1}} on the terminal, the terminal emits the "
"character sequence @kbd{C-c @key{ESC} O P}, and @code{read-key-sequence} "
"translates this back into @kbd{C-c @key{PF1}} and returns it as the vector "
"@code{[?\\C-c pf1]}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1721
msgid ""
"Translation keymaps take effect only after Emacs has decoded the keyboard "
"input (via the input coding system specified by "
"@code{keyboard-coding-system}). @xref{Terminal I/O Encoding}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1722
#, no-wrap
msgid "input-decode-map"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1725
msgid ""
"This variable holds a keymap that describes the character sequences sent by "
"function keys on an ordinary character terminal."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1732
msgid ""
"The value of @code{input-decode-map} is usually set up automatically "
"according to the terminal's Terminfo or Termcap entry, but sometimes those "
"need help from terminal-specific Lisp files. Emacs comes with "
"terminal-specific files for many common terminals; their main purpose is to "
"make entries in @code{input-decode-map} beyond those that can be deduced "
"from Termcap and Terminfo. @xref{Terminal-Specific}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1734
#, no-wrap
msgid "local-function-key-map"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1739
msgid ""
"This variable holds a keymap similar to @code{input-decode-map} except that "
"it describes key sequences which should be translated to alternative "
"interpretations that are usually preferred. It applies after "
"@code{input-decode-map} and before @code{key-translation-map}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1744
msgid ""
"Entries in @code{local-function-key-map} are ignored if they conflict with "
"bindings made in the minor mode, local, or global keymaps. I.e., the "
"remapping only applies if the original key sequence would otherwise not have "
"any binding."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1748
msgid ""
"@code{local-function-key-map} inherits from @code{function-key-map}. The "
"latter should only be altered if you want the binding to apply in all "
"terminals, so using the former is almost always preferred."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1750
#, no-wrap
msgid "key-translation-map"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1756
msgid ""
"This variable is another keymap used just like @code{input-decode-map} to "
"translate input events into other events. It differs from "
"@code{input-decode-map} in that it goes to work after "
"@code{local-function-key-map} is finished rather than before; it receives "
"the results of translation by @code{local-function-key-map}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1765
msgid ""
"Just like @code{input-decode-map}, but unlike @code{local-function-key-map}, "
"this keymap is applied regardless of whether the input key-sequence has a "
"normal binding. Note however that actual key bindings can have an effect on "
"@code{key-translation-map}, even though they are overridden by it. Indeed, "
"actual key bindings override @code{local-function-key-map} and thus may "
"alter the key sequence that @code{key-translation-map} receives. Clearly, "
"it is better to avoid this type of situation."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1769
msgid ""
"The intent of @code{key-translation-map} is for users to map one character "
"set to another, including ordinary characters normally bound to "
"@code{self-insert-command}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1771
#, no-wrap
msgid "key translation function"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1777
msgid ""
"You can use @code{input-decode-map}, @code{local-function-key-map}, and "
"@code{key-translation-map} for more than simple aliases, by using a "
"function, instead of a key sequence, as the translation of a key. Then this "
"function is called to compute the translation of that key."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1782
msgid ""
"The key translation function receives one argument, which is the prompt that "
"was specified in @code{read-key-sequence}---or @code{nil} if the key "
"sequence is being read by the editor command loop. In most cases you can "
"ignore the prompt value."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1786
msgid ""
"If the function reads input itself, it can have the effect of altering the "
"event that follows. For example, here's how to define @kbd{C-c h} to turn "
"the character that follows into a Hyper character:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1796
#, no-wrap
msgid ""
"(defun hyperify (prompt)\n"
" (let ((e (read-event)))\n"
" (vector (if (numberp e)\n"
" (logior (ash 1 24) e)\n"
" (if (memq 'hyper (event-modifiers e))\n"
" e\n"
" (add-event-modifier \"H-\" e))))))\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1804
#, no-wrap
msgid ""
"(defun add-event-modifier (string e)\n"
" (let ((symbol (if (symbolp e) e (car e))))\n"
" (setq symbol (intern (concat string\n"
" (symbol-name symbol))))\n"
" (if (symbolp e)\n"
" symbol\n"
" (cons symbol (cdr e)))))\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1806
#, no-wrap
msgid "(define-key local-function-key-map \"\\C-ch\" 'hyperify)\n"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1809
#, no-wrap
msgid "Interaction with normal keymaps"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1814
msgid ""
"The end of a key sequence is detected when that key sequence either is bound "
"to a command, or when Emacs determines that no additional event can lead to "
"a sequence that is bound to a command."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1825
msgid ""
"This means that, while @code{input-decode-map} and "
"@code{key-translation-map} apply regardless of whether the original key "
"sequence would have a binding, the presence of such a binding can still "
"prevent translation from taking place. For example, let us return to our "
"VT100 example above and add a binding for @kbd{C-c @key{ESC}} to the global "
"map; now when the user hits @kbd{C-c @key{PF1}} Emacs will fail to decode "
"@kbd{C-c @key{ESC} O P} into @kbd{C-c @key{PF1}} because it will stop "
"reading keys right after @kbd{C-c @key{ESC}}, leaving @kbd{O P} for later. "
"This is in case the user really hit @kbd{C-c @key{ESC}}, in which case Emacs "
"should not sit there waiting for the next key to decide whether the user "
"really pressed @kbd{@key{ESC}} or @kbd{@key{PF1}}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1830
msgid ""
"For that reason, it is better to avoid binding commands to key sequences "
"where the end of the key sequence is a prefix of a key translation. The "
"main such problematic suffixes/prefixes are @kbd{@key{ESC}}, @kbd{M-O} "
"(which is really @kbd{@key{ESC} O}) and @kbd{M-[} (which is really "
"@kbd{@key{ESC} [})."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1832
#, no-wrap
msgid "Commands for Binding Keys"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1836
msgid ""
"This section describes some convenient interactive interfaces for changing "
"key bindings. They work by calling @code{define-key}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1839
msgid ""
"People often use @code{global-set-key} in their init files (@pxref{Init "
"File}) for simple customization. For example,"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1842
#, no-wrap
msgid "(global-set-key (kbd \"C-x C-\\\\\") 'next-line)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1846
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1853
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1881
msgid "or"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1849
#, no-wrap
msgid "(global-set-key [?\\C-x ?\\C-\\\\] 'next-line)\n"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1856
#, no-wrap
msgid "(global-set-key [(control ?x) (control ?\\\\)] 'next-line)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1860
msgid "redefines @kbd{C-x C-\\} to move down a line."
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1863
#, no-wrap
msgid "(global-set-key [M-mouse-1] 'mouse-set-point)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1868
msgid ""
"redefines the first (leftmost) mouse button, entered with the Meta key, to "
"set point where you click."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1869
#, no-wrap
msgid "non-@acronym{ASCII} text in keybindings"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1874
msgid ""
"Be careful when using non-@acronym{ASCII} text characters in Lisp "
"specifications of keys to bind. If these are read as multibyte text, as "
"they usually will be in a Lisp file (@pxref{Loading Non-ASCII}), you must "
"type the keys as multibyte too. For instance, if you use this:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1877
#, no-wrap
msgid "(global-set-key \"ö\" 'my-function) ; bind o-umlaut\n"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1884
#, no-wrap
msgid "(global-set-key ?ö 'my-function) ; bind o-umlaut\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1893
msgid ""
"and your language environment is multibyte Latin-1, these commands actually "
"bind the multibyte character with code 246, not the byte code 246 "
"(@kbd{M-v}) sent by a Latin-1 terminal. In order to use this binding, you "
"need to teach Emacs how to decode the keyboard by using an appropriate input "
"method (@pxref{Input Methods, , Input Methods, emacs, The GNU Emacs "
"Manual})."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1894
#, no-wrap
msgid "Command global-set-key key binding"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1897
msgid ""
"This function sets the binding of @var{key} in the current global map to "
"@var{binding}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1903
#, no-wrap
msgid ""
"(global-set-key @var{key} @var{binding})\n"
"@equiv{}\n"
"(define-key (current-global-map) @var{key} @var{binding})\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1907
#, no-wrap
msgid "Command global-unset-key key"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1908
#, no-wrap
msgid "unbinding keys"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1911
msgid "This function removes the binding of @var{key} from the current global map."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1915
msgid ""
"One use of this function is in preparation for defining a longer key that "
"uses @var{key} as a prefix---which would not be allowed if @var{key} has a "
"non-prefix binding. For example:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1920
#, no-wrap
msgid ""
"(global-unset-key \"\\C-l\")\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1924
#, no-wrap
msgid ""
"(global-set-key \"\\C-l\\C-l\" 'redraw-display)\n"
" @result{} nil\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1928
msgid "This function is equivalent to using @code{define-key} as follows:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1934
#, no-wrap
msgid ""
"(global-unset-key @var{key})\n"
"@equiv{}\n"
"(define-key (current-global-map) @var{key} nil)\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1938
#, no-wrap
msgid "Command local-set-key key binding"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1941
msgid ""
"This function sets the binding of @var{key} in the current local keymap to "
"@var{binding}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1947
#, no-wrap
msgid ""
"(local-set-key @var{key} @var{binding})\n"
"@equiv{}\n"
"(define-key (current-local-map) @var{key} @var{binding})\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1951
#, no-wrap
msgid "Command local-unset-key key"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1954
msgid "This function removes the binding of @var{key} from the current local map."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1960
#, no-wrap
msgid ""
"(local-unset-key @var{key})\n"
"@equiv{}\n"
"(define-key (current-local-map) @var{key} nil)\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1966
#, no-wrap
msgid "scanning keymaps"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1967
#, no-wrap
msgid "keymaps, scanning"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1974
msgid ""
"This section describes functions used to scan all the current keymaps for "
"the sake of printing help information. To display the bindings in a "
"particular keymap, you can use the @code{describe-keymap} command "
"(@pxref{Misc Help, , Other Help Commands, emacs, The GNU Emacs Manual})"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1975
#, no-wrap
msgid "accessible-keymaps keymap &optional prefix"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1981
msgid ""
"This function returns a list of all the keymaps that can be reached (via "
"zero or more prefix keys) from @var{keymap}. The value is an association "
"list with elements of the form @code{(@var{key} .@: @var{map})}, where "
"@var{key} is a prefix key whose definition in @var{keymap} is @var{map}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1986
msgid ""
"The elements of the alist are ordered so that the @var{key} increases in "
"length. The first element is always @code{([] .@: @var{keymap})}, because "
"the specified keymap is accessible from itself with a prefix of no events."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1992
msgid ""
"If @var{prefix} is given, it should be a prefix key sequence; then "
"@code{accessible-keymaps} includes only the submaps whose prefixes start "
"with @var{prefix}. These elements look just as they do in the value of "
"@code{(accessible-keymaps)}; the only difference is that some elements are "
"omitted."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:1997
msgid ""
"In the example below, the returned alist indicates that the key @key{ESC}, "
"which is displayed as @samp{^[}, is a prefix key whose definition is the "
"sparse keymap @code{(keymap (83 .@: center-paragraph) (115 .@: foo))}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2006
#, no-wrap
msgid ""
"(accessible-keymaps (current-local-map))\n"
"@result{}(([] keymap\n"
" (27 keymap ; @r{Note this keymap for @key{ESC} is repeated below.}\n"
" (83 . center-paragraph)\n"
" (115 . center-line))\n"
" (9 . tab-to-tab-stop))\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2012
#, no-wrap
msgid ""
" (\"^[\" keymap\n"
" (83 . center-paragraph)\n"
" (115 . foo)))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2021
msgid ""
"In the following example, @kbd{C-h} is a prefix key that uses a sparse "
"keymap starting with @code{(keymap (118 . describe-variable)@dots{})}. "
"Another prefix, @kbd{C-x 4}, uses a keymap which is also the value of the "
"variable @code{ctl-x-4-map}. The event @code{mode-line} is one of several "
"dummy events used as prefixes for mouse actions in special parts of a "
"window."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2027
#, no-wrap
msgid ""
"(accessible-keymaps (current-global-map))\n"
"@result{} (([] keymap [set-mark-command beginning-of-line @dots{}\n"
" delete-backward-char])\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2031
#, no-wrap
msgid ""
" (\"^H\" keymap (118 . describe-variable) @dots{}\n"
" (8 . help-for-help))\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2035
#, no-wrap
msgid ""
" (\"^X\" keymap [x-flush-mouse-queue @dots{}\n"
" backward-kill-sentence])\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2039
#, no-wrap
msgid ""
" (\"^[\" keymap [mark-sexp backward-sexp @dots{}\n"
" backward-kill-word])\n"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2041
#, no-wrap
msgid " (\"^X4\" keymap (15 . display-buffer) @dots{})\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2044
#, no-wrap
msgid ""
" ([mode-line] keymap\n"
" (S-mouse-2 . mouse-split-window-horizontally) @dots{}))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2049
msgid "These are not all the keymaps you would see in actuality."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2051
#, no-wrap
msgid "map-keymap function keymap"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2058
msgid ""
"The function @code{map-keymap} calls @var{function} once for each binding in "
"@var{keymap}. It passes two arguments, the event type and the value of the "
"binding. If @var{keymap} has a parent, the parent's bindings are included "
"as well. This works recursively: if the parent has itself a parent, then "
"the grandparent's bindings are also included and so on."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2061
msgid "This function is the cleanest way to examine all the bindings in a keymap."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2063
#, no-wrap
msgid "where-is-internal command &optional keymap firstonly noindirect no-remap"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2068
msgid ""
"This function is a subroutine used by the @code{where-is} command "
"(@pxref{Help, , Help, emacs,The GNU Emacs Manual}). It returns a list of "
"all key sequences (of any length) that are bound to @var{command} in a set "
"of keymaps."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2071
msgid ""
"The argument @var{command} can be any object; it is compared with all keymap "
"entries using @code{eq}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2077
msgid ""
"If @var{keymap} is @code{nil}, then the maps used are the current active "
"keymaps, disregarding @code{overriding-local-map} (that is, pretending its "
"value is @code{nil}). If @var{keymap} is a keymap, then the maps searched "
"are @var{keymap} and the global keymap. If @var{keymap} is a list of "
"keymaps, only those keymaps are searched."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2082
msgid ""
"Usually it's best to use @code{overriding-local-map} as the expression for "
"@var{keymap}. Then @code{where-is-internal} searches precisely the keymaps "
"that are active. To search only the global map, pass the value "
"@code{(keymap)} (an empty keymap) as @var{keymap}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2090
msgid ""
"If @var{firstonly} is @code{non-ascii}, then the value is a single vector "
"representing the first key sequence found, rather than a list of all "
"possible key sequences. If @var{firstonly} is @code{t}, then the value is "
"the first key sequence, except that key sequences consisting entirely of "
"@acronym{ASCII} characters (or meta variants of @acronym{ASCII} characters) "
"are preferred to all other key sequences and that the return value can never "
"be a menu binding."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2094
msgid ""
"If @var{noindirect} is non-@code{nil}, @code{where-is-internal} doesn't look "
"inside menu-items to find their commands. This makes it possible to search "
"for a menu-item itself."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2098
msgid ""
"The fifth argument, @var{no-remap}, determines how this function treats "
"command remappings (@pxref{Remapping Commands}). There are two cases of "
"interest:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2100
#, no-wrap
msgid "If a command @var{other-command} is remapped to @var{command}:"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2106
msgid ""
"If @var{no-remap} is @code{nil}, find the bindings for @var{other-command} "
"and treat them as though they are also bindings for @var{command}. If "
"@var{no-remap} is non-@code{nil}, include the vector @code{[remap "
"@var{other-command}]} in the list of possible key sequences, instead of "
"finding those bindings."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2107
#, no-wrap
msgid "If @var{command} is remapped to @var{other-command}:"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2112
msgid ""
"If @var{no-remap} is @code{nil}, return the bindings for @var{other-command} "
"rather than @var{command}. If @var{no-remap} is non-@code{nil}, return the "
"bindings for @var{command}, ignoring the fact that it is remapped."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2115
#, no-wrap
msgid "Command describe-bindings &optional prefix buffer-or-name"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2119
msgid ""
"This function creates a listing of all current key bindings, and displays it "
"in a buffer named @file{*Help*}. The text is grouped by modes---minor modes "
"first, then the major mode, then global bindings."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2122
msgid ""
"If @var{prefix} is non-@code{nil}, it should be a prefix key; then the "
"listing includes only keys that start with @var{prefix}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2132
msgid ""
"When several characters with consecutive @acronym{ASCII} codes have the same "
"definition, they are shown together, as "
"@samp{@var{firstchar}..@var{lastchar}}. In this instance, you need to know "
"the @acronym{ASCII} codes to understand which characters this means. For "
"example, in the default global map, the characters @samp{@key{SPC} ..@: ~} "
"are described by a single line. @key{SPC} is @acronym{ASCII} 32, @kbd{~} is "
"@acronym{ASCII} 126, and the characters between them include all the normal "
"printing characters, (e.g., letters, digits, punctuation, etc.@:); all these "
"characters are bound to @code{self-insert-command}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2136
msgid ""
"If @var{buffer-or-name} is non-@code{nil}, it should be a buffer or a buffer "
"name. Then @code{describe-bindings} lists that buffer's bindings, instead "
"of the current buffer's."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2140
#, no-wrap
msgid "menu keymaps"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2147
msgid ""
"A keymap can operate as a menu as well as defining bindings for keyboard "
"keys and mouse buttons. Menus are usually actuated with the mouse, but they "
"can function with the keyboard also. If a menu keymap is active for the "
"next input event, that activates the keyboard menu feature."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2159
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2160
#, no-wrap
msgid "Defining Menus"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
msgid "How to make a keymap that defines a menu."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2496
#, no-wrap
msgid "Mouse Menus"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
msgid "How users actuate the menu with the mouse."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2534
#, no-wrap
msgid "Keyboard Menus"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
msgid "How users actuate the menu with the keyboard."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2561
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2562
#, no-wrap
msgid "Menu Example"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
msgid "Making a simple menu."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2633
#, no-wrap
msgid "Menu Bar"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
msgid "How to customize the menu bar."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2722
#, no-wrap
msgid "Tool Bar"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
msgid "A tool bar is a row of images."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2946
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2947
#, no-wrap
msgid "Modifying Menus"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
msgid "How to add new items to a menu."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2986
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2987
#, no-wrap
msgid "Easy Menu"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2157
msgid "A convenience macro for making menus."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2161
#, no-wrap
msgid "defining menus"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2162
#, no-wrap
msgid "menu prompt string"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2163
#, no-wrap
msgid "prompt string (of menu)"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2164
#, no-wrap
msgid "menu item"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2174
msgid ""
"A keymap acts as a menu if it has an @dfn{overall prompt string}, which is a "
"string that appears as an element of the keymap. (@xref{Format of "
"Keymaps}.) The string should describe the purpose of the menu's commands. "
"Emacs displays the overall prompt string as the menu title in some cases, "
"depending on the toolkit (if any) used for displaying menus.@footnote{It is "
"required for menus which do not use a toolkit, e.g., on a text terminal.} "
"Keyboard menus also display the overall prompt string."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2181
msgid ""
"The easiest way to construct a keymap with a prompt string is to specify the "
"string as an argument when you call @code{make-keymap}, "
"@code{make-sparse-keymap} (@pxref{Creating Keymaps}), or "
"@code{define-prefix-command} (@pxref{Definition of define-prefix-command}). "
"If you do not want the keymap to operate as a menu, don't specify a prompt "
"string for it."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2182
#, no-wrap
msgid "keymap-prompt keymap"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2185
msgid ""
"This function returns the overall prompt string of @var{keymap}, or "
"@code{nil} if it has none."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2193
msgid ""
"The menu's items are the bindings in the keymap. Each binding associates an "
"event type to a definition, but the event types have no significance for the "
"menu appearance. (Usually we use pseudo-events, symbols that the keyboard "
"cannot generate, as the event types for menu item bindings.) The menu is "
"generated entirely from the bindings that correspond in the keymap to these "
"events."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2200
msgid ""
"The order of items in the menu is the same as the order of bindings in the "
"keymap. Since @code{define-key} puts new bindings at the front, you should "
"define the menu items starting at the bottom of the menu and moving to the "
"top, if you care about the order. When you add an item to an existing menu, "
"you can specify its position in the menu using @code{define-key-after} "
"(@pxref{Modifying Menus})."
msgstr ""
#. type: subsubsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2206
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2208
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2209
#, no-wrap
msgid "Simple Menu Items"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2206
msgid "A simple kind of menu key binding."
msgstr ""
#. type: subsubsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2206
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2258
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2259
#, no-wrap
msgid "Extended Menu Items"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2206
msgid "More complex menu item definitions."
msgstr ""
#. type: subsubsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2206
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2379
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2380
#, no-wrap
msgid "Menu Separators"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2206
msgid "Drawing a horizontal line through a menu."
msgstr ""
#. type: subsubsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2206
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2464
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2465
#, no-wrap
msgid "Alias Menu Items"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2206
msgid "Using command aliases in menu items."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2213
msgid ""
"The simpler (and original) way to define a menu item is to bind some event "
"type (it doesn't matter what event type) to a binding like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2216
#, no-wrap
msgid "(@var{item-string} . @var{real-binding})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2225
msgid ""
"The @sc{car}, @var{item-string}, is the string to be displayed in the menu. "
"It should be short---preferably one to three words. It should describe the "
"action of the command it corresponds to. Note that not all graphical "
"toolkits can display non-@acronym{ASCII} text in menus (it will work for "
"keyboard menus and will work to a large extent with the GTK+ toolkit)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2227
msgid "You can also supply a second string, called the help string, as follows:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2230
#, no-wrap
msgid "(@var{item-string} @var{help} . @var{real-binding})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2236
msgid ""
"@var{help} specifies a help-echo string to display while the mouse is on "
"that item in the same way as @code{help-echo} text properties (@pxref{Help "
"display})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2241
msgid ""
"As far as @code{define-key} is concerned, @var{item-string} and "
"@var{help-string} are part of the event's binding. However, "
"@code{lookup-key} returns just @var{real-binding}, and only "
"@var{real-binding} is used for executing the key."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2244
msgid ""
"If @var{real-binding} is @code{nil}, then @var{item-string} appears in the "
"menu but cannot be selected."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2252
msgid ""
"If @var{real-binding} is a symbol and has a non-@code{nil} "
"@code{menu-enable} property, that property is an expression that controls "
"whether the menu item is enabled. Every time the keymap is used to display "
"a menu, Emacs evaluates the expression, and it enables the menu item only if "
"the expression's value is non-@code{nil}. When a menu item is disabled, it "
"is displayed in a fuzzy fashion, and cannot be selected."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2257
msgid ""
"The menu bar does not recalculate which items are enabled every time you "
"look at a menu. This is because the X toolkit requires the whole tree of "
"menus in advance. To force recalculation of the menu bar, call "
"@code{force-mode-line-update} (@pxref{Mode Line Format})."
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2260
#, no-wrap
msgid "menu-item"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2261
#, no-wrap
msgid "extended menu item"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2267
msgid ""
"An extended-format menu item is a more flexible and also cleaner alternative "
"to the simple format. You define an event type with a binding that's a list "
"starting with the symbol @code{menu-item}. For a non-selectable string, the "
"binding looks like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2270
#, no-wrap
msgid "(menu-item @var{item-name})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2275
msgid ""
"A string starting with two or more dashes specifies a separator line; see "
"@ref{Menu Separators}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2278
msgid ""
"To define a real menu item which can be selected, the extended format "
"binding looks like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2282
#, no-wrap
msgid ""
"(menu-item @var{item-name} @var{real-binding}\n"
" . @var{item-property-list})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2287
msgid ""
"Here, @var{item-name} is an expression which evaluates to the menu item "
"string. Thus, the string need not be a constant."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2294
msgid ""
"The third element, @var{real-binding}, can be the command to execute (in "
"which case you get a normal menu item). It can also be a keymap, which will "
"result in a submenu, and @var{item-name} is used as the submenu name. "
"Finally, it can be @code{nil}, in which case you will get a non-selectable "
"menu item. This is mostly useful when creating separator lines and the "
"like."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2297
msgid ""
"The tail of the list, @var{item-property-list}, has the form of a property "
"list which contains other information."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2299
msgid "Here is a table of the properties that are supported:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2301
#, no-wrap
msgid ":enable @var{form}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2305
msgid ""
"The result of evaluating @var{form} determines whether the item is enabled "
"(non-@code{nil} means yes). If the item is not enabled, you can't really "
"click on it."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2306
#, no-wrap
msgid ":visible @var{form}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2311
msgid ""
"The result of evaluating @var{form} determines whether the item should "
"actually appear in the menu (non-@code{nil} means yes). If the item does "
"not appear, then the menu is displayed as if this item were not defined at "
"all."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2312
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3085
#, no-wrap
msgid ":help @var{help}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2318
msgid ""
"The value of this property, @var{help}, specifies a help-echo string to "
"display while the mouse is on that item. This is displayed in the same way "
"as @code{help-echo} text properties (@pxref{Help display}). Note that this "
"must be a constant string, unlike the @code{help-echo} property for text and "
"overlays."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2319
#, no-wrap
msgid ":button (@var{type} . @var{selected})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2324
msgid ""
"This property provides a way to define radio buttons and toggle buttons. "
"The @sc{car}, @var{type}, says which: it should be @code{:toggle} or "
"@code{:radio}. The @sc{cdr}, @var{selected}, should be a form; the result "
"of evaluating it says whether this button is currently selected."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2330
msgid ""
"A @dfn{toggle} is a menu item which is labeled as either on or off according "
"to the value of @var{selected}. The command itself should toggle "
"@var{selected}, setting it to @code{t} if it is @code{nil}, and to "
"@code{nil} if it is @code{t}. Here is how the menu item to toggle the "
"@code{debug-on-error} flag is defined:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2336
#, no-wrap
msgid ""
"(menu-item \"Debug on Error\" toggle-debug-on-error\n"
" :button (:toggle\n"
" . (and (boundp 'debug-on-error)\n"
" debug-on-error)))\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2341
msgid ""
"This works because @code{toggle-debug-on-error} is defined as a command "
"which toggles the variable @code{debug-on-error}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2348
msgid ""
"@dfn{Radio buttons} are a group of menu items, in which at any time one and "
"only one is selected. There should be a variable whose value says which one "
"is selected at any time. The @var{selected} form for each radio button in "
"the group should check whether the variable has the right value for "
"selecting that button. Clicking on the button should set the variable so "
"that the button you clicked on becomes selected."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2349
#, no-wrap
msgid ":key-sequence @var{key-sequence}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2356
msgid ""
"This property specifies which key sequence to display as keyboard "
"equivalent. Before Emacs displays @var{key-sequence} in the menu, it "
"verifies that @var{key-sequence} is really equivalent to this menu item, so "
"it only has an effect if you specify a correct key sequence. Specifying "
"@code{nil} for @var{key-sequence} is equivalent to the @code{:key-sequence} "
"attribute being absent."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2357
#, no-wrap
msgid ":keys @var{string}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2361
msgid ""
"This property specifies that @var{string} is the string to display as the "
"keyboard equivalent for this menu item. You can use the @samp{\\\\[...]} "
"documentation construct in @var{string}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2367
msgid ""
"This property can also be a function (which will be called with no "
"arguments). This function should return a string. This function will be "
"called every time the menu is computed, so using a function that takes a lot "
"of time to compute is not a good idea, and it should expect to be called "
"from any context."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2368
#, no-wrap
msgid ":filter @var{filter-fn}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2373
msgid ""
"This property provides a way to compute the menu item dynamically. The "
"property value @var{filter-fn} should be a function of one argument; when it "
"is called, its argument will be @var{real-binding}. The function should "
"return the binding to use instead."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2377
msgid ""
"Emacs can call this function at any time that it does redisplay or operates "
"on menu data structures, so you should write it so it can safely be called "
"at any time."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2381
#, no-wrap
msgid "menu separators"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2386
msgid ""
"A menu separator is a kind of menu item that doesn't display any "
"text---instead, it divides the menu into subparts with a horizontal line. A "
"separator looks like this in the menu keymap:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2389
#, no-wrap
msgid "(menu-item @var{separator-type})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2393
msgid "where @var{separator-type} is a string starting with two or more dashes."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2397
msgid ""
"In the simplest case, @var{separator-type} consists of only dashes. That "
"specifies the default kind of separator. (For compatibility, @code{\"\"} "
"and @code{-} also count as separators.)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2400
msgid ""
"Certain other values of @var{separator-type} specify a different style of "
"separator. Here is a table of them:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2402
#, no-wrap
msgid "\"--no-line\""
msgstr ""
#. type: itemx
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2403
#, no-wrap
msgid "\"--space\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2405
msgid "An extra vertical space, with no actual line."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2406
#, no-wrap
msgid "\"--single-line\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2408
msgid "A single line in the menu's foreground color."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2409
#, no-wrap
msgid "\"--double-line\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2411
msgid "A double line in the menu's foreground color."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2412
#, no-wrap
msgid "\"--single-dashed-line\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2414
msgid "A single dashed line in the menu's foreground color."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2415
#, no-wrap
msgid "\"--double-dashed-line\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2417
msgid "A double dashed line in the menu's foreground color."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2418
#, no-wrap
msgid "\"--shadow-etched-in\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2421
msgid ""
"A single line with a 3D sunken appearance. This is the default, used "
"separators consisting of dashes only."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2422
#, no-wrap
msgid "\"--shadow-etched-out\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2424
msgid "A single line with a 3D raised appearance."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2425
#, no-wrap
msgid "\"--shadow-etched-in-dash\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2427
msgid "A single dashed line with a 3D sunken appearance."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2428
#, no-wrap
msgid "\"--shadow-etched-out-dash\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2430
msgid "A single dashed line with a 3D raised appearance."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2431
#, no-wrap
msgid "\"--shadow-double-etched-in\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2433
msgid "Two lines with a 3D sunken appearance."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2434
#, no-wrap
msgid "\"--shadow-double-etched-out\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2436
msgid "Two lines with a 3D raised appearance."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2437
#, no-wrap
msgid "\"--shadow-double-etched-in-dash\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2439
msgid "Two dashed lines with a 3D sunken appearance."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2440
#, no-wrap
msgid "\"--shadow-double-etched-out-dash\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2442
msgid "Two dashed lines with a 3D raised appearance."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2448
msgid ""
"You can also give these names in another style, adding a colon after the "
"double-dash and replacing each single dash with capitalization of the "
"following word. Thus, @code{\"--:singleLine\"}, is equivalent to "
"@code{\"--single-line\"}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2451
msgid ""
"You can use a longer form to specify keywords such as @code{:enable} and "
"@code{:visible} for a menu separator:"
msgstr ""
#. type: code{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2453
msgid "(menu-item @var{separator-type} nil . @var{item-property-list})"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2455
msgid "For example:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2458
#, no-wrap
msgid "(menu-item \"--\" nil :visible (boundp 'foo))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2463
msgid ""
"Some systems and display toolkits don't really handle all of these separator "
"types. If you use a type that isn't supported, the menu displays a similar "
"kind of separator that is supported."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2473
msgid ""
"Sometimes it is useful to make menu items that use the same command but with "
"different enable conditions. The best way to do this in Emacs now is with "
"extended menu items; before that feature existed, it could be done by "
"defining alias commands and using them in menu items. Here's an example "
"that makes two aliases for @code{read-only-mode} and gives them different "
"enable conditions:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2479
#, no-wrap
msgid ""
"(defalias 'make-read-only 'read-only-mode)\n"
"(put 'make-read-only 'menu-enable '(not buffer-read-only))\n"
"(defalias 'make-writable 'read-only-mode)\n"
"(put 'make-writable 'menu-enable 'buffer-read-only)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2486
msgid ""
"When using aliases in menus, often it is useful to display the equivalent "
"key bindings for the real command name, not the aliases (which typically "
"don't have any key bindings except for the menu itself). To request this, "
"give the alias symbol a non-@code{nil} @code{menu-alias} property. Thus,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2490
#, no-wrap
msgid ""
"(put 'make-read-only 'menu-alias t)\n"
"(put 'make-writable 'menu-alias t)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2495
msgid ""
"causes menu items for @code{make-read-only} and @code{make-writable} to show "
"the keyboard bindings for @code{read-only-mode}."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2497
#, no-wrap
msgid "Menus and the Mouse"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2502
msgid ""
"The usual way to make a menu keymap produce a menu is to make it the "
"definition of a prefix key. (A Lisp program can explicitly pop up a menu "
"and receive the user's choice---see @ref{Pop-Up Menus}.)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2509
msgid ""
"If the prefix key ends with a mouse event, Emacs handles the menu keymap by "
"popping up a visible menu, so that the user can select a choice with the "
"mouse. When the user clicks on a menu item, the event generated is whatever "
"character or symbol has the binding that brought about that menu item. (A "
"menu item may generate a series of events if the menu has multiple levels or "
"comes from the menu bar.)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2512
msgid ""
"It's often best to use a button-down event to trigger the menu. Then the "
"user can select a menu item by releasing the button."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2513
#, no-wrap
msgid "submenu"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2521
msgid ""
"If the menu keymap contains a binding to a nested keymap, the nested keymap "
"specifies a @dfn{submenu}. There will be a menu item, labeled by the nested "
"keymap's item string, and clicking on this item automatically pops up the "
"specified submenu. As a special exception, if the menu keymap contains a "
"single nested keymap and no other menu items, the menu shows the contents of "
"the nested keymap directly, not as a submenu."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2533
msgid ""
"However, if Emacs is compiled without X toolkit support, or on text "
"terminals, submenus are not supported. Each nested keymap is shown as a "
"menu item, but clicking on it does not automatically pop up the submenu. If "
"you wish to imitate the effect of submenus, you can do that by giving a "
"nested keymap an item string which starts with @samp{@@}. This causes Emacs "
"to display the nested keymap using a separate @dfn{menu pane}; the rest of "
"the item string after the @samp{@@} is the pane label. If Emacs is compiled "
"without X toolkit support, or if a menu is displayed on a text terminal, "
"menu panes are not used; in that case, a @samp{@@} at the beginning of an "
"item string is omitted when the menu label is displayed, and has no other "
"effect."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2535
#, no-wrap
msgid "Menus and the Keyboard"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2541
msgid ""
"When a prefix key ending with a keyboard event (a character or function key) "
"has a definition that is a menu keymap, the keymap operates as a keyboard "
"menu; the user specifies the next event by choosing a menu item with the "
"keyboard."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2550
msgid ""
"Emacs displays the keyboard menu with the map's overall prompt string, "
"followed by the alternatives (the item strings of the map's bindings), in "
"the echo area. If the bindings don't all fit at once, the user can type "
"@key{SPC} to see the next line of alternatives. Successive uses of "
"@key{SPC} eventually get to the end of the menu and then cycle around to the "
"beginning. (The variable @code{menu-prompt-more-char} specifies which "
"character is used for this; @key{SPC} is the default.)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2554
msgid ""
"When the user has found the desired alternative from the menu, he or she "
"should type the corresponding character---the one whose binding is that "
"alternative."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2555
#, no-wrap
msgid "menu-prompt-more-char"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2559
msgid ""
"This variable specifies the character to use to ask to see the next line of "
"a menu. Its initial value is 32, the code for @key{SPC}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2563
#, no-wrap
msgid "menu definition example"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2570
msgid ""
"Here is a complete example of defining a menu keymap. It is the definition "
"of the @samp{Replace} submenu in the @samp{Edit} menu in the menu bar, and "
"it uses the extended menu item format (@pxref{Extended Menu Items}). First "
"we create the keymap, and give it a name:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2573
#, no-wrap
msgid "(defvar menu-bar-replace-menu (make-sparse-keymap \"Replace\"))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2577
msgid "Next we define the menu items:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2588
#, no-wrap
msgid ""
"(define-key menu-bar-replace-menu [tags-repl-continue]\n"
" '(menu-item \"Continue Replace\" multifile-continue\n"
" :help \"Continue last tags replace operation\"))\n"
"(define-key menu-bar-replace-menu [tags-repl]\n"
" '(menu-item \"Replace in tagged files\" tags-query-replace\n"
" :help \"Interactively replace a regexp in all tagged "
"files\"))\n"
"(define-key menu-bar-replace-menu [separator-replace-tags]\n"
" '(menu-item \"--\"))\n"
";; @r{@dots{}}\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2599
msgid ""
"Note the symbols which the bindings are made for; these appear inside square "
"brackets, in the key sequence being defined. In some cases, this symbol is "
"the same as the command name; sometimes it is different. These symbols are "
"treated as function keys, but they are not real function keys on the "
"keyboard. They do not affect the functioning of the menu itself, but they "
"are echoed in the echo area when the user selects from the menu, and they "
"appear in the output of @code{where-is} and @code{apropos}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2605
msgid ""
"The menu in this example is intended for use with the mouse. If a menu is "
"intended for use with the keyboard, that is, if it is bound to a key "
"sequence ending with a keyboard event, then the menu items should be bound "
"to characters or real function keys, that can be typed with the keyboard."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2610
msgid ""
"The binding whose definition is @code{(\"--\")} is a separator line. Like a "
"real menu item, the separator has a key symbol, in this case "
"@code{separator-replace-tags}. If one menu has two separators, they must "
"have two different key symbols."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2612
msgid "Here is how we make this menu appear as an item in the parent menu:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2616
#, no-wrap
msgid ""
"(define-key menu-bar-edit-menu [replace]\n"
" (list 'menu-item \"Replace\" menu-bar-replace-menu))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2624
msgid ""
"Note that this incorporates the submenu keymap, which is the value of the "
"variable @code{menu-bar-replace-menu}, rather than the symbol "
"@code{menu-bar-replace-menu} itself. Using that symbol in the parent menu "
"item would be meaningless because @code{menu-bar-replace-menu} is not a "
"command."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2627
msgid ""
"If you wanted to attach the same replace menu to a mouse click, you can do "
"it this way:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2631
#, no-wrap
msgid ""
"(define-key global-map [C-S-down-mouse-1]\n"
" menu-bar-replace-menu)\n"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2634
#, no-wrap
msgid "The Menu Bar"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2635
#, no-wrap
msgid "menu bar"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2641
msgid ""
"Emacs usually shows a @dfn{menu bar} at the top of each frame. @xref{Menu "
"Bars,,,emacs, The GNU Emacs Manual}. Menu bar items are subcommands of the "
"fake function key @key{MENU-BAR}, as defined in the active keymaps."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2646
msgid ""
"To add an item to the menu bar, invent a fake function key of your own "
"(let's call it @var{key}), and make a binding for the key sequence "
"@code{[menu-bar @var{key}]}. Most often, the binding is a menu keymap, so "
"that pressing a button on the menu bar item leads to another menu."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2652
msgid ""
"When more than one active keymap defines the same function key for the menu "
"bar, the item appears just once. If the user clicks on that menu bar item, "
"it brings up a single, combined menu containing all the subcommands of that "
"item---the global subcommands, the local subcommands, and the minor mode "
"subcommands."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2657
msgid ""
"The variable @code{overriding-local-map} is normally ignored when "
"determining the menu bar contents. That is, the menu bar is computed from "
"the keymaps that would be active if @code{overriding-local-map} were "
"@code{nil}. @xref{Active Keymaps}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2659
msgid "Here's an example of setting up a menu bar item:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2666
#, no-wrap
msgid ""
";; @r{Make a menu keymap (with a prompt string)}\n"
";; @r{and make it the menu bar item's definition.}\n"
"(define-key global-map [menu-bar words]\n"
" (cons \"Words\" (make-sparse-keymap \"Words\")))\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2673
#, no-wrap
msgid ""
";; @r{Define specific subcommands in this menu.}\n"
"(define-key global-map\n"
" [menu-bar words forward]\n"
" '(\"Forward word\" . forward-word))\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2678
#, no-wrap
msgid ""
"(define-key global-map\n"
" [menu-bar words backward]\n"
" '(\"Backward word\" . backward-word))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2685
msgid ""
"A local keymap can cancel a menu bar item made by the global keymap by "
"rebinding the same fake function key with @code{undefined} as the binding. "
"For example, this is how Dired suppresses the @samp{Edit} menu bar item:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2688
#, no-wrap
msgid "(define-key dired-mode-map [menu-bar edit] 'undefined)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2695
msgid ""
"Here, @code{edit} is the symbol produced by a fake function key, it is used "
"by the global map for the @samp{Edit} menu bar item. The main reason to "
"suppress a global menu bar item is to regain space for mode-specific items."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2696
#, no-wrap
msgid "menu-bar-final-items"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2699
msgid ""
"Normally the menu bar shows global items followed by items defined by the "
"local maps."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2704
msgid ""
"This variable holds a list of fake function keys for items to display at the "
"end of the menu bar rather than in normal sequence. The default value is "
"@code{(help-menu)}; thus, the @samp{Help} menu item normally appears at the "
"end of the menu bar, following local menu items."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2706
#, no-wrap
msgid "menu-bar-update-hook"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2712
msgid ""
"This normal hook is run by redisplay to update the menu bar contents, before "
"redisplaying the menu bar. You can use it to update menus whose contents "
"should vary. Since this hook is run frequently, we advise you to ensure "
"that the functions it calls do not take much time in the usual case."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2721
msgid ""
"Next to every menu bar item, Emacs displays a key binding that runs the same "
"command (if such a key binding exists). This serves as a convenient hint "
"for users who do not know the key binding. If a command has multiple "
"bindings, Emacs normally displays the first one it finds. You can specify "
"one particular key binding by assigning an @code{:advertised-binding} symbol "
"property to the command. @xref{Keys in Documentation}."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2723
#, no-wrap
msgid "Tool bars"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2724
#, no-wrap
msgid "tool bar"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2729
msgid ""
"A @dfn{tool bar} is a row of clickable icons at the top of a frame, just "
"below the menu bar. @xref{Tool Bars,,,emacs, The GNU Emacs Manual}. Emacs "
"normally shows a tool bar on graphical displays."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2737
msgid ""
"On each frame, the frame parameter @code{tool-bar-lines} controls how many "
"lines' worth of height to reserve for the tool bar. A zero value suppresses "
"the tool bar. If the value is nonzero, and @code{auto-resize-tool-bars} is "
"non-@code{nil}, the tool bar expands and contracts automatically as needed "
"to hold the specified contents. If the value is @code{grow-only}, the tool "
"bar expands automatically, but does not contract automatically."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2742
msgid ""
"The tool bar contents are controlled by a menu keymap attached to a fake "
"function key called @key{TOOL-BAR} (much like the way the menu bar is "
"controlled). So you define a tool bar item using @code{define-key}, like "
"this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2745
#, no-wrap
msgid "(define-key global-map [tool-bar @var{key}] @var{item})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2751
msgid ""
"where @var{key} is a fake function key to distinguish this item from other "
"items, and @var{item} is a menu item key binding (@pxref{Extended Menu "
"Items}), which says how to display this item and how it behaves."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2757
msgid ""
"The usual menu keymap item properties, @code{:visible}, @code{:enable}, "
"@code{:button}, and @code{:filter}, are useful in tool bar bindings and have "
"their normal meanings. The @var{real-binding} in the item must be a "
"command, not a keymap; in other words, it does not work to define a tool bar "
"icon as a prefix key."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2761
msgid ""
"The @code{:help} property specifies a help-echo string to display while the "
"mouse is on that item. This is displayed in the same way as "
"@code{help-echo} text properties (@pxref{Help display})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2764
msgid ""
"In addition, you should use the @code{:image} property; this is how you "
"specify the image to display in the tool bar:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2766
#, no-wrap
msgid ":image @var{image}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2770
msgid ""
"@var{image} is either a single image specification (@pxref{Images}) or a "
"vector of four image specifications. If you use a vector of four, one of "
"them is used, depending on circumstances:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2772
#, no-wrap
msgid "item 0"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2774
msgid "Used when the item is enabled and selected."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2774
#, no-wrap
msgid "item 1"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2776
msgid "Used when the item is enabled and deselected."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2776
#, no-wrap
msgid "item 2"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2778
msgid "Used when the item is disabled and selected."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2778
#, no-wrap
msgid "item 3"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2780
msgid "Used when the item is disabled and deselected."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2785
msgid ""
"The GTK+ and NS versions of Emacs ignores items 1 to 3, because disabled "
"and/or deselected images are autocomputed from item 0."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2789
msgid ""
"If @var{image} is a single image specification, Emacs draws the tool bar "
"button in disabled state by applying an edge-detection algorithm to the "
"image."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2793
msgid ""
"The @code{:rtl} property specifies an alternative image to use for "
"right-to-left languages. Only the GTK+ version of Emacs supports this at "
"present."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2802
msgid ""
"Like the menu bar, the tool bar can display separators (@pxref{Menu "
"Separators}). Tool bar separators are vertical rather than horizontal, "
"though, and only a single style is supported. They are represented in the "
"tool bar keymap by @code{(menu-item \"--\")} entries; properties like "
"@code{:visible} are not supported for tool bar separators. Separators are "
"rendered natively in GTK+ and Nextstep tool bars; in the other cases, they "
"are rendered using an image of a vertical line."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2811
msgid ""
"The default tool bar is defined so that items specific to editing do not "
"appear for major modes whose command symbol has a @code{mode-class} property "
"of @code{special} (@pxref{Major Mode Conventions}). Major modes may add "
"items to the global bar by binding @code{[tool-bar @var{foo}]} in their "
"local map. It makes sense for some major modes to replace the default tool "
"bar items completely, since not many can be accommodated conveniently, and "
"the default bindings make this easy by using an indirection through "
"@code{tool-bar-map}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2812
#, no-wrap
msgid "tool-bar-map"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2814
msgid "By default, the global map binds @code{[tool-bar]} as follows:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2819
#, no-wrap
msgid ""
"(global-set-key [tool-bar]\n"
" `(menu-item ,(purecopy \"tool bar\") ignore\n"
" :filter tool-bar-make-keymap))\n"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2828
msgid ""
"The function @code{tool-bar-make-keymap}, in turn, derives the actual tool "
"bar map dynamically from the value of the variable @code{tool-bar-map}. "
"Hence, you should normally adjust the default (global) tool bar by changing "
"that map. Some major modes, such as Info mode, completely replace the "
"global tool bar by making @code{tool-bar-map} buffer-local and setting it to "
"a different keymap."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2832
msgid "There are two convenience functions for defining tool bar items, as follows."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2833
#, no-wrap
msgid "tool-bar-add-item icon def key &rest props"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2844
msgid ""
"This function adds an item to the tool bar by modifying "
"@code{tool-bar-map}. The image to use is defined by @var{icon}, which is "
"the base name of an XPM, XBM or PBM image file to be located by "
"@code{find-image}. Given a value @samp{\"exit\"}, say, @file{exit.xpm}, "
"@file{exit.pbm} and @file{exit.xbm} would be searched for in that order on a "
"color display. On a monochrome display, the search order is @samp{.pbm}, "
"@samp{.xbm} and @samp{.xpm}. The binding to use is the command @var{def}, "
"and @var{key} is the fake function key symbol in the prefix keymap. The "
"remaining arguments @var{props} are additional property list elements to add "
"to the menu item specification."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2847
msgid ""
"To define items in some local map, bind @code{tool-bar-map} with @code{let} "
"around calls of this function:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2853
#, no-wrap
msgid ""
"(defvar foo-tool-bar-map\n"
" (let ((tool-bar-map (make-sparse-keymap)))\n"
" (tool-bar-add-item @dots{})\n"
" @dots{}\n"
" tool-bar-map))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2856
#, no-wrap
msgid "tool-bar-add-item-from-menu command icon &optional map &rest props"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2865
msgid ""
"This function is a convenience for defining tool bar items which are "
"consistent with existing menu bar bindings. The binding of @var{command} is "
"looked up in the menu bar in @var{map} (default @code{global-map}) and "
"modified to add an image specification for @var{icon}, which is found in the "
"same way as by @code{tool-bar-add-item}. The resulting binding is then "
"placed in @code{tool-bar-map}, so use this function only for global tool bar "
"items."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2869
msgid ""
"@var{map} must contain an appropriate keymap bound to @code{[menu-bar]}. "
"The remaining arguments @var{props} are additional property list elements to "
"add to the menu item specification."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2871
#, no-wrap
msgid ""
"tool-bar-local-item-from-menu command icon in-map &optional from-map &rest "
"props"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2877
msgid ""
"This function is used for making non-global tool bar items. Use it like "
"@code{tool-bar-add-item-from-menu} except that @var{in-map} specifies the "
"local map to make the definition in. The argument @var{from-map} is like "
"the @var{map} argument of @code{tool-bar-add-item-from-menu}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2879
#, no-wrap
msgid "auto-resize-tool-bars"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2883
msgid ""
"If this variable is non-@code{nil}, the tool bar automatically resizes to "
"show all defined tool bar items---but not larger than a quarter of the "
"frame's height."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2887
msgid ""
"If the value is @code{grow-only}, the tool bar expands automatically, but "
"does not contract automatically. To contract the tool bar, the user has to "
"redraw the frame by entering @kbd{C-l}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2890
msgid ""
"If Emacs is built with GTK+ or Nextstep, the tool bar can only show one "
"line, so this variable has no effect."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2892
#, no-wrap
msgid "auto-raise-tool-bar-buttons"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2895
msgid ""
"If this variable is non-@code{nil}, tool bar items display in raised form "
"when the mouse moves over them."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2897
#, no-wrap
msgid "tool-bar-button-margin"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2900
msgid ""
"This variable specifies an extra margin to add around tool bar items. The "
"value is an integer, a number of pixels. The default is 4."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2902
#, no-wrap
msgid "tool-bar-button-relief"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2905
msgid ""
"This variable specifies the shadow width for tool bar items. The value is "
"an integer, a number of pixels. The default is 1."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2907
#, no-wrap
msgid "tool-bar-border"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2913
msgid ""
"This variable specifies the height of the border drawn below the tool bar "
"area. An integer specifies height as a number of pixels. If the value is "
"one of @code{internal-border-width} (the default) or @code{border-width}, "
"the tool bar border height corresponds to the corresponding frame parameter."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2921
msgid ""
"You can define a special meaning for clicking on a tool bar item with the "
"shift, control, meta, etc., modifiers. You do this by setting up additional "
"items that relate to the original item through the fake function keys. "
"Specifically, the additional items should use the modified versions of the "
"same fake function key used to name the original item."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2923
msgid "Thus, if the original item was defined this way,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2928
#, no-wrap
msgid ""
"(define-key global-map [tool-bar shell]\n"
" '(menu-item \"Shell\" shell\n"
" :image (image :type xpm :file \"shell.xpm\")))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2933
msgid ""
"then here is how you can define clicking on the same tool bar image with the "
"shift modifier:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2936
#, no-wrap
msgid "(define-key global-map [tool-bar S-shell] 'some-command)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2940
msgid ""
"@xref{Function Keys}, for more information about how to add modifiers to "
"function keys."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2945
msgid ""
"If you have functions that change whether a tool bar item is enabled or not, "
"this status is not necessarily updated visually immediately. To force "
"recalculation of the tool bar, call @code{force-mode-line-update} "
"(@pxref{Mode Line Format})."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2948
#, no-wrap
msgid "menu modification"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2954
msgid ""
"When you insert a new item in an existing menu, you probably want to put it "
"in a particular place among the menu's existing items. If you use "
"@code{define-key} to add the item, it normally goes at the front of the "
"menu. To put it elsewhere in the menu, use @code{define-key-after}:"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2955
#, no-wrap
msgid "define-key-after map key binding &optional after"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2965
msgid ""
"Define a binding in @var{map} for @var{key}, with value @var{binding}, just "
"like @code{define-key}, but position the binding in @var{map} after the "
"binding for the event @var{after}. The argument @var{key} should be of "
"length one---a vector or string with just one element. But @var{after} "
"should be a single event type---a symbol or a character, not a sequence. "
"The new binding goes after the binding for @var{after}. If @var{after} is "
"@code{t} or is omitted, then the new binding goes last, at the end of the "
"keymap. However, new bindings are added before any inherited keymap."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2967
msgid "Here is an example:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2971
#, no-wrap
msgid ""
"(define-key-after my-menu [drink]\n"
" '(\"Drink\" . drink-command) 'eat)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2976
msgid ""
"makes a binding for the fake function key @key{DRINK} and puts it right "
"after the binding for @key{EAT}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2979
msgid ""
"Here is how to insert an item called @samp{Work} in the @samp{Signals} menu "
"of Shell mode, after the item @code{break}:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2983
#, no-wrap
msgid ""
"(define-key-after shell-mode-map [menu-bar signals work]\n"
" '(\"Work\" . work-command) 'break)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2991
msgid ""
"The following macro provides a convenient way to define pop-up menus and/or "
"menu bar menus."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2992
#, no-wrap
msgid "easy-menu-define symbol maps doc menu"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:2995
msgid ""
"This macro defines a pop-up menu and/or menu bar submenu, whose contents are "
"given by @var{menu}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3000
msgid ""
"If @var{symbol} is non-@code{nil}, it should be a symbol; then this macro "
"defines @var{symbol} as a function for popping up the menu (@pxref{Pop-Up "
"Menus}), with @var{doc} as its documentation string. @var{symbol} should "
"not be quoted."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3005
msgid ""
"Regardless of the value of @var{symbol}, if @var{maps} is a keymap, the menu "
"is added to that keymap, as a top-level menu for the menu bar (@pxref{Menu "
"Bar}). It can also be a list of keymaps, in which case the menu is added "
"separately to each of those keymaps."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3009
msgid ""
"The first element of @var{menu} must be a string, which serves as the menu "
"label. It may be followed by any number of the following keyword-argument "
"pairs:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3011
#, no-wrap
msgid ":filter @var{function}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3015
msgid ""
"@var{function} must be a function which, if called with one argument---the "
"list of the other menu items---returns the actual items to be displayed in "
"the menu."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3016
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3063
#, no-wrap
msgid ":visible @var{include}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3020
msgid ""
"@var{include} is an expression; if it evaluates to @code{nil}, the menu is "
"made invisible. @code{:included} is an alias for @code{:visible}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3021
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3059
#, no-wrap
msgid ":active @var{enable}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3024
msgid ""
"@var{enable} is an expression; if it evaluates to @code{nil}, the menu is "
"not selectable. @code{:enable} is an alias for @code{:active}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3027
msgid "The remaining elements in @var{menu} are menu items."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3033
msgid ""
"A menu item can be a vector of three elements, @code{[@var{name} "
"@var{callback} @var{enable}]}. @var{name} is the menu item name (a "
"string). @var{callback} is a command to run, or an expression to evaluate, "
"when the item is chosen. @var{enable} is an expression; if it evaluates to "
"@code{nil}, the item is disabled for selection."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3035
msgid "Alternatively, a menu item may have the form:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3038
#, no-wrap
msgid " [ @var{name} @var{callback} [ @var{keyword} @var{arg} ]... ]\n"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3044
msgid ""
"where @var{name} and @var{callback} have the same meanings as above, and "
"each optional @var{keyword} and @var{arg} pair should be one of the "
"following:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3046
#, no-wrap
msgid ":keys @var{keys}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3052
msgid ""
"@var{keys} is a string to display as keyboard equivalent to the menu item. "
"This is normally not needed, as keyboard equivalents are computed "
"automatically. @var{keys} is expanded with @code{substitute-command-keys} "
"before it is displayed (@pxref{Keys in Documentation})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3053
#, no-wrap
msgid ":key-sequence @var{keys}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3058
msgid ""
"@var{keys} is a hint indicating which key sequence to display as keyboard "
"equivalent, in case the command is bound to several key sequences. It has "
"no effect if @var{keys} is not bound to same command as this menu item."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3062
msgid ""
"@var{enable} is an expression; if it evaluates to @code{nil}, the item is "
"made unselectable. @code{:enable} is an alias for @code{:active}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3067
msgid ""
"@var{include} is an expression; if it evaluates to @code{nil}, the item is "
"made invisible. @code{:included} is an alias for @code{:visible}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3068
#, no-wrap
msgid ":label @var{form}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3071
msgid ""
"@var{form} is an expression that is evaluated to obtain a value which serves "
"as the menu item's label (the default is @var{name})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3072
#, no-wrap
msgid ":suffix @var{form}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3075
msgid ""
"@var{form} is an expression that is dynamically evaluated and whose value is "
"concatenated with the menu entry's label."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3076
#, no-wrap
msgid ":style @var{style}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3080
msgid ""
"@var{style} is a symbol describing the type of menu item; it should be "
"@code{toggle} (a checkbox), or @code{radio} (a radio button), or anything "
"else (meaning an ordinary menu item)."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3081
#, no-wrap
msgid ":selected @var{selected}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3084
msgid ""
"@var{selected} is an expression; the checkbox or radio button is selected "
"whenever the expression's value is non-@code{nil}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3087
msgid "@var{help} is a string describing the menu item."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3092
msgid ""
"Alternatively, a menu item can be a string. Then that string appears in the "
"menu as unselectable text. A string consisting of dashes is displayed as a "
"separator (@pxref{Menu Separators})."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3095
msgid ""
"Alternatively, a menu item can be a list with the same format as "
"@var{menu}. This is a submenu."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3099
msgid ""
"Here is an example of using @code{easy-menu-define} to define a menu similar "
"to the one defined in the example in @ref{Menu Bar}:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/keymaps.texi:3106
#, no-wrap
msgid ""
"(easy-menu-define words-menu global-map\n"
" \"Menu for word navigation commands.\"\n"
" '(\"Words\"\n"
" [\"Forward word\" forward-word]\n"
" [\"Backward word\" backward-word]))\n"
msgstr ""