2828 lines
105 KiB
Plaintext
2828 lines
105 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/loading.texi:6
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:7
|
|
#, no-wrap
|
|
msgid "Loading"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:8
|
|
#, no-wrap
|
|
msgid "loading"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:9
|
|
#, no-wrap
|
|
msgid "library"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:10
|
|
#, no-wrap
|
|
msgid "Lisp library"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:16
|
|
msgid ""
|
|
"Loading a file of Lisp code means bringing its contents into the Lisp "
|
|
"environment in the form of Lisp objects. Emacs finds and opens the file, "
|
|
"reads the text, evaluates each form, and then closes the file. Such a file "
|
|
"is also called a @dfn{Lisp library}."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:22
|
|
msgid ""
|
|
"The load functions evaluate all the expressions in a file just as the "
|
|
"@code{eval-buffer} function evaluates all the expressions in a buffer. The "
|
|
"difference is that the load functions read and evaluate the text in the file "
|
|
"as found on disk, not the text in an Emacs buffer."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:23
|
|
#, no-wrap
|
|
msgid "top-level form"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:31
|
|
msgid ""
|
|
"The loaded file must contain Lisp expressions, either as source code or as "
|
|
"byte-compiled code. Each form in the file is called a @dfn{top-level "
|
|
"form}. There is no special format for the forms in a loadable file; any "
|
|
"form in a file may equally well be typed directly into a buffer and "
|
|
"evaluated there. (Indeed, most code is tested this way.) Most often, the "
|
|
"forms are function definitions and variable definitions."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:38
|
|
msgid ""
|
|
"Emacs can also load compiled dynamic modules: shared libraries that provide "
|
|
"additional functionality for use in Emacs Lisp programs, just like a package "
|
|
"written in Emacs Lisp would. When a dynamic module is loaded, Emacs calls a "
|
|
"specially-named initialization function which the module needs to implement, "
|
|
"and which exposes the additional functions and variables to Emacs Lisp "
|
|
"programs."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:41
|
|
msgid ""
|
|
"For on-demand loading of external libraries which are known in advance to be "
|
|
"required by certain Emacs primitives, @pxref{Dynamic Libraries}."
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:57
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:58
|
|
#, no-wrap
|
|
msgid "How Programs Do Loading"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
msgid "The @code{load} function and others."
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:227
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:228
|
|
#, no-wrap
|
|
msgid "Load Suffixes"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
msgid "Details about the suffixes that @code{load} tries."
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:279
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:280
|
|
#, no-wrap
|
|
msgid "Library Search"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
msgid "Finding a library to load."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:462
|
|
#, no-wrap
|
|
msgid "Loading Non-ASCII"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
msgid "Non-@acronym{ASCII} characters in Emacs Lisp files."
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:488
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:489
|
|
#, no-wrap
|
|
msgid "Autoload"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
msgid "Setting up a function to autoload."
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:795
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:796
|
|
#, no-wrap
|
|
msgid "Repeated Loading"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
msgid "Precautions about loading a file twice."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:849
|
|
#, no-wrap
|
|
msgid "Named Features"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
msgid "Loading a library if it isn't already loaded."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1015
|
|
#, no-wrap
|
|
msgid "Where Defined"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
msgid "Finding which file defined a certain symbol."
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1080
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1081
|
|
#, no-wrap
|
|
msgid "Unloading"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
msgid "How to unload a library that was loaded."
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1133
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1134
|
|
#, no-wrap
|
|
msgid "Hooks for Loading"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
msgid "Providing code to be run when particular libraries are loaded."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1190
|
|
#, no-wrap
|
|
msgid "Dynamic Modules"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:55
|
|
msgid "Modules provide additional Lisp primitives."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:66
|
|
msgid ""
|
|
"Emacs Lisp has several interfaces for loading. For example, @code{autoload} "
|
|
"creates a placeholder object for a function defined in a file; trying to "
|
|
"call the autoloading function loads the file to get the function's real "
|
|
"definition (@pxref{Autoload}). @code{require} loads a file if it isn't "
|
|
"already loaded (@pxref{Named Features}). Ultimately, all these facilities "
|
|
"call the @code{load} function to do the work."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:67
|
|
#, no-wrap
|
|
msgid "load filename &optional missing-ok nomessage nosuffix must-suffix"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:70
|
|
msgid ""
|
|
"This function finds and opens a file of Lisp code, evaluates all the forms "
|
|
"in it, and closes the file."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:89
|
|
msgid ""
|
|
"To find the file, @code{load} first looks for a file named "
|
|
"@file{@var{filename}.elc}, that is, for a file whose name is @var{filename} "
|
|
"with the extension @samp{.elc} appended. If such a file exists, and Emacs "
|
|
"was compiled with native-compilation support (@pxref{Native Compilation}), "
|
|
"@code{load} attempts to find a corresponding @samp{.eln} file, and if found, "
|
|
"loads it instead of @file{@var{filename}.elc}. Otherwise, it loads "
|
|
"@file{@var{filename}.elc}. If there is no file by that name, then "
|
|
"@code{load} looks for a file named @file{@var{filename}.el}. If that file "
|
|
"exists, it is loaded. If Emacs was compiled with support for dynamic "
|
|
"modules (@pxref{Dynamic Modules}), @code{load} next looks for a file named "
|
|
"@file{@var{filename}.@var{ext}}, where @var{ext} is a system-dependent "
|
|
"file-name extension of shared libraries. Finally, if neither of those names "
|
|
"is found, @code{load} looks for a file named @var{filename} with nothing "
|
|
"appended, and loads it if it exists. (The @code{load} function is not "
|
|
"clever about looking at @var{filename}. In the perverse case of a file "
|
|
"named @file{foo.el.el}, evaluation of @code{(load \"foo.el\")} will indeed "
|
|
"find it.)"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:97
|
|
msgid ""
|
|
"If Auto Compression mode is enabled, as it is by default, then if "
|
|
"@code{load} can not find a file, it searches for a compressed version of the "
|
|
"file before trying other file names. It decompresses and loads it if it "
|
|
"exists. It looks for compressed versions by appending each of the suffixes "
|
|
"in @code{jka-compr-load-suffixes} to the file name. The value of this "
|
|
"variable must be a list of strings. Its standard value is @code{(\".gz\")}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:106
|
|
msgid ""
|
|
"If the optional argument @var{nosuffix} is non-@code{nil}, then @code{load} "
|
|
"does not try the suffixes @samp{.elc} and @samp{.el}. In this case, you "
|
|
"must specify the precise file name you want, except that, if Auto "
|
|
"Compression mode is enabled, @code{load} will still use "
|
|
"@code{jka-compr-load-suffixes} to find compressed versions. By specifying "
|
|
"the precise file name and using @code{t} for @var{nosuffix}, you can prevent "
|
|
"file names like @file{foo.el.el} from being tried."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:112
|
|
msgid ""
|
|
"If the optional argument @var{must-suffix} is non-@code{nil}, then "
|
|
"@code{load} insists that the file name used must end in either @samp{.el} or "
|
|
"@samp{.elc} (possibly extended with a compression suffix) or the "
|
|
"shared-library extension, unless it contains an explicit directory name."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:118
|
|
msgid ""
|
|
"If the option @code{load-prefer-newer} is non-@code{nil}, then when "
|
|
"searching suffixes, @code{load} selects whichever version of a file "
|
|
"(@samp{.elc}, @samp{.el}, etc.)@: has been modified most recently. In this "
|
|
"case, @code{load} doesn't load the @samp{.eln} natively-compiled file even "
|
|
"if it exists."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:128
|
|
msgid ""
|
|
"If @var{filename} is a relative file name, such as @file{foo} or "
|
|
"@file{baz/foo.bar}, @code{load} searches for the file using the variable "
|
|
"@code{load-path}. It appends @var{filename} to each of the directories "
|
|
"listed in @code{load-path}, and loads the first file it finds whose name "
|
|
"matches. The current default directory is tried only if it is specified in "
|
|
"@code{load-path}, where @code{nil} stands for the default directory. "
|
|
"@code{load} tries all three possible suffixes in the first directory in "
|
|
"@code{load-path}, then all three suffixes in the second directory, and so "
|
|
"on. @xref{Library Search}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:132
|
|
msgid ""
|
|
"Whatever the name under which the file is eventually found, and the "
|
|
"directory where Emacs found it, Emacs sets the value of the variable "
|
|
"@code{load-file-name} to that file's name."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:136
|
|
msgid ""
|
|
"If you get a warning that @file{foo.elc} is older than @file{foo.el}, it "
|
|
"means you should consider recompiling @file{foo.el}. @xref{Byte "
|
|
"Compilation}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:140
|
|
msgid ""
|
|
"When loading a source file (not compiled), @code{load} performs character "
|
|
"set translation just as Emacs would do when visiting the file. @xref{Coding "
|
|
"Systems}."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:143
|
|
#, no-wrap
|
|
msgid "eager macro expansion"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:159
|
|
msgid ""
|
|
"When loading an uncompiled file, Emacs tries to expand any macros that the "
|
|
"file contains (@pxref{Macros}). We refer to this as @dfn{eager macro "
|
|
"expansion}. Doing this (rather than deferring the expansion until the "
|
|
"relevant code runs) can significantly speed up the execution of uncompiled "
|
|
"code. Sometimes, this macro expansion cannot be done, owing to a cyclic "
|
|
"dependency. In the simplest example of this, the file you are loading "
|
|
"refers to a macro defined in another file, and that file in turn requires "
|
|
"the file you are loading. This is generally harmless. Emacs prints a "
|
|
"warning (@samp{Eager macro-expansion skipped due to cycle@dots{}}) giving "
|
|
"details of the problem, but it still loads the file, just leaving the macro "
|
|
"unexpanded for now. You may wish to restructure your code so that this does "
|
|
"not happen. Loading a compiled file does not cause macroexpansion, because "
|
|
"this should already have happened during compilation. @xref{Compiling "
|
|
"Macros}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:164
|
|
msgid ""
|
|
"Messages like @samp{Loading foo...} and @samp{Loading foo...done} appear in "
|
|
"the echo area during loading unless @var{nomessage} is non-@code{nil}. If a "
|
|
"natively-compiled @samp{.eln} file is loaded, the message says so."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:165
|
|
#, no-wrap
|
|
msgid "load errors"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:169
|
|
msgid ""
|
|
"Any unhandled errors while loading a file terminate loading. If the load "
|
|
"was done for the sake of @code{autoload}, any function definitions made "
|
|
"during the loading are undone."
|
|
msgstr ""
|
|
|
|
#. type: kindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:170
|
|
#, no-wrap
|
|
msgid "file-error"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:175
|
|
msgid ""
|
|
"If @code{load} can't find the file to load, then normally it signals a "
|
|
"@code{file-error} (with @samp{Cannot open load file @var{filename}}). But "
|
|
"if @var{missing-ok} is non-@code{nil}, then @code{load} just returns "
|
|
"@code{nil}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:179
|
|
msgid ""
|
|
"You can use the variable @code{load-read-function} to specify a function for "
|
|
"@code{load} to use instead of @code{read} for reading expressions. See "
|
|
"below."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:181
|
|
msgid "@code{load} returns @code{t} if the file loads successfully."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:183
|
|
#, no-wrap
|
|
msgid "Command load-file filename"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:190
|
|
msgid ""
|
|
"This command loads the file @var{filename}. If @var{filename} is a relative "
|
|
"file name, then the current default directory is assumed. This command does "
|
|
"not use @code{load-path}, and does not append suffixes. However, it does "
|
|
"look for compressed versions (if Auto Compression Mode is enabled). Use "
|
|
"this command if you wish to specify precisely the file name to load."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:192
|
|
#, no-wrap
|
|
msgid "Command load-library library"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:196
|
|
msgid ""
|
|
"This command loads the library named @var{library}. It is equivalent to "
|
|
"@code{load}, except for the way it reads its argument interactively. "
|
|
"@xref{Lisp Libraries,,,emacs, The GNU Emacs Manual}."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:198
|
|
#, no-wrap
|
|
msgid "load-in-progress"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:201
|
|
msgid ""
|
|
"This variable is non-@code{nil} if Emacs is in the process of loading a "
|
|
"file, and it is @code{nil} otherwise."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:203
|
|
#, no-wrap
|
|
msgid "load-file-name"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:207
|
|
msgid ""
|
|
"When Emacs is in the process of loading a file, this variable's value is the "
|
|
"name of that file, as Emacs found it during the search described earlier in "
|
|
"this section."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:209
|
|
#, no-wrap
|
|
msgid "load-read-function"
|
|
msgstr ""
|
|
|
|
#. type: anchor{#1}
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:215
|
|
msgid "Definition of load-read-function"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:215
|
|
msgid ""
|
|
"This variable specifies an alternate expression-reading function for "
|
|
"@code{load} and @code{eval-region} to use instead of @code{read}. The "
|
|
"function should accept one argument, just as @code{read} does."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:218
|
|
msgid "By default, this variable's value is @code{read}. @xref{Input Functions}."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:222
|
|
msgid ""
|
|
"Instead of using this variable, it is cleaner to use another, newer feature: "
|
|
"to pass the function as the @var{read-function} argument to "
|
|
"@code{eval-region}. @xref{Definition of eval-region,, Eval}."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:226
|
|
msgid ""
|
|
"For information about how @code{load} is used in building Emacs, see "
|
|
"@ref{Building Emacs}."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:231
|
|
msgid ""
|
|
"We now describe some technical details about the exact suffixes that "
|
|
"@code{load} tries."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:232
|
|
#, no-wrap
|
|
msgid "load-suffixes"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:238
|
|
msgid ""
|
|
"This is a list of suffixes indicating (compiled or source) Emacs Lisp "
|
|
"files. It should not include the empty string. @code{load} uses these "
|
|
"suffixes in order when it appends Lisp suffixes to the specified file name. "
|
|
"The standard value is @code{(\".elc\" \".el\")} which produces the behavior "
|
|
"described in the previous section."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:240
|
|
#, no-wrap
|
|
msgid "load-file-rep-suffixes"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:245
|
|
msgid ""
|
|
"This is a list of suffixes that indicate representations of the same file. "
|
|
"This list should normally start with the empty string. When @code{load} "
|
|
"searches for a file it appends the suffixes in this list, in order, to the "
|
|
"file name, before searching for another file."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:254
|
|
msgid ""
|
|
"Enabling Auto Compression mode appends the suffixes in "
|
|
"@code{jka-compr-load-suffixes} to this list and disabling Auto Compression "
|
|
"mode removes them again. The standard value of "
|
|
"@code{load-file-rep-suffixes} if Auto Compression mode is disabled is "
|
|
"@code{(\"\")}. Given that the standard value of "
|
|
"@code{jka-compr-load-suffixes} is @code{(\".gz\")}, the standard value of "
|
|
"@code{load-file-rep-suffixes} if Auto Compression mode is enabled is "
|
|
"@code{(\"\" \".gz\")}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:256
|
|
#, no-wrap
|
|
msgid "get-load-suffixes"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:265
|
|
msgid ""
|
|
"This function returns the list of all suffixes that @code{load} should try, "
|
|
"in order, when its @var{must-suffix} argument is non-@code{nil}. This takes "
|
|
"both @code{load-suffixes} and @code{load-file-rep-suffixes} into account. "
|
|
"If @code{load-suffixes}, @code{jka-compr-load-suffixes} and "
|
|
"@code{load-file-rep-suffixes} all have their standard values, this function "
|
|
"returns @code{(\".elc\" \".elc.gz\" \".el\" \".el.gz\")} if Auto Compression "
|
|
"mode is enabled and @code{(\".elc\" \".el\")} if Auto Compression mode is "
|
|
"disabled."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:272
|
|
msgid ""
|
|
"To summarize, @code{load} normally first tries the suffixes in the value of "
|
|
"@code{(get-load-suffixes)} and then those in @code{load-file-rep-suffixes}. "
|
|
"If @var{nosuffix} is non-@code{nil}, it skips the former group, and if "
|
|
"@var{must-suffix} is non-@code{nil}, it skips the latter group."
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:273
|
|
#, no-wrap
|
|
msgid "load-prefer-newer"
|
|
msgstr ""
|
|
|
|
#. type: defopt
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:277
|
|
msgid ""
|
|
"If this option is non-@code{nil}, then rather than stopping at the first "
|
|
"suffix that exists, @code{load} tests them all, and uses whichever file is "
|
|
"the newest."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:281
|
|
#, no-wrap
|
|
msgid "library search"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:282
|
|
#, no-wrap
|
|
msgid "find library"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:286
|
|
msgid ""
|
|
"When Emacs loads a Lisp library, it searches for the library in a list of "
|
|
"directories specified by the variable @code{load-path}."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:287
|
|
#, no-wrap
|
|
msgid "load-path"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:292
|
|
msgid ""
|
|
"The value of this variable is a list of directories to search when loading "
|
|
"files with @code{load}. Each element is a string (which must be a "
|
|
"directory) or @code{nil} (which stands for the current working directory)."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:298
|
|
msgid ""
|
|
"When Emacs starts up, it sets up the value of @code{load-path} in several "
|
|
"steps. First, it initializes @code{load-path} using default locations set "
|
|
"when Emacs was compiled. Normally, this is a directory something like"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:301
|
|
#, no-wrap
|
|
msgid "\"/usr/local/share/emacs/@var{version}/lisp\"\n"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:307
|
|
msgid ""
|
|
"(In this and the following examples, replace @file{/usr/local} with the "
|
|
"installation prefix appropriate for your Emacs.) These directories contain "
|
|
"the standard Lisp files that come with Emacs. If Emacs cannot find them, it "
|
|
"will not start correctly."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:317
|
|
msgid ""
|
|
"If you run Emacs from the directory where it was built---that is, an "
|
|
"executable that has not been formally installed---Emacs instead initializes "
|
|
"@code{load-path} using the @file{lisp} directory in the directory containing "
|
|
"the sources from which it was built. If you built Emacs in a separate "
|
|
"directory from the sources, it also adds the lisp directories from the build "
|
|
"directory. (In all cases, elements are represented as absolute file names.)"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:318
|
|
#, no-wrap
|
|
msgid "site-lisp directories"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:323
|
|
msgid ""
|
|
"Unless you start Emacs with the @option{--no-site-lisp} option, it then adds "
|
|
"two more @file{site-lisp} directories to the front of @code{load-path}. "
|
|
"These are intended for locally installed Lisp files, and are normally of the "
|
|
"form:"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:326
|
|
#, no-wrap
|
|
msgid "\"/usr/local/share/emacs/@var{version}/site-lisp\"\n"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:330
|
|
msgid "and"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:333
|
|
#, no-wrap
|
|
msgid "\"/usr/local/share/emacs/site-lisp\"\n"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:342
|
|
msgid ""
|
|
"The first one is for locally installed files for a specific Emacs version; "
|
|
"the second is for locally installed files meant for use with all installed "
|
|
"Emacs versions. (If Emacs is running uninstalled, it also adds "
|
|
"@file{site-lisp} directories from the source and build directories, if they "
|
|
"exist. Normally these directories do not contain @file{site-lisp} "
|
|
"directories.)"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:343
|
|
#, no-wrap
|
|
msgid "@env{EMACSLOADPATH} environment variable"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:347
|
|
msgid ""
|
|
"If the environment variable @env{EMACSLOADPATH} is set, it modifies the "
|
|
"above initialization procedure. Emacs initializes @code{load-path} based on "
|
|
"the value of the environment variable."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:351
|
|
msgid ""
|
|
"The syntax of @env{EMACSLOADPATH} is the same as used for @env{PATH}; "
|
|
"directories are separated by @samp{:} (or @samp{;}, on some operating "
|
|
"systems)."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:357
|
|
msgid ""
|
|
"Here is an example of how to set @env{EMACSLOADPATH} variable (from a "
|
|
"@command{sh}-style shell):"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:360
|
|
#, no-wrap
|
|
msgid "export EMACSLOADPATH=/home/foo/.emacs.d/lisp:\n"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:371
|
|
msgid ""
|
|
"An empty element in the value of the environment variable, whether trailing "
|
|
"(as in the above example), leading, or embedded, is replaced by the default "
|
|
"value of @code{load-path} as determined by the standard initialization "
|
|
"procedure. If there are no such empty elements, then @env{EMACSLOADPATH} "
|
|
"specifies the entire @code{load-path}. You must include either an empty "
|
|
"element, or the explicit path to the directory containing the standard Lisp "
|
|
"files, else Emacs will not function. (Another way to modify "
|
|
"@code{load-path} is to use the @option{-L} command-line option when starting "
|
|
"Emacs; see below.)"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:381
|
|
msgid ""
|
|
"For each directory in @code{load-path}, Emacs then checks to see if it "
|
|
"contains a file @file{subdirs.el}, and if so, loads it. The "
|
|
"@file{subdirs.el} file is created when Emacs is built/installed, and "
|
|
"contains code that causes Emacs to add any subdirectories of those "
|
|
"directories to @code{load-path}. Both immediate subdirectories and "
|
|
"subdirectories multiple levels down are added. But it excludes "
|
|
"subdirectories whose names do not start with a letter or digit, and "
|
|
"subdirectories named @file{RCS} or @file{CVS}, and subdirectories containing "
|
|
"a file named @file{.nosearch}."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:386
|
|
msgid ""
|
|
"Next, Emacs adds any extra load directories that you specify using the "
|
|
"@option{-L} command-line option (@pxref{Action Arguments,,,emacs, The GNU "
|
|
"Emacs Manual}). It also adds the directories where optional packages are "
|
|
"installed, if any (@pxref{Packaging Basics})."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:389
|
|
msgid ""
|
|
"It is common to add code to one's init file (@pxref{Init File}) to add one "
|
|
"or more directories to @code{load-path}. For example:"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:392
|
|
#, no-wrap
|
|
msgid "(push \"~/.emacs.d/lisp\" load-path)\n"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:398
|
|
msgid ""
|
|
"Dumping Emacs uses a special value of @code{load-path}. If you use a "
|
|
"@file{site-load.el} or @file{site-init.el} file to customize the dumped "
|
|
"Emacs (@pxref{Building Emacs}), any changes to @code{load-path} that these "
|
|
"files make will be lost after dumping."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:399
|
|
#, no-wrap
|
|
msgid "Command locate-library library &optional nosuffix path interactive-call"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:405
|
|
msgid ""
|
|
"This command finds the precise file name for library @var{library}. It "
|
|
"searches for the library in the same way @code{load} does, and the argument "
|
|
"@var{nosuffix} has the same meaning as in @code{load}: don't add suffixes "
|
|
"@samp{.elc} or @samp{.el} to the specified name @var{library}."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:408
|
|
msgid ""
|
|
"If the @var{path} is non-@code{nil}, that list of directories is used "
|
|
"instead of @code{load-path}."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:413
|
|
msgid ""
|
|
"When @code{locate-library} is called from a program, it returns the file "
|
|
"name as a string. When the user runs @code{locate-library} interactively, "
|
|
"the argument @var{interactive-call} is @code{t}, and this tells "
|
|
"@code{locate-library} to display the file name in the echo area."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:415
|
|
#, no-wrap
|
|
msgid "shadowed Lisp files"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:416
|
|
#, no-wrap
|
|
msgid "Command list-load-path-shadows &optional stringp"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:421
|
|
msgid ""
|
|
"This command shows a list of @dfn{shadowed} Emacs Lisp files. A shadowed "
|
|
"file is one that will not normally be loaded, despite being in a directory "
|
|
"on @code{load-path}, due to the existence of another similarly-named file in "
|
|
"a directory earlier on @code{load-path}."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:423
|
|
msgid "For instance, suppose @code{load-path} is set to"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:426
|
|
#, no-wrap
|
|
msgid " (\"/opt/emacs/site-lisp\" \"/usr/share/emacs/23.3/lisp\")\n"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:433
|
|
msgid ""
|
|
"and that both these directories contain a file named @file{foo.el}. Then "
|
|
"@code{(require 'foo)} never loads the file in the second directory. Such a "
|
|
"situation might indicate a problem in the way Emacs was installed."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:438
|
|
msgid ""
|
|
"When called from Lisp, this function prints a message listing the shadowed "
|
|
"files, instead of displaying them in a buffer. If the optional argument "
|
|
"@code{stringp} is non-@code{nil}, it instead returns the shadowed files as a "
|
|
"string."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:446
|
|
msgid ""
|
|
"If Emacs was compiled with support for native compilation (@pxref{Native "
|
|
"Compilation}), then when a @samp{.elc} byte-compiled file is found by "
|
|
"searching @code{load-path}, Emacs will try to look for a corresponding "
|
|
"@samp{.eln} file holding the corresponding natively-compiled code. The "
|
|
"natively-compiled files are looked up in the directories listed by the "
|
|
"@code{native-comp-eln-load-path}."
|
|
msgstr ""
|
|
|
|
#. type: vindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:447
|
|
#, no-wrap
|
|
msgid "comp-native-version-dir"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:448
|
|
#, no-wrap
|
|
msgid "native-comp-eln-load-path"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:460
|
|
msgid ""
|
|
"This variable holds a list of directories where Emacs looks for "
|
|
"natively-compiled @samp{.eln} files. File names in the list that are not "
|
|
"absolute are interpreted as relative to @code{invocation-directory} "
|
|
"(@pxref{System Environment}). The last directory in the list is the system "
|
|
"directory, i.e.@: the directory with @samp{.eln} files installed by the "
|
|
"Emacs build and installation procedure. In each of the directories in the "
|
|
"list, Emacs looks for @samp{.eln} files in a subdirectory whose name is "
|
|
"constructed from the Emacs version and an 8-character hash that depends on "
|
|
"the current native-compilation @acronym{ABI}; the name of this subdirectory "
|
|
"is stored in the variable @code{comp-native-version-dir}."
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:463
|
|
#, no-wrap
|
|
msgid "Loading Non-@acronym{ASCII} Characters"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:464
|
|
#, no-wrap
|
|
msgid "loading, and non-ASCII characters"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:465
|
|
#, no-wrap
|
|
msgid "non-ASCII characters in loaded files"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:477
|
|
msgid ""
|
|
"When Emacs Lisp programs contain string constants with non-@acronym{ASCII} "
|
|
"characters, these can be represented within Emacs either as unibyte strings "
|
|
"or as multibyte strings (@pxref{Text Representations}). Which "
|
|
"representation is used depends on how the file is read into Emacs. If it is "
|
|
"read with decoding into multibyte representation, the text of the Lisp "
|
|
"program will be multibyte text, and its string constants will be multibyte "
|
|
"strings. If a file containing Latin-1 characters (for example) is read "
|
|
"without decoding, the text of the program will be unibyte text, and its "
|
|
"string constants will be unibyte strings. @xref{Coding Systems}."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:487
|
|
msgid ""
|
|
"In most Emacs Lisp programs, the fact that non-@acronym{ASCII} strings are "
|
|
"multibyte strings should not be noticeable, since inserting them in unibyte "
|
|
"buffers converts them to unibyte automatically. However, if this does make "
|
|
"a difference, you can force a particular Lisp file to be interpreted as "
|
|
"unibyte by writing @samp{coding: raw-text} in a local variables section. "
|
|
"With that designator, the file will unconditionally be interpreted as "
|
|
"unibyte. This can matter when making keybindings to non-@acronym{ASCII} "
|
|
"characters written as @code{?v@var{literal}}."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:490
|
|
#, no-wrap
|
|
msgid "autoload"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:500
|
|
msgid ""
|
|
"The @dfn{autoload} facility lets you register the existence of a function or "
|
|
"macro, but put off loading the file that defines it. The first call to the "
|
|
"function automatically loads the proper library, in order to install the "
|
|
"real definition and other associated code, then runs the real definition as "
|
|
"if it had been loaded all along. Autoloading can also be triggered by "
|
|
"looking up the documentation of the function or macro (@pxref{Documentation "
|
|
"Basics}), and completion of variable and function names (@pxref{Autoload by "
|
|
"Prefix} below)."
|
|
msgstr ""
|
|
|
|
#. type: subsection
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:504
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:740
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:741
|
|
#, no-wrap
|
|
msgid "Autoload by Prefix"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:504
|
|
msgid "Autoload by Prefix."
|
|
msgstr ""
|
|
|
|
#. type: node
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:504
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:759
|
|
#, no-wrap
|
|
msgid "When to Autoload"
|
|
msgstr ""
|
|
|
|
#. type: menuentry
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:504
|
|
msgid "When to Use Autoload."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:515
|
|
msgid ""
|
|
"There are two ways to set up an autoloaded function: by calling "
|
|
"@code{autoload}, and by writing a ``magic'' comment in the source before the "
|
|
"real definition. @code{autoload} is the low-level primitive for "
|
|
"autoloading; any Lisp program can call @code{autoload} at any time. Magic "
|
|
"comments are the most convenient way to make a function autoload, for "
|
|
"packages installed along with Emacs. These comments do nothing on their "
|
|
"own, but they serve as a guide for the command @code{update-file-autoloads}, "
|
|
"which constructs calls to @code{autoload} and arranges to execute them when "
|
|
"Emacs is built."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:516
|
|
#, no-wrap
|
|
msgid "autoload function filename &optional docstring interactive type"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:520
|
|
msgid ""
|
|
"This function defines the function (or macro) named @var{function} so as to "
|
|
"load automatically from @var{filename}. The string @var{filename} specifies "
|
|
"the file to load to get the real definition of @var{function}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:526
|
|
msgid ""
|
|
"If @var{filename} does not contain either a directory name, or the suffix "
|
|
"@code{.el} or @code{.elc}, this function insists on adding one of these "
|
|
"suffixes, and it will not load from a file whose name is just @var{filename} "
|
|
"with no added suffix. (The variable @code{load-suffixes} specifies the "
|
|
"exact required suffixes.)"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:534
|
|
msgid ""
|
|
"The argument @var{docstring} is the documentation string for the function. "
|
|
"Specifying the documentation string in the call to @code{autoload} makes it "
|
|
"possible to look at the documentation without loading the function's real "
|
|
"definition. Normally, this should be identical to the documentation string "
|
|
"in the function definition itself. If it isn't, the function definition's "
|
|
"documentation string takes effect when it is loaded."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:541
|
|
msgid ""
|
|
"If @var{interactive} is non-@code{nil}, that says @var{function} can be "
|
|
"called interactively. This lets completion in @kbd{M-x} work without "
|
|
"loading @var{function}'s real definition. The complete interactive "
|
|
"specification is not given here; it's not needed unless the user actually "
|
|
"calls @var{function}, and when that happens, it's time to load the real "
|
|
"definition."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:544
|
|
msgid ""
|
|
"If @var{interactive} is a list, it is interpreted as a list of modes this "
|
|
"command is applicable for."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:550
|
|
msgid ""
|
|
"You can autoload macros and keymaps as well as ordinary functions. Specify "
|
|
"@var{type} as @code{macro} if @var{function} is really a macro. Specify "
|
|
"@var{type} as @code{keymap} if @var{function} is really a keymap. Various "
|
|
"parts of Emacs need to know this information without loading the real "
|
|
"definition."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:557
|
|
msgid ""
|
|
"An autoloaded keymap loads automatically during key lookup when a prefix "
|
|
"key's binding is the symbol @var{function}. Autoloading does not occur for "
|
|
"other kinds of access to the keymap. In particular, it does not happen when "
|
|
"a Lisp program gets the keymap from the value of a variable and calls "
|
|
"@code{define-key}; not even if the variable name is the same symbol "
|
|
"@var{function}."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:558
|
|
#, no-wrap
|
|
msgid "function cell in autoload"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:564
|
|
msgid ""
|
|
"If @var{function} already has a non-void function definition that is not an "
|
|
"autoload object, this function does nothing and returns @code{nil}. "
|
|
"Otherwise, it constructs an autoload object (@pxref{Autoload Type}), and "
|
|
"stores it as the function definition for @var{function}. The autoload "
|
|
"object has this form:"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:567
|
|
#, no-wrap
|
|
msgid "(autoload @var{filename} @var{docstring} @var{interactive} @var{type})\n"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:570
|
|
msgid "For example,"
|
|
msgstr ""
|
|
|
|
#. type: group
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:575
|
|
#, no-wrap
|
|
msgid ""
|
|
"(symbol-function 'run-prolog)\n"
|
|
" @result{} (autoload \"prolog\" 169681 t nil)\n"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:584
|
|
msgid ""
|
|
"In this case, @code{\"prolog\"} is the name of the file to load, 169681 "
|
|
"refers to the documentation string in the @file{emacs/etc/DOC} file "
|
|
"(@pxref{Documentation Basics}), @code{t} means the function is interactive, "
|
|
"and @code{nil} that it is not a macro or a keymap."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:586
|
|
#, no-wrap
|
|
msgid "autoloadp object"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:590
|
|
msgid ""
|
|
"This function returns non-@code{nil} if @var{object} is an autoload object. "
|
|
"For example, to check if @code{run-prolog} is defined as an autoloaded "
|
|
"function, evaluate"
|
|
msgstr ""
|
|
|
|
#. type: smallexample
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:593
|
|
#, no-wrap
|
|
msgid "(autoloadp (symbol-function 'run-prolog))\n"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:596
|
|
#, no-wrap
|
|
msgid "autoload errors"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:606
|
|
msgid ""
|
|
"The autoloaded file usually contains other definitions and may require or "
|
|
"provide one or more features. If the file is not completely loaded (due to "
|
|
"an error in the evaluation of its contents), any function definitions or "
|
|
"@code{provide} calls that occurred during the load are undone. This is to "
|
|
"ensure that the next attempt to call any function autoloading from this file "
|
|
"will try again to load the file. If not for this, then some of the "
|
|
"functions in the file might be defined by the aborted load, but fail to work "
|
|
"properly for the lack of certain subroutines not loaded successfully because "
|
|
"they come later in the file."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:610
|
|
msgid ""
|
|
"If the autoloaded file fails to define the desired Lisp function or macro, "
|
|
"then an error is signaled with data @code{\"Autoloading failed to define "
|
|
"function @var{function-name}\"}."
|
|
msgstr ""
|
|
|
|
#. type: findex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:611
|
|
#, no-wrap
|
|
msgid "update-file-autoloads"
|
|
msgstr ""
|
|
|
|
#. type: findex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:612
|
|
#, no-wrap
|
|
msgid "make-directory-autoloads"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:613
|
|
#, no-wrap
|
|
msgid "magic autoload comment"
|
|
msgstr ""
|
|
|
|
#. type: anchor{#1}
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:614
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:627
|
|
#, no-wrap
|
|
msgid "autoload cookie"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:627
|
|
msgid ""
|
|
"A magic autoload comment (often called an @dfn{autoload cookie}) consists "
|
|
"of @samp{;;;###autoload}, on a line by itself, just before the real "
|
|
"definition of the function in its autoloadable source file. The command "
|
|
"@kbd{M-x update-file-autoloads} writes a corresponding @code{autoload} call "
|
|
"into @file{loaddefs.el}. (The string that serves as the autoload cookie and "
|
|
"the name of the file generated by @code{update-file-autoloads} can be "
|
|
"changed from the above defaults, see below.) Building Emacs loads "
|
|
"@file{loaddefs.el} and thus calls @code{autoload}. @kbd{M-x "
|
|
"make-directory-autoloads} is even more powerful; it updates autoloads for "
|
|
"all files in the current directory."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:634
|
|
msgid ""
|
|
"The same magic comment can copy any kind of form into @file{loaddefs.el}. "
|
|
"The form following the magic comment is copied verbatim, @emph{except} if it "
|
|
"is one of the forms which the autoload facility handles specially (e.g., by "
|
|
"conversion into an @code{autoload} call). The forms which are not copied "
|
|
"verbatim are the following:"
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:636
|
|
#, no-wrap
|
|
msgid "Definitions for function or function-like objects:"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:641
|
|
msgid ""
|
|
"@code{defun} and @code{defmacro}; also @code{cl-defun} and "
|
|
"@code{cl-defmacro} (@pxref{Argument Lists,,,cl,Common Lisp Extensions}), and "
|
|
"@code{define-overloadable-function} (see the commentary in "
|
|
"@file{mode-local.el})."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:642
|
|
#, no-wrap
|
|
msgid "Definitions for major or minor modes:"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:648
|
|
msgid ""
|
|
"@code{define-minor-mode}, @code{define-globalized-minor-mode}, "
|
|
"@code{define-generic-mode}, @code{define-derived-mode}, "
|
|
"@code{easy-mmode-define-minor-mode}, @code{easy-mmode-define-global-mode}, "
|
|
"@code{define-compilation-mode}, and @code{define-global-minor-mode}."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:649
|
|
#, no-wrap
|
|
msgid "Other definition types:"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:653
|
|
msgid ""
|
|
"@code{defcustom}, @code{defgroup}, @code{defclass} "
|
|
"(@pxref{Top,EIEIO,,eieio,EIEIO}), and @code{define-skeleton} "
|
|
"(@pxref{Top,Autotyping,,autotype,Autotyping})."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:661
|
|
msgid ""
|
|
"You can also use a magic comment to execute a form at build time "
|
|
"@emph{without} executing it when the file itself is loaded. To do this, "
|
|
"write the form @emph{on the same line} as the magic comment. Since it is in "
|
|
"a comment, it does nothing when you load the source file; but @kbd{M-x "
|
|
"update-file-autoloads} copies it to @file{loaddefs.el}, where it is executed "
|
|
"while building Emacs."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:664
|
|
msgid ""
|
|
"The following example shows how @code{doctor} is prepared for autoloading "
|
|
"with a magic comment:"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:672
|
|
#, no-wrap
|
|
msgid ""
|
|
";;;###autoload\n"
|
|
"(defun doctor ()\n"
|
|
" \"Switch to *doctor* buffer and start giving psychotherapy.\"\n"
|
|
" (interactive)\n"
|
|
" (switch-to-buffer \"*doctor*\")\n"
|
|
" (doctor-mode))\n"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:676
|
|
msgid "Here's what that produces in @file{loaddefs.el}:"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:680
|
|
#, no-wrap
|
|
msgid ""
|
|
"(autoload 'doctor \"doctor\" \"\\\n"
|
|
"Switch to *doctor* buffer and start giving psychotherapy.\n"
|
|
"\n"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:682
|
|
#, no-wrap
|
|
msgid "\\(fn)\" t nil)\n"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:685
|
|
#, no-wrap
|
|
msgid "@code{fn} in function's documentation string"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:694
|
|
msgid ""
|
|
"The backslash and newline immediately following the double-quote are a "
|
|
"convention used only in the preloaded uncompiled Lisp files such as "
|
|
"@file{loaddefs.el}; they tell @code{make-docfile} to put the documentation "
|
|
"string in the @file{etc/DOC} file. @xref{Building Emacs}. See also the "
|
|
"commentary in @file{lib-src/make-docfile.c}. @samp{(fn)} in the usage part "
|
|
"of the documentation string is replaced with the function's name when the "
|
|
"various help functions (@pxref{Help Functions}) display it."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:700
|
|
msgid ""
|
|
"If you write a function definition with an unusual macro that is not one of "
|
|
"the known and recognized function definition methods, use of an ordinary "
|
|
"magic autoload comment would copy the whole definition into "
|
|
"@code{loaddefs.el}. That is not desirable. You can put the desired "
|
|
"@code{autoload} call into @code{loaddefs.el} instead by writing this:"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:705
|
|
#, no-wrap
|
|
msgid ""
|
|
";;;###autoload (autoload 'foo \"myfile\")\n"
|
|
"(mydefunmacro foo\n"
|
|
" ...)\n"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:711
|
|
msgid ""
|
|
"You can use a non-default string as the autoload cookie and have the "
|
|
"corresponding autoload calls written into a file whose name is different "
|
|
"from the default @file{loaddefs.el}. Emacs provides two variables to "
|
|
"control this:"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:712
|
|
#, no-wrap
|
|
msgid "generate-autoload-cookie"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:717
|
|
msgid ""
|
|
"The value of this variable should be a string whose syntax is a Lisp "
|
|
"comment. @kbd{M-x update-file-autoloads} copies the Lisp form that follows "
|
|
"the cookie into the autoload file it generates. The default value of this "
|
|
"variable is @code{\";;;###autoload\"}."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:719
|
|
#, no-wrap
|
|
msgid "generated-autoload-file"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:725
|
|
msgid ""
|
|
"The value of this variable names an Emacs Lisp file where the autoload calls "
|
|
"should go. The default value is @file{loaddefs.el}, but you can override "
|
|
"that, e.g., in the local variables section of a @file{.el} file (@pxref{File "
|
|
"Local Variables}). The autoload file is assumed to contain a trailer "
|
|
"starting with a formfeed character."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:729
|
|
msgid ""
|
|
"The following function may be used to explicitly load the library specified "
|
|
"by an autoload object:"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:730
|
|
#, no-wrap
|
|
msgid "autoload-do-load autoload &optional name macro-only"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:738
|
|
msgid ""
|
|
"This function performs the loading specified by @var{autoload}, which should "
|
|
"be an autoload object. The optional argument @var{name}, if non-@code{nil}, "
|
|
"should be a symbol whose function value is @var{autoload}; in that case, the "
|
|
"return value of this function is the symbol's new function value. If the "
|
|
"value of the optional argument @var{macro-only} is @code{macro}, this "
|
|
"function avoids loading a function, only a macro."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:742
|
|
#, no-wrap
|
|
msgid "autoload by prefix"
|
|
msgstr ""
|
|
|
|
#. type: vindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:744
|
|
#, no-wrap
|
|
msgid "definition-prefixes"
|
|
msgstr ""
|
|
|
|
#. type: findex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:745
|
|
#, no-wrap
|
|
msgid "register-definition-prefixes"
|
|
msgstr ""
|
|
|
|
#. type: vindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:746
|
|
#, no-wrap
|
|
msgid "autoload-compute-prefixes"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:758
|
|
msgid ""
|
|
"During completion for the commands @code{describe-variable} and "
|
|
"@code{describe-function}, Emacs will try to load files which may contain "
|
|
"definitions matching the prefix being completed. The variable "
|
|
"@code{definition-prefixes} holds a hashtable which maps a prefix to the "
|
|
"corresponding list of files to load for it. Entries to this mapping are "
|
|
"added by calls to @code{register-definition-prefixes} which are generated by "
|
|
"@code{update-file-autoloads} (@pxref{Autoload}). Files which don't contain "
|
|
"any definitions worth loading (test files, for examples), should set "
|
|
"@code{autoload-compute-prefixes} to @code{nil} as a file-local variable."
|
|
msgstr ""
|
|
|
|
#. type: subsection
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:760
|
|
#, no-wrap
|
|
msgid "When to Use Autoload"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:761
|
|
#, no-wrap
|
|
msgid "autoload, when to use"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:768
|
|
msgid ""
|
|
"Do not add an autoload comment unless it is really necessary. Autoloading "
|
|
"code means it is always globally visible. Once an item is autoloaded, there "
|
|
"is no compatible way to transition back to it not being autoloaded (after "
|
|
"people become accustomed to being able to use it without an explicit load)."
|
|
msgstr ""
|
|
|
|
#. type: itemize
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:776
|
|
msgid ""
|
|
"The most common items to autoload are the interactive entry points to a "
|
|
"library. For example, if @file{python.el} is a library defining a "
|
|
"major-mode for editing Python code, autoload the definition of the "
|
|
"@code{python-mode} function, so that people can simply use @kbd{M-x "
|
|
"python-mode} to load the library."
|
|
msgstr ""
|
|
|
|
#. type: itemize
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:782
|
|
msgid ""
|
|
"Variables usually don't need to be autoloaded. An exception is if the "
|
|
"variable on its own is generally useful without the whole defining library "
|
|
"being loaded. (An example of this might be something like "
|
|
"@code{find-exec-terminator}.)"
|
|
msgstr ""
|
|
|
|
#. type: itemize
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:785
|
|
msgid "Don't autoload a user option just so that a user can set it."
|
|
msgstr ""
|
|
|
|
#. type: itemize
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:793
|
|
msgid ""
|
|
"Never add an autoload @emph{comment} to silence a compiler warning in "
|
|
"another file. In the file that produces the warning, use @code{(defvar "
|
|
"foo)} to silence an undefined variable warning, and @code{declare-function} "
|
|
"(@pxref{Declaring Functions}) to silence an undefined function warning; or "
|
|
"require the relevant library; or use an explicit autoload @emph{statement}."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:797
|
|
#, no-wrap
|
|
msgid "repeated loading"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:803
|
|
msgid ""
|
|
"You can load a given file more than once in an Emacs session. For example, "
|
|
"after you have rewritten and reinstalled a function definition by editing it "
|
|
"in a buffer, you may wish to return to the original version; you can do this "
|
|
"by reloading the file it came from."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:812
|
|
msgid ""
|
|
"When you load or reload files, bear in mind that the @code{load} and "
|
|
"@code{load-library} functions automatically load a byte-compiled file rather "
|
|
"than a non-compiled file of similar name. If you rewrite a file that you "
|
|
"intend to save and reinstall, you need to byte-compile the new version; "
|
|
"otherwise Emacs will load the older, byte-compiled file instead of your "
|
|
"newer, non-compiled file! If that happens, the message displayed when "
|
|
"loading the file includes, @samp{(compiled; note, source is newer)}, to "
|
|
"remind you to recompile it."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:818
|
|
msgid ""
|
|
"When writing the forms in a Lisp library file, keep in mind that the file "
|
|
"might be loaded more than once. For example, think about whether each "
|
|
"variable should be reinitialized when you reload the library; @code{defvar} "
|
|
"does not change the value if the variable is already initialized. "
|
|
"(@xref{Defining Variables}.)"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:820
|
|
msgid "The simplest way to add an element to an alist is like this:"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:823
|
|
#, no-wrap
|
|
msgid "(push '(leif-mode \" Leif\") minor-mode-alist)\n"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:828
|
|
msgid ""
|
|
"But this would add multiple elements if the library is reloaded. To avoid "
|
|
"the problem, use @code{add-to-list} (@pxref{List Variables}):"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:831
|
|
#, no-wrap
|
|
msgid "(add-to-list 'minor-mode-alist '(leif-mode \" Leif\"))\n"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:838
|
|
msgid ""
|
|
"Occasionally you will want to test explicitly whether a library has already "
|
|
"been loaded. If the library uses @code{provide} to provide a named feature, "
|
|
"you can use @code{featurep} earlier in the file to test whether the "
|
|
"@code{provide} call has been executed before (@pxref{Named Features}). "
|
|
"Alternatively, you could use something like this:"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:841
|
|
#, no-wrap
|
|
msgid ""
|
|
"(defvar foo-was-loaded nil)\n"
|
|
"\n"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:845
|
|
#, no-wrap
|
|
msgid ""
|
|
"(unless foo-was-loaded\n"
|
|
" @var{execute-first-time-only}\n"
|
|
" (setq foo-was-loaded t))\n"
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:850
|
|
#, no-wrap
|
|
msgid "Features"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:851
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1008
|
|
#, no-wrap
|
|
msgid "features"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:852
|
|
#, no-wrap
|
|
msgid "requiring features"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:853
|
|
#, no-wrap
|
|
msgid "providing features"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:860
|
|
msgid ""
|
|
"@code{provide} and @code{require} are an alternative to @code{autoload} for "
|
|
"loading files automatically. They work in terms of named @dfn{features}. "
|
|
"Autoloading is triggered by calling a specific function, but a feature is "
|
|
"loaded the first time another program asks for it by name."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:866
|
|
msgid ""
|
|
"A feature name is a symbol that stands for a collection of functions, "
|
|
"variables, etc. The file that defines them should @dfn{provide} the "
|
|
"feature. Another program that uses them may ensure they are defined by "
|
|
"@dfn{requiring} the feature. This loads the file of definitions if it "
|
|
"hasn't been loaded already."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:867
|
|
#, no-wrap
|
|
msgid "load error with require"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:874
|
|
msgid ""
|
|
"To require the presence of a feature, call @code{require} with the feature "
|
|
"name as argument. @code{require} looks in the global variable "
|
|
"@code{features} to see whether the desired feature has been provided "
|
|
"already. If not, it loads the feature from the appropriate file. This file "
|
|
"should call @code{provide} at the top level to add the feature to "
|
|
"@code{features}; if it fails to do so, @code{require} signals an error."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:877
|
|
msgid ""
|
|
"For example, in @file{idlwave.el}, the definition for "
|
|
"@code{idlwave-complete-filename} includes the following code:"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:886
|
|
#, no-wrap
|
|
msgid ""
|
|
"(defun idlwave-complete-filename ()\n"
|
|
" \"Use the comint stuff to complete a file name.\"\n"
|
|
" (require 'comint)\n"
|
|
" (let* ((comint-file-name-chars \"~/A-Za-z0-9+@@:_.$#%=@{@}\\\\-\")\n"
|
|
" (comint-completion-addsuffix nil)\n"
|
|
" ...)\n"
|
|
" (comint-dynamic-complete-filename)))\n"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:898
|
|
msgid ""
|
|
"The expression @code{(require 'comint)} loads the file @file{comint.el} if "
|
|
"it has not yet been loaded, ensuring that "
|
|
"@code{comint-dynamic-complete-filename} is defined. Features are normally "
|
|
"named after the files that provide them, so that @code{require} need not be "
|
|
"given the file name. (Note that it is important that the @code{require} "
|
|
"statement be outside the body of the @code{let}. Loading a library while "
|
|
"its variables are let-bound can have unintended consequences, namely the "
|
|
"variables becoming unbound after the let exits.)"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:900
|
|
msgid "The @file{comint.el} file contains the following top-level expression:"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:903
|
|
#, no-wrap
|
|
msgid "(provide 'comint)\n"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:909
|
|
msgid ""
|
|
"This adds @code{comint} to the global @code{features} list, so that "
|
|
"@code{(require 'comint)} will henceforth know that nothing needs to be done."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:910
|
|
#, no-wrap
|
|
msgid "byte-compiling @code{require}"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:917
|
|
msgid ""
|
|
"When @code{require} is used at top level in a file, it takes effect when you "
|
|
"byte-compile that file (@pxref{Byte Compilation}) as well as when you load "
|
|
"it. This is in case the required package contains macros that the byte "
|
|
"compiler must know about. It also avoids byte compiler warnings for "
|
|
"functions and variables defined in the file loaded with @code{require}."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:923
|
|
msgid ""
|
|
"Although top-level calls to @code{require} are evaluated during byte "
|
|
"compilation, @code{provide} calls are not. Therefore, you can ensure that a "
|
|
"file of definitions is loaded before it is byte-compiled by including a "
|
|
"@code{provide} followed by a @code{require} for the same feature, as in the "
|
|
"following example."
|
|
msgstr ""
|
|
|
|
#. type: group
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:929
|
|
#, no-wrap
|
|
msgid ""
|
|
"(provide 'my-feature) ; @r{Ignored by byte compiler,}\n"
|
|
" ; @r{evaluated by @code{load}.}\n"
|
|
"(require 'my-feature) ; @r{Evaluated by byte compiler.}\n"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:937
|
|
msgid ""
|
|
"The compiler ignores the @code{provide}, then processes the @code{require} "
|
|
"by loading the file in question. Loading the file does execute the "
|
|
"@code{provide} call, so the subsequent @code{require} call does nothing when "
|
|
"the file is loaded."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:938
|
|
#, no-wrap
|
|
msgid "provide feature &optional subfeatures"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:943
|
|
msgid ""
|
|
"This function announces that @var{feature} is now loaded, or being loaded, "
|
|
"into the current Emacs session. This means that the facilities associated "
|
|
"with @var{feature} are or will be available for other Lisp programs."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:949
|
|
msgid ""
|
|
"The direct effect of calling @code{provide} is to add @var{feature} to the "
|
|
"front of @code{features} if it is not already in that list and call any "
|
|
"@code{eval-after-load} code waiting for it (@pxref{Hooks for Loading}). The "
|
|
"argument @var{feature} must be a symbol. @code{provide} returns "
|
|
"@var{feature}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:959
|
|
msgid ""
|
|
"If provided, @var{subfeatures} should be a list of symbols indicating a set "
|
|
"of specific subfeatures provided by this version of @var{feature}. You can "
|
|
"test the presence of a subfeature using @code{featurep}. The idea of "
|
|
"subfeatures is that you use them when a package (which is one @var{feature}) "
|
|
"is complex enough to make it useful to give names to various parts or "
|
|
"functionalities of the package, which might or might not be loaded, or might "
|
|
"or might not be present in a given version. @xref{Network Feature Testing}, "
|
|
"for an example."
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:963
|
|
#, no-wrap
|
|
msgid ""
|
|
"features\n"
|
|
" @result{} (bar bish)\n"
|
|
"\n"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:968
|
|
#, no-wrap
|
|
msgid ""
|
|
"(provide 'foo)\n"
|
|
" @result{} foo\n"
|
|
"features\n"
|
|
" @result{} (foo bar bish)\n"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:974
|
|
msgid ""
|
|
"When a file is loaded to satisfy an autoload, and it stops due to an error "
|
|
"in the evaluation of its contents, any function definitions or "
|
|
"@code{provide} calls that occurred during the load are undone. "
|
|
"@xref{Autoload}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:976
|
|
#, no-wrap
|
|
msgid "require feature &optional filename noerror"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:980
|
|
msgid ""
|
|
"This function checks whether @var{feature} is present in the current Emacs "
|
|
"session (using @code{(featurep @var{feature})}; see below). The argument "
|
|
"@var{feature} must be a symbol."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:989
|
|
msgid ""
|
|
"If the feature is not present, then @code{require} loads @var{filename} with "
|
|
"@code{load}. If @var{filename} is not supplied, then the name of the symbol "
|
|
"@var{feature} is used as the base file name to load. However, in this case, "
|
|
"@code{require} insists on finding @var{feature} with an added @samp{.el} or "
|
|
"@samp{.elc} suffix (possibly extended with a compression suffix); a file "
|
|
"whose name is just @var{feature} won't be used. (The variable "
|
|
"@code{load-suffixes} specifies the exact required Lisp suffixes.)"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:994
|
|
msgid ""
|
|
"If @var{noerror} is non-@code{nil}, that suppresses errors from actual "
|
|
"loading of the file. In that case, @code{require} returns @code{nil} if "
|
|
"loading the file fails. Normally, @code{require} returns @var{feature}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:997
|
|
msgid ""
|
|
"If loading the file succeeds but does not provide @var{feature}, "
|
|
"@code{require} signals an error about the missing feature."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:999
|
|
#, no-wrap
|
|
msgid "featurep feature &optional subfeature"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1006
|
|
msgid ""
|
|
"This function returns @code{t} if @var{feature} has been provided in the "
|
|
"current Emacs session (i.e., if @var{feature} is a member of "
|
|
"@code{features}.) If @var{subfeature} is non-@code{nil}, then the function "
|
|
"returns @code{t} only if that subfeature is provided as well (i.e., if "
|
|
"@var{subfeature} is a member of the @code{subfeature} property of the "
|
|
"@var{feature} symbol.)"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1013
|
|
msgid ""
|
|
"The value of this variable is a list of symbols that are the features loaded "
|
|
"in the current Emacs session. Each symbol was put in this list with a call "
|
|
"to @code{provide}. The order of the elements in the @code{features} list is "
|
|
"not significant."
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1016
|
|
#, no-wrap
|
|
msgid "Which File Defined a Certain Symbol"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1017
|
|
#, no-wrap
|
|
msgid "symbol, where defined"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1018
|
|
#, no-wrap
|
|
msgid "where was a symbol defined"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1020
|
|
#, no-wrap
|
|
msgid "symbol-file symbol &optional type"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1026
|
|
msgid ""
|
|
"This function returns the name of the file that defined @var{symbol}. If "
|
|
"@var{type} is @code{nil}, then any kind of definition is acceptable. If "
|
|
"@var{type} is @code{defun}, @code{defvar}, or @code{defface}, that specifies "
|
|
"function definition, variable definition, or face definition only."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1031
|
|
msgid ""
|
|
"The value is normally an absolute file name. It can also be @code{nil}, if "
|
|
"the definition is not associated with any file. If @var{symbol} specifies "
|
|
"an autoloaded function, the value can be a relative file name without "
|
|
"extension."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1035
|
|
msgid ""
|
|
"The basis for @code{symbol-file} is the data in the variable "
|
|
"@code{load-history}."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1036
|
|
#, no-wrap
|
|
msgid "load-history"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1040
|
|
msgid ""
|
|
"The value of this variable is an alist that associates the names of loaded "
|
|
"library files with the names of the functions and variables they defined, as "
|
|
"well as the features they provided or required."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1045
|
|
msgid ""
|
|
"Each element in this alist describes one loaded library (including libraries "
|
|
"that are preloaded at startup). It is a list whose @sc{car} is the absolute "
|
|
"file name of the library (a string). The rest of the list elements have "
|
|
"these forms:"
|
|
msgstr ""
|
|
|
|
#. type: var{#1}
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1047
|
|
#, no-wrap
|
|
msgid "var"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1049
|
|
msgid "The symbol @var{var} was defined as a variable."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1049
|
|
#, no-wrap
|
|
msgid "(defun . @var{fun})"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1051
|
|
msgid "The function @var{fun} was defined."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1051
|
|
#, no-wrap
|
|
msgid "(t . @var{fun})"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1056
|
|
msgid ""
|
|
"The function @var{fun} was previously an autoload before this library "
|
|
"redefined it as a function. The following element is always @code{(defun "
|
|
". @var{fun})}, which represents defining @var{fun} as a function."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1056
|
|
#, no-wrap
|
|
msgid "(autoload . @var{fun})"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1058
|
|
msgid "The function @var{fun} was defined as an autoload."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1058
|
|
#, no-wrap
|
|
msgid "(defface . @var{face})"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1060
|
|
msgid "The face @var{face} was defined."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1060
|
|
#, no-wrap
|
|
msgid "(require . @var{feature})"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1062
|
|
msgid "The feature @var{feature} was required."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1062
|
|
#, no-wrap
|
|
msgid "(provide . @var{feature})"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1064
|
|
msgid "The feature @var{feature} was provided."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1064
|
|
#, no-wrap
|
|
msgid "(cl-defmethod @var{method} @var{specializers})"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1067
|
|
msgid ""
|
|
"The named @var{method} was defined by using @code{cl-defmethod}, with "
|
|
"@var{specializers} as its specializers."
|
|
msgstr ""
|
|
|
|
#. type: item
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1067
|
|
#, no-wrap
|
|
msgid "(define-type . @var{type})"
|
|
msgstr ""
|
|
|
|
#. type: table
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1069
|
|
msgid "The type @var{type} was defined."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1074
|
|
msgid ""
|
|
"The value of @code{load-history} may have one element whose @sc{car} is "
|
|
"@code{nil}. This element describes definitions made with @code{eval-buffer} "
|
|
"on a buffer that is not visiting a file."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1079
|
|
msgid ""
|
|
"The command @code{eval-region} updates @code{load-history}, but does so by "
|
|
"adding the symbols defined to the element for the file being visited, rather "
|
|
"than replacing that element. @xref{Eval}."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1082
|
|
#, no-wrap
|
|
msgid "unloading packages"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1087
|
|
msgid ""
|
|
"You can discard the functions and variables loaded by a library to reclaim "
|
|
"memory for other Lisp objects. To do this, use the function "
|
|
"@code{unload-feature}:"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1088
|
|
#, no-wrap
|
|
msgid "Command unload-feature feature &optional force"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1095
|
|
msgid ""
|
|
"This command unloads the library that provided feature @var{feature}. It "
|
|
"undefines all functions, macros, and variables defined in that library with "
|
|
"@code{defun}, @code{defalias}, @code{defsubst}, @code{defmacro}, "
|
|
"@code{defconst}, @code{defvar}, and @code{defcustom}. It then restores any "
|
|
"autoloads formerly associated with those symbols. (Loading saves these in "
|
|
"the @code{autoload} property of the symbol.)"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1104
|
|
msgid ""
|
|
"Before restoring the previous definitions, @code{unload-feature} runs "
|
|
"@code{remove-hook} to remove functions defined by the library from certain "
|
|
"hooks. These hooks include variables whose names end in @samp{-hook} (or "
|
|
"the deprecated suffix @samp{-hooks}), plus those listed in "
|
|
"@code{unload-feature-special-hooks}, as well as @code{auto-mode-alist}. "
|
|
"This is to prevent Emacs from ceasing to function because important hooks "
|
|
"refer to functions that are no longer defined."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1108
|
|
msgid ""
|
|
"Standard unloading activities also undo ELP profiling of functions in that "
|
|
"library, unprovides any features provided by the library, and cancels timers "
|
|
"held in variables defined by the library."
|
|
msgstr ""
|
|
|
|
#. type: vindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1109
|
|
#, no-wrap
|
|
msgid "@var{feature}-unload-function"
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1117
|
|
msgid ""
|
|
"If these measures are not sufficient to prevent malfunction, a library can "
|
|
"define an explicit unloader named @code{@var{feature}-unload-function}. If "
|
|
"that symbol is defined as a function, @code{unload-feature} calls it with no "
|
|
"arguments before doing anything else. It can do whatever is appropriate to "
|
|
"unload the library. If it returns @code{nil}, @code{unload-feature} "
|
|
"proceeds to take the normal unload actions. Otherwise it considers the job "
|
|
"to be done."
|
|
msgstr ""
|
|
|
|
#. type: deffn
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1123
|
|
msgid ""
|
|
"Ordinarily, @code{unload-feature} refuses to unload a library on which other "
|
|
"loaded libraries depend. (A library @var{a} depends on library @var{b} if "
|
|
"@var{a} contains a @code{require} for @var{b}.) If the optional argument "
|
|
"@var{force} is non-@code{nil}, dependencies are ignored and you can unload "
|
|
"any library."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1127
|
|
msgid ""
|
|
"The @code{unload-feature} function is written in Lisp; its actions are based "
|
|
"on the variable @code{load-history}."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1128
|
|
#, no-wrap
|
|
msgid "unload-feature-special-hooks"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1131
|
|
msgid ""
|
|
"This variable holds a list of hooks to be scanned before unloading a "
|
|
"library, to remove functions defined in the library."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1135
|
|
#, no-wrap
|
|
msgid "loading hooks"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1136
|
|
#, no-wrap
|
|
msgid "hooks for loading"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1140
|
|
msgid ""
|
|
"You can ask for code to be executed each time Emacs loads a library, by "
|
|
"using the variable @code{after-load-functions}:"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1141
|
|
#, no-wrap
|
|
msgid "after-load-functions"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1145
|
|
msgid ""
|
|
"This abnormal hook is run after loading a file. Each function in the hook "
|
|
"is called with a single argument, the absolute filename of the file that was "
|
|
"just loaded."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1149
|
|
msgid ""
|
|
"If you want code to be executed when a @emph{particular} library is loaded, "
|
|
"use the macro @code{with-eval-after-load}:"
|
|
msgstr ""
|
|
|
|
#. type: defmac
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1150
|
|
#, no-wrap
|
|
msgid "with-eval-after-load library body@dots{}"
|
|
msgstr ""
|
|
|
|
#. type: defmac
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1154
|
|
msgid ""
|
|
"This macro arranges to evaluate @var{body} at the end of loading the file "
|
|
"@var{library}, each time @var{library} is loaded. If @var{library} is "
|
|
"already loaded, it evaluates @var{body} right away."
|
|
msgstr ""
|
|
|
|
#. type: defmac
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1157
|
|
msgid ""
|
|
"You don't need to give a directory or extension in the file name "
|
|
"@var{library}. Normally, you just give a bare file name, like this:"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1160
|
|
#, no-wrap
|
|
msgid ""
|
|
"(with-eval-after-load \"js\" (define-key js-mode-map \"\\C-c\\C-c\" "
|
|
"'js-eval))\n"
|
|
msgstr ""
|
|
|
|
#. type: defmac
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1169
|
|
msgid ""
|
|
"To restrict which files can trigger the evaluation, include a directory or "
|
|
"an extension or both in @var{library}. Only a file whose absolute true name "
|
|
"(i.e., the name with all symbolic links chased out) matches all the given "
|
|
"name components will match. In the following example, @file{my_inst.elc} or "
|
|
"@file{my_inst.elc.gz} in some directory @code{..../foo/bar} will trigger the "
|
|
"evaluation, but not @file{my_inst.el}:"
|
|
msgstr ""
|
|
|
|
#. type: example
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1172
|
|
#, no-wrap
|
|
msgid "(with-eval-after-load \"foo/bar/my_inst.elc\" @dots{})\n"
|
|
msgstr ""
|
|
|
|
#. type: defmac
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1177
|
|
msgid ""
|
|
"@var{library} can also be a feature (i.e., a symbol), in which case "
|
|
"@var{body} is evaluated at the end of any file where @code{(provide "
|
|
"@var{library})} is called."
|
|
msgstr ""
|
|
|
|
#. type: defmac
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1180
|
|
msgid ""
|
|
"An error in @var{body} does not undo the load, but does prevent execution of "
|
|
"the rest of @var{body}."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1189
|
|
msgid ""
|
|
"Normally, well-designed Lisp programs should not use "
|
|
"@code{with-eval-after-load}. If you need to examine and set the variables "
|
|
"defined in another library (those meant for outside use), you can do it "
|
|
"immediately---there is no need to wait until the library is loaded. If you "
|
|
"need to call functions defined by that library, you should load the library, "
|
|
"preferably with @code{require} (@pxref{Named Features})."
|
|
msgstr ""
|
|
|
|
#. type: section
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1191
|
|
#, no-wrap
|
|
msgid "Emacs Dynamic Modules"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1192
|
|
#, no-wrap
|
|
msgid "dynamic modules"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1197
|
|
msgid ""
|
|
"A @dfn{dynamic Emacs module} is a shared library that provides additional "
|
|
"functionality for use in Emacs Lisp programs, just like a package written in "
|
|
"Emacs Lisp would."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1201
|
|
msgid ""
|
|
"Functions that load Emacs Lisp packages can also load dynamic modules. They "
|
|
"recognize dynamic modules by looking at their file-name extension, a.k.a.@: "
|
|
"``suffix''. This suffix is platform-dependent."
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1202
|
|
#, no-wrap
|
|
msgid "module-file-suffix"
|
|
msgstr ""
|
|
|
|
#. type: defvar
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1206
|
|
msgid ""
|
|
"This variable holds the system-dependent value of the file-name extension of "
|
|
"the module files. Its value is @file{.so} on POSIX hosts, @file{.dylib} on "
|
|
"macOS, and @file{.dll} on MS-Windows."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1210
|
|
msgid ""
|
|
"On macOS, dynamic modules can also have the suffix @file{.so} in addition to "
|
|
"@file{.dylib}."
|
|
msgstr ""
|
|
|
|
#. type: findex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1211
|
|
#, no-wrap
|
|
msgid "emacs_module_init"
|
|
msgstr ""
|
|
|
|
#. type: vindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1212
|
|
#, no-wrap
|
|
msgid "plugin_is_GPL_compatible"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1220
|
|
msgid ""
|
|
"Every dynamic module should export a C-callable function named "
|
|
"@code{emacs_module_init}, which Emacs will call as part of the call to "
|
|
"@code{load} or @code{require} which loads the module. It should also export "
|
|
"a symbol named @code{plugin_is_GPL_compatible} to indicate that its code is "
|
|
"released under the GPL or compatible license; Emacs will signal an error if "
|
|
"your program tries to load modules that don't export such a symbol."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1226
|
|
msgid ""
|
|
"If a module needs to call Emacs functions, it should do so through the "
|
|
"@acronym{API} (Application Programming Interface) defined and documented in "
|
|
"the header file @file{emacs-module.h} that is part of the Emacs "
|
|
"distribution. @xref{Writing Dynamic Modules}, for details of using that API "
|
|
"when writing your own modules."
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1227
|
|
#, no-wrap
|
|
msgid "user-ptr object"
|
|
msgstr ""
|
|
|
|
#. type: cindex
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1228
|
|
#, no-wrap
|
|
msgid "user pointer object"
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1237
|
|
msgid ""
|
|
"Modules can create @code{user-ptr} Lisp objects that embed pointers to C "
|
|
"struct's defined by the module. This is useful for keeping around complex "
|
|
"data structures created by a module, to be passed back to the module's "
|
|
"functions. User-ptr objects can also have associated @dfn{finalizers} -- "
|
|
"functions to be run when the object is GC'ed; this is useful for freeing any "
|
|
"resources allocated for the underlying data structure, such as memory, open "
|
|
"file descriptors, etc. @xref{Module Values}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1238
|
|
#, no-wrap
|
|
msgid "user-ptrp object"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1241
|
|
msgid "This function returns @code{t} if its argument is a @code{user-ptr} object."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1243
|
|
#, no-wrap
|
|
msgid "module-load file"
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1254
|
|
msgid ""
|
|
"Emacs calls this low-level primitive to load a module from the specified "
|
|
"@var{file} and perform the necessary initialization of the module. This is "
|
|
"the primitive which makes sure the module exports the "
|
|
"@code{plugin_is_GPL_compatible} symbol, calls the module's "
|
|
"@code{emacs_module_init} function, and signals an error if that function "
|
|
"returns an error indication, or if the use typed @kbd{C-g} during the "
|
|
"initialization. If the initialization succeeds, @code{module-load} returns "
|
|
"@code{t}. Note that @var{file} must already have the proper file-name "
|
|
"extension, as this function doesn't try looking for files with known "
|
|
"extensions, unlike @code{load}."
|
|
msgstr ""
|
|
|
|
#. type: defun
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1260
|
|
msgid ""
|
|
"Unlike @code{load}, @code{module-load} doesn't record the module in "
|
|
"@code{load-history}, doesn't print any messages, and doesn't protect against "
|
|
"recursive loads. Most users should therefore use @code{load}, "
|
|
"@code{load-file}, @code{load-library}, or @code{require} instead of "
|
|
"@code{module-load}."
|
|
msgstr ""
|
|
|
|
#. type: Plain text
|
|
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
|
|
#: Sources/doc/lispref/loading.texi:1263
|
|
msgid ""
|
|
"Loadable modules in Emacs are enabled by using the @kbd{--with-modules} "
|
|
"option at configure time."
|
|
msgstr ""
|