5951 lines
212 KiB
Plaintext
5951 lines
212 KiB
Plaintext
# SOME DESCRIPTIVE TITLE
|
||
# Copyright (C) YEAR Free Software Foundation, Inc.
|
||
# This file is distributed under the same license as the PACKAGE package.
|
||
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
||
#
|
||
#, fuzzy
|
||
msgid ""
|
||
msgstr ""
|
||
"Project-Id-Version: PACKAGE VERSION\n"
|
||
"POT-Creation-Date: 2021-11-07 12:11+0900\n"
|
||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||
"Language: \n"
|
||
"MIME-Version: 1.0\n"
|
||
"Content-Type: text/plain; charset=UTF-8\n"
|
||
"Content-Transfer-Encoding: 8bit\n"
|
||
|
||
#. type: chapter
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:6
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:7
|
||
#, no-wrap
|
||
msgid "Functions"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:12
|
||
msgid ""
|
||
"A Lisp program is composed mainly of Lisp functions. This chapter explains "
|
||
"what functions are, how they accept arguments, and how to define them."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:35
|
||
#, no-wrap
|
||
msgid "What Is a Function"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "Lisp functions vs. primitives; terminology."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:220
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:221
|
||
#, no-wrap
|
||
msgid "Lambda Expressions"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "How functions are expressed as Lisp objects."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:520
|
||
#, no-wrap
|
||
msgid "Function Names"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "A symbol can serve as the name of a function."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:575
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:576
|
||
#, no-wrap
|
||
msgid "Defining Functions"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "Lisp expressions for defining functions."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:690
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:691
|
||
#, no-wrap
|
||
msgid "Calling Functions"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "How to use an existing function."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:883
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:884
|
||
#, no-wrap
|
||
msgid "Mapping Functions"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "Applying a function to each element of a list, etc."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1003
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1004
|
||
#, no-wrap
|
||
msgid "Anonymous Functions"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "Lambda expressions are functions with no names."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1117
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1118
|
||
#, no-wrap
|
||
msgid "Generic Functions"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "Polymorphism, Emacs-style."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1354
|
||
#, no-wrap
|
||
msgid "Function Cells"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "Accessing or setting the function definition of a symbol."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1458
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1459
|
||
#, no-wrap
|
||
msgid "Closures"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "Functions that enclose a lexical environment."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1496
|
||
#, no-wrap
|
||
msgid "Advising Functions"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "Adding to the definition of a function."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2008
|
||
#, no-wrap
|
||
msgid "Obsolete Functions"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "Declaring functions obsolete."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2088
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2089
|
||
#, no-wrap
|
||
msgid "Inline Functions"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "Functions that the compiler will expand inline."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2237
|
||
#, no-wrap
|
||
msgid "Declare Form"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "Adding additional information about a function."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2338
|
||
#, no-wrap
|
||
msgid "Declaring Functions"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "Telling the compiler that a function is defined."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2425
|
||
#, no-wrap
|
||
msgid "Function Safety"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid "Determining whether a function is safe to call."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2513
|
||
#, no-wrap
|
||
msgid "Related Topics"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:33
|
||
msgid ""
|
||
"Cross-references to specific Lisp primitives that have a special bearing on "
|
||
"how functions work."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:36
|
||
#, no-wrap
|
||
msgid "What Is a Function?"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:38
|
||
#, no-wrap
|
||
msgid "return value"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:39
|
||
#, no-wrap
|
||
msgid "value of function"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:40
|
||
#, no-wrap
|
||
msgid "argument"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:41
|
||
#, no-wrap
|
||
msgid "pure function"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:51
|
||
msgid ""
|
||
"In a general sense, a function is a rule for carrying out a computation "
|
||
"given input values called @dfn{arguments}. The result of the computation is "
|
||
"called the @dfn{value} or @dfn{return value} of the function. The "
|
||
"computation can also have side effects, such as lasting changes in the "
|
||
"values of variables or the contents of data structures (@pxref{Definition of "
|
||
"side effect}). A @dfn{pure function} is a function which, in addition to "
|
||
"having no side effects, always returns the same value for the same "
|
||
"combination of arguments, regardless of external factors such as machine "
|
||
"type or system state."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:61
|
||
msgid ""
|
||
"In most computer languages, every function has a name. But in Lisp, a "
|
||
"function in the strictest sense has no name: it is an object which can "
|
||
"@emph{optionally} be associated with a symbol (e.g., @code{car}) that "
|
||
"serves as the function name. @xref{Function Names}. When a function has "
|
||
"been given a name, we usually also refer to that symbol as a ``function'' "
|
||
"(e.g., we refer to ``the function @code{car}''). In this manual, the "
|
||
"distinction between a function name and the function object itself is "
|
||
"usually unimportant, but we will take note wherever it is relevant."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:66
|
||
msgid ""
|
||
"Certain function-like objects, called @dfn{special forms} and @dfn{macros}, "
|
||
"also accept arguments to carry out computations. However, as explained "
|
||
"below, these are not considered functions in Emacs Lisp."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:68
|
||
msgid "Here are important terms for functions and function-like objects:"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:70
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:222
|
||
#, no-wrap
|
||
msgid "lambda expression"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:73
|
||
msgid ""
|
||
"A function (in the strict sense, i.e., a function object) which is written "
|
||
"in Lisp. These are described in the following section."
|
||
msgstr ""
|
||
|
||
#. type: ifnottex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:75
|
||
msgid "@xref{Lambda Expressions}."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:77
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:78
|
||
#, no-wrap
|
||
msgid "primitive"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:79
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1261
|
||
#, no-wrap
|
||
msgid "subr"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:80
|
||
#, no-wrap
|
||
msgid "built-in function"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:86
|
||
msgid ""
|
||
"A function which is callable from Lisp but is actually written in C@. "
|
||
"Primitives are also called @dfn{built-in functions}, or @dfn{subrs}. "
|
||
"Examples include functions like @code{car} and @code{append}. In addition, "
|
||
"all special forms (see below) are also considered primitives."
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:93
|
||
msgid ""
|
||
"Usually, a function is implemented as a primitive because it is a "
|
||
"fundamental part of Lisp (e.g., @code{car}), or because it provides a "
|
||
"low-level interface to operating system services, or because it needs to run "
|
||
"fast. Unlike functions defined in Lisp, primitives can be modified or added "
|
||
"only by changing the C sources and recompiling Emacs. See @ref{Writing "
|
||
"Emacs Primitives}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:94
|
||
#, no-wrap
|
||
msgid "special form"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:100
|
||
msgid ""
|
||
"A primitive that is like a function but does not evaluate all of its "
|
||
"arguments in the usual way. It may evaluate only some of the arguments, or "
|
||
"may evaluate them in an unusual order, or several times. Examples include "
|
||
"@code{if}, @code{and}, and @code{while}. @xref{Special Forms}."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:101
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:102
|
||
#, no-wrap
|
||
msgid "macro"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:108
|
||
msgid ""
|
||
"A construct defined in Lisp, which differs from a function in that it "
|
||
"translates a Lisp expression into another expression which is to be "
|
||
"evaluated instead of the original expression. Macros enable Lisp "
|
||
"programmers to do the sorts of things that special forms can do. "
|
||
"@xref{Macros}."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:109
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:110
|
||
#, no-wrap
|
||
msgid "command"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:118
|
||
msgid ""
|
||
"An object which can be invoked via the @code{command-execute} primitive, "
|
||
"usually due to the user typing in a key sequence @dfn{bound} to that "
|
||
"command. @xref{Interactive Call}. A command is usually a function; if the "
|
||
"function is written in Lisp, it is made into a command by an "
|
||
"@code{interactive} form in the function definition (@pxref{Defining "
|
||
"Commands}). Commands that are functions can also be called from Lisp "
|
||
"expressions, just like other functions."
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:124
|
||
msgid ""
|
||
"Keyboard macros (strings and vectors) are commands also, even though they "
|
||
"are not functions. @xref{Keyboard Macros}. We say that a symbol is a "
|
||
"command if its function cell contains a command (@pxref{Symbol Components}); "
|
||
"such a @dfn{named command} can be invoked with @kbd{M-x}."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:125
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1469
|
||
#, no-wrap
|
||
msgid "closure"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:129
|
||
msgid ""
|
||
"A function object that is much like a lambda expression, except that it also "
|
||
"encloses an environment of lexical variable bindings. @xref{Closures}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:130
|
||
#, no-wrap
|
||
msgid "byte-code function"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:133
|
||
msgid ""
|
||
"A function that has been compiled by the byte compiler. @xref{Byte-Code "
|
||
"Type}."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:134
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:135
|
||
#, no-wrap
|
||
msgid "autoload object"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:139
|
||
msgid ""
|
||
"A place-holder for a real function. If the autoload object is called, Emacs "
|
||
"loads the file containing the definition of the real function, and then "
|
||
"calls the real function. @xref{Autoload}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:143
|
||
msgid ""
|
||
"You can use the function @code{functionp} to test if an object is a "
|
||
"function:"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:144
|
||
#, no-wrap
|
||
msgid "functionp object"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:149
|
||
msgid ""
|
||
"This function returns @code{t} if @var{object} is any kind of function, "
|
||
"i.e., can be passed to @code{funcall}. Note that @code{functionp} returns "
|
||
"@code{t} for symbols that are function names, and returns @code{nil} for "
|
||
"special forms."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:153
|
||
msgid ""
|
||
"It is also possible to find out how many arguments an arbitrary function "
|
||
"expects:"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:154
|
||
#, no-wrap
|
||
msgid "func-arity function"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:162
|
||
msgid ""
|
||
"This function provides information about the argument list of the specified "
|
||
"@var{function}. The returned value is a cons cell of the form "
|
||
"@w{@code{(@var{min} . @var{max})}}, where @var{min} is the minimum number of "
|
||
"arguments, and @var{max} is either the maximum number of arguments, or the "
|
||
"symbol @code{many} for functions with @code{&rest} arguments, or the symbol "
|
||
"@code{unevalled} if @var{function} is a special form."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:165
|
||
msgid ""
|
||
"Note that this function might return inaccurate results in some situations, "
|
||
"such as the following:"
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:170
|
||
msgid ""
|
||
"Functions defined using @code{apply-partially} (@pxref{Calling Functions, "
|
||
"apply-partially})."
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:174
|
||
msgid ""
|
||
"Functions that are advised using @code{advice-add} (@pxref{Advising Named "
|
||
"Functions})."
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:178
|
||
msgid ""
|
||
"Functions that determine the argument list dynamically, as part of their "
|
||
"code."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:185
|
||
msgid ""
|
||
"Unlike @code{functionp}, the next three functions do @emph{not} treat a "
|
||
"symbol as its function definition."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:186
|
||
#, no-wrap
|
||
msgid "subrp object"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:189
|
||
msgid ""
|
||
"This function returns @code{t} if @var{object} is a built-in function (i.e., "
|
||
"a Lisp primitive)."
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:194
|
||
#, no-wrap
|
||
msgid ""
|
||
"(subrp 'message) ; @r{@code{message} is a symbol,}\n"
|
||
" @result{} nil ; @r{not a subr object.}\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:198
|
||
#, no-wrap
|
||
msgid ""
|
||
"(subrp (symbol-function 'message))\n"
|
||
" @result{} t\n"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:202
|
||
#, no-wrap
|
||
msgid "byte-code-function-p object"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:205
|
||
msgid ""
|
||
"This function returns @code{t} if @var{object} is a byte-code function. For "
|
||
"example:"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:210
|
||
#, no-wrap
|
||
msgid ""
|
||
"(byte-code-function-p (symbol-function 'next-line))\n"
|
||
" @result{} t\n"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:214
|
||
#, no-wrap
|
||
msgid "subr-arity subr"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:218
|
||
msgid ""
|
||
"This works like @code{func-arity}, but only for built-in functions and "
|
||
"without symbol indirection. It signals an error for non-built-in "
|
||
"functions. We recommend to use @code{func-arity} instead."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:226
|
||
msgid ""
|
||
"A lambda expression is a function object written in Lisp. Here is an "
|
||
"example:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:231
|
||
#, no-wrap
|
||
msgid ""
|
||
"(lambda (x)\n"
|
||
" \"Return the hyperbolic cosine of X.\"\n"
|
||
" (* 0.5 (+ (exp x) (exp (- x)))))\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:236
|
||
msgid ""
|
||
"In Emacs Lisp, such a list is a valid expression which evaluates to a "
|
||
"function object."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:243
|
||
msgid ""
|
||
"A lambda expression, by itself, has no name; it is an @dfn{anonymous "
|
||
"function}. Although lambda expressions can be used this way "
|
||
"(@pxref{Anonymous Functions}), they are more commonly associated with "
|
||
"symbols to make @dfn{named functions} (@pxref{Function Names}). Before "
|
||
"going into these details, the following subsections describe the components "
|
||
"of a lambda expression and what they do."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:249
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:251
|
||
#, no-wrap
|
||
msgid "Lambda Components"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:249
|
||
msgid "The parts of a lambda expression."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:249
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:295
|
||
#, no-wrap
|
||
msgid "Simple Lambda"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:249
|
||
msgid "A simple example."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:249
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:345
|
||
#, no-wrap
|
||
msgid "Argument List"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:249
|
||
msgid "Details and special features of argument lists."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:249
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:455
|
||
#, no-wrap
|
||
msgid "Function Documentation"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:249
|
||
msgid "How to put documentation in a function."
|
||
msgstr ""
|
||
|
||
#. type: subsection
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:252
|
||
#, no-wrap
|
||
msgid "Components of a Lambda Expression"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:255
|
||
msgid "A lambda expression is a list that looks like this:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:261
|
||
#, no-wrap
|
||
msgid ""
|
||
"(lambda (@var{arg-variables}@dots{})\n"
|
||
" [@var{documentation-string}]\n"
|
||
" [@var{interactive-declaration}]\n"
|
||
" @var{body-forms}@dots{})\n"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:263
|
||
#, no-wrap
|
||
msgid "lambda list"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:269
|
||
msgid ""
|
||
"The first element of a lambda expression is always the symbol "
|
||
"@code{lambda}. This indicates that the list represents a function. The "
|
||
"reason functions are defined to start with @code{lambda} is so that other "
|
||
"lists, intended for other uses, will not accidentally be valid as functions."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:276
|
||
msgid ""
|
||
"The second element is a list of symbols---the argument variable names "
|
||
"(@pxref{Argument List}). This is called the @dfn{lambda list}. When a Lisp "
|
||
"function is called, the argument values are matched up against the variables "
|
||
"in the lambda list, which are given local bindings with the values "
|
||
"provided. @xref{Local Variables}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:280
|
||
msgid ""
|
||
"The documentation string is a Lisp string object placed within the function "
|
||
"definition to describe the function for the Emacs help facilities. "
|
||
"@xref{Function Documentation}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:288
|
||
msgid ""
|
||
"The interactive declaration is a list of the form @code{(interactive "
|
||
"@var{code-string})}. This declares how to provide arguments if the function "
|
||
"is used interactively. Functions with this declaration are called "
|
||
"@dfn{commands}; they can be called using @kbd{M-x} or bound to a key. "
|
||
"Functions not intended to be called in this way should not have interactive "
|
||
"declarations. @xref{Defining Commands}, for how to write an interactive "
|
||
"declaration."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:289
|
||
#, no-wrap
|
||
msgid "body of function"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:294
|
||
msgid ""
|
||
"The rest of the elements are the @dfn{body} of the function: the Lisp code "
|
||
"to do the work of the function (or, as a Lisp programmer would say, ``a list "
|
||
"of Lisp forms to evaluate''). The value returned by the function is the "
|
||
"value returned by the last element of the body."
|
||
msgstr ""
|
||
|
||
#. type: subsection
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:296
|
||
#, no-wrap
|
||
msgid "A Simple Lambda Expression Example"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:299
|
||
msgid "Consider the following example:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:302
|
||
#, no-wrap
|
||
msgid "(lambda (a b c) (+ a b c))\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:306
|
||
msgid "We can call this function by passing it to @code{funcall}, like this:"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:311
|
||
#, no-wrap
|
||
msgid ""
|
||
"(funcall (lambda (a b c) (+ a b c))\n"
|
||
" 1 2 3)\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:319
|
||
msgid ""
|
||
"This call evaluates the body of the lambda expression with the variable "
|
||
"@code{a} bound to 1, @code{b} bound to 2, and @code{c} bound to 3. "
|
||
"Evaluation of the body adds these three numbers, producing the result 6; "
|
||
"therefore, this call to the function returns the value 6."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:322
|
||
msgid ""
|
||
"Note that the arguments can be the results of other function calls, as in "
|
||
"this example:"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:327
|
||
#, no-wrap
|
||
msgid ""
|
||
"(funcall (lambda (a b c) (+ a b c))\n"
|
||
" 1 (* 2 3) (- 5 4))\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:334
|
||
msgid ""
|
||
"This evaluates the arguments @code{1}, @code{(* 2 3)}, and @code{(- 5 4)} "
|
||
"from left to right. Then it applies the lambda expression to the argument "
|
||
"values 1, 6 and 1 to produce the value 8."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:344
|
||
msgid ""
|
||
"As these examples show, you can use a form with a lambda expression as its "
|
||
"@sc{car} to make local variables and give them values. In the old days of "
|
||
"Lisp, this technique was the only way to bind and initialize local "
|
||
"variables. But nowadays, it is clearer to use the special form @code{let} "
|
||
"for this purpose (@pxref{Local Variables}). Lambda expressions are mainly "
|
||
"used as anonymous functions for passing as arguments to other functions "
|
||
"(@pxref{Anonymous Functions}), or stored as symbol function definitions to "
|
||
"produce named functions (@pxref{Function Names})."
|
||
msgstr ""
|
||
|
||
#. type: subsection
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:346
|
||
#, no-wrap
|
||
msgid "Features of Argument Lists"
|
||
msgstr ""
|
||
|
||
#. type: kindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:347
|
||
#, no-wrap
|
||
msgid "wrong-number-of-arguments"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:348
|
||
#, no-wrap
|
||
msgid "argument binding"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:349
|
||
#, no-wrap
|
||
msgid "binding arguments"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:350
|
||
#, no-wrap
|
||
msgid "argument lists, features"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:357
|
||
msgid ""
|
||
"Our simple sample function, @code{(lambda (a b c) (+ a b c))}, specifies "
|
||
"three argument variables, so it must be called with three arguments: if you "
|
||
"try to call it with only two arguments or four arguments, you get a "
|
||
"@code{wrong-number-of-arguments} error (@pxref{Errors})."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:365
|
||
msgid ""
|
||
"It is often convenient to write a function that allows certain arguments to "
|
||
"be omitted. For example, the function @code{substring} accepts three "
|
||
"arguments---a string, the start index and the end index---but the third "
|
||
"argument defaults to the @var{length} of the string if you omit it. It is "
|
||
"also convenient for certain functions to accept an indefinite number of "
|
||
"arguments, as the functions @code{list} and @code{+} do."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:366
|
||
#, no-wrap
|
||
msgid "optional arguments"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:367
|
||
#, no-wrap
|
||
msgid "rest arguments"
|
||
msgstr ""
|
||
|
||
#. type: kindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:368
|
||
#, no-wrap
|
||
msgid "&optional"
|
||
msgstr ""
|
||
|
||
#. type: kindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:369
|
||
#, no-wrap
|
||
msgid "&rest"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:374
|
||
msgid ""
|
||
"To specify optional arguments that may be omitted when a function is called, "
|
||
"simply include the keyword @code{&optional} before the optional arguments. "
|
||
"To specify a list of zero or more extra arguments, include the keyword "
|
||
"@code{&rest} before one final argument."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:376
|
||
msgid "Thus, the complete syntax for an argument list is as follows:"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:382
|
||
#, no-wrap
|
||
msgid ""
|
||
"(@var{required-vars}@dots{}\n"
|
||
" @r{[}&optional @r{[}@var{optional-vars}@dots{}@r{]}@r{]}\n"
|
||
" @r{[}&rest @var{rest-var}@r{]})\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:388
|
||
msgid ""
|
||
"The square brackets indicate that the @code{&optional} and @code{&rest} "
|
||
"clauses, and the variables that follow them, are optional."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:394
|
||
msgid ""
|
||
"A call to the function requires one actual argument for each of the "
|
||
"@var{required-vars}. There may be actual arguments for zero or more of the "
|
||
"@var{optional-vars}, and there cannot be any actual arguments beyond that "
|
||
"unless the lambda list uses @code{&rest}. In that case, there may be any "
|
||
"number of extra actual arguments."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:402
|
||
msgid ""
|
||
"If actual arguments for the optional and rest variables are omitted, then "
|
||
"they always default to @code{nil}. There is no way for the function to "
|
||
"distinguish between an explicit argument of @code{nil} and an omitted "
|
||
"argument. However, the body of the function is free to consider @code{nil} "
|
||
"an abbreviation for some other meaningful value. This is what "
|
||
"@code{substring} does; @code{nil} as the third argument to @code{substring} "
|
||
"means to use the length of the string supplied."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:403
|
||
#, no-wrap
|
||
msgid "CL note---default optional arg"
|
||
msgstr ""
|
||
|
||
#. type: quotation
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:409
|
||
msgid ""
|
||
"@b{Common Lisp note:} Common Lisp allows the function to specify what "
|
||
"default value to use when an optional argument is omitted; Emacs Lisp always "
|
||
"uses @code{nil}. Emacs Lisp does not support @code{supplied-p} variables "
|
||
"that tell you whether an argument was explicitly passed."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:412
|
||
msgid "For example, an argument list that looks like this:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:415
|
||
#, no-wrap
|
||
msgid "(a b &optional c d &rest e)\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:429
|
||
msgid ""
|
||
"binds @code{a} and @code{b} to the first two actual arguments, which are "
|
||
"required. If one or two more arguments are provided, @code{c} and @code{d} "
|
||
"are bound to them respectively; any arguments after the first four are "
|
||
"collected into a list and @code{e} is bound to that list. Thus, if there "
|
||
"are only two arguments, @code{c}, @code{d} and @code{e} are @code{nil}; if "
|
||
"two or three arguments, @code{d} and @code{e} are @code{nil}; if four "
|
||
"arguments or fewer, @code{e} is @code{nil}. Note that exactly five "
|
||
"arguments with an explicit @code{nil} argument provided for @code{e} will "
|
||
"cause that @code{nil} argument to be passed as a list with one element, "
|
||
"@code{(nil)}, as with any other single value for @code{e}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:438
|
||
msgid ""
|
||
"There is no way to have required arguments following optional ones---it "
|
||
"would not make sense. To see why this must be so, suppose that @code{c} in "
|
||
"the example were optional and @code{d} were required. Suppose three actual "
|
||
"arguments are given; which variable would the third argument be for? Would "
|
||
"it be used for the @var{c}, or for @var{d}? One can argue for both "
|
||
"possibilities. Similarly, it makes no sense to have any more arguments "
|
||
"(either required or optional) after a @code{&rest} argument."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:440
|
||
msgid "Here are some examples of argument lists and proper calls:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:453
|
||
#, no-wrap
|
||
msgid ""
|
||
"(funcall (lambda (n) (1+ n)) ; @r{One required:}\n"
|
||
" 1) ; @r{requires exactly one argument.}\n"
|
||
" @result{} 2\n"
|
||
"(funcall (lambda (n &optional n1) ; @r{One required and one optional:}\n"
|
||
" (if n1 (+ n n1) (1+ n))) ; @r{1 or 2 arguments.}\n"
|
||
" 1 2)\n"
|
||
" @result{} 3\n"
|
||
"(funcall (lambda (n &rest ns) ; @r{One required and one rest:}\n"
|
||
" (+ n (apply '+ ns))) ; @r{1 or more arguments.}\n"
|
||
" 1 2 3 4 5)\n"
|
||
" @result{} 15\n"
|
||
msgstr ""
|
||
|
||
#. type: subsection
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:456
|
||
#, no-wrap
|
||
msgid "Documentation Strings of Functions"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:457
|
||
#, no-wrap
|
||
msgid "documentation string of function"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:458
|
||
#, no-wrap
|
||
msgid "function's documentation string"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:466
|
||
msgid ""
|
||
"A lambda expression may optionally have a @dfn{documentation string} just "
|
||
"after the lambda list. This string does not affect execution of the "
|
||
"function; it is a kind of comment, but a systematized comment which actually "
|
||
"appears inside the Lisp world and can be used by the Emacs help facilities. "
|
||
"@xref{Documentation}, for how the documentation string is accessed."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:471
|
||
msgid ""
|
||
"It is a good idea to provide documentation strings for all the functions in "
|
||
"your program, even those that are called only from within your program. "
|
||
"Documentation strings are like comments, except that they are easier to "
|
||
"access."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:475
|
||
msgid ""
|
||
"The first line of the documentation string should stand on its own, because "
|
||
"@code{apropos} displays just this first line. It should consist of one or "
|
||
"two complete sentences that summarize the function's purpose."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:484
|
||
msgid ""
|
||
"The start of the documentation string is usually indented in the source "
|
||
"file, but since these spaces come before the starting double-quote, they are "
|
||
"not part of the string. Some people make a practice of indenting any "
|
||
"additional lines of the string so that the text lines up in the program "
|
||
"source. @emph{That is a mistake.} The indentation of the following lines is "
|
||
"inside the string; what looks nice in the source code will look ugly when "
|
||
"displayed by the help commands."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:492
|
||
msgid ""
|
||
"You may wonder how the documentation string could be optional, since there "
|
||
"are required components of the function that follow it (the body). Since "
|
||
"evaluation of a string returns that string, without any side effects, it has "
|
||
"no effect if it is not the last form in the body. Thus, in practice, there "
|
||
"is no confusion between the first form of the body and the documentation "
|
||
"string; if the only body form is a string then it serves both as the return "
|
||
"value and as the documentation."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:496
|
||
msgid ""
|
||
"The last line of the documentation string can specify calling conventions "
|
||
"different from the actual function arguments. Write text like this:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:499
|
||
#, no-wrap
|
||
msgid "\\(fn @var{arglist})\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:507
|
||
msgid ""
|
||
"following a blank line, at the beginning of the line, with no newline "
|
||
"following it inside the documentation string. (The @samp{\\} is used to "
|
||
"avoid confusing the Emacs motion commands.) The calling convention "
|
||
"specified in this way appears in help messages in place of the one derived "
|
||
"from the actual arguments of the function."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:511
|
||
msgid ""
|
||
"This feature is particularly useful for macro definitions, since the "
|
||
"arguments written in a macro definition often do not correspond to the way "
|
||
"users think of the parts of the macro call."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:519
|
||
msgid ""
|
||
"Do not use this feature if you want to deprecate the calling convention and "
|
||
"favor the one you advertise by the above specification. Instead, use the "
|
||
"@code{advertised-calling-convention} declaration (@pxref{Declare Form}) or "
|
||
"@code{set-advertised-calling-convention} (@pxref{Obsolete Functions}), "
|
||
"because these two will cause the byte compiler emit a warning message when "
|
||
"it compiles Lisp programs which use the deprecated calling convention."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:521
|
||
#, no-wrap
|
||
msgid "Naming a Function"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:522
|
||
#, no-wrap
|
||
msgid "function definition"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:523
|
||
#, no-wrap
|
||
msgid "named function"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:524
|
||
#, no-wrap
|
||
msgid "function name"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:531
|
||
msgid ""
|
||
"A symbol can serve as the name of a function. This happens when the "
|
||
"symbol's @dfn{function cell} (@pxref{Symbol Components}) contains a function "
|
||
"object (e.g., a lambda expression). Then the symbol itself becomes a valid, "
|
||
"callable function, equivalent to the function object in its function cell."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:538
|
||
msgid ""
|
||
"The contents of the function cell are also called the symbol's @dfn{function "
|
||
"definition}. The procedure of using a symbol's function definition in place "
|
||
"of the symbol is called @dfn{symbol function indirection}; see @ref{Function "
|
||
"Indirection}. If you have not given a symbol a function definition, its "
|
||
"function cell is said to be @dfn{void}, and it cannot be used as a function."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:544
|
||
msgid ""
|
||
"In practice, nearly all functions have names, and are referred to by their "
|
||
"names. You can create a named Lisp function by defining a lambda expression "
|
||
"and putting it in a function cell (@pxref{Function Cells}). However, it is "
|
||
"more common to use the @code{defun} special form, described in the next "
|
||
"section."
|
||
msgstr ""
|
||
|
||
#. type: ifnottex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:546
|
||
msgid "@xref{Defining Functions}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:554
|
||
msgid ""
|
||
"We give functions names because it is convenient to refer to them by their "
|
||
"names in Lisp expressions. Also, a named Lisp function can easily refer to "
|
||
"itself---it can be recursive. Furthermore, primitives can only be referred "
|
||
"to textually by their names, since primitive function objects "
|
||
"(@pxref{Primitive Function Type}) have no read syntax."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:560
|
||
msgid ""
|
||
"A function need not have a unique name. A given function object "
|
||
"@emph{usually} appears in the function cell of only one symbol, but this is "
|
||
"just a convention. It is easy to store it in several symbols using "
|
||
"@code{fset}; then each of the symbols is a valid name for the same function."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:565
|
||
msgid ""
|
||
"Note that a symbol used as a function name may also be used as a variable; "
|
||
"these two uses of a symbol are independent and do not conflict. (This is "
|
||
"not the case in some dialects of Lisp, like Scheme.)"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:574
|
||
msgid ""
|
||
"By convention, if a function's symbol consists of two names separated by "
|
||
"@samp{--}, the function is intended for internal use and the first part "
|
||
"names the file defining the function. For example, a function named "
|
||
"@code{vc-git--rev-parse} is an internal function defined in "
|
||
"@file{vc-git.el}. Internal-use functions written in C have names ending in "
|
||
"@samp{-internal}, e.g., @code{bury-buffer-internal}. Emacs code contributed "
|
||
"before 2018 may follow other internal-use naming conventions, which are "
|
||
"being phased out."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:577
|
||
#, no-wrap
|
||
msgid "defining a function"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:583
|
||
msgid ""
|
||
"We usually give a name to a function when it is first created. This is "
|
||
"called @dfn{defining a function}, and we usually do it with the @code{defun} "
|
||
"macro. This section also describes other ways to define a function."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:584
|
||
#, no-wrap
|
||
msgid "defun name args [doc] [declare] [interactive] body@dots{}"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:589
|
||
msgid ""
|
||
"@code{defun} is the usual way to define new Lisp functions. It defines the "
|
||
"symbol @var{name} as a function with argument list @var{args} "
|
||
"(@pxref{Argument List}) and body forms given by @var{body}. Neither "
|
||
"@var{name} nor @var{args} should be quoted."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:596
|
||
msgid ""
|
||
"@var{doc}, if present, should be a string specifying the function's "
|
||
"documentation string (@pxref{Function Documentation}). @var{declare}, if "
|
||
"present, should be a @code{declare} form specifying function metadata "
|
||
"(@pxref{Declare Form}). @var{interactive}, if present, should be an "
|
||
"@code{interactive} form specifying how the function is to be called "
|
||
"interactively (@pxref{Interactive Call})."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:598
|
||
msgid "The return value of @code{defun} is undefined."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:600
|
||
msgid "Here are some examples:"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:606
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun foo () 5)\n"
|
||
"(foo)\n"
|
||
" @result{} 5\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:613
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun bar (a &optional b &rest c)\n"
|
||
" (list a b c))\n"
|
||
"(bar 1 2 3 4 5)\n"
|
||
" @result{} (1 2 (3 4 5))\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:617
|
||
#, no-wrap
|
||
msgid ""
|
||
"(bar 1)\n"
|
||
" @result{} (1 nil nil)\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:621
|
||
#, no-wrap
|
||
msgid ""
|
||
"(bar)\n"
|
||
"@error{} Wrong number of arguments.\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:631
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun capitalize-backwards ()\n"
|
||
" \"Upcase the last letter of the word at point.\"\n"
|
||
" (interactive)\n"
|
||
" (backward-word 1)\n"
|
||
" (forward-word 1)\n"
|
||
" (backward-char 1)\n"
|
||
" (capitalize-word 1))\n"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:634
|
||
#, no-wrap
|
||
msgid "override existing functions"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:635
|
||
#, no-wrap
|
||
msgid "redefine existing functions"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:642
|
||
msgid ""
|
||
"Be careful not to redefine existing functions unintentionally. @code{defun} "
|
||
"redefines even primitive functions such as @code{car} without any hesitation "
|
||
"or notification. Emacs does not prevent you from doing this, because "
|
||
"redefining a function is sometimes done deliberately, and there is no way to "
|
||
"distinguish deliberate redefinition from unintentional redefinition."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:644
|
||
#, no-wrap
|
||
msgid "function aliases"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:645
|
||
#, no-wrap
|
||
msgid "alias, for functions"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:646
|
||
#, no-wrap
|
||
msgid "defalias name definition &optional doc"
|
||
msgstr ""
|
||
|
||
#. type: anchor{#1}
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:651
|
||
msgid "Definition of defalias"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:651
|
||
msgid ""
|
||
"This function defines the symbol @var{name} as a function, with definition "
|
||
"@var{definition} (which can be any valid Lisp function). Its return value "
|
||
"is @emph{undefined}."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:655
|
||
msgid ""
|
||
"If @var{doc} is non-@code{nil}, it becomes the function documentation of "
|
||
"@var{name}. Otherwise, any documentation provided by @var{definition} is "
|
||
"used."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:656
|
||
#, no-wrap
|
||
msgid "defalias-fset-function property"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:660
|
||
msgid ""
|
||
"Internally, @code{defalias} normally uses @code{fset} to set the "
|
||
"definition. If @var{name} has a @code{defalias-fset-function} property, "
|
||
"however, the associated value is used as a function to call in place of "
|
||
"@code{fset}."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:666
|
||
msgid ""
|
||
"The proper place to use @code{defalias} is where a specific function name is "
|
||
"being defined---especially where that name appears explicitly in the source "
|
||
"file being loaded. This is because @code{defalias} records which file "
|
||
"defined the function, just like @code{defun} (@pxref{Unloading})."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:670
|
||
msgid ""
|
||
"By contrast, in programs that manipulate function definitions for other "
|
||
"purposes, it is better to use @code{fset}, which does not keep such "
|
||
"records. @xref{Function Cells}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:682
|
||
msgid ""
|
||
"You cannot create a new primitive function with @code{defun} or "
|
||
"@code{defalias}, but you can use them to change the function definition of "
|
||
"any symbol, even one such as @code{car} or @code{x-popup-menu} whose normal "
|
||
"definition is a primitive. However, this is risky: for instance, it is next "
|
||
"to impossible to redefine @code{car} without breaking Lisp completely. "
|
||
"Redefining an obscure function such as @code{x-popup-menu} is less "
|
||
"dangerous, but it still may not work as you expect. If there are calls to "
|
||
"the primitive from C code, they call the primitive's C definition directly, "
|
||
"so changing the symbol's definition will have no effect on them."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:686
|
||
msgid ""
|
||
"See also @code{defsubst}, which defines a function like @code{defun} and "
|
||
"tells the Lisp compiler to perform inline expansion on it. @xref{Inline "
|
||
"Functions}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:689
|
||
msgid "To undefine a function name, use @code{fmakunbound}. @xref{Function Cells}."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:692
|
||
#, no-wrap
|
||
msgid "function invocation"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:693
|
||
#, no-wrap
|
||
msgid "calling a function"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:698
|
||
msgid ""
|
||
"Defining functions is only half the battle. Functions don't do anything "
|
||
"until you @dfn{call} them, i.e., tell them to run. Calling a function is "
|
||
"also known as @dfn{invocation}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:703
|
||
msgid ""
|
||
"The most common way of invoking a function is by evaluating a list. For "
|
||
"example, evaluating the list @code{(concat \"a\" \"b\")} calls the function "
|
||
"@code{concat} with arguments @code{\"a\"} and @code{\"b\"}. "
|
||
"@xref{Evaluation}, for a description of evaluation."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:710
|
||
msgid ""
|
||
"When you write a list as an expression in your program, you specify which "
|
||
"function to call, and how many arguments to give it, in the text of the "
|
||
"program. Usually that's just what you want. Occasionally you need to "
|
||
"compute at run time which function to call. To do that, use the function "
|
||
"@code{funcall}. When you also need to determine at run time how many "
|
||
"arguments to pass, use @code{apply}."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:711
|
||
#, no-wrap
|
||
msgid "funcall function &rest arguments"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:714
|
||
msgid ""
|
||
"@code{funcall} calls @var{function} with @var{arguments}, and returns "
|
||
"whatever @var{function} returns."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:724
|
||
msgid ""
|
||
"Since @code{funcall} is a function, all of its arguments, including "
|
||
"@var{function}, are evaluated before @code{funcall} is called. This means "
|
||
"that you can use any expression to obtain the function to be called. It "
|
||
"also means that @code{funcall} does not see the expressions you write for "
|
||
"the @var{arguments}, only their values. These values are @emph{not} "
|
||
"evaluated a second time in the act of calling @var{function}; the operation "
|
||
"of @code{funcall} is like the normal procedure for calling a function, once "
|
||
"its arguments have already been evaluated."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:730
|
||
msgid ""
|
||
"The argument @var{function} must be either a Lisp function or a primitive "
|
||
"function. Special forms and macros are not allowed, because they make sense "
|
||
"only when given the unevaluated argument expressions. @code{funcall} cannot "
|
||
"provide these because, as we saw above, it never knows them in the first "
|
||
"place."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:734
|
||
msgid ""
|
||
"If you need to use @code{funcall} to call a command and make it behave as if "
|
||
"invoked interactively, use @code{funcall-interactively} (@pxref{Interactive "
|
||
"Call})."
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:739
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:779
|
||
#, no-wrap
|
||
msgid ""
|
||
"(setq f 'list)\n"
|
||
" @result{} list\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:743
|
||
#, no-wrap
|
||
msgid ""
|
||
"(funcall f 'x 'y 'z)\n"
|
||
" @result{} (x y z)\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:747
|
||
#, no-wrap
|
||
msgid ""
|
||
"(funcall f 'x 'y '(z))\n"
|
||
" @result{} (x y (z))\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:751
|
||
#, no-wrap
|
||
msgid ""
|
||
"(funcall 'and t nil)\n"
|
||
"@error{} Invalid function: #<subr and>\n"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:755
|
||
msgid "Compare these examples with the examples of @code{apply}."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:757
|
||
#, no-wrap
|
||
msgid "apply function &rest arguments"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:764
|
||
msgid ""
|
||
"@code{apply} calls @var{function} with @var{arguments}, just like "
|
||
"@code{funcall} but with one difference: the last of @var{arguments} is a "
|
||
"list of objects, which are passed to @var{function} as separate arguments, "
|
||
"rather than a single list. We say that @code{apply} @dfn{spreads} this list "
|
||
"so that each individual element becomes an argument."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:769
|
||
msgid ""
|
||
"@code{apply} with a single argument is special: the first element of the "
|
||
"argument, which must be a non-empty list, is called as a function with the "
|
||
"remaining elements as individual arguments. Passing two or more arguments "
|
||
"will be faster."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:774
|
||
msgid ""
|
||
"@code{apply} returns the result of calling @var{function}. As with "
|
||
"@code{funcall}, @var{function} must either be a Lisp function or a primitive "
|
||
"function; special forms and macros do not make sense in @code{apply}."
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:783
|
||
#, no-wrap
|
||
msgid ""
|
||
"(apply f 'x 'y 'z)\n"
|
||
"@error{} Wrong type argument: listp, z\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:787
|
||
#, no-wrap
|
||
msgid ""
|
||
"(apply '+ 1 2 '(3 4))\n"
|
||
" @result{} 10\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:791
|
||
#, no-wrap
|
||
msgid ""
|
||
"(apply '+ '(1 2 3 4))\n"
|
||
" @result{} 10\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:796
|
||
#, no-wrap
|
||
msgid ""
|
||
"(apply 'append '((a b c) nil (x y z) nil))\n"
|
||
" @result{} (a b c x y z)\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:801
|
||
#, no-wrap
|
||
msgid ""
|
||
"(apply '(+ 3 4))\n"
|
||
" @result{} 7\n"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:806
|
||
msgid ""
|
||
"For an interesting example of using @code{apply}, see @ref{Definition of "
|
||
"mapcar}."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:808
|
||
#, no-wrap
|
||
msgid "partial application of functions"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:809
|
||
#, no-wrap
|
||
msgid "currying"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:821
|
||
msgid ""
|
||
"Sometimes it is useful to fix some of the function's arguments at certain "
|
||
"values, and leave the rest of arguments for when the function is actually "
|
||
"called. The act of fixing some of the function's arguments is called "
|
||
"@dfn{partial application} of the function@footnote{ This is related to, but "
|
||
"different from @dfn{currying}, which transforms a function that takes "
|
||
"multiple arguments in such a way that it can be called as a chain of "
|
||
"functions, each one with a single argument.}. The result is a new function "
|
||
"that accepts the rest of arguments and calls the original function with all "
|
||
"the arguments combined."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:823
|
||
msgid "Here's how to do partial application in Emacs Lisp:"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:824
|
||
#, no-wrap
|
||
msgid "apply-partially func &rest args"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:836
|
||
msgid ""
|
||
"This function returns a new function which, when called, will call "
|
||
"@var{func} with the list of arguments composed from @var{args} and "
|
||
"additional arguments specified at the time of the call. If @var{func} "
|
||
"accepts @var{n} arguments, then a call to @code{apply-partially} with "
|
||
"@w{@code{@var{m} <= @var{n}}} arguments will produce a new function of "
|
||
"@w{@code{@var{n} - @var{m}}} arguments@footnote{ If the number of arguments "
|
||
"that @var{func} can accept is unlimited, then the new function will also "
|
||
"accept an unlimited number of arguments, so in that case "
|
||
"@code{apply-partially} doesn't reduce the number of arguments that the new "
|
||
"function could accept. }."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:843
|
||
msgid ""
|
||
"Here's how we could define the built-in function @code{1+}, if it didn't "
|
||
"exist, using @code{apply-partially} and @code{+}, another built-in "
|
||
"function@footnote{ Note that unlike the built-in function, this version "
|
||
"accepts any number of arguments. }:"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:848
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defalias '1+ (apply-partially '+ 1)\n"
|
||
" \"Increment argument by one.\")\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:852
|
||
#, no-wrap
|
||
msgid ""
|
||
"(1+ 10)\n"
|
||
" @result{} 11\n"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:856
|
||
#, no-wrap
|
||
msgid "functionals"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:861
|
||
msgid ""
|
||
"It is common for Lisp functions to accept functions as arguments or find "
|
||
"them in data structures (especially in hook variables and property lists) "
|
||
"and call them using @code{funcall} or @code{apply}. Functions that accept "
|
||
"function arguments are often called @dfn{functionals}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:865
|
||
msgid ""
|
||
"Sometimes, when you call a functional, it is useful to supply a no-op "
|
||
"function as the argument. Here are two different kinds of no-op function:"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:866
|
||
#, no-wrap
|
||
msgid "identity argument"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:868
|
||
msgid "This function returns @var{argument} and has no side effects."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:870
|
||
#, no-wrap
|
||
msgid "ignore &rest arguments"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:872
|
||
msgid "This function ignores any @var{arguments} and returns @code{nil}."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:874
|
||
#, no-wrap
|
||
msgid "always &rest arguments"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:876
|
||
msgid "This function ignores any @var{arguments} and returns @code{t}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:882
|
||
msgid ""
|
||
"Some functions are user-visible @dfn{commands}, which can be called "
|
||
"interactively (usually by a key sequence). It is possible to invoke such a "
|
||
"command exactly as though it was called interactively, by using the "
|
||
"@code{call-interactively} function. @xref{Interactive Call}."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:885
|
||
#, no-wrap
|
||
msgid "mapping functions"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:895
|
||
msgid ""
|
||
"A @dfn{mapping function} applies a given function (@emph{not} a special form "
|
||
"or macro) to each element of a list or other collection. Emacs Lisp has "
|
||
"several such functions; this section describes @code{mapcar}, @code{mapc}, "
|
||
"@code{mapconcat}, and @code{mapcan}, which map over a list. "
|
||
"@xref{Definition of mapatoms}, for the function @code{mapatoms} which maps "
|
||
"over the symbols in an obarray. @xref{Definition of maphash}, for the "
|
||
"function @code{maphash} which maps over key/value associations in a hash "
|
||
"table."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:900
|
||
msgid ""
|
||
"These mapping functions do not allow char-tables because a char-table is a "
|
||
"sparse array whose nominal range of indices is very large. To map over a "
|
||
"char-table in a way that deals properly with its sparse nature, use the "
|
||
"function @code{map-char-table} (@pxref{Char-Tables})."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:901
|
||
#, no-wrap
|
||
msgid "mapcar function sequence"
|
||
msgstr ""
|
||
|
||
#. type: anchor{#1}
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:905
|
||
msgid "Definition of mapcar"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:905
|
||
msgid ""
|
||
"@code{mapcar} applies @var{function} to each element of @var{sequence} in "
|
||
"turn, and returns a list of the results."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:910
|
||
msgid ""
|
||
"The argument @var{sequence} can be any kind of sequence except a char-table; "
|
||
"that is, a list, a vector, a bool-vector, or a string. The result is always "
|
||
"a list. The length of the result is the same as the length of "
|
||
"@var{sequence}. For example:"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:919
|
||
#, no-wrap
|
||
msgid ""
|
||
"(mapcar #'car '((a b) (c d) (e f)))\n"
|
||
" @result{} (a c e)\n"
|
||
"(mapcar #'1+ [1 2 3])\n"
|
||
" @result{} (2 3 4)\n"
|
||
"(mapcar #'string \"abc\")\n"
|
||
" @result{} (\"a\" \"b\" \"c\")\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:924
|
||
#, no-wrap
|
||
msgid ""
|
||
";; @r{Call each function in @code{my-hooks}.}\n"
|
||
"(mapcar 'funcall my-hooks)\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:937
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun mapcar* (function &rest args)\n"
|
||
" \"Apply FUNCTION to successive cars of all ARGS.\n"
|
||
"Return the list of results.\"\n"
|
||
" ;; @r{If no list is exhausted,}\n"
|
||
" (if (not (memq nil args))\n"
|
||
" ;; @r{apply function to @sc{car}s.}\n"
|
||
" (cons (apply function (mapcar #'car args))\n"
|
||
" (apply #'mapcar* function\n"
|
||
" ;; @r{Recurse for rest of elements.}\n"
|
||
" (mapcar #'cdr args)))))\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:942
|
||
#, no-wrap
|
||
msgid ""
|
||
"(mapcar* #'cons '(a b c) '(1 2 3 4))\n"
|
||
" @result{} ((a . 1) (b . 2) (c . 3))\n"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:946
|
||
#, no-wrap
|
||
msgid "mapcan function sequence"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:953
|
||
msgid ""
|
||
"This function applies @var{function} to each element of @var{sequence}, like "
|
||
"@code{mapcar}, but instead of collecting the results into a list, it returns "
|
||
"a single list with all the elements of the results (which must be lists), by "
|
||
"altering the results (using @code{nconc}; @pxref{Rearrangement}). Like with "
|
||
"@code{mapcar}, @var{sequence} can be of any type except a char-table."
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:962
|
||
#, no-wrap
|
||
msgid ""
|
||
";; @r{Contrast this:}\n"
|
||
"(mapcar #'list '(a b c d))\n"
|
||
" @result{} ((a) (b) (c) (d))\n"
|
||
";; @r{with this:}\n"
|
||
"(mapcan #'list '(a b c d))\n"
|
||
" @result{} (a b c d)\n"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:966
|
||
#, no-wrap
|
||
msgid "mapc function sequence"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:970
|
||
msgid ""
|
||
"@code{mapc} is like @code{mapcar} except that @var{function} is used for "
|
||
"side-effects only---the values it returns are ignored, not collected into a "
|
||
"list. @code{mapc} always returns @var{sequence}."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:972
|
||
#, no-wrap
|
||
msgid "mapconcat function sequence &optional separator"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:980
|
||
msgid ""
|
||
"@code{mapconcat} applies @var{function} to each element of @var{sequence}; "
|
||
"the results, which must be sequences of characters (strings, vectors, or "
|
||
"lists), are concatenated into a single string return value. Between each "
|
||
"pair of result sequences, @code{mapconcat} inserts the characters from "
|
||
"@var{separator}, which also must be a string, or a vector or list of "
|
||
"characters; a @code{nil} value is treated as the empty string. "
|
||
"@xref{Sequences Arrays Vectors}."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:986
|
||
msgid ""
|
||
"The argument @var{function} must be a function that can take one argument "
|
||
"and returns a sequence of characters: a string, a vector, or a list. The "
|
||
"argument @var{sequence} can be any kind of sequence except a char-table; "
|
||
"that is, a list, a vector, a bool-vector, or a string."
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:993
|
||
#, no-wrap
|
||
msgid ""
|
||
"(mapconcat #'symbol-name\n"
|
||
" '(The cat in the hat)\n"
|
||
" \" \")\n"
|
||
" @result{} \"The cat in the hat\"\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:999
|
||
#, no-wrap
|
||
msgid ""
|
||
"(mapconcat (lambda (x) (format \"%c\" (1+ x)))\n"
|
||
" \"HAL-8000\")\n"
|
||
" @result{} \"IBM.9111\"\n"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1005
|
||
#, no-wrap
|
||
msgid "anonymous function"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1016
|
||
msgid ""
|
||
"Although functions are usually defined with @code{defun} and given names at "
|
||
"the same time, it is sometimes convenient to use an explicit lambda "
|
||
"expression---an @dfn{anonymous function}. Anonymous functions are valid "
|
||
"wherever function names are. They are often assigned as variable values, or "
|
||
"as arguments to functions; for instance, you might pass one as the "
|
||
"@var{function} argument to @code{mapcar}, which applies that function to "
|
||
"each element of a list (@pxref{Mapping Functions}). @xref{describe-symbols "
|
||
"example}, for a realistic example of this."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1021
|
||
msgid ""
|
||
"When defining a lambda expression that is to be used as an anonymous "
|
||
"function, you can in principle use any method to construct the list. But "
|
||
"typically you should use the @code{lambda} macro, or the @code{function} "
|
||
"special form, or the @code{#'} read syntax:"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1022
|
||
#, no-wrap
|
||
msgid "lambda args [doc] [interactive] body@dots{}"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1026
|
||
msgid ""
|
||
"This macro returns an anonymous function with argument list @var{args}, "
|
||
"documentation string @var{doc} (if any), interactive spec @var{interactive} "
|
||
"(if any), and body forms given by @var{body}."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1030
|
||
msgid ""
|
||
"Under dynamic binding, this macro effectively makes @code{lambda} forms "
|
||
"self-quoting: evaluating a form whose @sc{car} is @code{lambda} yields the "
|
||
"form itself:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1034
|
||
#, no-wrap
|
||
msgid ""
|
||
"(lambda (x) (* x x))\n"
|
||
" @result{} (lambda (x) (* x x))\n"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1038
|
||
msgid ""
|
||
"Note that when evaluating under lexical binding the result is a closure "
|
||
"object (@pxref{Closures})."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1042
|
||
msgid ""
|
||
"The @code{lambda} form has one other effect: it tells the Emacs evaluator "
|
||
"and byte-compiler that its argument is a function, by using @code{function} "
|
||
"as a subroutine (see below)."
|
||
msgstr ""
|
||
|
||
#. type: defspec
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1044
|
||
#, no-wrap
|
||
msgid "function function-object"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1045
|
||
#, no-wrap
|
||
msgid "function quoting"
|
||
msgstr ""
|
||
|
||
#. type: defspec
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1052
|
||
msgid ""
|
||
"This special form returns @var{function-object} without evaluating it. In "
|
||
"this, it is similar to @code{quote} (@pxref{Quoting}). But unlike "
|
||
"@code{quote}, it also serves as a note to the Emacs evaluator and "
|
||
"byte-compiler that @var{function-object} is intended to be used as a "
|
||
"function. Assuming @var{function-object} is a valid lambda expression, this "
|
||
"has two effects:"
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1057
|
||
msgid ""
|
||
"When the code is byte-compiled, @var{function-object} is compiled into a "
|
||
"byte-code function object (@pxref{Byte Compilation})."
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1061
|
||
msgid ""
|
||
"When lexical binding is enabled, @var{function-object} is converted into a "
|
||
"closure. @xref{Closures}."
|
||
msgstr ""
|
||
|
||
#. type: defspec
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1066
|
||
msgid ""
|
||
"When @var{function-object} is a symbol and the code is byte compiled, the "
|
||
"byte-compiler will warn if that function is not defined or might not be "
|
||
"known at run time."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1068
|
||
#, no-wrap
|
||
msgid "@samp{#'} syntax"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1071
|
||
msgid ""
|
||
"The read syntax @code{#'} is a short-hand for using @code{function}. The "
|
||
"following forms are all equivalent:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1076
|
||
#, no-wrap
|
||
msgid ""
|
||
"(lambda (x) (* x x))\n"
|
||
"(function (lambda (x) (* x x)))\n"
|
||
"#'(lambda (x) (* x x))\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1082
|
||
msgid ""
|
||
"In the following example, we define a @code{change-property} function that "
|
||
"takes a function as its third argument, followed by a @code{double-property} "
|
||
"function that makes use of @code{change-property} by passing it an anonymous "
|
||
"function:"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1088
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun change-property (symbol prop function)\n"
|
||
" (let ((value (get symbol prop)))\n"
|
||
" (put symbol prop (funcall function value))))\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1093
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun double-property (symbol prop)\n"
|
||
" (change-property symbol prop (lambda (x) (* 2 x))))\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1098
|
||
msgid "Note that we do not quote the @code{lambda} form."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1102
|
||
msgid ""
|
||
"If you compile the above code, the anonymous function is also compiled. "
|
||
"This would not happen if, say, you had constructed the anonymous function by "
|
||
"quoting it as a list:"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1108
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun double-property (symbol prop)\n"
|
||
" (change-property symbol prop '(lambda (x) (* 2 x))))\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1116
|
||
msgid ""
|
||
"In that case, the anonymous function is kept as a lambda expression in the "
|
||
"compiled code. The byte-compiler cannot assume this list is a function, "
|
||
"even though it looks like one, since it does not know that "
|
||
"@code{change-property} intends to use it as a function."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1119
|
||
#, no-wrap
|
||
msgid "generic functions"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1120
|
||
#, no-wrap
|
||
msgid "polymorphism"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1130
|
||
msgid ""
|
||
"Functions defined using @code{defun} have a hard-coded set of assumptions "
|
||
"about the types and expected values of their arguments. For example, a "
|
||
"function that was designed to handle values of its argument that are either "
|
||
"numbers or lists of numbers will fail or signal an error if called with a "
|
||
"value of any other type, such as a vector or a string. This happens because "
|
||
"the implementation of the function is not prepared to deal with types other "
|
||
"than those assumed during the design."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1136
|
||
msgid ""
|
||
"By contrast, object-oriented programs use @dfn{polymorphic functions}: a set "
|
||
"of specialized functions having the same name, each one of which was written "
|
||
"for a certain specific set of argument types. Which of the functions is "
|
||
"actually called is decided at run time based on the types of the actual "
|
||
"arguments."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1137
|
||
#, no-wrap
|
||
msgid "CLOS"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1144
|
||
msgid ""
|
||
"Emacs provides support for polymorphism. Like other Lisp environments, "
|
||
"notably Common Lisp and its Common Lisp Object System (@acronym{CLOS}), this "
|
||
"support is based on @dfn{generic functions}. The Emacs generic functions "
|
||
"closely follow @acronym{CLOS}, including use of similar names, so if you "
|
||
"have experience with @acronym{CLOS}, the rest of this section will sound "
|
||
"very familiar."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1155
|
||
msgid ""
|
||
"A generic function specifies an abstract operation, by defining its name and "
|
||
"list of arguments, but (usually) no implementation. The actual "
|
||
"implementation for several specific classes of arguments is provided by "
|
||
"@dfn{methods}, which should be defined separately. Each method that "
|
||
"implements a generic function has the same name as the generic function, but "
|
||
"the method's definition indicates what kinds of arguments it can handle by "
|
||
"@dfn{specializing} the arguments defined by the generic function. These "
|
||
"@dfn{argument specializers} can be more or less specific; for example, a "
|
||
"@code{string} type is more specific than a more general type, such as "
|
||
"@code{sequence}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1159
|
||
msgid ""
|
||
"Note that, unlike in message-based OO languages, such as C@t{++} and Simula, "
|
||
"methods that implement generic functions don't belong to a class, they "
|
||
"belong to the generic function they implement."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1167
|
||
msgid ""
|
||
"When a generic function is invoked, it selects the applicable methods by "
|
||
"comparing the actual arguments passed by the caller with the argument "
|
||
"specializers of each method. A method is applicable if the actual arguments "
|
||
"of the call are compatible with the method's specializers. If more than one "
|
||
"method is applicable, they are combined using certain rules, described "
|
||
"below, and the combination then handles the call."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1168
|
||
#, no-wrap
|
||
msgid ""
|
||
"cl-defgeneric name arguments [documentation] [options-and-methods@dots{}] "
|
||
"&rest body"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1175
|
||
msgid ""
|
||
"This macro defines a generic function with the specified @var{name} and "
|
||
"@var{arguments}. If @var{body} is present, it provides the default "
|
||
"implementation. If @var{documentation} is present (it should always be), it "
|
||
"specifies the documentation string for the generic function, in the form "
|
||
"@code{(:documentation @var{docstring})}. The optional "
|
||
"@var{options-and-methods} can be one of the following forms:"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1177
|
||
#, no-wrap
|
||
msgid "(declare @var{declarations})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1179
|
||
msgid "A declare form, as described in @ref{Declare Form}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1179
|
||
#, no-wrap
|
||
msgid "(:argument-precedence-order &rest @var{args})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1186
|
||
msgid ""
|
||
"This form affects the sorting order for combining applicable methods. "
|
||
"Normally, when two methods are compared during combination, method arguments "
|
||
"are examined left to right, and the first method whose argument specializer "
|
||
"is more specific will come before the other one. The order defined by this "
|
||
"form overrides that, and the arguments are examined according to their order "
|
||
"in this form, and not left to right."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1186
|
||
#, no-wrap
|
||
msgid "(:method [@var{qualifiers}@dots{}] args &rest body)"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1188
|
||
msgid "This form defines a method like @code{cl-defmethod} does."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1191
|
||
#, no-wrap
|
||
msgid ""
|
||
"cl-defmethod name [extra] [qualifier] arguments [&context (expr "
|
||
"spec)@dots{}] &rest [docstring] body"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1201
|
||
msgid ""
|
||
"This macro defines a particular implementation for the generic function "
|
||
"called @var{name}. The implementation code is given by @var{body}. If "
|
||
"present, @var{docstring} is the documentation string for the method. The "
|
||
"@var{arguments} list, which must be identical in all the methods that "
|
||
"implement a generic function, and must match the argument list of that "
|
||
"function, provides argument specializers of the form @code{(@var{arg} "
|
||
"@var{spec})}, where @var{arg} is the argument name as specified in the "
|
||
"@code{cl-defgeneric} call, and @var{spec} is one of the following "
|
||
"specializer forms:"
|
||
msgstr ""
|
||
|
||
#. type: var{#1}
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1203
|
||
#, no-wrap
|
||
msgid "type"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1206
|
||
msgid ""
|
||
"This specializer requires the argument to be of the given @var{type}, one of "
|
||
"the types from the type hierarchy described below."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1206
|
||
#, no-wrap
|
||
msgid "(eql @var{object})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1209
|
||
msgid ""
|
||
"This specializer requires the argument be @code{eql} to the given "
|
||
"@var{object}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1209
|
||
#, no-wrap
|
||
msgid "(head @var{object})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1212
|
||
msgid ""
|
||
"The argument must be a cons cell whose @code{car} is @code{eql} to "
|
||
"@var{object}."
|
||
msgstr ""
|
||
|
||
#. type: var{#1}
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1212
|
||
#, no-wrap
|
||
msgid "struct-type"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1216
|
||
msgid ""
|
||
"The argument must be an instance of a class named @var{struct-type} defined "
|
||
"with @code{cl-defstruct} (@pxref{Structures,,, cl, Common Lisp Extensions "
|
||
"for GNU Emacs Lisp}), or of one of its child classes."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1232
|
||
msgid ""
|
||
"Method definitions can make use of a new argument-list keyword, "
|
||
"@code{&context}, which introduces extra specializers that test the "
|
||
"environment at the time the method is run. This keyword should appear after "
|
||
"the list of required arguments, but before any @code{&rest} or "
|
||
"@code{&optional} keywords. The @code{&context} specializers look much like "
|
||
"regular argument specializers---(@var{expr} @var{spec})---except that "
|
||
"@var{expr} is an expression to be evaluated in the current context, and the "
|
||
"@var{spec} is a value to compare against. For example, @code{&context "
|
||
"(overwrite-mode (eql t))} will make the method applicable only when "
|
||
"@code{overwrite-mode} is turned on. The @code{&context} keyword can be "
|
||
"followed by any number of context specializers. Because the context "
|
||
"specializers are not part of the generic function's argument signature, they "
|
||
"may be omitted in methods that don't require them."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1238
|
||
msgid ""
|
||
"The type specializer, @code{(@var{arg} @var{type})}, can specify one of the "
|
||
"@dfn{system types} in the following list. When a parent type is specified, "
|
||
"an argument whose type is any of its more specific child types, as well as "
|
||
"grand-children, grand-grand-children, etc. will also be compatible."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1240
|
||
#, no-wrap
|
||
msgid "integer"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1242
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1258
|
||
msgid "Parent type: @code{number}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1242
|
||
#, no-wrap
|
||
msgid "number"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1243
|
||
#, no-wrap
|
||
msgid "null"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1245
|
||
msgid "Parent type: @code{symbol}"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1245
|
||
#, no-wrap
|
||
msgid "symbol"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1246
|
||
#, no-wrap
|
||
msgid "string"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1248
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1266
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1268
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1270
|
||
msgid "Parent type: @code{array}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1248
|
||
#, no-wrap
|
||
msgid "array"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1250
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1254
|
||
msgid "Parent type: @code{sequence}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1250
|
||
#, no-wrap
|
||
msgid "cons"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1252
|
||
msgid "Parent type: @code{list}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1252
|
||
#, no-wrap
|
||
msgid "list"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1254
|
||
#, no-wrap
|
||
msgid "marker"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1255
|
||
#, no-wrap
|
||
msgid "overlay"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1256
|
||
#, no-wrap
|
||
msgid "float"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1258
|
||
#, no-wrap
|
||
msgid "window-configuration"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1259
|
||
#, no-wrap
|
||
msgid "process"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1260
|
||
#, no-wrap
|
||
msgid "window"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1262
|
||
#, no-wrap
|
||
msgid "compiled-function"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1263
|
||
#, no-wrap
|
||
msgid "buffer"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1264
|
||
#, no-wrap
|
||
msgid "char-table"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1266
|
||
#, no-wrap
|
||
msgid "bool-vector"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1268
|
||
#, no-wrap
|
||
msgid "vector"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1270
|
||
#, no-wrap
|
||
msgid "frame"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1271
|
||
#, no-wrap
|
||
msgid "hash-table"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1272
|
||
#, no-wrap
|
||
msgid "font-spec"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1273
|
||
#, no-wrap
|
||
msgid "font-entity"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1274
|
||
#, no-wrap
|
||
msgid "font-object"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1280
|
||
msgid ""
|
||
"The optional @var{extra} element, expressed as @samp{:extra @var{string}}, "
|
||
"allows you to add more methods, distinguished by @var{string}, for the same "
|
||
"specializers and qualifiers."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1287
|
||
msgid ""
|
||
"The optional @var{qualifier} allows combining several applicable methods. "
|
||
"If it is not present, the defined method is a @dfn{primary} method, "
|
||
"responsible for providing the primary implementation of the generic function "
|
||
"for the specialized arguments. You can also define @dfn{auxiliary methods}, "
|
||
"by using one of the following values as @var{qualifier}:"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1289
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1813
|
||
#, no-wrap
|
||
msgid ":before"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1293
|
||
msgid ""
|
||
"This auxiliary method will run before the primary method. More accurately, "
|
||
"all the @code{:before} methods will run before the primary, in the "
|
||
"most-specific-first order."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1293
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1825
|
||
#, no-wrap
|
||
msgid ":after"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1297
|
||
msgid ""
|
||
"This auxiliary method will run after the primary method. More accurately, "
|
||
"all such methods will run after the primary, in the most-specific-last "
|
||
"order."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1297
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1841
|
||
#, no-wrap
|
||
msgid ":around"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1302
|
||
msgid ""
|
||
"This auxiliary method will run @emph{instead} of the primary method. The "
|
||
"most specific of such methods will be run before any other method. Such "
|
||
"methods normally use @code{cl-call-next-method}, described below, to invoke "
|
||
"the other auxiliary or primary methods."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1310
|
||
msgid ""
|
||
"Functions defined using @code{cl-defmethod} cannot be made interactive, "
|
||
"i.e.@: commands (@pxref{Defining Commands}), by adding the "
|
||
"@code{interactive} form to them. If you need a polymorphic command, we "
|
||
"recommend defining a normal command that calls a polymorphic function "
|
||
"defined via @code{cl-defgeneric} and @code{cl-defmethod}."
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1312
|
||
#, no-wrap
|
||
msgid "dispatch of methods for generic function"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1313
|
||
#, no-wrap
|
||
msgid "multiple-dispatch methods"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1324
|
||
msgid ""
|
||
"Each time a generic function is called, it builds the @dfn{effective method} "
|
||
"which will handle this invocation by combining the applicable methods "
|
||
"defined for the function. The process of finding the applicable methods and "
|
||
"producing the effective method is called @dfn{dispatch}. The applicable "
|
||
"methods are those all of whose specializers are compatible with the actual "
|
||
"arguments of the call. Since all of the arguments must be compatible with "
|
||
"the specializers, they all determine whether a method is applicable. "
|
||
"Methods that explicitly specialize more than one argument are called "
|
||
"@dfn{multiple-dispatch methods}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1337
|
||
msgid ""
|
||
"The applicable methods are sorted into the order in which they will be "
|
||
"combined. The method whose left-most argument specializer is the most "
|
||
"specific one will come first in the order. (Specifying "
|
||
"@code{:argument-precedence-order} as part of @code{cl-defmethod} overrides "
|
||
"that, as described above.) If the method body calls "
|
||
"@code{cl-call-next-method}, the next most-specific method will run. If "
|
||
"there are applicable @code{:around} methods, the most-specific of them will "
|
||
"run first; it should call @code{cl-call-next-method} to run any of the less "
|
||
"specific @code{:around} methods. Next, the @code{:before} methods run in "
|
||
"the order of their specificity, followed by the primary method, and lastly "
|
||
"the @code{:after} methods in the reverse order of their specificity."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1338
|
||
#, no-wrap
|
||
msgid "cl-call-next-method &rest args"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1345
|
||
msgid ""
|
||
"When invoked from within the lexical body of a primary or an @code{:around} "
|
||
"auxiliary method, call the next applicable method for the same generic "
|
||
"function. Normally, it is called with no arguments, which means to call the "
|
||
"next applicable method with the same arguments that the calling method was "
|
||
"invoked. Otherwise, the specified arguments are used instead."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1347
|
||
#, no-wrap
|
||
msgid "cl-next-method-p"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1351
|
||
msgid ""
|
||
"This function, when called from within the lexical body of a primary or an "
|
||
"@code{:around} auxiliary method, returns non-@code{nil} if there is a next "
|
||
"method to call."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1355
|
||
#, no-wrap
|
||
msgid "Accessing Function Cell Contents"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1360
|
||
msgid ""
|
||
"The @dfn{function definition} of a symbol is the object stored in the "
|
||
"function cell of the symbol. The functions described here access, test, and "
|
||
"set the function cell of symbols."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1363
|
||
msgid ""
|
||
"See also the function @code{indirect-function}. @xref{Definition of "
|
||
"indirect-function}."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1364
|
||
#, no-wrap
|
||
msgid "symbol-function symbol"
|
||
msgstr ""
|
||
|
||
#. type: kindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1365
|
||
#, no-wrap
|
||
msgid "void-function"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1368
|
||
msgid ""
|
||
"This returns the object in the function cell of @var{symbol}. It does not "
|
||
"check that the returned object is a legitimate function."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1372
|
||
msgid ""
|
||
"If the function cell is void, the return value is @code{nil}. To "
|
||
"distinguish between a function cell that is void and one set to @code{nil}, "
|
||
"use @code{fboundp} (see below)."
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1378
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun bar (n) (+ n 2))\n"
|
||
"(symbol-function 'bar)\n"
|
||
" @result{} (lambda (n) (+ n 2))\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1382
|
||
#, no-wrap
|
||
msgid ""
|
||
"(fset 'baz 'bar)\n"
|
||
" @result{} bar\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1386
|
||
#, no-wrap
|
||
msgid ""
|
||
"(symbol-function 'baz)\n"
|
||
" @result{} bar\n"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1390
|
||
#, no-wrap
|
||
msgid "void function cell"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1395
|
||
msgid ""
|
||
"If you have never given a symbol any function definition, we say that that "
|
||
"symbol's function cell is @dfn{void}. In other words, the function cell "
|
||
"does not have any Lisp object in it. If you try to call the symbol as a "
|
||
"function, Emacs signals a @code{void-function} error."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1401
|
||
msgid ""
|
||
"Note that void is not the same as @code{nil} or the symbol @code{void}. The "
|
||
"symbols @code{nil} and @code{void} are Lisp objects, and can be stored into "
|
||
"a function cell just as any other object can be (and they can be valid "
|
||
"functions if you define them in turn with @code{defun}). A void function "
|
||
"cell contains no object whatsoever."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1405
|
||
msgid ""
|
||
"You can test the voidness of a symbol's function definition with "
|
||
"@code{fboundp}. After you have given a symbol a function definition, you "
|
||
"can make it void once more using @code{fmakunbound}."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1406
|
||
#, no-wrap
|
||
msgid "fboundp symbol"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1410
|
||
msgid ""
|
||
"This function returns @code{t} if the symbol has an object in its function "
|
||
"cell, @code{nil} otherwise. It does not check that the object is a "
|
||
"legitimate function."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1412
|
||
#, no-wrap
|
||
msgid "fmakunbound symbol"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1417
|
||
msgid ""
|
||
"This function makes @var{symbol}'s function cell void, so that a subsequent "
|
||
"attempt to access this cell will cause a @code{void-function} error. It "
|
||
"returns @var{symbol}. (See also @code{makunbound}, in @ref{Void "
|
||
"Variables}.)"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1423
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun foo (x) x)\n"
|
||
"(foo 1)\n"
|
||
" @result{}1\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1427
|
||
#, no-wrap
|
||
msgid ""
|
||
"(fmakunbound 'foo)\n"
|
||
" @result{} foo\n"
|
||
msgstr ""
|
||
|
||
#. type: group
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1431
|
||
#, no-wrap
|
||
msgid ""
|
||
"(foo 1)\n"
|
||
"@error{} Symbol's function definition is void: foo\n"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1435
|
||
#, no-wrap
|
||
msgid "fset symbol definition"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1441
|
||
msgid ""
|
||
"This function stores @var{definition} in the function cell of @var{symbol}. "
|
||
"The result is @var{definition}. Normally @var{definition} should be a "
|
||
"function or the name of a function, but this is not checked. The argument "
|
||
"@var{symbol} is an ordinary evaluated argument."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1446
|
||
msgid ""
|
||
"The primary use of this function is as a subroutine by constructs that "
|
||
"define or alter functions, like @code{defun} or @code{advice-add} "
|
||
"(@pxref{Advising Functions}). You can also use it to give a symbol a "
|
||
"function definition that is not a function, e.g., a keyboard macro "
|
||
"(@pxref{Keyboard Macros}):"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1451
|
||
#, no-wrap
|
||
msgid ""
|
||
";; @r{Define a named keyboard macro.}\n"
|
||
"(fset 'kill-two-lines \"\\^u2\\^k\")\n"
|
||
" @result{} \"\\^u2\\^k\"\n"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1456
|
||
msgid ""
|
||
"It you wish to use @code{fset} to make an alternate name for a function, "
|
||
"consider using @code{defalias} instead. @xref{Definition of defalias}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1468
|
||
msgid ""
|
||
"As explained in @ref{Variable Scoping}, Emacs can optionally enable lexical "
|
||
"binding of variables. When lexical binding is enabled, any named function "
|
||
"that you create (e.g., with @code{defun}), as well as any anonymous function "
|
||
"that you create using the @code{lambda} macro or the @code{function} special "
|
||
"form or the @code{#'} syntax (@pxref{Anonymous Functions}), is automatically "
|
||
"converted into a @dfn{closure}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1476
|
||
msgid ""
|
||
"A closure is a function that also carries a record of the lexical "
|
||
"environment that existed when the function was defined. When it is invoked, "
|
||
"any lexical variable references within its definition use the retained "
|
||
"lexical environment. In all other respects, closures behave much like "
|
||
"ordinary functions; in particular, they can be called in the same way as "
|
||
"ordinary functions."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1478
|
||
msgid "@xref{Lexical Binding}, for an example of using a closure."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1483
|
||
msgid ""
|
||
"Currently, an Emacs Lisp closure object is represented by a list with the "
|
||
"symbol @code{closure} as the first element, a list representing the lexical "
|
||
"environment as the second element, and the argument list and body forms as "
|
||
"the remaining elements:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1488
|
||
#, no-wrap
|
||
msgid ""
|
||
";; @r{lexical binding is enabled.}\n"
|
||
"(lambda (x) (* x x))\n"
|
||
" @result{} (closure (t) (x) (* x x))\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1495
|
||
msgid ""
|
||
"However, the fact that the internal structure of a closure is exposed to the "
|
||
"rest of the Lisp world is considered an internal implementation detail. For "
|
||
"this reason, we recommend against directly examining or altering the "
|
||
"structure of closure objects."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1497
|
||
#, no-wrap
|
||
msgid "Advising Emacs Lisp Functions"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1498
|
||
#, no-wrap
|
||
msgid "advising functions"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1499
|
||
#, no-wrap
|
||
msgid "piece of advice"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1508
|
||
msgid ""
|
||
"When you need to modify a function defined in another library, or when you "
|
||
"need to modify a hook like @code{@var{foo}-function}, a process filter, or "
|
||
"basically any variable or object field which holds a function value, you can "
|
||
"use the appropriate setter function, such as @code{fset} or @code{defun} for "
|
||
"named functions, @code{setq} for hook variables, or "
|
||
"@code{set-process-filter} for process filters, but those are often too "
|
||
"blunt, completely throwing away the previous value."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1512
|
||
msgid ""
|
||
"The @dfn{advice} feature lets you add to the existing definition of a "
|
||
"function, by @dfn{advising the function}. This is a cleaner method than "
|
||
"redefining the whole function."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1518
|
||
msgid ""
|
||
"Emacs's advice system provides two sets of primitives for that: the core "
|
||
"set, for function values held in variables and object fields (with the "
|
||
"corresponding primitives being @code{add-function} and "
|
||
"@code{remove-function}) and another set layered on top of it for named "
|
||
"functions (with the main primitives being @code{advice-add} and "
|
||
"@code{advice-remove})."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1521
|
||
msgid ""
|
||
"As a trivial example, here's how to add advice that'll modify the return "
|
||
"value of a function every time it's called:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1528
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun my-double (x)\n"
|
||
" (* x 2))\n"
|
||
"(defun my-increase (x)\n"
|
||
" (+ x 1))\n"
|
||
"(advice-add 'my-double :filter-return #'my-increase)\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1532
|
||
msgid ""
|
||
"After adding this advice, if you call @code{my-double} with @samp{3}, the "
|
||
"return value will be @samp{7}. To remove this advice, say"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1535
|
||
#, no-wrap
|
||
msgid "(advice-remove 'my-double #'my-increase)\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1539
|
||
msgid ""
|
||
"A more advanced example would be to trace the calls to the process filter of "
|
||
"a process @var{proc}:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1543
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun my-tracing-function (proc string)\n"
|
||
" (message \"Proc %S received %S\" proc string))\n"
|
||
"\n"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1545
|
||
#, no-wrap
|
||
msgid "(add-function :before (process-filter @var{proc}) #'my-tracing-function)\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1551
|
||
msgid ""
|
||
"This will cause the process's output to be passed to "
|
||
"@code{my-tracing-function} before being passed to the original process "
|
||
"filter. @code{my-tracing-function} receives the same arguments as the "
|
||
"original function. When you're done with it, you can revert to the untraced "
|
||
"behavior with:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1554
|
||
#, no-wrap
|
||
msgid "(remove-function (process-filter @var{proc}) #'my-tracing-function)\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1558
|
||
msgid ""
|
||
"Similarly, if you want to trace the execution of the function named "
|
||
"@code{display-buffer}, you could use:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1565
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun his-tracing-function (orig-fun &rest args)\n"
|
||
" (message \"display-buffer called with args %S\" args)\n"
|
||
" (let ((res (apply orig-fun args)))\n"
|
||
" (message \"display-buffer returned %S\" res)\n"
|
||
" res))\n"
|
||
"\n"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1567
|
||
#, no-wrap
|
||
msgid "(advice-add 'display-buffer :around #'his-tracing-function)\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1574
|
||
msgid ""
|
||
"Here, @code{his-tracing-function} is called instead of the original function "
|
||
"and receives the original function (additionally to that function's "
|
||
"arguments) as argument, so it can call it if and when it needs to. When "
|
||
"you're tired of seeing this output, you can revert to the untraced behavior "
|
||
"with:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1577
|
||
#, no-wrap
|
||
msgid "(advice-remove 'display-buffer #'his-tracing-function)\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1582
|
||
msgid ""
|
||
"The arguments @code{:before} and @code{:around} used in the above examples "
|
||
"specify how the two functions are composed, since there are many different "
|
||
"ways to do it. The added function is also called a piece of @emph{advice}."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1588
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1590
|
||
#, no-wrap
|
||
msgid "Core Advising Primitives"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1588
|
||
msgid "Primitives to manipulate advice."
|
||
msgstr ""
|
||
|
||
#. type: subsection
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1588
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1719
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1720
|
||
#, no-wrap
|
||
msgid "Advising Named Functions"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1588
|
||
msgid "Advising named functions."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1588
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1805
|
||
#, no-wrap
|
||
msgid "Advice Combinators"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1588
|
||
msgid "Ways to compose advice."
|
||
msgstr ""
|
||
|
||
#. type: node
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1588
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1918
|
||
#, no-wrap
|
||
msgid "Porting Old Advice"
|
||
msgstr ""
|
||
|
||
#. type: menuentry
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1588
|
||
msgid "Adapting code using the old defadvice."
|
||
msgstr ""
|
||
|
||
#. type: subsection
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1591
|
||
#, no-wrap
|
||
msgid "Primitives to manipulate advices"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1592
|
||
#, no-wrap
|
||
msgid "advice, add and remove"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1594
|
||
#, no-wrap
|
||
msgid "add-function where place function &optional props"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1597
|
||
msgid ""
|
||
"This macro is the handy way to add the advice @var{function} to the function "
|
||
"stored in @var{place} (@pxref{Generalized Variables})."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1602
|
||
msgid ""
|
||
"@var{where} determines how @var{function} is composed with the existing "
|
||
"function, e.g., whether @var{function} should be called before, or after the "
|
||
"original function. @xref{Advice Combinators}, for the list of available "
|
||
"ways to compose the two functions."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1611
|
||
msgid ""
|
||
"When modifying a variable (whose name will usually end with "
|
||
"@code{-function}), you can choose whether @var{function} is used globally or "
|
||
"only in the current buffer: if @var{place} is just a symbol, then "
|
||
"@var{function} is added to the global value of @var{place}. Whereas if "
|
||
"@var{place} is of the form @code{(local @var{symbol})}, where @var{symbol} "
|
||
"is an expression which returns the variable name, then @var{function} will "
|
||
"only be added in the current buffer. Finally, if you want to modify a "
|
||
"lexical variable, you will have to use @code{(var @var{variable})}."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1615
|
||
msgid ""
|
||
"Every function added with @code{add-function} can be accompanied by an "
|
||
"association list of properties @var{props}. Currently only two of those "
|
||
"properties have a special meaning:"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1617
|
||
#, no-wrap
|
||
msgid "name"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1621
|
||
msgid ""
|
||
"This gives a name to the advice, which @code{remove-function} can use to "
|
||
"identify which function to remove. Typically used when @var{function} is an "
|
||
"anonymous function."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1622
|
||
#, no-wrap
|
||
msgid "depth"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1629
|
||
msgid ""
|
||
"This specifies how to order the advice, should several pieces of advice be "
|
||
"present. By default, the depth is 0. A depth of 100 indicates that this "
|
||
"piece of advice should be kept as deep as possible, whereas a depth of "
|
||
"@minus{}100 indicates that it should stay as the outermost piece. When two "
|
||
"pieces of advice specify the same depth, the most recently added one will be "
|
||
"outermost."
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1642
|
||
msgid ""
|
||
"For @code{:before} advice, being outermost means that this advice will be "
|
||
"run first, before any other advice, whereas being innermost means that it "
|
||
"will run right before the original function, with no other advice run "
|
||
"between itself and the original function. Similarly, for @code{:after} "
|
||
"advice innermost means that it will run right after the original function, "
|
||
"with no other advice run in between, whereas outermost means that it will be "
|
||
"run right at the end after all other advice. An innermost @code{:override} "
|
||
"piece of advice will only override the original function and other pieces of "
|
||
"advice will apply to it, whereas an outermost @code{:override} piece of "
|
||
"advice will override not only the original function but all other advice "
|
||
"applied to it as well."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1653
|
||
msgid ""
|
||
"If @var{function} is not interactive, then the combined function will "
|
||
"inherit the interactive spec, if any, of the original function. Else, the "
|
||
"combined function will be interactive and will use the interactive spec of "
|
||
"@var{function}. One exception: if the interactive spec of @var{function} is "
|
||
"a function (i.e., a @code{lambda} expression or an @code{fbound} symbol "
|
||
"rather than an expression or a string), then the interactive spec of the "
|
||
"combined function will be a call to that function with as sole argument the "
|
||
"interactive spec of the original function. To interpret the spec received "
|
||
"as argument, use @code{advice-eval-interactive-spec}."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1661
|
||
msgid ""
|
||
"Note: The interactive spec of @var{function} will apply to the combined "
|
||
"function and should hence obey the calling convention of the combined "
|
||
"function rather than that of @var{function}. In many cases, it makes no "
|
||
"difference since they are identical, but it does matter for @code{:around}, "
|
||
"@code{:filter-args}, and @code{:filter-return}, where @var{function} "
|
||
"receives different arguments than the original function stored in "
|
||
"@var{place}."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1663
|
||
#, no-wrap
|
||
msgid "remove-function place function"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1667
|
||
msgid ""
|
||
"This macro removes @var{function} from the function stored in @var{place}. "
|
||
"This only works if @var{function} was added to @var{place} using "
|
||
"@code{add-function}."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1673
|
||
msgid ""
|
||
"@var{function} is compared with functions added to @var{place} using "
|
||
"@code{equal}, to try and make it work also with lambda expressions. It is "
|
||
"additionally compared also with the @code{name} property of the functions "
|
||
"added to @var{place}, which can be more reliable than comparing lambda "
|
||
"expressions using @code{equal}."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1675
|
||
#, no-wrap
|
||
msgid "advice-function-member-p advice function-def"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1679
|
||
msgid ""
|
||
"Return non-@code{nil} if @var{advice} is already in @var{function-def}. "
|
||
"Like for @code{remove-function} above, instead of @var{advice} being the "
|
||
"actual function, it can also be the @code{name} of the piece of advice."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1681
|
||
#, no-wrap
|
||
msgid "advice-function-mapc f function-def"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1685
|
||
msgid ""
|
||
"Call the function @var{f} for every piece of advice that was added to "
|
||
"@var{function-def}. @var{f} is called with two arguments: the advice "
|
||
"function and its properties."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1687
|
||
#, no-wrap
|
||
msgid "advice-eval-interactive-spec spec"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1693
|
||
msgid ""
|
||
"Evaluate the interactive @var{spec} just like an interactive call to a "
|
||
"function with such a spec would, and then return the corresponding list of "
|
||
"arguments that was built. E.g., @code{(advice-eval-interactive-spec "
|
||
"\"r\\nP\")} will return a list of three elements, containing the boundaries "
|
||
"of the region and the current prefix argument."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1697
|
||
msgid ""
|
||
"For instance, if you want to make the @kbd{C-x m} (@code{compose-mail}) "
|
||
"command prompt for a @samp{From:} header, you could say something like this:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1714
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun my-compose-mail-advice (orig &rest args)\n"
|
||
" \"Read From: address interactively.\"\n"
|
||
" (interactive\n"
|
||
" (lambda (spec)\n"
|
||
" (let* ((user-mail-address\n"
|
||
" (completing-read \"From: \"\n"
|
||
" '(\"one.address@@example.net\"\n"
|
||
" \"alternative.address@@example.net\")))\n"
|
||
" (from (message-make-from user-full-name\n"
|
||
" user-mail-address))\n"
|
||
" (spec (advice-eval-interactive-spec spec)))\n"
|
||
" ;; Put the From header into the OTHER-HEADERS argument.\n"
|
||
" (push (cons 'From from) (nth 2 spec))\n"
|
||
" spec)))\n"
|
||
" (apply orig args))\n"
|
||
"\n"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1716
|
||
#, no-wrap
|
||
msgid "(advice-add 'compose-mail :around #'my-compose-mail-advice)\n"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1721
|
||
#, no-wrap
|
||
msgid "advising named functions"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1725
|
||
msgid ""
|
||
"A common use of advice is for named functions and macros. You could just "
|
||
"use @code{add-function} as in:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1728
|
||
#, no-wrap
|
||
msgid "(add-function :around (symbol-function '@var{fun}) #'his-tracing-function)\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1737
|
||
msgid ""
|
||
"But you should use @code{advice-add} and @code{advice-remove} for that "
|
||
"instead. This separate set of functions to manipulate pieces of advice "
|
||
"applied to named functions, offers the following extra features compared to "
|
||
"@code{add-function}: they know how to deal with macros and autoloaded "
|
||
"functions, they let @code{describe-function} preserve the original docstring "
|
||
"as well as document the added advice, and they let you add and remove advice "
|
||
"before a function is even defined."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1745
|
||
msgid ""
|
||
"@code{advice-add} can be useful for altering the behavior of existing calls "
|
||
"to an existing function without having to redefine the whole function. "
|
||
"However, it can be a source of bugs, since existing callers to the function "
|
||
"may assume the old behavior, and work incorrectly when the behavior is "
|
||
"changed by advice. Advice can also cause confusion in debugging, if the "
|
||
"person doing the debugging does not notice or remember that the function has "
|
||
"been modified by advice."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1752
|
||
msgid ""
|
||
"For these reasons, advice should be reserved for the cases where you cannot "
|
||
"modify a function's behavior in any other way. If it is possible to do the "
|
||
"same thing via a hook, that is preferable (@pxref{Hooks}). If you simply "
|
||
"want to change what a particular key does, it may be better to write a new "
|
||
"command, and remap the old command's key bindings to the new one "
|
||
"(@pxref{Remapping Commands})."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1761
|
||
msgid ""
|
||
"If you are writing code for release, for others to use, try to avoid "
|
||
"including advice in it. If the function you want to advise has no hook to "
|
||
"do the job, please talk with the Emacs developers about adding a suitable "
|
||
"hook. Especially, Emacs's own source files should not put advice on "
|
||
"functions in Emacs. (There are currently a few exceptions to this "
|
||
"convention, but we aim to correct them.) It is generally cleaner to create "
|
||
"a new hook in @code{foo}, and make @code{bar} use the hook, than to have "
|
||
"@code{bar} put advice in @code{foo}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1766
|
||
msgid ""
|
||
"Special forms (@pxref{Special Forms}) cannot be advised, however macros can "
|
||
"be advised, in much the same way as functions. Of course, this will not "
|
||
"affect code that has already been macro-expanded, so you need to make sure "
|
||
"the advice is installed before the macro is expanded."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1774
|
||
msgid ""
|
||
"It is possible to advise a primitive (@pxref{What Is a Function}), but one "
|
||
"should typically @emph{not} do so, for two reasons. Firstly, some "
|
||
"primitives are used by the advice mechanism, and advising them could cause "
|
||
"an infinite recursion. Secondly, many primitives are called directly from "
|
||
"C, and such calls ignore advice; hence, one ends up in a confusing situation "
|
||
"where some calls (occurring from Lisp code) obey the advice and other calls "
|
||
"(from C code) do not."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1775
|
||
#, no-wrap
|
||
msgid "define-advice symbol (where lambda-list &optional name depth) &rest body"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1780
|
||
msgid ""
|
||
"This macro defines a piece of advice and adds it to the function named "
|
||
"@var{symbol}. The advice is an anonymous function if @var{name} is "
|
||
"@code{nil} or a function named @code{symbol@@name}. See @code{advice-add} "
|
||
"for explanation of other arguments."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1782
|
||
#, no-wrap
|
||
msgid "advice-add symbol where function &optional props"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1786
|
||
msgid ""
|
||
"Add the advice @var{function} to the named function @var{symbol}. "
|
||
"@var{where} and @var{props} have the same meaning as for @code{add-function} "
|
||
"(@pxref{Core Advising Primitives})."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1788
|
||
#, no-wrap
|
||
msgid "advice-remove symbol function"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1791
|
||
msgid ""
|
||
"Remove the advice @var{function} from the named function @var{symbol}. "
|
||
"@var{function} can also be the @code{name} of a piece of advice."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1793
|
||
#, no-wrap
|
||
msgid "advice-member-p function symbol"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1797
|
||
msgid ""
|
||
"Return non-@code{nil} if the advice @var{function} is already in the named "
|
||
"function @var{symbol}. @var{function} can also be the @code{name} of a "
|
||
"piece of advice."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1799
|
||
#, no-wrap
|
||
msgid "advice-mapc function symbol"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1803
|
||
msgid ""
|
||
"Call @var{function} for every piece of advice that was added to the named "
|
||
"function @var{symbol}. @var{function} is called with two arguments: the "
|
||
"advice function and its properties."
|
||
msgstr ""
|
||
|
||
#. type: subsection
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1806
|
||
#, no-wrap
|
||
msgid "Ways to compose advice"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1811
|
||
msgid ""
|
||
"Here are the different possible values for the @var{where} argument of "
|
||
"@code{add-function} and @code{advice-add}, specifying how the advice "
|
||
"@var{function} and the original function should be composed."
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1818
|
||
msgid ""
|
||
"Call @var{function} before the old function. Both functions receive the "
|
||
"same arguments, and the return value of the composition is the return value "
|
||
"of the old function. More specifically, the composition of the two "
|
||
"functions behaves like:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1820
|
||
#, no-wrap
|
||
msgid "(lambda (&rest r) (apply @var{function} r) (apply @var{oldfun} r))\n"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1824
|
||
msgid ""
|
||
"@code{(add-function :before @var{funvar} @var{function})} is comparable for "
|
||
"single-function hooks to @code{(add-hook '@var{hookvar} @var{function})} for "
|
||
"normal hooks."
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1830
|
||
msgid ""
|
||
"Call @var{function} after the old function. Both functions receive the same "
|
||
"arguments, and the return value of the composition is the return value of "
|
||
"the old function. More specifically, the composition of the two functions "
|
||
"behaves like:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1832
|
||
#, no-wrap
|
||
msgid "(lambda (&rest r) (prog1 (apply @var{oldfun} r) (apply @var{function} r)))\n"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1836
|
||
msgid ""
|
||
"@code{(add-function :after @var{funvar} @var{function})} is comparable for "
|
||
"single-function hooks to @code{(add-hook '@var{hookvar} @var{function} "
|
||
"'append)} for normal hooks."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1837
|
||
#, no-wrap
|
||
msgid ":override"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1840
|
||
msgid ""
|
||
"This completely replaces the old function with the new one. The old "
|
||
"function can of course be recovered if you later call "
|
||
"@code{remove-function}."
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1848
|
||
msgid ""
|
||
"Call @var{function} instead of the old function, but provide the old "
|
||
"function as an extra argument to @var{function}. This is the most flexible "
|
||
"composition. For example, it lets you call the old function with different "
|
||
"arguments, or many times, or within a let-binding, or you can sometimes "
|
||
"delegate the work to the old function and sometimes override it completely. "
|
||
"More specifically, the composition of the two functions behaves like:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1850
|
||
#, no-wrap
|
||
msgid "(lambda (&rest r) (apply @var{function} @var{oldfun} r))\n"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1852
|
||
#, no-wrap
|
||
msgid ":before-while"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1858
|
||
msgid ""
|
||
"Call @var{function} before the old function and don't call the old function "
|
||
"if @var{function} returns @code{nil}. Both functions receive the same "
|
||
"arguments, and the return value of the composition is the return value of "
|
||
"the old function. More specifically, the composition of the two functions "
|
||
"behaves like:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1860
|
||
#, no-wrap
|
||
msgid "(lambda (&rest r) (and (apply @var{function} r) (apply @var{oldfun} r)))\n"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1864
|
||
msgid ""
|
||
"@code{(add-function :before-while @var{funvar} @var{function})} is "
|
||
"comparable for single-function hooks to @code{(add-hook '@var{hookvar} "
|
||
"@var{function})} when @var{hookvar} is run via "
|
||
"@code{run-hook-with-args-until-failure}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1865
|
||
#, no-wrap
|
||
msgid ":before-until"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1869
|
||
msgid ""
|
||
"Call @var{function} before the old function and only call the old function "
|
||
"if @var{function} returns @code{nil}. More specifically, the composition of "
|
||
"the two functions behaves like:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1871
|
||
#, no-wrap
|
||
msgid "(lambda (&rest r) (or (apply @var{function} r) (apply @var{oldfun} r)))\n"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1875
|
||
msgid ""
|
||
"@code{(add-function :before-until @var{funvar} @var{function})} is "
|
||
"comparable for single-function hooks to @code{(add-hook '@var{hookvar} "
|
||
"@var{function})} when @var{hookvar} is run via "
|
||
"@code{run-hook-with-args-until-success}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1876
|
||
#, no-wrap
|
||
msgid ":after-while"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1881
|
||
msgid ""
|
||
"Call @var{function} after the old function and only if the old function "
|
||
"returned non-@code{nil}. Both functions receive the same arguments, and the "
|
||
"return value of the composition is the return value of @var{function}. More "
|
||
"specifically, the composition of the two functions behaves like:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1883
|
||
#, no-wrap
|
||
msgid "(lambda (&rest r) (and (apply @var{oldfun} r) (apply @var{function} r)))\n"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1888
|
||
msgid ""
|
||
"@code{(add-function :after-while @var{funvar} @var{function})} is comparable "
|
||
"for single-function hooks to @code{(add-hook '@var{hookvar} @var{function} "
|
||
"'append)} when @var{hookvar} is run via "
|
||
"@code{run-hook-with-args-until-failure}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1889
|
||
#, no-wrap
|
||
msgid ":after-until"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1893
|
||
msgid ""
|
||
"Call @var{function} after the old function and only if the old function "
|
||
"returned @code{nil}. More specifically, the composition of the two "
|
||
"functions behaves like:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1895
|
||
#, no-wrap
|
||
msgid "(lambda (&rest r) (or (apply @var{oldfun} r) (apply @var{function} r)))\n"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1900
|
||
msgid ""
|
||
"@code{(add-function :after-until @var{funvar} @var{function})} is comparable "
|
||
"for single-function hooks to @code{(add-hook '@var{hookvar} @var{function} "
|
||
"'append)} when @var{hookvar} is run via "
|
||
"@code{run-hook-with-args-until-success}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1901
|
||
#, no-wrap
|
||
msgid ":filter-args"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1905
|
||
msgid ""
|
||
"Call @var{function} first and use the result (which should be a list) as the "
|
||
"new arguments to pass to the old function. More specifically, the "
|
||
"composition of the two functions behaves like:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1907
|
||
#, no-wrap
|
||
msgid "(lambda (&rest r) (apply @var{oldfun} (funcall @var{function} r)))\n"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1909
|
||
#, no-wrap
|
||
msgid ":filter-return"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1912
|
||
msgid ""
|
||
"Call the old function first and pass the result to @var{function}. More "
|
||
"specifically, the composition of the two functions behaves like:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1914
|
||
#, no-wrap
|
||
msgid "(lambda (&rest r) (funcall @var{function} (apply @var{oldfun} r)))\n"
|
||
msgstr ""
|
||
|
||
#. type: subsection
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1919
|
||
#, no-wrap
|
||
msgid "Adapting code using the old defadvice"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1920
|
||
#, no-wrap
|
||
msgid "old advices, porting"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1925
|
||
#, no-wrap
|
||
msgid "advices, porting from @code{defadvice}"
|
||
msgstr ""
|
||
|
||
#. type: findex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1926
|
||
#, no-wrap
|
||
msgid "defadvice"
|
||
msgstr ""
|
||
|
||
#. type: findex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1927
|
||
#, no-wrap
|
||
msgid "ad-activate"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1932
|
||
msgid ""
|
||
"A lot of code uses the old @code{defadvice} mechanism, which is largely made "
|
||
"obsolete by the new @code{advice-add}, whose implementation and semantics is "
|
||
"significantly simpler."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1934
|
||
msgid "An old piece of advice such as:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1944
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defadvice previous-line (before next-line-at-end\n"
|
||
" (&optional arg try-vscroll))\n"
|
||
" \"Insert an empty line when moving up from the top line.\"\n"
|
||
" (if (and next-line-add-newlines (= arg 1)\n"
|
||
" (save-excursion (beginning-of-line) (bobp)))\n"
|
||
" (progn\n"
|
||
" (beginning-of-line)\n"
|
||
" (newline))))\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1947
|
||
msgid "could be translated in the new advice mechanism into a plain function:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1956
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun previous-line--next-line-at-end (&optional arg try-vscroll)\n"
|
||
" \"Insert an empty line when moving up from the top line.\"\n"
|
||
" (if (and next-line-add-newlines (= arg 1)\n"
|
||
" (save-excursion (beginning-of-line) (bobp)))\n"
|
||
" (progn\n"
|
||
" (beginning-of-line)\n"
|
||
" (newline))))\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1960
|
||
msgid ""
|
||
"Obviously, this does not actually modify @code{previous-line}. For that the "
|
||
"old advice needed:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1962
|
||
#, no-wrap
|
||
msgid "(ad-activate 'previous-line)\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1964
|
||
msgid "whereas the new advice mechanism needs:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1966
|
||
#, no-wrap
|
||
msgid "(advice-add 'previous-line :before #'previous-line--next-line-at-end)\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1973
|
||
msgid ""
|
||
"Note that @code{ad-activate} had a global effect: it activated all pieces of "
|
||
"advice enabled for that specified function. If you wanted to only activate "
|
||
"or deactivate a particular piece, you needed to @emph{enable} or "
|
||
"@emph{disable} it with @code{ad-enable-advice} and "
|
||
"@code{ad-disable-advice}. The new mechanism does away with this "
|
||
"distinction."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1975
|
||
msgid "Around advice such as:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1982
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defadvice foo (around foo-around)\n"
|
||
" \"Ignore case in `foo'.\"\n"
|
||
" (let ((case-fold-search t))\n"
|
||
" ad-do-it))\n"
|
||
"(ad-activate 'foo)\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1985
|
||
msgid "could translate into:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:1992
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defun foo--foo-around (orig-fun &rest args)\n"
|
||
" \"Ignore case in `foo'.\"\n"
|
||
" (let ((case-fold-search t))\n"
|
||
" (apply orig-fun args)))\n"
|
||
"(advice-add 'foo :around #'foo--foo-around)\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2002
|
||
msgid ""
|
||
"Regarding the advice's @emph{class}, note that the new @code{:before} is not "
|
||
"quite equivalent to the old @code{before}, because in the old advice you "
|
||
"could modify the function's arguments (e.g., with @code{ad-set-arg}), and "
|
||
"that would affect the argument values seen by the original function, whereas "
|
||
"in the new @code{:before}, modifying an argument via @code{setq} in the "
|
||
"advice has no effect on the arguments seen by the original function. When "
|
||
"porting @code{before} advice which relied on this behavior, you'll need to "
|
||
"turn it into new @code{:around} or @code{:filter-args} advice instead."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2007
|
||
msgid ""
|
||
"Similarly old @code{after} advice could modify the returned value by "
|
||
"changing @code{ad-return-value}, whereas new @code{:after} advice cannot, so "
|
||
"when porting such old @code{after} advice, you'll need to turn it into new "
|
||
"@code{:around} or @code{:filter-return} advice instead."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2009
|
||
#, no-wrap
|
||
msgid "Declaring Functions Obsolete"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2010
|
||
#, no-wrap
|
||
msgid "obsolete functions"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2018
|
||
msgid ""
|
||
"You can mark a named function as @dfn{obsolete}, meaning that it may be "
|
||
"removed at some point in the future. This causes Emacs to warn that the "
|
||
"function is obsolete whenever it byte-compiles code containing that "
|
||
"function, and whenever it displays the documentation for that function. In "
|
||
"all other respects, an obsolete function behaves like any other function."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2023
|
||
msgid ""
|
||
"The easiest way to mark a function as obsolete is to put a @code{(declare "
|
||
"(obsolete @dots{}))} form in the function's @code{defun} definition. "
|
||
"@xref{Declare Form}. Alternatively, you can use the @code{make-obsolete} "
|
||
"function, described below."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2029
|
||
msgid ""
|
||
"A macro (@pxref{Macros}) can also be marked obsolete with "
|
||
"@code{make-obsolete}; this has the same effects as for a function. An alias "
|
||
"for a function or macro can also be marked as obsolete; this makes the alias "
|
||
"itself obsolete, not the function or macro which it resolves to."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2030
|
||
#, no-wrap
|
||
msgid "make-obsolete obsolete-name current-name when"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2034
|
||
msgid ""
|
||
"This function marks @var{obsolete-name} as obsolete. @var{obsolete-name} "
|
||
"should be a symbol naming a function or macro, or an alias for a function or "
|
||
"macro."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2043
|
||
msgid ""
|
||
"If @var{current-name} is a symbol, the warning message says to use "
|
||
"@var{current-name} instead of @var{obsolete-name}. @var{current-name} does "
|
||
"not need to be an alias for @var{obsolete-name}; it can be a different "
|
||
"function with similar functionality. @var{current-name} can also be a "
|
||
"string, which serves as the warning message. The message should begin in "
|
||
"lower case, and end with a period. It can also be @code{nil}, in which case "
|
||
"the warning message provides no additional details."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2046
|
||
msgid ""
|
||
"The argument @var{when} should be a string indicating when the function was "
|
||
"first made obsolete---for example, a date or a release number."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2048
|
||
#, no-wrap
|
||
msgid "define-obsolete-function-alias obsolete-name current-name when &optional doc"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2052
|
||
msgid ""
|
||
"This convenience macro marks the function @var{obsolete-name} obsolete and "
|
||
"also defines it as an alias for the function @var{current-name}. It is "
|
||
"equivalent to the following:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2056
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defalias @var{obsolete-name} @var{current-name} @var{doc})\n"
|
||
"(make-obsolete @var{obsolete-name} @var{current-name} @var{when})\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2061
|
||
msgid ""
|
||
"In addition, you can mark a particular calling convention for a function as "
|
||
"obsolete:"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2062
|
||
#, no-wrap
|
||
msgid "set-advertised-calling-convention function signature when"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2070
|
||
msgid ""
|
||
"This function specifies the argument list @var{signature} as the correct way "
|
||
"to call @var{function}. This causes the Emacs byte compiler to issue a "
|
||
"warning whenever it comes across an Emacs Lisp program that calls "
|
||
"@var{function} any other way (however, it will still allow the code to be "
|
||
"byte compiled). @var{when} should be a string indicating when the variable "
|
||
"was first made obsolete (usually a version number string)."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2073
|
||
msgid ""
|
||
"For instance, in old versions of Emacs the @code{sit-for} function accepted "
|
||
"three arguments, like this"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2076
|
||
#, no-wrap
|
||
msgid " (sit-for seconds milliseconds nodisp)\n"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2081
|
||
msgid ""
|
||
"However, calling @code{sit-for} this way is considered obsolete "
|
||
"(@pxref{Waiting}). The old calling convention is deprecated like this:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2085
|
||
#, no-wrap
|
||
msgid ""
|
||
"(set-advertised-calling-convention\n"
|
||
" 'sit-for '(seconds &optional nodisp) \"22.1\")\n"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2090
|
||
#, no-wrap
|
||
msgid "inline functions"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2096
|
||
msgid ""
|
||
"An @dfn{inline function} is a function that works just like an ordinary "
|
||
"function, except for one thing: when you byte-compile a call to the function "
|
||
"(@pxref{Byte Compilation}), the function's definition is expanded into the "
|
||
"caller."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2101
|
||
msgid ""
|
||
"The simple way to define an inline function, is to write @code{defsubst} "
|
||
"instead of @code{defun}. The rest of the definition looks just the same, "
|
||
"but using @code{defsubst} says to make it inline for byte compilation."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2102
|
||
#, no-wrap
|
||
msgid "defsubst name args [doc] [declare] [interactive] body@dots{}"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2105
|
||
msgid ""
|
||
"This macro defines an inline function. Its syntax is exactly the same as "
|
||
"@code{defun} (@pxref{Defining Functions})."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2111
|
||
msgid ""
|
||
"Making a function inline often makes its function calls run faster. But it "
|
||
"also has disadvantages. For one thing, it reduces flexibility; if you "
|
||
"change the definition of the function, calls already inlined still use the "
|
||
"old definition until you recompile them."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2116
|
||
msgid ""
|
||
"Another disadvantage is that making a large function inline can increase the "
|
||
"size of compiled code both in files and in memory. Since the speed "
|
||
"advantage of inline functions is greatest for small functions, you generally "
|
||
"should not make large functions inline."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2123
|
||
msgid ""
|
||
"Also, inline functions do not behave well with respect to debugging, "
|
||
"tracing, and advising (@pxref{Advising Functions}). Since ease of debugging "
|
||
"and the flexibility of redefining functions are important features of Emacs, "
|
||
"you should not make a function inline, even if it's small, unless its speed "
|
||
"is really crucial, and you've timed the code to verify that using "
|
||
"@code{defun} actually has performance problems."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2126
|
||
msgid ""
|
||
"After an inline function is defined, its inline expansion can be performed "
|
||
"later on in the same file, just like macros."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2137
|
||
msgid ""
|
||
"It's possible to use @code{defmacro} to define a macro to expand into the "
|
||
"same code that an inline function would execute (@pxref{Macros}). But the "
|
||
"macro would be limited to direct use in expressions---a macro cannot be "
|
||
"called with @code{apply}, @code{mapcar} and so on. Also, it takes some work "
|
||
"to convert an ordinary function into a macro. To convert it into an inline "
|
||
"function is easy; just replace @code{defun} with @code{defsubst}. Since "
|
||
"each argument of an inline function is evaluated exactly once, you needn't "
|
||
"worry about how many times the body uses the arguments, as you do for "
|
||
"macros."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2141
|
||
msgid ""
|
||
"Alternatively, you can define a function by providing the code which will "
|
||
"inline it as a compiler macro. The following macros make this possible."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2143
|
||
#, no-wrap
|
||
msgid "define-inline name args [doc] [declare] body@dots{}"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2147
|
||
msgid ""
|
||
"Define a function @var{name} by providing code that does its inlining, as a "
|
||
"compiler macro. The function will accept the argument list @var{args} and "
|
||
"will have the specified @var{body}."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2152
|
||
msgid ""
|
||
"If present, @var{doc} should be the function's documentation string "
|
||
"(@pxref{Function Documentation}); @var{declare}, if present, should be a "
|
||
"@code{declare} form (@pxref{Declare Form}) specifying the function's "
|
||
"metadata."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2156
|
||
msgid ""
|
||
"Functions defined via @code{define-inline} have several advantages with "
|
||
"respect to macros defined by @code{defsubst} or @code{defmacro}:"
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2160
|
||
msgid "They can be passed to @code{mapcar} (@pxref{Mapping Functions})."
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2163
|
||
msgid "They are more efficient."
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2167
|
||
msgid ""
|
||
"They can be used as @dfn{place forms} to store values (@pxref{Generalized "
|
||
"Variables})."
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2172
|
||
msgid ""
|
||
"They behave in a more predictable way than @code{cl-defsubst} "
|
||
"(@pxref{Argument Lists,,, cl, Common Lisp Extensions for GNU Emacs Lisp})."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2177
|
||
msgid ""
|
||
"Like @code{defmacro}, a function inlined with @code{define-inline} inherits "
|
||
"the scoping rules, either dynamic or lexical, from the call site. "
|
||
"@xref{Variable Scoping}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2180
|
||
msgid ""
|
||
"The following macros should be used in the body of a function defined by "
|
||
"@code{define-inline}."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2181
|
||
#, no-wrap
|
||
msgid "inline-quote expression"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2185
|
||
msgid ""
|
||
"Quote @var{expression} for @code{define-inline}. This is similar to the "
|
||
"backquote (@pxref{Backquote}), but quotes code and accepts only @code{,}, "
|
||
"not @code{,@@}."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2187
|
||
#, no-wrap
|
||
msgid "inline-letevals (bindings@dots{}) body@dots{}"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2191
|
||
msgid ""
|
||
"This provides a convenient way to ensure that the arguments to an inlined "
|
||
"function are evaluated exactly once, as well as to create local variables."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2195
|
||
msgid ""
|
||
"It's similar to @code{let} (@pxref{Local Variables}): It sets up local "
|
||
"variables as specified by @var{bindings}, and then evaluates @var{body} with "
|
||
"those bindings in effect."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2202
|
||
msgid ""
|
||
"Each element of @var{bindings} should be either a symbol or a list of the "
|
||
"form @w{@code{(@var{var} @var{expr})}}; the result is to evaluate @var{expr} "
|
||
"and bind @var{var} to the result. However, when an element of "
|
||
"@var{bindings} is just a symbol @var{var}, the result of evaluating "
|
||
"@var{var} is re-bound to @var{var} (which is quite different from the way "
|
||
"@code{let} works)."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2206
|
||
msgid ""
|
||
"The tail of @var{bindings} can be either @code{nil} or a symbol which should "
|
||
"hold a list of arguments, in which case each argument is evaluated, and the "
|
||
"symbol is bound to the resulting list."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2208
|
||
#, no-wrap
|
||
msgid "inline-const-p expression"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2211
|
||
msgid "Return non-@code{nil} if the value of @var{expression} is already known."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2213
|
||
#, no-wrap
|
||
msgid "inline-const-val expression"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2215
|
||
msgid "Return the value of @var{expression}."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2217
|
||
#, no-wrap
|
||
msgid "inline-error format &rest args"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2219
|
||
msgid "Signal an error, formatting @var{args} according to @var{format}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2222
|
||
msgid "Here's an example of using @code{define-inline}:"
|
||
msgstr ""
|
||
|
||
#. type: lisp
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2227
|
||
#, no-wrap
|
||
msgid ""
|
||
"(define-inline myaccessor (obj)\n"
|
||
" (inline-letevals (obj)\n"
|
||
" (inline-quote (if (foo-p ,obj) (aref (cdr ,obj) 3) (aref ,obj 2)))))\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2231
|
||
msgid "This is equivalent to"
|
||
msgstr ""
|
||
|
||
#. type: lisp
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2235
|
||
#, no-wrap
|
||
msgid ""
|
||
"(defsubst myaccessor (obj)\n"
|
||
" (if (foo-p obj) (aref (cdr obj) 3) (aref obj 2)))\n"
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2238
|
||
#, no-wrap
|
||
msgid "The @code{declare} Form"
|
||
msgstr ""
|
||
|
||
#. type: findex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2239
|
||
#, no-wrap
|
||
msgid "declare"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2245
|
||
msgid ""
|
||
"@code{declare} is a special macro which can be used to add meta properties "
|
||
"to a function or macro: for example, marking it as obsolete, or giving its "
|
||
"forms a special @key{TAB} indentation convention in Emacs Lisp mode."
|
||
msgstr ""
|
||
|
||
#. type: anchor{#1}
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2247
|
||
msgid "Definition of declare"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2247
|
||
#, no-wrap
|
||
msgid "declare specs@dots{}"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2256
|
||
msgid ""
|
||
"This macro ignores its arguments and evaluates to @code{nil}; it has no "
|
||
"run-time effect. However, when a @code{declare} form occurs in the "
|
||
"@var{declare} argument of a @code{defun} or @code{defsubst} function "
|
||
"definition (@pxref{Defining Functions}) or a @code{defmacro} macro "
|
||
"definition (@pxref{Defining Macros}), it appends the properties specified by "
|
||
"@var{specs} to the function or macro. This work is specially performed by "
|
||
"@code{defun}, @code{defsubst}, and @code{defmacro}."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2260
|
||
msgid ""
|
||
"Each element in @var{specs} should have the form @code{(@var{property} "
|
||
"@var{args}@dots{})}, which should not be quoted. These have the following "
|
||
"effects:"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2262
|
||
#, no-wrap
|
||
msgid "(advertised-calling-convention @var{signature} @var{when})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2267
|
||
msgid ""
|
||
"This acts like a call to @code{set-advertised-calling-convention} "
|
||
"(@pxref{Obsolete Functions}); @var{signature} specifies the correct argument "
|
||
"list for calling the function or macro, and @var{when} should be a string "
|
||
"indicating when the old argument list was first made obsolete."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2268
|
||
#, no-wrap
|
||
msgid "(debug @var{edebug-form-spec})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2271
|
||
msgid ""
|
||
"This is valid for macros only. When stepping through the macro with Edebug, "
|
||
"use @var{edebug-form-spec}. @xref{Instrumenting Macro Calls}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2272
|
||
#, no-wrap
|
||
msgid "(doc-string @var{n})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2277
|
||
msgid ""
|
||
"This is used when defining a function or macro which itself will be used to "
|
||
"define entities like functions, macros, or variables. It indicates that the "
|
||
"@var{n}th argument, if any, should be considered as a documentation string."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2278
|
||
#, no-wrap
|
||
msgid "(indent @var{indent-spec})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2282
|
||
msgid ""
|
||
"Indent calls to this function or macro according to @var{indent-spec}. This "
|
||
"is typically used for macros, though it works for functions too. "
|
||
"@xref{Indenting Macros}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2283
|
||
#, no-wrap
|
||
msgid "(interactive-only @var{value})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2286
|
||
msgid ""
|
||
"Set the function's @code{interactive-only} property to @var{value}. "
|
||
"@xref{The interactive-only property}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2287
|
||
#, no-wrap
|
||
msgid "(obsolete @var{current-name} @var{when})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2295
|
||
msgid ""
|
||
"Mark the function or macro as obsolete, similar to a call to "
|
||
"@code{make-obsolete} (@pxref{Obsolete Functions}). @var{current-name} "
|
||
"should be a symbol (in which case the warning message says to use that "
|
||
"instead), a string (specifying the warning message), or @code{nil} (in which "
|
||
"case the warning message gives no extra details). @var{when} should be a "
|
||
"string indicating when the function or macro was first made obsolete."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2296
|
||
#, no-wrap
|
||
msgid "(compiler-macro @var{expander})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2308
|
||
msgid ""
|
||
"This can only be used for functions, and tells the compiler to use "
|
||
"@var{expander} as an optimization function. When encountering a call to the "
|
||
"function, of the form @code{(@var{function} @var{args}@dots{})}, the macro "
|
||
"expander will call @var{expander} with that form as well as with "
|
||
"@var{args}@dots{}, and @var{expander} can either return a new expression to "
|
||
"use instead of the function call, or it can return just the form unchanged, "
|
||
"to indicate that the function call should be left alone. @var{expander} can "
|
||
"be a symbol, or it can be a form @code{(lambda (@var{arg}) @var{body})} in "
|
||
"which case @var{arg} will hold the original function call expression, and "
|
||
"the (unevaluated) arguments to the function can be accessed using the "
|
||
"function's formal arguments."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2309
|
||
#, no-wrap
|
||
msgid "(gv-expander @var{expander})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2315
|
||
msgid ""
|
||
"Declare @var{expander} to be the function to handle calls to the macro (or "
|
||
"function) as a generalized variable, similarly to "
|
||
"@code{gv-define-expander}. @var{expander} can be a symbol or it can be of "
|
||
"the form @code{(lambda (@var{arg}) @var{body})} in which case that function "
|
||
"will additionally have access to the macro (or function)'s arguments."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2316
|
||
#, no-wrap
|
||
msgid "(gv-setter @var{setter})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2323
|
||
msgid ""
|
||
"Declare @var{setter} to be the function to handle calls to the macro (or "
|
||
"function) as a generalized variable. @var{setter} can be a symbol in which "
|
||
"case it will be passed to @code{gv-define-simple-setter}, or it can be of "
|
||
"the form @code{(lambda (@var{arg}) @var{body})} in which case that function "
|
||
"will additionally have access to the macro (or function)'s arguments and it "
|
||
"will be passed to @code{gv-define-setter}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2324
|
||
#, no-wrap
|
||
msgid "(completion @var{completion-predicate})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2330
|
||
msgid ""
|
||
"Declare @var{completion-predicate} as a function to determine whether to "
|
||
"include the symbol in the list of functions when asking for completions in "
|
||
"@kbd{M-x}. @var{completion-predicate} is called with two parameters: The "
|
||
"first parameter is the symbol, and the second is the current buffer."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2331
|
||
#, no-wrap
|
||
msgid "(modes @var{modes})"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2334
|
||
msgid "Specify that this command is meant to be applicable for @var{modes} only."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2339
|
||
#, no-wrap
|
||
msgid "Telling the Compiler that a Function is Defined"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2340
|
||
#, no-wrap
|
||
msgid "function declaration"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2341
|
||
#, no-wrap
|
||
msgid "declaring functions"
|
||
msgstr ""
|
||
|
||
#. type: findex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2342
|
||
#, no-wrap
|
||
msgid "declare-function"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2349
|
||
msgid ""
|
||
"Byte-compiling a file often produces warnings about functions that the "
|
||
"compiler doesn't know about (@pxref{Compiler Errors}). Sometimes this "
|
||
"indicates a real problem, but usually the functions in question are defined "
|
||
"in other files which would be loaded if that code is run. For example, "
|
||
"byte-compiling @file{simple.el} used to warn:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2353
|
||
#, no-wrap
|
||
msgid ""
|
||
"simple.el:8727:1:Warning: the function ‘shell-mode’ is not known to be\n"
|
||
" defined.\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2361
|
||
msgid ""
|
||
"In fact, @code{shell-mode} is used only in a function that executes "
|
||
"@code{(require 'shell)} before calling @code{shell-mode}, so "
|
||
"@code{shell-mode} will be defined properly at run-time. When you know that "
|
||
"such a warning does not indicate a real problem, it is good to suppress the "
|
||
"warning. That makes new warnings which might mean real problems more "
|
||
"visible. You do that with @code{declare-function}."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2364
|
||
msgid ""
|
||
"All you need to do is add a @code{declare-function} statement before the "
|
||
"first use of the function in question:"
|
||
msgstr ""
|
||
|
||
#. type: example
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2367
|
||
#, no-wrap
|
||
msgid "(declare-function shell-mode \"shell\" ())\n"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2372
|
||
msgid ""
|
||
"This says that @code{shell-mode} is defined in @file{shell.el} (the "
|
||
"@samp{.el} can be omitted). The compiler takes for granted that that file "
|
||
"really defines the function, and does not check."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2379
|
||
msgid ""
|
||
"The optional third argument specifies the argument list of "
|
||
"@code{shell-mode}. In this case, it takes no arguments (@code{nil} is "
|
||
"different from not specifying a value). In other cases, this might be "
|
||
"something like @code{(file &optional overwrite)}. You don't have to specify "
|
||
"the argument list, but if you do the byte compiler can check that the calls "
|
||
"match the declaration."
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2380
|
||
#, no-wrap
|
||
msgid "declare-function function file &optional arglist fileonly"
|
||
msgstr ""
|
||
|
||
#. type: defmac
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2391
|
||
msgid ""
|
||
"Tell the byte compiler to assume that @var{function} is defined in the file "
|
||
"@var{file}. The optional third argument @var{arglist} is either @code{t}, "
|
||
"meaning the argument list is unspecified, or a list of formal parameters in "
|
||
"the same style as @code{defun}. An omitted @var{arglist} defaults to "
|
||
"@code{t}, not @code{nil}; this is atypical behavior for omitted arguments, "
|
||
"and it means that to supply a fourth but not third argument one must specify "
|
||
"@code{t} for the third-argument placeholder instead of the usual "
|
||
"@code{nil}. The optional fourth argument @var{fileonly} non-@code{nil} "
|
||
"means check only that @var{file} exists, not that it actually defines "
|
||
"@var{function}."
|
||
msgstr ""
|
||
|
||
#. type: findex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2393
|
||
#, no-wrap
|
||
msgid "check-declare-file"
|
||
msgstr ""
|
||
|
||
#. type: findex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2394
|
||
#, no-wrap
|
||
msgid "check-declare-directory"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2400
|
||
msgid ""
|
||
"To verify that these functions really are declared where "
|
||
"@code{declare-function} says they are, use @code{check-declare-file} to "
|
||
"check all @code{declare-function} calls in one source file, or use "
|
||
"@code{check-declare-directory} check all the files in and under a certain "
|
||
"directory."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2405
|
||
msgid ""
|
||
"These commands find the file that ought to contain a function's definition "
|
||
"using @code{locate-library}; if that finds no file, they expand the "
|
||
"definition file name relative to the directory of the file that contains the "
|
||
"@code{declare-function} call."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2410
|
||
msgid ""
|
||
"You can also say that a function is a primitive by specifying a file name "
|
||
"ending in @samp{.c} or @samp{.m}. This is useful only when you call a "
|
||
"primitive that is defined only on certain systems. Most primitives are "
|
||
"always defined, so they will never give you a warning."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2415
|
||
msgid ""
|
||
"Sometimes a file will optionally use functions from an external package. If "
|
||
"you prefix the filename in the @code{declare-function} statement with "
|
||
"@samp{ext:}, then it will be checked if it is found, otherwise skipped "
|
||
"without error."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2424
|
||
msgid ""
|
||
"There are some function definitions that @samp{check-declare} does not "
|
||
"understand (e.g., @code{defstruct} and some other macros). In such cases, "
|
||
"you can pass a non-@code{nil} @var{fileonly} argument to "
|
||
"@code{declare-function}, meaning to only check that the file exists, not "
|
||
"that it actually defines the function. Note that to do this without having "
|
||
"to specify an argument list, you should set the @var{arglist} argument to "
|
||
"@code{t} (because @code{nil} means an empty argument list, as opposed to an "
|
||
"unspecified one)."
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2426
|
||
#, no-wrap
|
||
msgid "Determining whether a Function is Safe to Call"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2427
|
||
#, no-wrap
|
||
msgid "function safety"
|
||
msgstr ""
|
||
|
||
#. type: cindex
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2428
|
||
#, no-wrap
|
||
msgid "safety of functions"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2437
|
||
msgid ""
|
||
"Some major modes, such as SES, call functions that are stored in user "
|
||
"files. (@xref{Top, Simple Emacs Spreadsheet,,ses}, for more information on "
|
||
"SES@.) User files sometimes have poor pedigrees---you can get a spreadsheet "
|
||
"from someone you've just met, or you can get one through email from someone "
|
||
"you've never met. So it is risky to call a function whose source code is "
|
||
"stored in a user file until you have determined that it is safe."
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2438
|
||
#, no-wrap
|
||
msgid "unsafep form &optional unsafep-vars"
|
||
msgstr ""
|
||
|
||
#. type: defun
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2445
|
||
msgid ""
|
||
"Returns @code{nil} if @var{form} is a @dfn{safe} Lisp expression, or returns "
|
||
"a list that describes why it might be unsafe. The argument "
|
||
"@var{unsafep-vars} is a list of symbols known to have temporary bindings at "
|
||
"this point; it is mainly used for internal recursive calls. The current "
|
||
"buffer is an implicit argument, which provides a list of buffer-local "
|
||
"bindings."
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2456
|
||
msgid ""
|
||
"Being quick and simple, @code{unsafep} does a very light analysis and "
|
||
"rejects many Lisp expressions that are actually safe. There are no known "
|
||
"cases where @code{unsafep} returns @code{nil} for an unsafe expression. "
|
||
"However, a safe Lisp expression can return a string with a @code{display} "
|
||
"property, containing an associated Lisp expression to be executed after the "
|
||
"string is inserted into a buffer. This associated expression can be a "
|
||
"virus. In order to be safe, you must delete properties from all strings "
|
||
"calculated by user code before inserting them into buffers."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2464
|
||
#, no-wrap
|
||
msgid "Safe expression"
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2468
|
||
#, no-wrap
|
||
msgid "An atom or quoted thing.\n"
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2471
|
||
#, no-wrap
|
||
msgid ""
|
||
"A call to a safe function (see below), if all its arguments are\n"
|
||
"safe expressions.\n"
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2476
|
||
#, no-wrap
|
||
msgid ""
|
||
"One of the special forms @code{and}, @code{catch}, @code{cond},\n"
|
||
"@code{if}, @code{or}, @code{prog1}, @code{prog2}, @code{progn},\n"
|
||
"@code{while}, and @code{unwind-protect}], if all its arguments are\n"
|
||
"safe.\n"
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2481
|
||
#, no-wrap
|
||
msgid ""
|
||
"A form that creates temporary bindings (@code{condition-case},\n"
|
||
"@code{dolist}, @code{dotimes}, @code{lambda}, @code{let}, or\n"
|
||
"@code{let*}), if all args are safe and the symbols to be bound are not\n"
|
||
"explicitly risky (@pxref{File Local Variables}).\n"
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2486
|
||
#, no-wrap
|
||
msgid ""
|
||
"An assignment using @code{add-to-list}, @code{setq}, @code{push}, or\n"
|
||
"@code{pop}, if all args are safe and the symbols to be assigned are\n"
|
||
"not explicitly risky and they already have temporary or buffer-local\n"
|
||
"bindings.\n"
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2489
|
||
#, no-wrap
|
||
msgid ""
|
||
"One of [apply, mapc, mapcar, mapconcat] if the first argument is a\n"
|
||
"safe explicit lambda and the other args are safe expressions.\n"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2491
|
||
#, no-wrap
|
||
msgid "Safe function"
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2495
|
||
#, no-wrap
|
||
msgid "A lambda containing safe expressions.\n"
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2497
|
||
#, no-wrap
|
||
msgid "A symbol on the list @code{safe-functions}, so the user says it's safe.\n"
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2499
|
||
#, no-wrap
|
||
msgid "A symbol with a non-@code{nil} @code{side-effect-free} property.\n"
|
||
msgstr ""
|
||
|
||
#. type: itemize
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2504
|
||
#, no-wrap
|
||
msgid ""
|
||
"A symbol with a non-@code{nil} @code{safe-function} property. The\n"
|
||
"value @code{t} indicates a function that is safe but has innocuous\n"
|
||
"side effects. Other values will someday indicate functions with\n"
|
||
"classes of side effects that are not always safe.\n"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2510
|
||
#, no-wrap
|
||
msgid ""
|
||
"The @code{side-effect-free} and @code{safe-function} properties are\n"
|
||
"provided for built-in functions and for low-level functions and macros\n"
|
||
"defined in @file{subr.el}. You can assign these properties for the\n"
|
||
"functions you write.\n"
|
||
msgstr ""
|
||
|
||
#. type: section
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2514
|
||
#, no-wrap
|
||
msgid "Other Topics Related to Functions"
|
||
msgstr ""
|
||
|
||
#. type: Plain text
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2519
|
||
msgid ""
|
||
"Here is a table of several functions that do things related to function "
|
||
"calling and function definitions. They are documented elsewhere, but we "
|
||
"provide cross references here."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2521
|
||
#, no-wrap
|
||
msgid "apply"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2523
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2544
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2550
|
||
msgid "See @ref{Calling Functions}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2524
|
||
#, no-wrap
|
||
msgid "autoload"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2526
|
||
msgid "See @ref{Autoload}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2527
|
||
#, no-wrap
|
||
msgid "call-interactively"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2529
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2535
|
||
msgid "See @ref{Interactive Call}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2530
|
||
#, no-wrap
|
||
msgid "called-interactively-p"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2532
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2559
|
||
msgid "See @ref{Distinguish Interactive}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2533
|
||
#, no-wrap
|
||
msgid "commandp"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2536
|
||
#, no-wrap
|
||
msgid "documentation"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2538
|
||
msgid "See @ref{Accessing Documentation}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2539
|
||
#, no-wrap
|
||
msgid "eval"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2541
|
||
msgid "See @ref{Eval}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2542
|
||
#, no-wrap
|
||
msgid "funcall"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2545
|
||
#, no-wrap
|
||
msgid "function"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2547
|
||
msgid "See @ref{Anonymous Functions}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2548
|
||
#, no-wrap
|
||
msgid "ignore"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2551
|
||
#, no-wrap
|
||
msgid "indirect-function"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2553
|
||
msgid "See @ref{Function Indirection}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2554
|
||
#, no-wrap
|
||
msgid "interactive"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2556
|
||
msgid "See @ref{Using Interactive}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2557
|
||
#, no-wrap
|
||
msgid "interactive-p"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2560
|
||
#, no-wrap
|
||
msgid "mapatoms"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2562
|
||
msgid "See @ref{Creating Symbols}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2563
|
||
#, no-wrap
|
||
msgid "mapcar"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2565
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2571
|
||
msgid "See @ref{Mapping Functions}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2566
|
||
#, no-wrap
|
||
msgid "map-char-table"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2568
|
||
msgid "See @ref{Char-Tables}."
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2569
|
||
#, no-wrap
|
||
msgid "mapconcat"
|
||
msgstr ""
|
||
|
||
#. type: item
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2572
|
||
#, no-wrap
|
||
msgid "undefined"
|
||
msgstr ""
|
||
|
||
#. type: table
|
||
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
||
#: Sources/doc/lispref/functions.texi:2574
|
||
msgid "See @ref{Functions for Key Lookup}."
|
||
msgstr ""
|