documentation_emacs/source/lispref/loading.texi.fr.po
2022-03-08 11:11:57 +01:00

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 ""