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

8470 lines
305 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/files.texi:6 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/files.texi:7
#, no-wrap
msgid "Files"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:14
msgid ""
"This chapter describes the Emacs Lisp functions and variables to find, "
"create, view, save, and otherwise work with files and directories. A few "
"other file-related functions are described in @ref{Buffers}, and those "
"related to backups and auto-saving are described in @ref{Backups and "
"Auto-Saving}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:20
msgid ""
"Many of the file functions take one or more arguments that are file names. "
"A file name is a string. Most of these functions expand file name arguments "
"using the function @code{expand-file-name}, so that @file{~} is handled "
"correctly, as are relative file names (including @file{../} and the empty "
"string). @xref{File Name Expansion}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:28
msgid ""
"In addition, certain @dfn{magic} file names are handled specially. For "
"example, when a remote file name is specified, Emacs accesses the file over "
"the network via an appropriate protocol. @xref{Remote Files,, Remote Files, "
"emacs, The GNU Emacs Manual}. This handling is done at a very low level, so "
"you may assume that all the functions described in this chapter accept magic "
"file names as file name arguments, except where noted. @xref{Magic File "
"Names}, for details."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:34
msgid ""
"When file I/O functions signal Lisp errors, they usually use the condition "
"@code{file-error} (@pxref{Handling Errors}). The error message is in most "
"cases obtained from the operating system, according to locale "
"@code{system-messages-locale}, and decoded using coding system "
"@code{locale-coding-system} (@pxref{Locales})."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:52
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:53
#, no-wrap
msgid "Visiting Files"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
msgid "Reading files into Emacs buffers for editing."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:327
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:328
#, no-wrap
msgid "Saving Buffers"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
msgid "Writing changed buffers back into files."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:527
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:528
#, no-wrap
msgid "Reading from Files"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
msgid "Reading files into buffers without visiting."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:601
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:602
#, no-wrap
msgid "Writing to Files"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
msgid "Writing new files from parts of buffers."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:718
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:719
#, no-wrap
msgid "File Locks"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
msgid "Locking and unlocking files, to prevent simultaneous editing by two people."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:845
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:846
#, no-wrap
msgid "Information about Files"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
msgid "Testing existence, accessibility, size of files."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1639
#, no-wrap
msgid "Changing Files"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
msgid "Renaming files, changing permissions, etc."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2022
#, no-wrap
msgid "Files and Storage"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
msgid "Surviving power and media failures"
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2044
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2045
#, no-wrap
msgid "File Names"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
msgid "Decomposing and expanding file names."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2966
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2967
#, no-wrap
msgid "Contents of Directories"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
msgid "Getting a list of the files in a directory."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3150
#, no-wrap
msgid "Create/Delete Dirs"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
msgid "Creating and Deleting Directories."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3221
#, no-wrap
msgid "Magic File Names"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
msgid "Special handling for certain file names."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3608
#, no-wrap
msgid "Format Conversion"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:50
msgid "Conversion to and from various file formats."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:54
#, no-wrap
msgid "finding files"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:55
#, no-wrap
msgid "visiting files"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:60
msgid ""
"Visiting a file means reading a file into a buffer. Once this is done, we "
"say that the buffer is @dfn{visiting} that file, and call the file @dfn{the "
"visited file} of the buffer."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:70
msgid ""
"A file and a buffer are two different things. A file is information "
"recorded permanently in the computer (unless you delete it). A buffer, on "
"the other hand, is information inside of Emacs that will vanish at the end "
"of the editing session (or when you kill the buffer). When a buffer is "
"visiting a file, it contains information copied from the file. The copy in "
"the buffer is what you modify with editing commands. Changes to the buffer "
"do not change the file; to make the changes permanent, you must @dfn{save} "
"the buffer, which means copying the altered buffer contents back into the "
"file."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:77
msgid ""
"Despite the distinction between files and buffers, people often refer to a "
"file when they mean a buffer and vice-versa. Indeed, we say, ``I am editing "
"a file'', rather than, ``I am editing a buffer that I will soon save as a "
"file of the same name''. Humans do not usually need to make the distinction "
"explicit. When dealing with a computer program, however, it is good to keep "
"the distinction in mind."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:81
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:83
#, no-wrap
msgid "Visiting Functions"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:81
msgid "The usual interface functions for visiting."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:81
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:253
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:254
#, no-wrap
msgid "Subroutines of Visiting"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:81
msgid "Lower-level subroutines that they use."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:84
#, no-wrap
msgid "Functions for Visiting Files"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:85
#, no-wrap
msgid "visiting files, functions for"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:86
#, no-wrap
msgid "how to visit files"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:93
msgid ""
"This section describes the functions normally used to visit files. For "
"historical reasons, these functions have names starting with @samp{find-} "
"rather than @samp{visit-}. @xref{Buffer File Name}, for functions and "
"variables that access the visited file name of a buffer or that find an "
"existing buffer by its visited file name."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:98
msgid ""
"In a Lisp program, if you want to look at the contents of a file but not "
"alter it, the fastest way is to use @code{insert-file-contents} in a "
"temporary buffer. Visiting the file is not necessary and takes longer. "
"@xref{Reading from Files}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:99
#, no-wrap
msgid "Command find-file filename &optional wildcards"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:103
msgid ""
"This command selects a buffer visiting the file @var{filename}, using an "
"existing buffer if there is one, and otherwise creating a new buffer and "
"reading the file into it. It also returns that buffer."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:106
msgid ""
"Aside from some technical details, the body of the @code{find-file} function "
"is basically equivalent to:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:109
#, no-wrap
msgid "(switch-to-buffer (find-file-noselect filename nil nil wildcards))\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:113
msgid "(See @code{switch-to-buffer} in @ref{Switching Buffers}.)"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:117
msgid ""
"If @var{wildcards} is non-@code{nil}, which is always true in an interactive "
"call, then @code{find-file} expands wildcard characters in @var{filename} "
"and visits all the matching files."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:120
msgid ""
"When @code{find-file} is called interactively, it prompts for @var{filename} "
"in the minibuffer."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:122
#, no-wrap
msgid "Command find-file-literally filename"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:133
msgid ""
"This command visits @var{filename}, like @code{find-file} does, but it does "
"not perform any format conversions (@pxref{Format Conversion}), character "
"code conversions (@pxref{Coding Systems}), or end-of-line conversions "
"(@pxref{Coding System Basics, End of line conversion}). The buffer visiting "
"the file is made unibyte, and its major mode is Fundamental mode, regardless "
"of the file name. File local variable specifications in the file "
"(@pxref{File Local Variables}) are ignored, and automatic decompression and "
"adding a newline at the end of the file due to @code{require-final-newline} "
"(@pxref{Saving Buffers, require-final-newline}) are also disabled."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:140
msgid ""
"Note that if Emacs already has a buffer visiting the same file "
"non-literally, it will not visit the same file literally, but instead just "
"switch to the existing buffer. If you want to be sure of accessing a file's "
"contents literally, you should create a temporary buffer and then read the "
"file contents into it using @code{insert-file-contents-literally} "
"(@pxref{Reading from Files})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:142
#, no-wrap
msgid "find-file-noselect filename &optional nowarn rawfile wildcards"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:147
msgid ""
"This function is the guts of all the file-visiting functions. It returns a "
"buffer visiting the file @var{filename}. You may make the buffer current or "
"display it in a window if you wish, but this function does not do so."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:155
msgid ""
"The function returns an existing buffer if there is one; otherwise it "
"creates a new buffer and reads the file into it. When "
"@code{find-file-noselect} uses an existing buffer, it first verifies that "
"the file has not changed since it was last visited or saved in that buffer. "
"If the file has changed, this function asks the user whether to reread the "
"changed file. If the user says @samp{yes}, any edits previously made in the "
"buffer are lost."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:161
msgid ""
"Reading the file involves decoding the file's contents (@pxref{Coding "
"Systems}), including end-of-line conversion, and format conversion "
"(@pxref{Format Conversion}). If @var{wildcards} is non-@code{nil}, then "
"@code{find-file-noselect} expands wildcard characters in @var{filename} and "
"visits all the matching files."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:167
msgid ""
"This function displays warning or advisory messages in various peculiar "
"cases, unless the optional argument @var{nowarn} is non-@code{nil}. For "
"example, if it needs to create a buffer, and there is no file named "
"@var{filename}, it displays the message @samp{(New file)} in the echo area, "
"and leaves the buffer empty."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:174
msgid ""
"The @code{find-file-noselect} function normally calls @code{after-find-file} "
"after reading the file (@pxref{Subroutines of Visiting}). That function "
"sets the buffer major mode, parses local variables, warns the user if there "
"exists an auto-save file more recent than the file just visited, and "
"finishes by running the functions in @code{find-file-hook}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:180
msgid ""
"If the optional argument @var{rawfile} is non-@code{nil}, then "
"@code{after-find-file} is not called, and the "
"@code{find-file-not-found-functions} are not run in case of failure. What's "
"more, a non-@code{nil} @var{rawfile} value suppresses coding system "
"conversion and format conversion."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:185
msgid ""
"The @code{find-file-noselect} function usually returns the buffer that is "
"visiting the file @var{filename}. But, if wildcards are actually used and "
"expanded, it returns a list of buffers that are visiting the various files."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:190
#, no-wrap
msgid ""
"(find-file-noselect \"/etc/fstab\")\n"
" @result{} #<buffer fstab>\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:194
#, no-wrap
msgid "Command find-file-other-window filename &optional wildcards"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:199
msgid ""
"This command selects a buffer visiting the file @var{filename}, but does so "
"in a window other than the selected window. It may use another existing "
"window or split a window; see @ref{Switching Buffers}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:202
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:211
msgid "When this command is called interactively, it prompts for @var{filename}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:204
#, no-wrap
msgid "Command find-file-read-only filename &optional wildcards"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:208
msgid ""
"This command selects a buffer visiting the file @var{filename}, like "
"@code{find-file}, but it marks the buffer as read-only. @xref{Read Only "
"Buffers}, for related functions and variables."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:213
#, no-wrap
msgid "find-file-wildcards"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:220
msgid ""
"If this variable is non-@code{nil}, then the various @code{find-file} "
"commands check for wildcard characters and visit all the files that match "
"them (when invoked interactively or when their @var{wildcards} argument is "
"non-@code{nil}). If this option is @code{nil}, then the @code{find-file} "
"commands ignore their @var{wildcards} argument and never treat wildcard "
"characters specially."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:222
#, no-wrap
msgid "find-file-hook"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:227
msgid ""
"The value of this variable is a list of functions to be called after a file "
"is visited. The file's local-variables specification (if any) will have "
"been processed before the hooks are run. The buffer visiting the file is "
"current when the hook functions are run."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:229
msgid "This variable is a normal hook. @xref{Hooks}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:231
#, no-wrap
msgid "find-file-not-found-functions"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:238
msgid ""
"The value of this variable is a list of functions to be called when "
"@code{find-file} or @code{find-file-noselect} is passed a nonexistent file "
"name. @code{find-file-noselect} calls these functions as soon as it detects "
"a nonexistent file. It calls them in the order of the list, until one of "
"them returns non-@code{nil}. @code{buffer-file-name} is already set up."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:241
msgid ""
"This is not a normal hook because the values of the functions are used, and "
"in many cases only some of the functions are called."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:243
#, no-wrap
msgid "find-file-literally"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:251
msgid ""
"This buffer-local variable, if set to a non-@code{nil} value, makes "
"@code{save-buffer} behave as if the buffer were visiting its file literally, "
"i.e., without conversions of any kind. The command "
"@code{find-file-literally} sets this variable's local value, but other "
"equivalent functions and commands can do that as well, e.g., to avoid "
"automatic addition of a newline at the end of the file. This variable is "
"permanent local, so it is unaffected by changes of major modes."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:259
msgid ""
"The @code{find-file-noselect} function uses two important subroutines which "
"are sometimes useful in user Lisp code: @code{create-file-buffer} and "
"@code{after-find-file}. This section explains how to use them."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:263
#, no-wrap
msgid "create-file-buffer filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:270
msgid ""
"This function creates a suitably named buffer for visiting @var{filename}, "
"and returns it. It uses @var{filename} (sans directory) as the name if "
"that name is free; otherwise, it appends a string such as @samp{<2>} to get "
"an unused name. See also @ref{Creating Buffers}. Note that the "
"@file{uniquify} library affects the result of this function. "
"@xref{Uniquify,,, emacs, The GNU Emacs Manual}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:274
msgid ""
"@strong{Please note:} @code{create-file-buffer} does @emph{not} associate "
"the new buffer with a file and does not select the buffer. It also does not "
"use the default major mode."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:279
#, no-wrap
msgid ""
"(create-file-buffer \"foo\")\n"
" @result{} #<buffer foo>\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:283
#, no-wrap
msgid ""
"(create-file-buffer \"foo\")\n"
" @result{} #<buffer foo<2>>\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:287
#, no-wrap
msgid ""
"(create-file-buffer \"foo\")\n"
" @result{} #<buffer foo<3>>\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:292
msgid ""
"This function is used by @code{find-file-noselect}. It uses "
"@code{generate-new-buffer} (@pxref{Creating Buffers})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:294
#, no-wrap
msgid ""
"after-find-file &optional error warn noauto "
"after-find-file-from-revert-buffer nomodes"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:298
msgid ""
"This function sets the buffer major mode, and parses local variables "
"(@pxref{Auto Major Mode}). It is called by @code{find-file-noselect} and by "
"the default revert function (@pxref{Reverting})."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:299
#, no-wrap
msgid "new file message"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:300
#, no-wrap
msgid "file open error"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:306
msgid ""
"If reading the file got an error because the file does not exist, but its "
"directory does exist, the caller should pass a non-@code{nil} value for "
"@var{error}. In that case, @code{after-find-file} issues a warning: "
"@samp{(New file)}. For more serious errors, the caller should usually not "
"call @code{after-find-file}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:309
msgid ""
"If @var{warn} is non-@code{nil}, then this function issues a warning if an "
"auto-save file exists and is more recent than the visited file."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:312
msgid ""
"If @var{noauto} is non-@code{nil}, that says not to enable or disable "
"Auto-Save mode. The mode remains enabled if it was enabled before."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:317
msgid ""
"If @var{after-find-file-from-revert-buffer} is non-@code{nil}, that means "
"this call was from @code{revert-buffer}. This has no direct effect, but "
"some mode functions and hook functions check the value of this variable."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:322
msgid ""
"If @var{nomodes} is non-@code{nil}, that means don't alter the buffer's "
"major mode, don't process local variables specifications in the file, and "
"don't run @code{find-file-hook}. This feature is used by "
"@code{revert-buffer} in some cases."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:325
msgid ""
"The last thing @code{after-find-file} does is call all the functions in the "
"list @code{find-file-hook}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:329
#, no-wrap
msgid "saving buffers"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:338
msgid ""
"When you edit a file in Emacs, you are actually working on a buffer that is "
"visiting that file---that is, the contents of the file are copied into the "
"buffer and the copy is what you edit. Changes to the buffer do not change "
"the file until you @dfn{save} the buffer, which means copying the contents "
"of the buffer into the file. Buffers which are not visiting a file can "
"still be ``saved'', in a sense, using functions in the buffer-local "
"@code{write-contents-functions} hook."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:339
#, no-wrap
msgid "Command save-buffer &optional backup-option"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:343
msgid ""
"This function saves the contents of the current buffer in its visited file "
"if the buffer has been modified since it was last visited or saved. "
"Otherwise it does nothing."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:349
msgid ""
"@code{save-buffer} is responsible for making backup files. Normally, "
"@var{backup-option} is @code{nil}, and @code{save-buffer} makes a backup "
"file only if this is the first save since visiting the file. Other values "
"for @var{backup-option} request the making of backup files in other "
"circumstances:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:355
msgid ""
"With an argument of 4 or 64, reflecting 1 or 3 @kbd{C-u}'s, the "
"@code{save-buffer} function marks this version of the file to be backed up "
"when the buffer is next saved."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:360
msgid ""
"With an argument of 16 or 64, reflecting 2 or 3 @kbd{C-u}'s, the "
"@code{save-buffer} function unconditionally backs up the previous version of "
"the file before saving it."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:363
msgid "With an argument of 0, unconditionally do @emph{not} make any backup file."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:366
#, no-wrap
msgid "Command save-some-buffers &optional save-silently-p pred"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:372
msgid "Definition of save-some-buffers"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:372
msgid ""
"This command saves some modified file-visiting buffers. Normally it asks "
"the user about each buffer. But if @var{save-silently-p} is non-@code{nil}, "
"it saves all the file-visiting buffers without querying the user."
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:373
#, no-wrap
msgid "save-some-buffers-default-predicate"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:386
msgid ""
"The optional @var{pred} argument provides a predicate that controls which "
"buffers to ask about (or to save silently if @var{save-silently-p} is "
"non-@code{nil}). If @var{pred} is @code{nil}, that means to use the value "
"of @code{save-some-buffers-default-predicate} instead of @var{pred}. If the "
"result is @code{nil}, it means ask only about file-visiting buffers. If it "
"is @code{t}, that means also offer to save certain other non-file "
"buffers---those that have a non-@code{nil} buffer-local value of "
"@code{buffer-offer-save} (@pxref{Killing Buffers}). A user who says "
"@samp{yes} to saving a non-file buffer is asked to specify the file name to "
"use. The @code{save-buffers-kill-emacs} function passes the value @code{t} "
"for @var{pred}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:391
msgid ""
"If the predicate is neither @code{t} nor @code{nil}, then it should be a "
"function of no arguments. It will be called in each buffer to decide "
"whether to offer to save that buffer. If it returns a non-@code{nil} value "
"in a certain buffer, that means do offer to save that buffer."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:393
#, no-wrap
msgid "Command write-file filename &optional confirm"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:401
msgid "Definition of write-file"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:401
msgid ""
"This function writes the current buffer into file @var{filename}, makes the "
"buffer visit that file, and marks it not modified. Then it renames the "
"buffer based on @var{filename}, appending a string like @samp{<2>} if "
"necessary to make a unique buffer name. It does most of this work by "
"calling @code{set-visited-file-name} (@pxref{Buffer File Name}) and "
"@code{save-buffer}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:405
msgid ""
"If @var{confirm} is non-@code{nil}, that means to ask for confirmation "
"before overwriting an existing file. Interactively, confirmation is "
"required, unless the user supplies a prefix argument."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:410
msgid ""
"If @var{filename} is a directory name (@pxref{Directory Names}), "
"@code{write-file} uses the name of the visited file, in directory "
"@var{filename}. If the buffer is not visiting a file, it uses the buffer "
"name instead."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:418
msgid ""
"Saving a buffer runs several hooks. It also performs format conversion "
"(@pxref{Format Conversion}). Note that these hooks, described below, are "
"only run by @code{save-buffer}, they are not run by other primitives and "
"functions that write buffer text to files, and in particular auto-saving "
"(@pxref{Auto-Saving}) doesn't run these hooks."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:419
#, no-wrap
msgid "write-file-functions"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:425
msgid ""
"The value of this variable is a list of functions to be called before "
"writing out a buffer to its visited file. If one of them returns "
"non-@code{nil}, the file is considered already written and the rest of the "
"functions are not called, nor is the usual code for writing the file "
"executed."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:429
msgid ""
"If a function in @code{write-file-functions} returns non-@code{nil}, it is "
"responsible for making a backup file (if that is appropriate). To do so, "
"execute the following code:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:432
#, no-wrap
msgid "(or buffer-backed-up (backup-buffer))\n"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:438
msgid ""
"You might wish to save the file modes value returned by @code{backup-buffer} "
"and use that (if non-@code{nil}) to set the mode bits of the file that you "
"write. This is what @code{save-buffer} normally does. @xref{Making "
"Backups,, Making Backup Files}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:445
msgid ""
"The hook functions in @code{write-file-functions} are also responsible for "
"encoding the data (if desired): they must choose a suitable coding system "
"and end-of-line conversion (@pxref{Lisp and Coding Systems}), perform the "
"encoding (@pxref{Explicit Encoding}), and set @code{last-coding-system-used} "
"to the coding system that was used (@pxref{Encoding and I/O})."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:453
msgid ""
"If you set this hook locally in a buffer, it is assumed to be associated "
"with the file or the way the contents of the buffer were obtained. Thus the "
"variable is marked as a permanent local, so that changing the major mode "
"does not alter a buffer-local value. On the other hand, calling "
"@code{set-visited-file-name} will reset it. If this is not what you want, "
"you might like to use @code{write-contents-functions} instead."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:456
msgid ""
"Even though this is not a normal hook, you can use @code{add-hook} and "
"@code{remove-hook} to manipulate the list. @xref{Hooks}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:458
#, no-wrap
msgid "write-contents-functions"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:467
msgid ""
"This works just like @code{write-file-functions}, but it is intended for "
"hooks that pertain to the buffer's contents, not to the particular visited "
"file or its location, and can be used to create arbitrary save processes for "
"buffers that aren't visiting files at all. Such hooks are usually set up by "
"major modes, as buffer-local bindings for this variable. This variable "
"automatically becomes buffer-local whenever it is set; switching to a new "
"major mode always resets this variable, but calling "
"@code{set-visited-file-name} does not."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:471
msgid ""
"If any of the functions in this hook returns non-@code{nil}, the file is "
"considered already written and the rest are not called and neither are the "
"functions in @code{write-file-functions}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:478
msgid ""
"When using this hook to save buffers that are not visiting files (for "
"instance, special-mode buffers), keep in mind that, if the function fails to "
"save correctly and returns a @code{nil} value, @code{save-buffer} will go on "
"to prompt the user for a file to save the buffer in. If this is "
"undesirable, consider having the function fail by raising an error."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:480
#, no-wrap
msgid "before-save-hook"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:486
msgid ""
"This normal hook runs before a buffer is saved in its visited file, "
"regardless of whether that is done normally or by one of the hooks described "
"above. For instance, the @file{copyright.el} program uses this hook to make "
"sure the file you are saving has the current year in its copyright notice."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:488
#, no-wrap
msgid "after-save-hook"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:490
msgid "This normal hook runs after a buffer has been saved in its visited file."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:492
#, no-wrap
msgid "file-precious-flag"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:499
msgid ""
"If this variable is non-@code{nil}, then @code{save-buffer} protects against "
"I/O errors while saving by writing the new file to a temporary name instead "
"of the name it is supposed to have, and then renaming it to the intended "
"name after it is clear there are no errors. This procedure prevents "
"problems such as a lack of disk space from resulting in an invalid file."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:503
msgid ""
"As a side effect, backups are necessarily made by copying. @xref{Rename or "
"Copy}. Yet, at the same time, saving a precious file always breaks all hard "
"links between the file you save and other file names."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:506
msgid ""
"Some modes give this variable a non-@code{nil} buffer-local value in "
"particular buffers."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:508
#, no-wrap
msgid "require-final-newline"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:518
msgid ""
"This variable determines whether files may be written out that do @emph{not} "
"end with a newline. If the value of the variable is @code{t}, then "
"@code{save-buffer} silently adds a newline at the end of the buffer whenever "
"it does not already end in one. If the value is @code{visit}, Emacs adds a "
"missing newline just after it visits the file. If the value is "
"@code{visit-save}, Emacs adds a missing newline both on visiting and on "
"saving. For any other non-@code{nil} value, @code{save-buffer} asks the "
"user whether to add a newline each time the case arises."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:522
msgid ""
"If the value of the variable is @code{nil}, then @code{save-buffer} doesn't "
"add newlines at all. @code{nil} is the default value, but a few major modes "
"set it to @code{t} in particular buffers."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:526
msgid ""
"See also the function @code{set-visited-file-name} (@pxref{Buffer File "
"Name})."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:529
#, no-wrap
msgid "reading from files"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:534
msgid ""
"To copy the contents of a file into a buffer, use the function "
"@code{insert-file-contents}. (Don't use the command @code{insert-file} in a "
"Lisp program, as that sets the mark.)"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:535
#, no-wrap
msgid "insert-file-contents filename &optional visit beg end replace"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:540
msgid ""
"This function inserts the contents of file @var{filename} into the current "
"buffer after point. It returns a list of the absolute file name and the "
"length of the data inserted. An error is signaled if @var{filename} is not "
"the name of a file that can be read."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:550
msgid ""
"This function checks the file contents against the defined file formats, and "
"converts the file contents if appropriate and also calls the functions in "
"the list @code{after-insert-file-functions}. @xref{Format Conversion}. "
"Normally, one of the functions in the @code{after-insert-file-functions} "
"list determines the coding system (@pxref{Coding Systems}) used for decoding "
"the file's contents, including end-of-line conversion. However, if the file "
"contains null bytes, it is by default visited without any code conversions. "
"@xref{Lisp and Coding Systems, inhibit-null-byte-detection}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:556
msgid ""
"If @var{visit} is non-@code{nil}, this function additionally marks the "
"buffer as unmodified and sets up various fields in the buffer so that it is "
"visiting the file @var{filename}: these include the buffer's visited file "
"name and its last save file modtime. This feature is used by "
"@code{find-file-noselect} and you probably should not use it yourself."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:560
msgid ""
"If @var{beg} and @var{end} are non-@code{nil}, they should be numbers that "
"are byte offsets specifying the portion of the file to insert. In this "
"case, @var{visit} must be @code{nil}. For example,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:563
#, no-wrap
msgid "(insert-file-contents filename nil 0 500)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:567
msgid "inserts the characters coded by the first 500 bytes of a file."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:577
msgid ""
"If @var{beg} or @var{end} happens to be in the middle of a character's "
"multibyte sequence, Emacs's character code conversion will insert one or "
"more eight-bit characters (a.k.a.@: ``raw bytes'') (@pxref{Character Sets}) "
"into the buffer. If you want to read part of a file this way, we recommend "
"to bind @code{coding-system-for-read} to a suitable value around the call to "
"this function (@pxref{Specifying Coding Systems}), and to write Lisp code "
"which will check for raw bytes at the boundaries, read the entire sequence "
"of these bytes, and convert them back to valid characters."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:583
msgid ""
"If the argument @var{replace} is non-@code{nil}, it means to replace the "
"contents of the buffer (actually, just the accessible portion) with the "
"contents of the file. This is better than simply deleting the buffer "
"contents and inserting the whole file, because (1) it preserves some marker "
"positions and (2) it puts less data in the undo list."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:587
msgid ""
"It is possible to read a special file (such as a FIFO or an I/O device) "
"with @code{insert-file-contents}, as long as @var{replace} and @var{visit} "
"are @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:589
#, no-wrap
msgid "insert-file-contents-literally filename &optional visit beg end replace"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:595
msgid ""
"This function works like @code{insert-file-contents} except that each byte "
"in the file is handled separately, being converted into an eight-bit "
"character if needed. It does not run @code{after-insert-file-functions}, "
"and does not do format decoding, character code conversion, automatic "
"uncompression, and so on."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:600
msgid ""
"If you want to pass a file name to another process so that another program "
"can read the file, use the function @code{file-local-copy}; see @ref{Magic "
"File Names}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:603
#, no-wrap
msgid "writing to files"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:610
msgid ""
"You can write the contents of a buffer, or part of a buffer, directly to a "
"file on disk using the @code{append-to-file} and @code{write-region} "
"functions. Don't use these functions to write to files that are being "
"visited; that could cause confusion in the mechanisms for visiting."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:611
#, no-wrap
msgid "Command append-to-file start end filename"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:616
msgid ""
"This function appends the contents of the region delimited by @var{start} "
"and @var{end} in the current buffer to the end of file @var{filename}. If "
"that file does not exist, it is created. This function returns @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:618
msgid "An error is signaled if you cannot write or create @var{filename}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:620
msgid "When called from Lisp, this function is completely equivalent to:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:623
#, no-wrap
msgid "(write-region start end filename t)\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:626
#, no-wrap
msgid ""
"Command write-region start end filename &optional append visit lockname "
"mustbenew"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:629
msgid ""
"This function writes the region delimited by @var{start} and @var{end} in "
"the current buffer into the file specified by @var{filename}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:633
msgid ""
"If @var{start} is @code{nil}, then the command writes the entire buffer "
"contents (@emph{not} just the accessible portion) to the file and ignores "
"@var{end}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:637
msgid ""
"If @var{start} is a string, then @code{write-region} writes or appends that "
"string, rather than text from the buffer. @var{end} is ignored in this "
"case."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:642
msgid ""
"If @var{append} is non-@code{nil}, then the specified text is appended to "
"the existing file contents (if any). If @var{append} is a number, "
"@code{write-region} seeks to that byte offset from the start of the file and "
"writes the data from there."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:651
msgid ""
"If @var{mustbenew} is non-@code{nil}, then @code{write-region} asks for "
"confirmation if @var{filename} names an existing file. If @var{mustbenew} "
"is the symbol @code{excl}, then @code{write-region} does not ask for "
"confirmation, but instead it signals an error @code{file-already-exists} if "
"the file already exists. Although @code{write-region} normally follows a "
"symbolic link and creates the pointed-to file if the symbolic link is "
"dangling, it does not follow symbolic links if @var{mustbenew} is "
"@code{excl}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:656
msgid ""
"The test for an existing file, when @var{mustbenew} is @code{excl}, uses a "
"special system feature. At least for files on a local disk, there is no "
"chance that some other program could create a file of the same name before "
"Emacs does, without Emacs's noticing."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:663
msgid ""
"If @var{visit} is @code{t}, then Emacs establishes an association between "
"the buffer and the file: the buffer is then visiting that file. It also "
"sets the last file modification time for the current buffer to "
"@var{filename}'s modtime, and marks the buffer as not modified. This "
"feature is used by @code{save-buffer}, but you probably should not use it "
"yourself."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:671
msgid ""
"If @var{visit} is a string, it specifies the file name to visit. This way, "
"you can write the data to one file (@var{filename}) while recording the "
"buffer as visiting another file (@var{visit}). The argument @var{visit} is "
"used in the echo area message and also for file locking; @var{visit} is "
"stored in @code{buffer-file-name}. This feature is used to implement "
"@code{file-precious-flag}; don't use it yourself unless you really know what "
"you're doing."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:675
msgid ""
"The optional argument @var{lockname}, if non-@code{nil}, specifies the file "
"name to use for purposes of locking and unlocking, overriding @var{filename} "
"and @var{visit} for that purpose."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:681
msgid ""
"The function @code{write-region} converts the data which it writes to the "
"appropriate file formats specified by @code{buffer-file-format} and also "
"calls the functions in the list @code{write-region-annotate-functions}. "
"@xref{Format Conversion}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:688
msgid ""
"Normally, @code{write-region} displays the message @samp{Wrote "
"@var{filename}} in the echo area. This message is inhibited if @var{visit} "
"is neither @code{t} nor @code{nil} nor a string, or if Emacs is operating in "
"batch mode (@pxref{Batch Mode}). This feature is useful for programs that "
"use files for internal purposes, files that the user does not need to know "
"about."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:690
#, no-wrap
msgid "write-region-inhibit-fsync"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:697
msgid ""
"If this variable's value is @code{nil}, @code{write-region} uses the "
"@code{fsync} system call after writing a file. Although this slows Emacs "
"down, it lessens the risk of data loss after power failure. If the value is "
"@code{t}, Emacs does not use @code{fsync}. The default value is @code{nil} "
"when Emacs is interactive, and @code{t} when Emacs runs in batch mode. "
"@xref{Files and Storage}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:699
#, no-wrap
msgid "with-temp-file file body@dots{}"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:707
msgid "Definition of with-temp-file"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:707
msgid ""
"The @code{with-temp-file} macro evaluates the @var{body} forms with a "
"temporary buffer as the current buffer; then, at the end, it writes the "
"buffer contents into file @var{file}. It kills the temporary buffer when "
"finished, restoring the buffer that was current before the "
"@code{with-temp-file} form. Then it returns the value of the last form in "
"@var{body}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:710
msgid ""
"The current buffer is restored even in case of an abnormal exit via "
"@code{throw} or error (@pxref{Nonlocal Exits})."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:716
msgid ""
"Like @code{with-temp-buffer} (@pxref{Definition of with-temp-buffer,, "
"Current Buffer}), the temporary buffer used by this macro does not run the "
"hooks @code{kill-buffer-hook}, @code{kill-buffer-query-functions} "
"(@pxref{Killing Buffers}), and @code{buffer-list-update-hook} (@pxref{Buffer "
"List})."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:720
#, no-wrap
msgid "file locks"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:721
#, no-wrap
msgid "lock file"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:722
#, no-wrap
msgid ".#, lock file names"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:742
msgid ""
"When two users edit the same file at the same time, they are likely to "
"interfere with each other. Emacs tries to prevent this situation from "
"arising by recording a @dfn{file lock} when a file is being modified. Emacs "
"can then detect the first attempt to modify a buffer visiting a file that is "
"locked by another Emacs job, and ask the user what to do. The file lock is "
"really a file, a symbolic link with a special name, stored in the same "
"directory as the file you are editing. The name is constructed by "
"prepending @file{.#} to the file name of the buffer. The target of the "
"symbolic link will be of the form "
"@code{@var{user}@@@var{host}.@var{pid}:@var{boot}}, where @var{user} is "
"replaced with the current username (from @code{user-login-name}), @var{host} "
"with the name of the host where Emacs is running (from @code{system-name}), "
"@var{pid} with Emacs's process id, and @var{boot} with the time since the "
"last reboot. @code{:@var{boot}} is omitted if the boot time is "
"unavailable. (On file systems that do not support symbolic links, a regular "
"file is used instead, with contents of the form "
"@code{@var{user}@@@var{host}.@var{pid}:@var{boot}}.)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:750
msgid ""
"When you access files using NFS, there may be a small probability that you "
"and another user will both lock the same file simultaneously. If this "
"happens, it is possible for the two users to make changes simultaneously, "
"but Emacs will still warn the user who saves second. Also, the detection of "
"modification of a buffer visiting a file changed on disk catches some cases "
"of simultaneous editing; see @ref{Modification Time}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:751
#, no-wrap
msgid "file-locked-p filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:756
msgid ""
"This function returns @code{nil} if the file @var{filename} is not locked. "
"It returns @code{t} if it is locked by this Emacs process, and it returns "
"the name of the user who has locked it if it is locked by some other job."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:761
#, no-wrap
msgid ""
"(file-locked-p \"foo\")\n"
" @result{} nil\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:765
#, no-wrap
msgid "lock-buffer &optional filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:771
msgid ""
"This function locks the file @var{filename}, if the current buffer is "
"modified. The argument @var{filename} defaults to the current buffer's "
"visited file. Nothing is done if the current buffer is not visiting a file, "
"or is not modified, or if the option @code{create-lockfiles} is @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:773
#, no-wrap
msgid "unlock-buffer"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:780
msgid ""
"This function unlocks the file being visited in the current buffer, if the "
"buffer is modified. If the buffer is not modified, then the file should not "
"be locked, so this function does nothing. It also does nothing if the "
"current buffer is not visiting a file, or is not locked. This function "
"handles file system errors by calling @code{display-warning} and otherwise "
"ignores the error."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:782
#, no-wrap
msgid "create-lockfiles"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:784
msgid "If this variable is @code{nil}, Emacs does not lock files."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:786
#, no-wrap
msgid "lock-file-name-transforms"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:793
msgid ""
"By default, Emacs creates the lock files in the same directory as the files "
"that are being locked. This can be changed by customizing this variable. "
"Is has the same syntax as @code{auto-save-file-name-transforms} "
"(@pxref{Auto-Saving}). For instance, to make Emacs write all the lock files "
"to @file{/var/tmp/}, you could say something like:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:797
#, no-wrap
msgid ""
"(setq lock-file-name-transforms\n"
" '((\"\\\\`/.*/\\\\([^/]+\\\\)\\\\'\" \"/var/tmp/\\\\1\" t)))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:800
#, no-wrap
msgid "ask-user-about-lock file other-user"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:805
msgid ""
"This function is called when the user tries to modify @var{file}, but it is "
"locked by another user named @var{other-user}. The default definition of "
"this function asks the user to say what to do. The value this function "
"returns determines what Emacs does next:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:810
msgid ""
"A value of @code{t} says to grab the lock on the file. Then this user may "
"edit the file and @var{other-user} loses the lock."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:814
msgid ""
"A value of @code{nil} says to ignore the lock and let this user edit the "
"file anyway."
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:816
#, no-wrap
msgid "file-locked"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:819
msgid ""
"This function may instead signal a @code{file-locked} error, in which case "
"the change that the user was about to make does not take place."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:821
msgid "The error message for this error looks like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:824
#, no-wrap
msgid "@error{} File is locked: @var{file} @var{other-user}\n"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:829
msgid ""
"where @code{file} is the name of the file and @var{other-user} is the name "
"of the user who has locked the file."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:833
msgid ""
"If you wish, you can replace the @code{ask-user-about-lock} function with "
"your own version that makes the decision in another way."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:835
#, no-wrap
msgid "remote-file-name-inhibit-locks"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:838
msgid ""
"You can prevent the creation of remote lock files by setting the variable "
"@code{remote-file-name-inhibit-locks} to @code{t}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:840
#, no-wrap
msgid "Command lock-file-mode"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:843
msgid ""
"This command, called interactively, toggles the local value of "
"@code{create-lockfiles} in the current buffer."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:847
#, no-wrap
msgid "file, information about"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:854
msgid ""
"This section describes the functions for retrieving various types of "
"information about files (or directories or symbolic links), such as whether "
"a file is readable or writable, and its size. These functions all take "
"arguments which are file names. Except where noted, these arguments need to "
"specify existing files, or an error is signaled."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:855
#, no-wrap
msgid "file names, trailing whitespace"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:856
#, no-wrap
msgid "trailing blanks in file names"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:860
msgid ""
"Be careful with file names that end in spaces. On some filesystems "
"(notably, MS-Windows), trailing whitespace characters in file names are "
"silently and automatically ignored."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:868
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:870
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:871
#, no-wrap
msgid "Testing Accessibility"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:868
msgid "Is a given file readable? Writable?"
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:868
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1039
#, no-wrap
msgid "Kinds of Files"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:868
msgid "Is it a directory? A symbolic link?"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:868
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1165
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1166
#, no-wrap
msgid "Truenames"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:868
msgid "Eliminating symbolic links from a file name."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:868
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1276
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1277
#, no-wrap
msgid "File Attributes"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:868
msgid "File sizes, modification times, etc."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:868
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1505
#, no-wrap
msgid "Extended Attributes"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:868
msgid "Extended file attributes for access control."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:868
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1569
#, no-wrap
msgid "Locating Files"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:868
msgid "How to find a file in standard places."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:872
#, no-wrap
msgid "accessibility of a file"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:873
#, no-wrap
msgid "file accessibility"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:878
msgid ""
"These functions test for permission to access a file for reading, writing, "
"or execution. Unless explicitly stated otherwise, they follow symbolic "
"links. @xref{Kinds of Files}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:883
msgid ""
"On some operating systems, more complex sets of access permissions can be "
"specified, via mechanisms such as Access Control Lists (ACLs). "
"@xref{Extended Attributes}, for how to query and set those permissions."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:884
#, no-wrap
msgid "file-exists-p filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:891
msgid ""
"This function returns @code{t} if a file named @var{filename} appears to "
"exist. This does not mean you can necessarily read the file, only that you "
"can probably find out its attributes. (On GNU and other POSIX-like systems, "
"this is true if the file exists and you have execute permission on the "
"containing directories, regardless of the permissions of the file itself.)"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:894
msgid ""
"If the file does not exist, or if there was trouble determining whether the "
"file exists, this function returns @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:899
msgid ""
"Directories are files, so @code{file-exists-p} can return @code{t} when "
"given a directory. However, because @code{file-exists-p} follows symbolic "
"links, it returns @code{t} for a symbolic link name only if the target file "
"exists."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:901
#, no-wrap
msgid "file-readable-p filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:904
msgid ""
"This function returns @code{t} if a file named @var{filename} exists and you "
"can read it. It returns @code{nil} otherwise."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:906
#, no-wrap
msgid "file-executable-p filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:912
msgid ""
"This function returns @code{t} if a file named @var{filename} exists and you "
"can execute it. It returns @code{nil} otherwise. On GNU and other "
"POSIX-like systems, if the file is a directory, execute permission means you "
"can check the existence and attributes of files inside the directory, and "
"open those files if their modes permit."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:914
#, no-wrap
msgid "file-writable-p filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:920
msgid ""
"This function returns @code{t} if the file @var{filename} can be written or "
"created by you, and @code{nil} otherwise. A file is writable if the file "
"exists and you can write it. It is creatable if it does not exist, but its "
"parent directory does exist and you can write in that directory."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:924
msgid ""
"In the example below, @file{foo} is not writable because the parent "
"directory does not exist, even though the user could create such a "
"directory."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:929
#, no-wrap
msgid ""
"(file-writable-p \"~/no-such-dir/foo\")\n"
" @result{} nil\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:933
#, no-wrap
msgid "file-accessible-directory-p dirname"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:940
msgid ""
"This function returns @code{t} if you have permission to open existing files "
"in the directory whose name as a file is @var{dirname}; otherwise (e.g., if "
"there is no such directory), it returns @code{nil}. The value of "
"@var{dirname} may be either a directory name (such as @file{/foo/}) or the "
"file name of a file which is a directory (such as @file{/foo}, without the "
"final slash)."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:943
msgid ""
"For example, from the following we deduce that any attempt to read a file in "
"@file{/foo/} will give an error:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:947
#, no-wrap
msgid ""
"(file-accessible-directory-p \"/foo\")\n"
" @result{} nil\n"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:950
#, no-wrap
msgid "with-existing-directory body@dots{}"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:958
msgid ""
"This macro ensures that @code{default-directory} is bound to an existing "
"directory before executing @var{body}. If @code{default-directory} already "
"exists, that's preferred, and otherwise some other directory is used. This "
"macro can be useful, for instance, when calling an external command that "
"requires that it's running in a directory that exists. The chosen directory "
"is not guaranteed to be writable."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:960
#, no-wrap
msgid "access-file filename string"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:964
msgid ""
"If you can read @var{filename} this function returns @code{nil}; otherwise "
"it signals an error using @var{string} as the error message text."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:966
#, no-wrap
msgid "file-ownership-preserved-p filename &optional group"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:970
msgid ""
"This function returns @code{t} if deleting the file @var{filename} and then "
"creating it anew would keep the file's owner unchanged. It also returns "
"@code{t} for nonexistent files."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:973
msgid ""
"If the optional argument @var{group} is non-@code{nil}, this function also "
"checks that the file's group would be unchanged."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:975
msgid "This function does not follow symbolic links."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:977
#, no-wrap
msgid "file-modes filename &optional flag"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:978
#, no-wrap
msgid "mode bits"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:979
#, no-wrap
msgid "file permissions"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:980
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1869
#, no-wrap
msgid "permissions, file"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:981
#, no-wrap
msgid "file modes"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:986
msgid ""
"This function returns the @dfn{mode bits} of @var{filename}---an integer "
"summarizing its read, write, and execution permissions. This function "
"follows symbolic links. If the file does not exist, the return value is "
"@code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:994
msgid ""
"@xref{File permissions,,, coreutils, The @sc{gnu} @code{Coreutils} Manual}, "
"for a description of mode bits. For example, if the low-order bit is 1, the "
"file is executable by all users; if the second-lowest-order bit is 1, the "
"file is writable by all users; etc. The highest possible value is 4095 "
"(7777 octal), meaning that everyone has read, write, and execute permission, "
"the @acronym{SUID} bit is set for both others and group, and the sticky bit "
"is set."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1001
msgid ""
"By default this function follows symbolic links. However, if the optional "
"argument @var{flag} is the symbol @code{nofollow}, this function does not "
"follow @var{filename} if it is a symbolic link; this can help prevent "
"inadvertently obtaining the mode bits of a file somewhere else, and is more "
"consistent with @code{file-attributes} (@pxref{File Attributes})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1004
msgid ""
"@xref{Changing Files}, for the @code{set-file-modes} function, which can be "
"used to set these permissions."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1009
#, no-wrap
msgid ""
"(file-modes \"~/junk/diffs\" 'nofollow)\n"
" @result{} 492 ; @r{Decimal integer.}\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1013
#, no-wrap
msgid ""
"(format \"%o\" 492)\n"
" @result{} \"754\" ; @r{Convert to octal.}\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1018
#, no-wrap
msgid ""
"(set-file-modes \"~/junk/diffs\" #o666 'nofollow)\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1023
#, no-wrap
msgid ""
"$ ls -l diffs\n"
"-rw-rw-rw- 1 lewis lewis 3063 Oct 30 16:00 diffs\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1026
#, no-wrap
msgid "MS-DOS and file modes"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1027
#, no-wrap
msgid "file modes and MS-DOS"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1037
msgid ""
"@strong{MS-DOS note:} On MS-DOS, there is no such thing as an executable "
"file mode bit. So @code{file-modes} considers a file executable if its name "
"ends in one of the standard executable extensions, such as @file{.com}, "
"@file{.bat}, @file{.exe}, and some others. Files that begin with the "
"POSIX-standard @samp{#!} signature, such as shell and Perl scripts, are also "
"considered executable. Directories are also reported as executable, for "
"compatibility with POSIX@. These conventions are also followed by "
"@code{file-attributes} (@pxref{File Attributes})."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1040
#, no-wrap
msgid "Distinguishing Kinds of Files"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1041
#, no-wrap
msgid "file classification"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1042
#, no-wrap
msgid "classification of file types"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1043
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1057
#, no-wrap
msgid "symbolic links"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1047
msgid ""
"This section describes how to distinguish various kinds of files, such as "
"directories, symbolic links, and ordinary files."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1055
msgid ""
"Symbolic links are ordinarily followed wherever they appear. For example, "
"to interpret the file name @file{a/b/c}, any of @file{a}, @file{a/b}, and "
"@file{a/b/c} can be symbolic links that are followed, possibly recursively "
"if the link targets are themselves symbolic links. However, a few functions "
"do not follow symbolic links at the end of a file name (@file{a/b/c} in this "
"example). Such a function is said to @dfn{not follow symbolic links}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1056
#, no-wrap
msgid "file-symlink-p filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1063
msgid ""
"If the file @var{filename} is a symbolic link, this function does not follow "
"it and instead returns its link target as a string. (The link target string "
"is not necessarily the full absolute file name of the target; determining "
"the full file name that the link points to is nontrivial, see below.)"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1067
msgid ""
"If the file @var{filename} is not a symbolic link, or does not exist, or if "
"there is trouble determining whether it is a symbolic link, "
"@code{file-symlink-p} returns @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1069
msgid "Here are a few examples of using this function:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1074
#, no-wrap
msgid ""
"(file-symlink-p \"not-a-symlink\")\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1078
#, no-wrap
msgid ""
"(file-symlink-p \"sym-link\")\n"
" @result{} \"not-a-symlink\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1082
#, no-wrap
msgid ""
"(file-symlink-p \"sym-link2\")\n"
" @result{} \"sym-link\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1086
#, no-wrap
msgid ""
"(file-symlink-p \"/bin\")\n"
" @result{} \"/pub/bin\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1094
msgid ""
"Note that in the third example, the function returned @file{sym-link}, but "
"did not proceed to resolve it, although that file is itself a symbolic "
"link. That is because this function does not follow symbolic links---the "
"process of following the symbolic links does not apply to the last component "
"of the file name."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1101
msgid ""
"The string that this function returns is what is recorded in the symbolic "
"link; it may or may not include any leading directories. This function does "
"@emph{not} expand the link target to produce a fully-qualified file name, "
"and in particular does not use the leading directories, if any, of the "
"@var{filename} argument if the link target is not an absolute file name. "
"Here's an example:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1106
#, no-wrap
msgid ""
"(file-symlink-p \"/foo/bar/baz\")\n"
" @result{} \"some-file\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1116
msgid ""
"Here, although @file{/foo/bar/baz} was given as a fully-qualified file name, "
"the result is not, and in fact does not have any leading directories at "
"all. And since @file{some-file} might itself be a symbolic link, you cannot "
"simply prepend leading directories to it, nor even naively use "
"@code{expand-file-name} (@pxref{File Name Expansion}) to produce its "
"absolute file name."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1122
msgid ""
"For this reason, this function is seldom useful if you need to determine "
"more than just the fact that a file is or isn't a symbolic link. If you "
"actually need the file name of the link target, use @code{file-chase-links} "
"or @code{file-truename}, described in @ref{Truenames}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1124
#, no-wrap
msgid "file-directory-p filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1130
msgid ""
"This function returns @code{t} if @var{filename} is the name of an existing "
"directory. It returns @code{nil} if @var{filename} does not name a "
"directory, or if there is trouble determining whether it is a directory. "
"This function follows symbolic links."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1135
#, no-wrap
msgid ""
"(file-directory-p \"~rms\")\n"
" @result{} t\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1139
#, no-wrap
msgid ""
"(file-directory-p \"~rms/lewis/files.texi\")\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1143
#, no-wrap
msgid ""
"(file-directory-p \"~rms/lewis/no-such-file\")\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1147
#, no-wrap
msgid ""
"(file-directory-p \"$HOME\")\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1152
#, no-wrap
msgid ""
"(file-directory-p\n"
" (substitute-in-file-name \"$HOME\"))\n"
" @result{} t\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1156
#, no-wrap
msgid "file-regular-p filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1163
msgid ""
"This function returns @code{t} if the file @var{filename} exists and is a "
"regular file (not a directory, named pipe, terminal, or other I/O device). "
"It returns @code{nil} if @var{filename} does not exist or is not a regular "
"file, or if there is trouble determining whether it is a regular file. This "
"function follows symbolic links."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1167
#, no-wrap
msgid "truename (of file)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1176
msgid ""
"The @dfn{truename} of a file is the name that you get by following symbolic "
"links at all levels until none remain, then simplifying away @samp{.}@: and "
"@samp{..}@: appearing as name components. This results in a sort of "
"canonical name for the file. A file does not always have a unique truename; "
"the number of distinct truenames a file has is equal to the number of hard "
"links to the file. However, truenames are useful because they eliminate "
"symbolic links as a cause of name variation."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1177
#, no-wrap
msgid "file-truename filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1181
msgid ""
"This function returns the truename of the file @var{filename}. If the "
"argument is not an absolute file name, this function first expands it "
"against @code{default-directory}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1185
msgid ""
"This function does not expand environment variables. Only "
"@code{substitute-in-file-name} does that. @xref{Definition of "
"substitute-in-file-name}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1194
msgid ""
"If you may need to follow symbolic links preceding @samp{..}@: appearing as "
"a name component, call @code{file-truename} without prior direct or indirect "
"calls to @code{expand-file-name}. Otherwise, the file name component "
"immediately preceding @samp{..} will be simplified away before "
"@code{file-truename} is called. To eliminate the need for a call to "
"@code{expand-file-name}, @code{file-truename} handles @samp{~} in the same "
"way that @code{expand-file-name} does."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1198
msgid ""
"If the target of a symbolic links has remote file name syntax, "
"@code{file-truename} returns it quoted. @xref{File Name Expansion,, "
"Functions that Expand Filenames}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1200
#, no-wrap
msgid "file-chase-links filename &optional limit"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1205
msgid ""
"This function follows symbolic links, starting with @var{filename}, until it "
"finds a file name which is not the name of a symbolic link. Then it returns "
"that file name. This function does @emph{not} follow symbolic links at the "
"level of parent directories."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1209
msgid ""
"If you specify a number for @var{limit}, then after chasing through that "
"many links, the function just returns what it has even if that is still a "
"symbolic link."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1216
msgid ""
"To illustrate the difference between @code{file-chase-links} and "
"@code{file-truename}, suppose that @file{/usr/foo} is a symbolic link to the "
"directory @file{/home/foo}, and @file{/home/foo/hello} is an ordinary file "
"(or at least, not a symbolic link) or nonexistent. Then we would have:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1224
#, no-wrap
msgid ""
"(file-chase-links \"/usr/foo/hello\")\n"
" ;; @r{This does not follow the links in the parent directories.}\n"
" @result{} \"/usr/foo/hello\"\n"
"(file-truename \"/usr/foo/hello\")\n"
" ;; @r{Assuming that @file{/home} is not a symbolic link.}\n"
" @result{} \"/home/foo/hello\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1226
#, no-wrap
msgid "file-equal-p file1 file2"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1232
msgid ""
"This function returns @code{t} if the files @var{file1} and @var{file2} name "
"the same file. This is similar to comparing their truenames, except that "
"remote file names are also handled in an appropriate manner. If @var{file1} "
"or @var{file2} does not exist, the return value is unspecified."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1234
#, no-wrap
msgid "file-name-case-insensitive-p filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1244
msgid ""
"Sometimes file names or their parts need to be compared as strings, in which "
"case it's important to know whether the underlying filesystem is "
"case-insensitive. This function returns @code{t} if file @var{filename} is "
"on a case-insensitive filesystem. It always returns @code{t} on MS-DOS and "
"MS-Windows. On Cygwin and macOS, filesystems may or may not be "
"case-insensitive, and the function tries to determine case-sensitivity by a "
"runtime test. If the test is inconclusive, the function returns @code{t} on "
"Cygwin and @code{nil} on macOS."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1251
msgid ""
"Currently this function always returns @code{nil} on platforms other than "
"MS-DOS, MS-Windows, Cygwin, and macOS@. It does not detect "
"case-insensitivity of mounted filesystems, such as Samba shares or "
"NFS-mounted Windows volumes. On remote hosts, it assumes @code{t} for the "
"@samp{smb} method. For all other connection methods, runtime tests are "
"performed."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1253
#, no-wrap
msgid "file-in-directory-p file dir"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1259
msgid ""
"This function returns @code{t} if @var{file} is a file in directory "
"@var{dir}, or in a subdirectory of @var{dir}. It also returns @code{t} if "
"@var{file} and @var{dir} are the same directory. It compares the truenames "
"of the two directories. If @var{dir} does not name an existing directory, "
"the return value is @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1261
#, no-wrap
msgid "vc-responsible-backend file"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1270
msgid ""
"This function determines the responsible VC backend of the given "
"@var{file}. For example, if @file{emacs.c} is a file tracked by Git, "
"@w{@code{(vc-responsible-backend \"emacs.c\")}} returns @samp{Git}. Note "
"that if @var{file} is a symbolic link, @code{vc-responsible-backend} will "
"not resolve it---the backend of the symbolic link file itself is reported. "
"To get the backend VC of the file to which @var{file} refers, wrap "
"@var{file} with a symbolic link resolving function such as "
"@code{file-chase-links}:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1273
#, no-wrap
msgid "(vc-responsible-backend (file-chase-links \"emacs.c\"))\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1278
#, no-wrap
msgid "file attributes"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1284
msgid ""
"This section describes the functions for getting detailed information about "
"a file, including the owner and group numbers, the number of names, the "
"inode number, the size, and the times of access and modification."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1285
#, no-wrap
msgid "file-newer-than-file-p filename1 filename2"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1286
#, no-wrap
msgid "file age"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1287
#, no-wrap
msgid "file modification time"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1292
msgid ""
"This function returns @code{t} if the file @var{filename1} is newer than "
"file @var{filename2}. If @var{filename1} does not exist, it returns "
"@code{nil}. If @var{filename1} does exist, but @var{filename2} does not, it "
"returns @code{t}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1296
msgid ""
"In the following example, assume that the file @file{aug-19} was written on "
"the 19th, @file{aug-20} was written on the 20th, and the file @file{no-file} "
"doesn't exist at all."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1301
#, no-wrap
msgid ""
"(file-newer-than-file-p \"aug-19\" \"aug-20\")\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1305
#, no-wrap
msgid ""
"(file-newer-than-file-p \"aug-20\" \"aug-19\")\n"
" @result{} t\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1309
#, no-wrap
msgid ""
"(file-newer-than-file-p \"aug-19\" \"no-file\")\n"
" @result{} t\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1313
#, no-wrap
msgid ""
"(file-newer-than-file-p \"no-file\" \"aug-19\")\n"
" @result{} nil\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1317
#, no-wrap
msgid "file-has-changed-p filename tag"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1329
msgid ""
"This function returns non-@code{nil} if the time stamp of @var{filename} has "
"changed since the last call. When called for the first time for some "
"@var{filename}, it records the last modification time and size of the file, "
"and returns non-@code{nil} when @var{filename} exists. Thereafter, when "
"called for the same @var{filename}, it compares the current time stamp and "
"size with the recorded ones, and returns non-@code{nil} only if either the "
"time stamp or the size (or both) are different. This is useful when a Lisp "
"program wants to re-read a file whenever it changes. With an optional "
"argument @var{tag}, which must be a symbol, the size and modification time "
"comparisons are limited to calls with the same tag."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1331
#, no-wrap
msgid "file-attributes filename &optional id-format"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1342
msgid "Definition of file-attributes"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1342
msgid ""
"This function returns a list of attributes of file @var{filename}. If the "
"specified file does not exist, it returns @code{nil}. This function does "
"not follow symbolic links. The optional parameter @var{id-format} specifies "
"the preferred format of attributes @acronym{UID} and @acronym{GID} (see "
"below)---the valid values are @code{'string} and @code{'integer}. The "
"latter is the default, but we plan to change that, so you should specify a "
"non-@code{nil} value for @var{id-format} if you use the returned "
"@acronym{UID} or @acronym{GID}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1349
msgid ""
"On GNU platforms when operating on a local file, this function is atomic: if "
"the filesystem is simultaneously being changed by some other process, this "
"function returns the file's attributes either before or after the change. "
"Otherwise this function is not atomic, and might return @code{nil} if it "
"detects the race condition, or might return a hodgepodge of the previous and "
"current file attributes."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1353
msgid ""
"Accessor functions are provided to access the elements in this list. The "
"accessors are mentioned along with the descriptions of the elements below."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1355
msgid "The elements of the list, in order, are:"
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1361
msgid ""
"@code{t} for a directory, a string for a symbolic link (the name linked to), "
"or @code{nil} for a text file (@code{file-attribute-type})."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1367
msgid ""
"The number of names the file has (@code{file-attribute-link-number}). "
"Alternate names, also known as hard links, can be created by using the "
"@code{add-name-to-file} function (@pxref{Changing Files})."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1372
msgid ""
"The file's @acronym{UID}, normally as a string "
"(@code{file-attribute-user-id}). However, if it does not correspond to a "
"named user, the value is an integer."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1375
msgid "The file's @acronym{GID}, likewise (@code{file-attribute-group-id})."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1383
msgid ""
"The time of last access as a Lisp timestamp "
"(@code{file-attribute-access-time}). The timestamp is in the style of "
"@code{current-time} (@pxref{Time of Day}) and is truncated to that of the "
"filesystem's timestamp resolution; for example, on some FAT-based "
"filesystems, only the date of last access is recorded, so this time will "
"always hold the midnight of the day of the last access."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1384
#, no-wrap
msgid "modification time of file"
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1389
msgid ""
"The time of last modification as a Lisp timestamp "
"(@code{file-attribute-modification-time}). This is the last time when the "
"file's contents were modified."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1396
msgid ""
"The time of last status change as a Lisp timestamp "
"(@code{file-attribute-status-change-time}). This is the time of the last "
"change to the file's access mode bits, its owner and group, and other "
"information recorded in the filesystem for the file, beyond the file's "
"contents."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1399
msgid "The size of the file in bytes (@code{file-attribute-size})."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1403
msgid ""
"The file's modes, as a string of ten letters or dashes, as in @samp{ls -l} "
"(@code{file-attribute-modes})."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1406
msgid "An unspecified value, present for backward compatibility."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1410
msgid ""
"The file's inode number (@code{file-attribute-inode-number}), a nonnegative "
"integer."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1418
msgid ""
"The filesystem number of the device that the file is on "
"@code{file-attribute-device-number}), an integer. This element and the "
"file's inode number together give enough information to distinguish any two "
"files on the system---no two files can have the same values for both of "
"these numbers."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1421
msgid "For example, here are the file attributes for @file{files.texi}:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1432
#, no-wrap
msgid ""
"(file-attributes \"files.texi\" 'string)\n"
" @result{} (nil 1 \"lh\" \"users\"\n"
" (20614 64019 50040 152000)\n"
" (20000 23 0 0)\n"
" (20614 64555 902289 872000)\n"
" 122295 \"-rw-rw-rw-\"\n"
" t 6473924464520138\n"
" 1014478468)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1437
msgid "and here is how the result is interpreted:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1439
#, no-wrap
msgid "nil"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1441
msgid "is neither a directory nor a symbolic link."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1442
#, no-wrap
msgid "1"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1445
msgid ""
"has only one name (the name @file{files.texi} in the current default "
"directory)."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1446
#, no-wrap
msgid "\"lh\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1448
msgid "is owned by the user with name @samp{lh}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1449
#, no-wrap
msgid "\"users\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1451
msgid "is in the group with name @samp{users}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1452
#, no-wrap
msgid "(20614 64019 50040 152000)"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1454
msgid "was last accessed on October 23, 2012, at 20:12:03.050040152 UTC."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1455
#, no-wrap
msgid "(20000 23 0 0)"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1457
msgid "was last modified on July 15, 2001, at 08:53:43 UTC."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1458
#, no-wrap
msgid "(20614 64555 902289 872000)"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1460
msgid "last had its status changed on October 23, 2012, at 20:20:59.902289872 UTC."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1461
#, no-wrap
msgid "122295"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1465
msgid ""
"is 122295 bytes long. (It may not contain 122295 characters, though, if "
"some of the bytes belong to multibyte sequences, and also if the end-of-line "
"format is CR-LF.)"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1466
#, no-wrap
msgid "\"-rw-rw-rw-\""
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1468
msgid "has a mode of read and write access for the owner, group, and world."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1469
#, no-wrap
msgid "t"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1471
msgid "is merely a placeholder; it carries no information."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1472
#, no-wrap
msgid "6473924464520138"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1474
msgid "has an inode number of 6473924464520138."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1475
#, no-wrap
msgid "1014478468"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1477
msgid "is on the file-system device whose number is 1014478468."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1480
#, no-wrap
msgid "file-nlinks filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1486
msgid ""
"This function returns the number of names (i.e., hard links) that file "
"@var{filename} has. If the file does not exist, this function returns "
"@code{nil}. Note that symbolic links have no effect on this function, "
"because they are not considered to be names of the files they link to. This "
"function does not follow symbolic links."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1492
#, no-wrap
msgid ""
"$ ls -l foo*\n"
"-rw-rw-rw- 2 rms rms 4 Aug 19 01:27 foo\n"
"-rw-rw-rw- 2 rms rms 4 Aug 19 01:27 foo1\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1497
#, no-wrap
msgid ""
"(file-nlinks \"foo\")\n"
" @result{} 2\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1501
#, no-wrap
msgid ""
"(file-nlinks \"doesnt-exist\")\n"
" @result{} nil\n"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1506
#, no-wrap
msgid "Extended File Attributes"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1507
#, no-wrap
msgid "extended file attributes"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1516
msgid ""
"On some operating systems, each file can be associated with arbitrary "
"@dfn{extended file attributes}. At present, Emacs supports querying and "
"setting two specific sets of extended file attributes: Access Control Lists "
"(ACLs) and SELinux contexts. These extended file attributes are used, on "
"some systems, to impose more sophisticated file access controls than the "
"basic Unix-style permissions discussed in the previous sections."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1517
#, no-wrap
msgid "access control list"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1518
#, no-wrap
msgid "ACL entries"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1519
#, no-wrap
msgid "SELinux context"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1525
msgid ""
"A detailed explanation of ACLs and SELinux is beyond the scope of this "
"manual. For our purposes, each file can be associated with an @dfn{ACL}, "
"which specifies its properties under an ACL-based file control system, "
"and/or an @dfn{SELinux context}, which specifies its properties under the "
"SELinux system."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1526
#, no-wrap
msgid "file-acl filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1531
msgid ""
"This function returns the ACL for the file @var{filename}. The exact Lisp "
"representation of the ACL is unspecified (and may change in future Emacs "
"versions), but it is the same as what @code{set-file-acl} takes for its "
"@var{acl} argument (@pxref{Changing Files})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1535
msgid ""
"The underlying ACL implementation is platform-specific; on GNU/Linux and "
"BSD, Emacs uses the POSIX ACL interface, while on MS-Windows Emacs emulates "
"the POSIX ACL interface with native file security APIs."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1538
msgid ""
"If ACLs are not supported or the file does not exist, then the return value "
"is @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1540
#, no-wrap
msgid "file-selinux-context filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1548
msgid ""
"This function returns the SELinux context of the file @var{filename}, as a "
"list of the form @code{(@var{user} @var{role} @var{type} @var{range})}. The "
"list elements are the context's user, role, type, and range respectively, as "
"Lisp strings; see the SELinux documentation for details about what these "
"actually mean. The return value has the same form as what "
"@code{set-file-selinux-context} takes for its @var{context} argument "
"(@pxref{Changing Files})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1551
msgid ""
"If SELinux is not supported or the file does not exist, then the return "
"value is @code{(nil nil nil nil)}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1553
#, no-wrap
msgid "file-extended-attributes filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1560
msgid ""
"This function returns an alist of the Emacs-recognized extended attributes "
"of file @var{filename}. Currently, it serves as a convenient way to "
"retrieve both the ACL and SELinux context; you can then call the function "
"@code{set-file-extended-attributes}, with the returned alist as its second "
"argument, to apply the same file access attributes to another file "
"(@pxref{Changing Files})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1563
msgid ""
"One of the elements is @code{(acl . @var{acl})}, where @var{acl} has the "
"same form returned by @code{file-acl}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1567
msgid ""
"Another element is @code{(selinux-context . @var{context})}, where "
"@var{context} is the SELinux context, in the same form returned by "
"@code{file-selinux-context}."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1570
#, no-wrap
msgid "Locating Files in Standard Places"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1571
#, no-wrap
msgid "locate file in path"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1572
#, no-wrap
msgid "find file in path"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1577
msgid ""
"This section explains how to search for a file in a list of directories (a "
"@dfn{path}), or for an executable file in the standard list of executable "
"file directories."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1580
msgid ""
"To search for a user-specific configuration file, @xref{Standard File "
"Names}, for the @code{locate-user-emacs-file} function."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1581
#, no-wrap
msgid "locate-file filename path &optional suffixes predicate"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1587
msgid ""
"This function searches for a file whose name is @var{filename} in a list of "
"directories given by @var{path}, trying the suffixes in @var{suffixes}. If "
"it finds such a file, it returns the file's absolute file name "
"(@pxref{Relative File Names}); otherwise it returns @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1597
msgid ""
"The optional argument @var{suffixes} gives the list of file-name suffixes to "
"append to @var{filename} when searching. @code{locate-file} tries each "
"possible directory with each of these suffixes. If @var{suffixes} is "
"@code{nil}, or @code{(\"\")}, then there are no suffixes, and @var{filename} "
"is used only as-is. Typical values of @var{suffixes} are "
"@code{exec-suffixes} (@pxref{Subprocess Creation}), @code{load-suffixes}, "
"@code{load-file-rep-suffixes} and the return value of the function "
"@code{get-load-suffixes} (@pxref{Load Suffixes})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1603
msgid ""
"Typical values for @var{path} are @code{exec-path} (@pxref{Subprocess "
"Creation}) when looking for executable programs, or @code{load-path} "
"(@pxref{Library Search}) when looking for Lisp files. If @var{filename} is "
"absolute, @var{path} has no effect, but the suffixes in @var{suffixes} are "
"still tried."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1611
msgid ""
"The optional argument @var{predicate}, if non-@code{nil}, specifies a "
"predicate function for testing whether a candidate file is suitable. The "
"predicate is passed the candidate file name as its single argument. If "
"@var{predicate} is @code{nil} or omitted, @code{locate-file} uses "
"@code{file-readable-p} as the predicate. @xref{Kinds of Files}, for other "
"useful predicates, e.g., @code{file-executable-p} and "
"@code{file-directory-p}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1615
msgid ""
"This function will normally skip directories, so if you want it to find "
"directories, make sure the @var{predicate} function returns @code{dir-ok} "
"for them. For example:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1619
#, no-wrap
msgid ""
"(locate-file \"html\" '(\"/var/www\" \"/srv\") nil\n"
" (lambda (f) (if (file-directory-p f) 'dir-ok)))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1625
msgid ""
"For compatibility, @var{predicate} can also be one of the symbols "
"@code{executable}, @code{readable}, @code{writable}, @code{exists}, or a "
"list of one or more of these symbols."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1627
#, no-wrap
msgid "executable-find program &optional remote"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1634
msgid ""
"This function searches for the executable file of the named @var{program} "
"and returns the absolute file name of the executable, including its "
"file-name extensions, if any. It returns @code{nil} if the file is not "
"found. The function searches in all the directories in @code{exec-path}, "
"and tries all the file-name extensions in @code{exec-suffixes} "
"(@pxref{Subprocess Creation})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1637
msgid ""
"If @var{remote} is non-@code{nil}, and @code{default-directory} is a remote "
"directory, @var{program} is searched on the respective remote host."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1640
#, no-wrap
msgid "Changing File Names and Attributes"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1642
#, no-wrap
msgid "copying files"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1643
#, no-wrap
msgid "deleting files"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1644
#, no-wrap
msgid "linking files"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1645
#, no-wrap
msgid "setting modes of files"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1653
msgid ""
"The functions in this section rename, copy, delete, link, and set the modes "
"(permissions) of files. Typically, they signal a @code{file-error} error if "
"they fail to perform their function, reporting the system-dependent error "
"message that describes the reason for the failure. If they fail because a "
"file is missing, they signal a @code{file-missing} error instead."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1657
msgid ""
"For performance, the operating system may cache or alias changes made by "
"these functions instead of writing them immediately to secondary storage. "
"@xref{Files and Storage}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1667
msgid ""
"In the functions that have an argument @var{newname}, if this argument is a "
"directory name it is treated as if the nondirectory part of the source name "
"were appended. Typically, a directory name is one that ends in @samp{/} "
"(@pxref{Directory Names}). For example, if the old name is @file{a/b/c}, "
"the @var{newname} @file{d/e/f/} is treated as if it were @file{d/e/f/c}. "
"This special treatment does not apply if @var{newname} is not a directory "
"name but names a file that is a directory; for example, the @var{newname} "
"@file{d/e/f} is left as-is even if @file{d/e/f} happens to be a directory."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1671
msgid ""
"In the functions that have an argument @var{newname}, if a file by the name "
"of @var{newname} already exists, the actions taken depend on the value of "
"the argument @var{ok-if-already-exists}:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1676
msgid ""
"Signal a @code{file-already-exists} error if @var{ok-if-already-exists} is "
"@code{nil}."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1679
msgid "Request confirmation if @var{ok-if-already-exists} is a number."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1683
msgid ""
"Replace the old file without confirmation if @var{ok-if-already-exists} is "
"any other value."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1685
#, no-wrap
msgid "Command add-name-to-file oldname newname &optional ok-if-already-exists"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1686
#, no-wrap
msgid "file with multiple names"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1687
#, no-wrap
msgid "file hard link"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1691
msgid ""
"This function gives the file named @var{oldname} the additional name "
"@var{newname}. This means that @var{newname} becomes a new hard link to "
"@var{oldname}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1699
msgid ""
"If @var{newname} is a symbolic link, its directory entry is replaced, not "
"the directory entry it points to. If @var{oldname} is a symbolic link, this "
"function might or might not follow the link; it does not follow the link on "
"GNU platforms. If @var{oldname} is a directory, this function typically "
"fails, although for the superuser on a few old-fashioned non-GNU platforms "
"it can succeed and create a filesystem that is not tree-structured."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1702
msgid ""
"In the first part of the following example, we list two files, @file{foo} "
"and @file{foo3}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1708
#, no-wrap
msgid ""
"$ ls -li fo*\n"
"81908 -rw-rw-rw- 1 rms rms 29 Aug 18 20:32 foo\n"
"84302 -rw-rw-rw- 1 rms rms 24 Aug 18 20:31 foo3\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1714
msgid ""
"Now we create a hard link, by calling @code{add-name-to-file}, then list the "
"files again. This shows two names for one file, @file{foo} and @file{foo2}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1719
#, no-wrap
msgid ""
"(add-name-to-file \"foo\" \"foo2\")\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1726
#, no-wrap
msgid ""
"$ ls -li fo*\n"
"81908 -rw-rw-rw- 2 rms rms 29 Aug 18 20:32 foo\n"
"81908 -rw-rw-rw- 2 rms rms 29 Aug 18 20:32 foo2\n"
"84302 -rw-rw-rw- 1 rms rms 24 Aug 18 20:31 foo3\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1730
msgid "Finally, we evaluate the following:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1733
#, no-wrap
msgid "(add-name-to-file \"foo\" \"foo3\" t)\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1739
msgid ""
"and list the files again. Now there are three names for one file: "
"@file{foo}, @file{foo2}, and @file{foo3}. The old contents of @file{foo3} "
"are lost."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1744
#, no-wrap
msgid ""
"(add-name-to-file \"foo1\" \"foo3\")\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1751
#, no-wrap
msgid ""
"$ ls -li fo*\n"
"81908 -rw-rw-rw- 3 rms rms 29 Aug 18 20:32 foo\n"
"81908 -rw-rw-rw- 3 rms rms 29 Aug 18 20:32 foo2\n"
"81908 -rw-rw-rw- 3 rms rms 29 Aug 18 20:32 foo3\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1757
msgid ""
"This function is meaningless on operating systems where multiple names for "
"one file are not allowed. Some systems implement multiple names by copying "
"the file instead."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1759
msgid "See also @code{file-nlinks} in @ref{File Attributes}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1761
#, no-wrap
msgid "Command rename-file filename newname &optional ok-if-already-exists"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1763
msgid "This command renames the file @var{filename} as @var{newname}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1769
msgid ""
"If @var{filename} has additional names aside from @var{filename}, it "
"continues to have those names. In fact, adding the name @var{newname} with "
"@code{add-name-to-file} and then deleting @var{filename} has the same effect "
"as renaming, aside from momentary intermediate states and treatment of "
"errors, directories and symbolic links."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1774
msgid ""
"This command does not follow symbolic links. If @var{filename} is a "
"symbolic link, this command renames the symbolic link, not the file it "
"points to. If @var{newname} is a symbolic link, its directory entry is "
"replaced, not the directory entry it points to."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1781
msgid ""
"This command does nothing if @var{filename} and @var{newname} are the same "
"directory entry, i.e., if they refer to the same parent directory and give "
"the same name within that directory. Otherwise, if @var{filename} and "
"@var{newname} name the same file, this command does nothing on "
"POSIX-conforming systems, and removes @var{filename} on some non-POSIX "
"systems."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1784
msgid ""
"If @var{newname} exists, then it must be an empty directory if @var{oldname} "
"is a directory and a non-directory otherwise."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1786
#, no-wrap
msgid ""
"Command copy-file oldname newname &optional ok-if-already-exists time "
"preserve-uid-gid preserve-extended-attributes"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1792
msgid ""
"This command copies the file @var{oldname} to @var{newname}. An error is "
"signaled if @var{oldname} is not a regular file. If @var{newname} names a "
"directory, it copies @var{oldname} into that directory, preserving its final "
"name component."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1795
msgid ""
"This function follows symbolic links, except that it does not follow a "
"dangling symbolic link to create @var{newname}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1802
msgid ""
"If @var{time} is non-@code{nil}, then this function gives the new file the "
"same last-modified time that the old one has. (This works on only some "
"operating systems.) If setting the time gets an error, @code{copy-file} "
"signals a @code{file-date-error} error. In an interactive call, a prefix "
"argument specifies a non-@code{nil} value for @var{time}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1809
msgid ""
"If argument @var{preserve-uid-gid} is @code{nil}, we let the operating "
"system decide the user and group ownership of the new file (this is usually "
"set to the user running Emacs). If @var{preserve-uid-gid} is "
"non-@code{nil}, we attempt to copy the user and group ownership of the "
"file. This works only on some operating systems, and only if you have the "
"correct permissions to do so."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1814
msgid ""
"If the optional argument @var{preserve-permissions} is non-@code{nil}, this "
"function copies the file modes (or ``permissions'') of @var{oldname} to "
"@var{newname}, as well as the Access Control List and SELinux context (if "
"any). @xref{Information about Files}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1820
msgid ""
"Otherwise, the file modes of @var{newname} are left unchanged if it is an "
"existing file, and set to those of @var{oldname}, masked by the default file "
"permissions (see @code{set-default-file-modes} below), if @var{newname} is "
"to be newly created. The Access Control List or SELinux context are not "
"copied over in either case."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1822
#, no-wrap
msgid "Command make-symbolic-link target linkname &optional ok-if-already-exists"
msgstr ""
#. type: pindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1823
#, no-wrap
msgid "ln"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1824
#, no-wrap
msgid "file-already-exists"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1832
msgid ""
"This command makes a symbolic link to @var{target}, named @var{linkname}. "
"This is like the shell command @samp{ln -s @var{target} @var{linkname}}. "
"The @var{target} argument is treated only as a string; it need not name an "
"existing file. If @var{ok-if-already-exists} is an integer, indicating "
"interactive use, then leading @samp{~} is expanded and leading @samp{/:} is "
"stripped in the @var{target} string."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1836
msgid ""
"If @var{target} is a relative file name, the resulting symbolic link is "
"interpreted relative to the directory containing the symbolic link. "
"@xref{Relative File Names}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1840
msgid ""
"If both @var{target} and @var{linkname} have remote file name syntax, and if "
"both remote identifications are equal, the symbolic link points to the local "
"file name part of @var{target}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1843
msgid "This function is not available on systems that don't support symbolic links."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1845
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3198
#, no-wrap
msgid "trash"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1846
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3199
#, no-wrap
msgid "delete-by-moving-to-trash"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1847
#, no-wrap
msgid "Command delete-file filename &optional trash"
msgstr ""
#. type: pindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1848
#, no-wrap
msgid "rm"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1853
msgid ""
"This command deletes the file @var{filename}. If the file has multiple "
"names, it continues to exist under the other names. If @var{filename} is a "
"symbolic link, @code{delete-file} deletes only the symbolic link and not its "
"target."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1857
msgid ""
"A suitable kind of @code{file-error} error is signaled if the file does not "
"exist, or is not deletable. (On GNU and other POSIX-like systems, a file is "
"deletable if its directory is writable.)"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1864
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3219
msgid ""
"If the optional argument @var{trash} is non-@code{nil} and the variable "
"@code{delete-by-moving-to-trash} is non-@code{nil}, this command moves the "
"file into the system Trash instead of deleting it. @xref{Misc File "
"Ops,,Miscellaneous File Operations, emacs, The GNU Emacs Manual}. When "
"called interactively, @var{trash} is @code{t} if no prefix argument is "
"given, and @code{nil} otherwise."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1866
msgid "See also @code{delete-directory} in @ref{Create/Delete Dirs}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1868
#, no-wrap
msgid "file permissions, setting"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1870
#, no-wrap
msgid "file modes, setting"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1871
#, no-wrap
msgid "Command set-file-modes filename mode &optional flag"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1874
msgid ""
"This function sets the @dfn{file mode} (or @dfn{permissions}) of "
"@var{filename} to @var{mode}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1882
msgid ""
"By default this function follows symbolic links. However, if the optional "
"argument @var{flag} is the symbol @code{nofollow}, this function does not "
"follow @var{filename} if it is a symbolic link; this can help prevent "
"inadvertently changing the mode bits of a file somewhere else. On platforms "
"that do not support changing mode bits on a symbolic link, this function "
"signals an error when @var{filename} is a symbolic link and @var{flag} is "
"@code{nofollow}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1887
msgid ""
"If called non-interactively, @var{mode} must be an integer. Only the lowest "
"12 bits of the integer are used; on most systems, only the lowest 9 bits are "
"meaningful. You can use the Lisp construct for octal numbers to enter "
"@var{mode}. For example,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1890
#, no-wrap
msgid "(set-file-modes \"myfile\" #o644 'nofollow)\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1897
msgid ""
"specifies that the file should be readable and writable for its owner, "
"readable for group members, and readable for all other users. @xref{File "
"permissions,,, coreutils, The @sc{gnu} @code{Coreutils} Manual}, for a "
"description of mode bit specifications."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1901
msgid ""
"Interactively, @var{mode} is read from the minibuffer using "
"@code{read-file-modes} (see below), which lets the user type in either an "
"integer or a string representing the permissions symbolically."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1904
msgid ""
"@xref{Testing Accessibility}, for the function @code{file-modes}, which "
"returns the permissions of a file."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1906
#, no-wrap
msgid "set-default-file-modes mode"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1907
#, no-wrap
msgid "umask"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1917
msgid ""
"This function sets the default permissions for new files created by Emacs "
"and its subprocesses. Every file created with Emacs initially has these "
"permissions, or a subset of them (@code{write-region} will not grant execute "
"permissions even if the default file permissions allow execution). On GNU "
"and other POSIX-like systems, the default permissions are given by the "
"bitwise complement of the @samp{umask} value, i.e.@: each bit that is set in "
"the argument @var{mode} will be @emph{reset} in the default permissions with "
"which Emacs creates files."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1921
msgid ""
"The argument @var{mode} should be an integer which specifies the "
"permissions, similar to @code{set-file-modes} above. Only the lowest 9 bits "
"are meaningful."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1925
msgid ""
"The default file permissions have no effect when you save a modified version "
"of an existing file; saving a file preserves its existing permissions."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1927
#, no-wrap
msgid "with-file-modes mode body@dots{}"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1933
msgid ""
"This macro evaluates the @var{body} forms with the default permissions for "
"new files temporarily set to @var{modes} (whose value is as for "
"@code{set-file-modes} above). When finished, it restores the original "
"default file permissions, and returns the value of the last form in "
"@var{body}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1935
msgid "This is useful for creating private files, for example."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1937
#, no-wrap
msgid "default-file-modes"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1939
msgid "This function returns the default file permissions, as an integer."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1941
#, no-wrap
msgid "read-file-modes &optional prompt base-file"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1948
msgid ""
"This function reads a set of file mode bits from the minibuffer. The first "
"optional argument @var{prompt} specifies a non-default prompt. Second "
"second optional argument @var{base-file} is the name of a file on whose "
"permissions to base the mode bits that this function returns, if what the "
"user types specifies mode bits relative to permissions of an existing file."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1961
msgid ""
"If user input represents an octal number, this function returns that "
"number. If it is a complete symbolic specification of mode bits, as in "
"@code{\"u=rwx\"}, the function converts it to the equivalent numeric value "
"using @code{file-modes-symbolic-to-number} and returns the result. If the "
"specification is relative, as in @code{\"o+g\"}, then the permissions on "
"which the specification is based are taken from the mode bits of "
"@var{base-file}. If @var{base-file} is omitted or @code{nil}, the function "
"uses @code{0} as the base mode bits. The complete and relative "
"specifications can be combined, as in @code{\"u+r,g+rx,o+r,g-w\"}. "
"@xref{File permissions,,, coreutils, The @sc{gnu} @code{Coreutils} Manual}, "
"for a description of file mode specifications."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1963
#, no-wrap
msgid "file-modes-symbolic-to-number modes &optional base-modes"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1970
msgid ""
"This function converts a symbolic file mode specification in @var{modes} "
"into the equivalent integer. If the symbolic specification is based on an "
"existing file, that file's mode bits are taken from the optional argument "
"@var{base-modes}; if that argument is omitted or @code{nil}, it defaults to "
"0, i.e., no access rights at all."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1972
#, no-wrap
msgid "file-modes-number-to-symbolic modes"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1975
msgid ""
"This function converts a numeric file mode specification in @var{modes} into "
"the equivalent symbolic form."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1977
#, no-wrap
msgid "set-file-times filename &optional time flag"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1982
msgid ""
"This function sets the access and modification times of @var{filename} to "
"@var{time}. The return value is @code{t} if the times are successfully set, "
"otherwise it is @code{nil}. @var{time} defaults to the current time and "
"must be a time value (@pxref{Time of Day})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1990
msgid ""
"By default this function follows symbolic links. However, if the optional "
"argument @var{flag} is the symbol @code{nofollow}, this function does not "
"follow @var{filename} if it is a symbolic link; this can help prevent "
"inadvertently changing the times of a file somewhere else. On platforms "
"that do not support changing times on a symbolic link, this function signals "
"an error when @var{filename} is a symbolic link and @var{flag} is "
"@code{nofollow}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1992
#, no-wrap
msgid "set-file-extended-attributes filename attribute-alist"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:1999
msgid ""
"This function sets the Emacs-recognized extended file attributes for "
"@var{filename}. The second argument @var{attribute-alist} should be an "
"alist of the same form returned by @code{file-extended-attributes}. The "
"return value is @code{t} if the attributes are successfully set, otherwise "
"it is @code{nil}. @xref{Extended Attributes}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2001
#, no-wrap
msgid "set-file-selinux-context filename context"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2006
msgid ""
"This function sets the SELinux security context for @var{filename} to "
"@var{context}. The @var{context} argument should be a list "
"@code{(@var{user} @var{role} @var{type} @var{range})}, where each element is "
"a string. @xref{Extended Attributes}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2011
msgid ""
"The function returns @code{t} if it succeeds in setting the SELinux context "
"of @var{filename}. It returns @code{nil} if the context was not set (e.g., "
"if SELinux is disabled, or if Emacs was compiled without SELinux support)."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2013
#, no-wrap
msgid "set-file-acl filename acl"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2017
msgid ""
"This function sets the Access Control List for @var{filename} to @var{acl}. "
"The @var{acl} argument should have the same form returned by the function "
"@code{file-acl}. @xref{Extended Attributes}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2020
msgid ""
"The function returns @code{t} if it successfully sets the ACL of "
"@var{filename}, @code{nil} otherwise."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2023
#, no-wrap
msgid "Files and Secondary Storage"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2024
#, no-wrap
msgid "secondary storage"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2034
msgid ""
"After Emacs changes a file, there are two reasons the changes might not "
"survive later failures of power or media, both having to do with "
"efficiency. First, the operating system might alias written data with data "
"already stored elsewhere on secondary storage until one file or the other is "
"later modified; this will lose both files if the only copy on secondary "
"storage is lost due to media failure. Second, the operating system might "
"not write data to secondary storage immediately, which will lose the data if "
"power is lost."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2035
#, no-wrap
msgid "write-region"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2043
msgid ""
"Although both sorts of failures can largely be avoided by a suitably "
"configured file system, such systems are typically more expensive or less "
"efficient. In more-typical systems, to survive media failure you can copy "
"the file to a different device, and to survive a power failure you can use "
"the @code{write-region} function with the @code{write-region-inhibit-fsync} "
"variable set to @code{nil}. @xref{Writing to Files}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2046
#, no-wrap
msgid "file names"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2051
msgid ""
"Files are generally referred to by their names, in Emacs as elsewhere. File "
"names in Emacs are represented as strings. The functions that operate on a "
"file all expect a file name argument."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2056
msgid ""
"In addition to operating on files themselves, Emacs Lisp programs often need "
"to operate on file names; i.e., to take them apart and to use part of a name "
"to construct related file names. This section describes how to manipulate "
"file names."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2060
msgid ""
"The functions in this section do not actually access files, so they can "
"operate on file names that do not refer to an existing file or directory."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2061
#, no-wrap
msgid "cygwin-convert-file-name-from-windows"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2062
#, no-wrap
msgid "cygwin-convert-file-name-to-windows"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2063
#, no-wrap
msgid "MS-Windows file-name syntax"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2064
#, no-wrap
msgid "converting file names from/to MS-Windows syntax"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2075
msgid ""
"On MS-DOS and MS-Windows, these functions (like the function that actually "
"operate on files) accept MS-DOS or MS-Windows file-name syntax, where "
"backslashes separate the components, as well as POSIX syntax; but they "
"always return POSIX syntax. This enables Lisp programs to specify file "
"names in POSIX syntax and work properly on all systems without "
"change.@footnote{In MS-Windows versions of Emacs compiled for the Cygwin "
"environment, you can use the functions "
"@code{cygwin-convert-file-name-to-windows} and "
"@code{cygwin-convert-file-name-from-windows} to convert between the two "
"file-name syntaxes.}"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2086
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2088
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2089
#, no-wrap
msgid "File Name Components"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2086
msgid "The directory part of a file name, and the rest."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2086
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2247
#, no-wrap
msgid "Relative File Names"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2086
msgid "Some file names are relative to a current directory."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2086
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2320
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2321
#, no-wrap
msgid "Directory Names"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2086
msgid "A directory's name as a directory is different from its name as a file."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2086
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2426
#, no-wrap
msgid "File Name Expansion"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2086
msgid "Converting relative file names to absolute ones."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2086
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2654
#, no-wrap
msgid "Unique File Names"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2086
msgid "Generating names for temporary files."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2086
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2806
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2807
#, no-wrap
msgid "File Name Completion"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2086
msgid "Finding the completions for a given file name."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2086
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2906
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2907
#, no-wrap
msgid "Standard File Names"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2086
msgid ""
"If your package uses a fixed file name, how to handle various operating "
"systems simply."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2090
#, no-wrap
msgid "directory part (of file name)"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2091
#, no-wrap
msgid "nondirectory part (of file name)"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2092
#, no-wrap
msgid "version number (in file name)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2103
msgid ""
"The operating system groups files into directories. To specify a file, you "
"must specify the directory and the file's name within that directory. "
"Therefore, Emacs considers a file name as having two main parts: the "
"@dfn{directory name} part, and the @dfn{nondirectory} part (or @dfn{file "
"name within the directory}). Either part may be empty. Concatenating these "
"two parts reproduces the original file name. @footnote{Emacs follows the "
"GNU convention to use the term @emph{file name} instead of the term "
"@emph{pathname}. We use the term @emph{path} only for search paths, which "
"are lists of directory names.}"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2107
msgid ""
"On most systems, the directory part is everything up to and including the "
"last slash (backslash is also allowed in input on MS-DOS or MS-Windows); the "
"nondirectory part is the rest."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2111
msgid ""
"For some purposes, the nondirectory part is further subdivided into the name "
"proper and the @dfn{version number}. On most systems, only backup files "
"have version numbers in their names."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2112
#, no-wrap
msgid "file-name-directory filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2116
msgid ""
"This function returns the directory part of @var{filename}, as a directory "
"name (@pxref{Directory Names}), or @code{nil} if @var{filename} does not "
"include a directory part."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2119
msgid ""
"On GNU and other POSIX-like systems, a string returned by this function "
"always ends in a slash. On MS-DOS it can also end in a colon."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2124
#, no-wrap
msgid ""
"(file-name-directory \"lewis/foo\") ; @r{GNU example}\n"
" @result{} \"lewis/\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2128
#, no-wrap
msgid ""
"(file-name-directory \"foo\") ; @r{GNU example}\n"
" @result{} nil\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2132
#, no-wrap
msgid "file-name-nondirectory filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2134
msgid "This function returns the nondirectory part of @var{filename}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2139
#, no-wrap
msgid ""
"(file-name-nondirectory \"lewis/foo\")\n"
" @result{} \"foo\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2143
#, no-wrap
msgid ""
"(file-name-nondirectory \"foo\")\n"
" @result{} \"foo\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2147
#, no-wrap
msgid ""
"(file-name-nondirectory \"lewis/\")\n"
" @result{} \"\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2151
#, no-wrap
msgid "file-name-sans-versions filename &optional keep-backup-version"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2154
msgid ""
"This function returns @var{filename} with any file version numbers, backup "
"version numbers, or trailing tildes discarded."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2158
msgid ""
"If @var{keep-backup-version} is non-@code{nil}, then true file version "
"numbers understood as such by the file system are discarded from the return "
"value, but backup version numbers are kept."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2163
#, no-wrap
msgid ""
"(file-name-sans-versions \"~rms/foo.~1~\")\n"
" @result{} \"~rms/foo\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2167
#, no-wrap
msgid ""
"(file-name-sans-versions \"~rms/foo~\")\n"
" @result{} \"~rms/foo\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2171
#, no-wrap
msgid ""
"(file-name-sans-versions \"~rms/foo\")\n"
" @result{} \"~rms/foo\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2175
#, no-wrap
msgid "file-name-extension filename &optional period"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2181
msgid ""
"This function returns @var{filename}'s final extension, if any, after "
"applying @code{file-name-sans-versions} to remove any version/backup part. "
"The extension, in a file name, is the part that follows the last @samp{.} in "
"the last name component (minus any version/backup part)."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2188
msgid ""
"This function returns @code{nil} for extensionless file names such as "
"@file{foo}. It returns @code{\"\"} for null extensions, as in @file{foo.}. "
"If the last component of a file name begins with a @samp{.}, that @samp{.} "
"doesn't count as the beginning of an extension. Thus, @file{.emacs}'s "
"extension is @code{nil}, not @samp{.emacs}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2192
msgid ""
"If @var{period} is non-@code{nil}, then the returned value includes the "
"period that delimits the extension, and if @var{filename} has no extension, "
"the value is @code{\"\"}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2194
#, no-wrap
msgid "file-name-with-extension filename extension"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2198
msgid ""
"This function returns @var{filename} with its extension set to "
"@var{extension}. A single leading dot in the @var{extension} will be "
"stripped if there is one. For example:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2206
#, no-wrap
msgid ""
"(file-name-with-extension \"file\" \"el\")\n"
" @result{} \"file.el\"\n"
"(file-name-with-extension \"file\" \".el\")\n"
" @result{} \"file.el\"\n"
"(file-name-with-extension \"file.c\" \"el\")\n"
" @result{} \"file.el\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2211
msgid ""
"Note that this function will error if @var{filename} or @var{extension} are "
"empty, or if the @var{filename} is shaped like a directory (i.e., if "
"@code{directory-name-p} returns non-@code{nil})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2213
#, no-wrap
msgid "file-name-sans-extension filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2217
msgid ""
"This function returns @var{filename} minus its extension, if any. The "
"version/backup part, if present, is only removed if the file has an "
"extension. For example,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2231
#, no-wrap
msgid ""
"(file-name-sans-extension \"foo.lose.c\")\n"
" @result{} \"foo.lose\"\n"
"(file-name-sans-extension \"big.hack/foo\")\n"
" @result{} \"big.hack/foo\"\n"
"(file-name-sans-extension \"/my/home/.emacs\")\n"
" @result{} \"/my/home/.emacs\"\n"
"(file-name-sans-extension \"/my/home/.emacs.el\")\n"
" @result{} \"/my/home/.emacs\"\n"
"(file-name-sans-extension \"~/foo.el.~3~\")\n"
" @result{} \"~/foo\"\n"
"(file-name-sans-extension \"~/foo.~3~\")\n"
" @result{} \"~/foo.~3~\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2235
msgid ""
"Note that the @samp{.~3~} in the two last examples is the backup part, not "
"an extension."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2237
#, no-wrap
msgid "file-name-base filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2240
msgid ""
"This function is the composition of @code{file-name-sans-extension} and "
"@code{file-name-nondirectory}. For example,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2244
#, no-wrap
msgid ""
"(file-name-base \"/my/home/foo.c\")\n"
" @result{} \"foo\"\n"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2248
#, no-wrap
msgid "Absolute and Relative File Names"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2249
#, no-wrap
msgid "absolute file name"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2250
#, no-wrap
msgid "relative file name"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2264
msgid ""
"All the directories in the file system form a tree starting at the root "
"directory. A file name can specify all the directory names starting from "
"the root of the tree; then it is called an @dfn{absolute} file name. Or it "
"can specify the position of the file in the tree relative to a default "
"directory; then it is called a @dfn{relative} file name. On GNU and other "
"POSIX-like systems, after any leading @samp{~} has been expanded, an "
"absolute file name starts with a @samp{/} (@pxref{abbreviate-file-name}), "
"and a relative one does not. On MS-DOS and MS-Windows, an absolute file "
"name starts with a slash or a backslash, or with a drive specification "
"@samp{@var{x}:/}, where @var{x} is the @dfn{drive letter}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2265
#, no-wrap
msgid "file-name-absolute-p filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2272
msgid ""
"This function returns @code{t} if file @var{filename} is an absolute file "
"name, @code{nil} otherwise. A file name is considered to be absolute if its "
"first component is @samp{~}, or is @samp{~@var{user}} where @var{user} is a "
"valid login name. In the following examples, assume that there is a user "
"named @samp{rms} but no user named @samp{nosuchuser}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2277
#, no-wrap
msgid ""
"(file-name-absolute-p \"~rms/foo\")\n"
" @result{} t\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2281
#, no-wrap
msgid ""
"(file-name-absolute-p \"~nosuchuser/foo\")\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2285
#, no-wrap
msgid ""
"(file-name-absolute-p \"rms/foo\")\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2289
#, no-wrap
msgid ""
"(file-name-absolute-p \"/user/rms/foo\")\n"
" @result{} t\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2298
msgid ""
"Given a possibly relative file name, you can expand any leading @samp{~} and "
"convert the result to an absolute name using @code{expand-file-name} "
"(@pxref{File Name Expansion}). This function converts absolute file names "
"to relative names:"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2299
#, no-wrap
msgid "file-relative-name filename &optional directory"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2305
msgid ""
"This function tries to return a relative name that is equivalent to "
"@var{filename}, assuming the result will be interpreted relative to "
"@var{directory} (an absolute directory name or directory file name). If "
"@var{directory} is omitted or @code{nil}, it defaults to the current "
"buffer's default directory."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2311
msgid ""
"On some operating systems, an absolute file name begins with a device name. "
"On such systems, @var{filename} has no relative equivalent based on "
"@var{directory} if they start with two different device names. In this "
"case, @code{file-relative-name} returns @var{filename} in absolute form."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2317
#, no-wrap
msgid ""
"(file-relative-name \"/foo/bar\" \"/foo/\")\n"
" @result{} \"bar\"\n"
"(file-relative-name \"/foo/bar\" \"/hack/\")\n"
" @result{} \"../foo/bar\"\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2322
#, no-wrap
msgid "directory name"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2323
#, no-wrap
msgid "directory file name"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2324
#, no-wrap
msgid "file name of directory"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2336
msgid ""
"A @dfn{directory name} is a string that must name a directory if it names "
"any file at all. A directory is actually a kind of file, and it has a file "
"name (called the @dfn{directory file name}), which is related to the "
"directory name but is typically not identical. (This is not quite the same "
"as the usual POSIX terminology.) These two names for the same entity are "
"related by a syntactic transformation. On GNU and other POSIX-like systems, "
"this is simple: to obtain a directory name, append a @samp{/} to a directory "
"file name that does not already end in @samp{/}. On MS-DOS the relationship "
"is more complicated."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2342
msgid ""
"The difference between a directory name and a directory file name is subtle "
"but crucial. When an Emacs variable or function argument is described as "
"being a directory name, a directory file name is not acceptable. When "
"@code{file-name-directory} returns a string, that is always a directory "
"name."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2347
msgid ""
"The following two functions convert between directory names and directory "
"file names. They do nothing special with environment variable substitutions "
"such as @samp{$HOME}, and the constructs @samp{~}, @samp{.} and @samp{..}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2348
#, no-wrap
msgid "file-name-as-directory filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2353
msgid ""
"This function returns a string representing @var{filename} in a form that "
"the operating system will interpret as the name of a directory (a directory "
"name). On most systems, this means appending a slash to the string (if it "
"does not already end in one)."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2358
#, no-wrap
msgid ""
"(file-name-as-directory \"~rms/lewis\")\n"
" @result{} \"~rms/lewis/\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2362
#, no-wrap
msgid "directory-name-p filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2367
msgid ""
"This function returns non-@code{nil} if @var{filename} ends with a directory "
"separator character. This is the forward slash @samp{/} on GNU and other "
"POSIX-like systems; MS-Windows and MS-DOS recognize both the forward slash "
"and the backslash @samp{\\} as directory separators."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2369
#, no-wrap
msgid "directory-file-name dirname"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2375
msgid ""
"This function returns a string representing @var{dirname} in a form that the "
"operating system will interpret as the name of a file (a directory file "
"name). On most systems, this means removing the final directory separators "
"from the string, unless the string consists entirely of directory "
"separators."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2380
#, no-wrap
msgid ""
"(directory-file-name \"~lewis/\")\n"
" @result{} \"~lewis\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2384
#, no-wrap
msgid "file-name-concat directory &rest components"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2388
msgid ""
"Concatenate @var{components} to @var{directory}, inserting a slash before "
"the components if @var{directory} or the preceding component didn't end with "
"a slash."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2393
#, no-wrap
msgid ""
"(file-name-concat \"/tmp\" \"foo\")\n"
" @result{} \"/tmp/foo\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2399
msgid ""
"A @var{directory} or components that are @code{nil} or the empty string are "
"ignored---they are filtered out first and do not affect the results in any "
"way."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2403
msgid ""
"This is almost the same as using @code{concat}, but @var{dirname} (and the "
"non-final components) may or may not end with slash characters, and this "
"function will not double those characters."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2407
msgid "To convert a directory name to its abbreviation, use this function:"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2408
#, no-wrap
msgid "file name abbreviations"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2409
#, no-wrap
msgid "abbreviated file names"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2410
#, no-wrap
msgid "directory-abbrev-alist"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2411
#, no-wrap
msgid "abbreviate-file-name filename"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2421
msgid "abbreviate-file-name"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2421
msgid ""
"This function returns an abbreviated form of @var{filename}. It applies the "
"abbreviations specified in @code{directory-abbrev-alist} (@pxref{File "
"Aliases,,File Aliases, emacs, The GNU Emacs Manual}), then substitutes "
"@samp{~} for the user's home directory if the argument names a file in the "
"home directory or one of its subdirectories. If the home directory is a "
"root directory, it is not replaced with @samp{~}, because this does not make "
"the result shorter on many systems."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2424
msgid ""
"You can use this function for directory names and for file names, because it "
"recognizes abbreviations even as part of the name."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2427
#, no-wrap
msgid "Functions that Expand Filenames"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2428
#, no-wrap
msgid "expansion of file names"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2435
msgid ""
"@dfn{Expanding} a file name means converting a relative file name to an "
"absolute one. Since this is done relative to a default directory, you must "
"specify the default directory as well as the file name to be expanded. It "
"also involves expanding abbreviations like @file{~/}"
msgstr ""
#. type: ifnottex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2437
msgid "(@pxref{abbreviate-file-name}),"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2439
msgid "and eliminating redundancies like @file{./} and @file{@var{name}/../}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2440
#, no-wrap
msgid "expand-file-name filename &optional directory"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2448
msgid ""
"This function converts @var{filename} to an absolute file name. If "
"@var{directory} is supplied, it is the default directory to start with if "
"@var{filename} is relative and does not start with @samp{~}. (The value of "
"@var{directory} should itself be an absolute directory name or directory "
"file name; it may start with @samp{~}.) Otherwise, the current buffer's "
"value of @code{default-directory} is used. For example:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2453
#, no-wrap
msgid ""
"(expand-file-name \"foo\")\n"
" @result{} \"/xcssun/users/rms/lewis/foo\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2457
#, no-wrap
msgid ""
"(expand-file-name \"../foo\")\n"
" @result{} \"/xcssun/users/rms/foo\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2461
#, no-wrap
msgid ""
"(expand-file-name \"foo\" \"/usr/spool/\")\n"
" @result{} \"/usr/spool/foo\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2475
msgid ""
"If the part of @var{filename} before the first slash is @samp{~}, it expands "
"to your home directory, which is typically specified by the value of the "
"@env{HOME} environment variable (@pxref{General Variables,,, emacs, The GNU "
"Emacs Manual}). If the part before the first slash is @samp{~@var{user}} "
"and if @var{user} is a valid login name, it expands to @var{user}'s home "
"directory. If you do not want this expansion for a relative @var{filename} "
"that might begin with a literal @samp{~}, you can use @code{(concat "
"(file-name-as-directory directory) filename)} instead of "
"@code{(expand-file-name filename directory)}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2478
msgid ""
"File names containing @samp{.} or @samp{..} are simplified to their "
"canonical form:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2483
#, no-wrap
msgid ""
"(expand-file-name \"bar/../foo\")\n"
" @result{} \"/xcssun/users/rms/lewis/foo\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2487
msgid "In some cases, a leading @samp{..} component can remain in the output:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2492
#, no-wrap
msgid ""
"(expand-file-name \"../home\" \"/\")\n"
" @result{} \"/../home\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2499
msgid ""
"This is for the sake of filesystems that have the concept of a superroot "
"above the root directory @file{/}. On other filesystems, @file{/../} is "
"interpreted exactly the same as @file{/}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2501
msgid "Expanding @file{.} or the empty string returns the default directory:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2508
#, no-wrap
msgid ""
"(expand-file-name \".\" \"/usr/spool/\")\n"
" @result{} \"/usr/spool\"\n"
"(expand-file-name \"\" \"/usr/spool/\")\n"
" @result{} \"/usr/spool\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2513
msgid ""
"Note that @code{expand-file-name} does @emph{not} expand environment "
"variables; only @code{substitute-in-file-name} does that:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2518
#, no-wrap
msgid ""
"(expand-file-name \"$HOME/foo\")\n"
" @result{} \"/xcssun/users/rms/lewis/$HOME/foo\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2526
msgid ""
"Note also that @code{expand-file-name} does not follow symbolic links at any "
"level. This results in a difference between the way @code{file-truename} "
"and @code{expand-file-name} treat @samp{..}. Assuming that @samp{/tmp/bar} "
"is a symbolic link to the directory @samp{/tmp/foo/bar} we get:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2531
#, no-wrap
msgid ""
"(file-truename \"/tmp/bar/../myfile\")\n"
" @result{} \"/tmp/foo/myfile\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2535
#, no-wrap
msgid ""
"(expand-file-name \"/tmp/bar/../myfile\")\n"
" @result{} \"/tmp/myfile\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2541
msgid ""
"If you may need to follow symbolic links preceding @samp{..}, you should "
"make sure to call @code{file-truename} without prior direct or indirect "
"calls to @code{expand-file-name}. @xref{Truenames}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2543
#, no-wrap
msgid "default-directory"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2547
msgid ""
"The value of this buffer-local variable is the default directory for the "
"current buffer. It should be an absolute directory name; it may start with "
"@samp{~}. This variable is buffer-local in every buffer."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2550
msgid ""
"@code{expand-file-name} uses the default directory when its second argument "
"is @code{nil}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2552
msgid "The value is always a string ending with a slash."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2557
#, no-wrap
msgid ""
"default-directory\n"
" @result{} \"/user/lewis/manual/\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2561
#, no-wrap
msgid "substitute-in-file-name filename"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2569
msgid "Definition of substitute-in-file-name"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2569
msgid ""
"This function replaces environment variable references in @var{filename} "
"with the environment variable values. Following standard Unix shell syntax, "
"@samp{$} is the prefix to substitute an environment variable value. If the "
"input contains @samp{$$}, that is converted to @samp{$}; this gives the user "
"a way to quote a @samp{$}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2574
msgid ""
"The environment variable name is the series of alphanumeric characters "
"(including underscores) that follow the @samp{$}. If the character "
"following the @samp{$} is a @samp{@{}, then the variable name is everything "
"up to the matching @samp{@}}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2583
msgid ""
"Calling @code{substitute-in-file-name} on output produced by "
"@code{substitute-in-file-name} tends to give incorrect results. For "
"instance, use of @samp{$$} to quote a single @samp{$} won't work properly, "
"and @samp{$} in an environment variable's value could lead to repeated "
"substitution. Therefore, programs that call this function and put the "
"output where it will be passed to this function need to double all @samp{$} "
"characters to prevent subsequent incorrect results."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2587
msgid ""
"Here we assume that the environment variable @env{HOME}, which holds the "
"user's home directory, has value @samp{/xcssun/users/rms}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2592
#, no-wrap
msgid ""
"(substitute-in-file-name \"$HOME/foo\")\n"
" @result{} \"/xcssun/users/rms/foo\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2598
msgid ""
"After substitution, if a @samp{~} or a @samp{/} appears immediately after "
"another @samp{/}, the function discards everything before it (up through the "
"immediately preceding @samp{/})."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2603
#, no-wrap
msgid ""
"(substitute-in-file-name \"bar/~/foo\")\n"
" @result{} \"~/foo\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2608
#, no-wrap
msgid ""
"(substitute-in-file-name \"/usr/local/$HOME/foo\")\n"
" @result{} \"/xcssun/users/rms/foo\"\n"
" ;; @r{@file{/usr/local/} has been discarded.}\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2617
msgid ""
"Sometimes, it is not desired to expand file names. In such cases, the file "
"name can be quoted to suppress the expansion, and to handle the file name "
"literally. Quoting happens by prefixing the file name with @samp{/:}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2618
#, no-wrap
msgid "file-name-quote name"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2624
msgid ""
"This macro adds the quotation prefix @samp{/:} to the file @var{name}. For "
"a local file @var{name}, it prefixes @var{name} with @samp{/:}. If "
"@var{name} is a remote file name, the local part of @var{name} (@pxref{Magic "
"File Names}) is quoted. If @var{name} is already a quoted file name, "
"@var{name} is returned unchanged."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2629
#, no-wrap
msgid ""
"(substitute-in-file-name (file-name-quote \"bar/~/foo\"))\n"
" @result{} \"/:bar/~/foo\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2634
#, no-wrap
msgid ""
"(substitute-in-file-name (file-name-quote \"/ssh:host:bar/~/foo\"))\n"
" @result{} \"/ssh:host:/:bar/~/foo\"\n"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2639
msgid ""
"The macro cannot be used to suppress file name handlers from magic file "
"names (@pxref{Magic File Names})."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2641
#, no-wrap
msgid "file-name-unquote name"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2645
msgid ""
"This macro removes the quotation prefix @samp{/:} from the file @var{name}, "
"if any. If @var{name} is a remote file name, the local part of @var{name} is "
"unquoted."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2647
#, no-wrap
msgid "file-name-quoted-p name"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2651
msgid ""
"This macro returns non-@code{nil}, when @var{name} is quoted with the prefix "
"@samp{/:}. If @var{name} is a remote file name, the local part of "
"@var{name} is checked."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2655
#, no-wrap
msgid "Generating Unique File Names"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2656
#, no-wrap
msgid "unique file names"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2657
#, no-wrap
msgid "temporary files"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2661
msgid ""
"Some programs need to write temporary files. Here is the usual way to "
"construct a name for such a file:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2664
#, no-wrap
msgid "(make-temp-file @var{name-of-application})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2669
msgid ""
"The job of @code{make-temp-file} is to prevent two different users or two "
"different jobs from trying to use the exact same file name."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2670
#, no-wrap
msgid "make-temp-file prefix &optional dir-flag suffix text"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2679
msgid ""
"This function creates a temporary file and returns its name. Emacs creates "
"the temporary file's name by adding to @var{prefix} some random characters "
"that are different in each Emacs job. The result is guaranteed to be a "
"newly created file, containing @var{text} if that's given as a string and "
"empty otherwise. On MS-DOS, this function can truncate @var{prefix} to fit "
"into the 8+3 file-name limits. If @var{prefix} is a relative file name, it "
"is expanded against @code{temporary-file-directory}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2684
#, no-wrap
msgid ""
"(make-temp-file \"foo\")\n"
" @result{} \"/tmp/foo232J6v\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2690
msgid ""
"When @code{make-temp-file} returns, the file has been created and is empty. "
"At that point, you should write the intended contents into the file."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2694
msgid ""
"If @var{dir-flag} is non-@code{nil}, @code{make-temp-file} creates an empty "
"directory instead of an empty file. It returns the file name, not the "
"directory name, of that directory. @xref{Directory Names}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2697
msgid ""
"If @var{suffix} is non-@code{nil}, @code{make-temp-file} adds it at the end "
"of the file name."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2699
msgid "If @var{text} is a string, @code{make-temp-file} inserts it in the file."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2706
msgid ""
"To prevent conflicts among different libraries running in the same Emacs, "
"each Lisp program that uses @code{make-temp-file} should have its own "
"@var{prefix}. The number added to the end of @var{prefix} distinguishes "
"between the same application running in different Emacs jobs. Additional "
"added characters permit a large number of distinct names even in one Emacs "
"job."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2714
msgid ""
"The default directory for temporary files is controlled by the variable "
"@code{temporary-file-directory}. This variable gives the user a uniform way "
"to specify the directory for all temporary files. Some programs use "
"@code{small-temporary-file-directory} instead, if that is non-@code{nil}. "
"To use it, you should expand the prefix against the proper directory before "
"calling @code{make-temp-file}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2715
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2791
#, no-wrap
msgid "temporary-file-directory"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2716
#, no-wrap
msgid "@env{TMPDIR} environment variable"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2717
#, no-wrap
msgid "@env{TMP} environment variable"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2718
#, no-wrap
msgid "@env{TEMP} environment variable"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2724
msgid ""
"This variable specifies the directory name for creating temporary files. "
"Its value should be a directory name (@pxref{Directory Names}), but it is "
"good for Lisp programs to cope if the value is a directory's file name "
"instead. Using the value as the second argument to @code{expand-file-name} "
"is a good way to achieve that."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2729
msgid ""
"The default value is determined in a reasonable way for your operating "
"system; it is based on the @env{TMPDIR}, @env{TMP} and @env{TEMP} "
"environment variables, with a fall-back to a system-dependent name if none "
"of these variables is defined."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2735
msgid ""
"Even if you do not use @code{make-temp-file} to create the temporary file, "
"you should still use this variable to decide which directory to put the file "
"in. However, if you expect the file to be small, you should use "
"@code{small-temporary-file-directory} first if that is non-@code{nil}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2737
#, no-wrap
msgid "small-temporary-file-directory"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2740
msgid ""
"This variable specifies the directory name for creating certain temporary "
"files, which are likely to be small."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2743
msgid ""
"If you want to write a temporary file which is likely to be small, you "
"should compute the directory like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2749
#, no-wrap
msgid ""
"(make-temp-file\n"
" (expand-file-name @var{prefix}\n"
" (or small-temporary-file-directory\n"
" temporary-file-directory)))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2752
#, no-wrap
msgid "make-temp-name base-name"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2761
msgid ""
"This function generates a string that might be a unique file name. The name "
"starts with @var{base-name}, and has several random characters appended to "
"it, which are different in each Emacs job. It is like @code{make-temp-file} "
"except that (i) it just constructs a name and does not create a file, (ii) "
"@var{base-name} should be an absolute file name that is not magic, and (iii) "
"if the returned file name is magic, it might name an existing file. "
"@xref{Magic File Names}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2766
msgid ""
"@strong{Warning:} In most cases, you should not use this function; use "
"@code{make-temp-file} instead! This function is susceptible to a race "
"condition, between the @code{make-temp-name} call and the creation of the "
"file, which in some cases may cause a security hole."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2770
msgid ""
"Sometimes, it is necessary to create a temporary file on a remote host or a "
"mounted directory. The following two functions support this."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2771
#, no-wrap
msgid "temporary file on a remote host"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2772
#, no-wrap
msgid "make-nearby-temp-file prefix &optional dir-flag suffix"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2781
msgid ""
"This function is similar to @code{make-temp-file}, but it creates a "
"temporary file as close as possible to @code{default-directory}. If "
"@var{prefix} is a relative file name, and @code{default-directory} is a "
"remote file name or located on a mounted file systems, the temporary file is "
"created in the directory returned by the function "
"@code{temporary-file-directory}. Otherwise, the function "
"@code{make-temp-file} is used. @var{prefix}, @var{dir-flag} and "
"@var{suffix} have the same meaning as in @code{make-temp-file}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2787
#, no-wrap
msgid ""
"(let ((default-directory \"/ssh:remotehost:\"))\n"
" (make-nearby-temp-file \"foo\"))\n"
" @result{} \"/ssh:remotehost:/tmp/foo232J6v\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2801
msgid ""
"The directory for writing temporary files via @code{make-nearby-temp-file}. "
"In case of a remote @code{default-directory}, this is a directory for "
"temporary files on that remote host. If such a directory does not exist, or "
"@code{default-directory} ought to be located on a mounted file system (see "
"@code{mounted-file-systems}), the function returns "
"@code{default-directory}. For a non-remote and non-mounted "
"@code{default-directory}, the value of the variable "
"@code{temporary-file-directory} is returned."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2805
msgid ""
"In order to extract the local part of the file's name of a temporary file, "
"use @code{file-local-name} (@pxref{Magic File Names})."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2808
#, no-wrap
msgid "file name completion subroutines"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2809
#, no-wrap
msgid "completion, file name"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2813
msgid ""
"This section describes low-level subroutines for completing a file name. "
"For higher level functions, see @ref{Reading File Names}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2814
#, no-wrap
msgid "file-name-all-completions partial-filename directory"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2820
msgid ""
"This function returns a list of all possible completions for a file whose "
"name starts with @var{partial-filename} in directory @var{directory}. The "
"order of the completions is the order of the files in the directory, which "
"is unpredictable and conveys no useful information."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2825
msgid ""
"The argument @var{partial-filename} must be a file name containing no "
"directory part and no slash (or backslash on some systems). The current "
"buffer's default directory is prepended to @var{directory}, if "
"@var{directory} is not absolute."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2830
msgid ""
"In the following example, suppose that @file{~rms/lewis} is the current "
"default directory, and has five files whose names begin with @samp{f}: "
"@file{foo}, @file{file~}, @file{file.c}, @file{file.c.~1~}, and "
"@file{file.c.~2~}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2836
#, no-wrap
msgid ""
"(file-name-all-completions \"f\" \"\")\n"
" @result{} (\"foo\" \"file~\" \"file.c.~2~\"\n"
" \"file.c.~1~\" \"file.c\")\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2841
#, no-wrap
msgid ""
"(file-name-all-completions \"fo\" \"\")\n"
" @result{} (\"foo\")\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2845
#, no-wrap
msgid "file-name-completion filename directory &optional predicate"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2852
msgid ""
"This function completes the file name @var{filename} in directory "
"@var{directory}. It returns the longest prefix common to all file names in "
"directory @var{directory} that start with @var{filename}. If "
"@var{predicate} is non-@code{nil} then it ignores possible completions that "
"don't satisfy @var{predicate}, after calling that function with one "
"argument, the expanded absolute file name."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2856
msgid ""
"If only one match exists and @var{filename} matches it exactly, the function "
"returns @code{t}. The function returns @code{nil} if directory "
"@var{directory} contains no name starting with @var{filename}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2861
msgid ""
"In the following example, suppose that the current default directory has "
"five files whose names begin with @samp{f}: @file{foo}, @file{file~}, "
"@file{file.c}, @file{file.c.~1~}, and @file{file.c.~2~}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2866
#, no-wrap
msgid ""
"(file-name-completion \"fi\" \"\")\n"
" @result{} \"file\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2871
#, no-wrap
msgid ""
"(file-name-completion \"file.c.~1\" \"\")\n"
" @result{} \"file.c.~1~\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2876
#, no-wrap
msgid ""
"(file-name-completion \"file.c.~1~\" \"\")\n"
" @result{} t\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2881
#, no-wrap
msgid ""
"(file-name-completion \"file.c.~3\" \"\")\n"
" @result{} nil\n"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2885
#, no-wrap
msgid "completion-ignored-extensions"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2890
msgid ""
"@code{file-name-completion} usually ignores file names that end in any "
"string in this list. It does not ignore them when all the possible "
"completions end in one of these suffixes. This variable has no effect on "
"@code{file-name-all-completions}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2892
msgid "A typical value might look like this:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2897
#, no-wrap
msgid ""
"completion-ignored-extensions\n"
" @result{} (\".o\" \".elc\" \"~\" \".dvi\")\n"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2904
msgid ""
"If an element of @code{completion-ignored-extensions} ends in a slash "
"@samp{/}, it signals a directory. The elements which do @emph{not} end in a "
"slash will never match a directory; thus, the above value will not filter "
"out a directory named @file{foo.elc}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2919
msgid ""
"Sometimes, an Emacs Lisp program needs to specify a standard file name for a "
"particular use---typically, to hold configuration data specified by the "
"current user. Usually, such files should be located in the directory "
"specified by @code{user-emacs-directory}, which is typically "
"@file{~/.config/emacs/} or @file{~/.emacs.d/} by default (@pxref{Find "
"Init,,How Emacs Finds Your Init File, emacs, The GNU Emacs Manual}). For "
"example, abbrev definitions are stored by default in "
"@file{~/.config/emacs/abbrev_defs} or @file{~/.emacs.d/abbrev_defs}. The "
"easiest way to specify such a file name is to use the function "
"@code{locate-user-emacs-file}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2920
#, no-wrap
msgid "locate-user-emacs-file base-name &optional old-name"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2926
msgid ""
"This function returns an absolute file name for an Emacs-specific "
"configuration or data file. The argument @file{base-name} should be a "
"relative file name. The return value is the absolute name of a file in the "
"directory specified by @code{user-emacs-directory}; if that directory does "
"not exist, this function creates it."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2936
msgid ""
"If the optional argument @var{old-name} is non-@code{nil}, it specifies a "
"file in the user's home directory, @file{~/@var{old-name}}. If such a file "
"exists, the return value is the absolute name of that file, instead of the "
"file specified by @var{base-name}. This argument is intended to be used by "
"Emacs packages to provide backward compatibility. For instance, prior to "
"the introduction of @code{user-emacs-directory}, the abbrev file was located "
"in @file{~/.abbrev_defs}. Here is the definition of "
"@code{abbrev-file-name}:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2943
#, no-wrap
msgid ""
"(defcustom abbrev-file-name\n"
" (locate-user-emacs-file \"abbrev_defs\" \".abbrev_defs\")\n"
" \"Default name of file from which to read abbrevs.\"\n"
" @dots{}\n"
" :type 'file)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2949
msgid ""
"A lower-level function for standardizing file names, which "
"@code{locate-user-emacs-file} uses as a subroutine, is "
"@code{convert-standard-filename}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2950
#, no-wrap
msgid "convert-standard-filename filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2953
msgid ""
"This function returns a file name based on @var{filename}, which fits the "
"conventions of the current operating system."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2960
msgid ""
"On GNU and other POSIX-like systems, this simply returns @var{filename}. On "
"other operating systems, it may enforce system-specific file name "
"conventions; for example, on MS-DOS this function performs a variety of "
"changes to enforce MS-DOS file name limitations, including converting any "
"leading @samp{.} to @samp{_} and truncating to three characters after the "
"@samp{.}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2964
msgid ""
"The recommended way to use this function is to specify a name which fits the "
"conventions of GNU and Unix systems, and pass it to "
"@code{convert-standard-filename}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2968
#, no-wrap
msgid "directory-oriented functions"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2969
#, no-wrap
msgid "file names in directory"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2973
msgid ""
"A directory is a kind of file that contains other files entered under "
"various names. Directories are a feature of the file system."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2978
msgid ""
"Emacs can list the names of the files in a directory as a Lisp list, or "
"display the names in a buffer using the @code{ls} shell command. In the "
"latter case, it can optionally display information about each file, "
"depending on the options passed to the @code{ls} command."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2979
#, no-wrap
msgid "directory-files directory &optional full-name match-regexp nosort count"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2982
msgid ""
"This function returns a list of the names of the files in the directory "
"@var{directory}. By default, the list is in alphabetical order."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2986
msgid ""
"If @var{full-name} is non-@code{nil}, the function returns the files' "
"absolute file names. Otherwise, it returns the names relative to the "
"specified directory."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2992
msgid ""
"If @var{match-regexp} is non-@code{nil}, this function returns only those "
"file names whose non-directory part contain a match for that regular "
"expression---the other file names are excluded from the list. On "
"case-insensitive filesystems, the regular expression matching is "
"case-insensitive."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:2998
msgid ""
"If @var{nosort} is non-@code{nil}, @code{directory-files} does not sort the "
"list, so you get the file names in no particular order. Use this if you "
"want the utmost possible speed and don't care what order the files are "
"processed in. If the order of processing is visible to the user, then the "
"user will probably be happier if you do sort the names."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3002
msgid ""
"If @var{count} is non-@code{nil}, the function will return names of first "
"@var{count} number of files, or names of all files, whichever occurs first. "
"@var{count} has to be an integer greater than zero."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3009
#, no-wrap
msgid ""
"(directory-files \"~lewis\")\n"
" @result{} (\"#foo#\" \"#foo.el#\" \".\" \"..\"\n"
" \"dired-mods.el\" \"files.texi\"\n"
" \"files.texi.~1~\")\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3014
msgid ""
"An error is signaled if @var{directory} is not the name of a directory that "
"can be read."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3016
#, no-wrap
msgid "directory-empty-p directory"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3021
msgid ""
"This utility function returns @code{t} if given @var{directory} is an "
"accessible directory and it does not contain any files, i.e., is an empty "
"directory. It will ignore @samp{.} and @samp{..} on systems that return "
"them as files in a directory."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3024
msgid ""
"Symbolic links to directories count as directories. See "
"@var{file-symlink-p} to distinguish symlinks."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3026
#, no-wrap
msgid "recursive traverse of directory tree"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3027
#, no-wrap
msgid ""
"directory-files-recursively directory regexp &optional include-directories "
"predicate follow-symlinks"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3041
msgid ""
"Return all files under @var{directory} whose names match @var{regexp}. This "
"function searches the specified @var{directory} and its sub-directories, "
"recursively, for files whose basenames (i.e., without the leading "
"directories) match the specified @var{regexp}, and returns a list of the "
"absolute file names of the matching files (@pxref{Relative File Names, "
"absolute file names}). The file names are returned in depth-first order, "
"meaning that files in some sub-directory are returned before the files in "
"its parent directory. In addition, matching files found in each "
"subdirectory are sorted alphabetically by their basenames. By default, "
"directories whose names match @var{regexp} are omitted from the list, but if "
"the optional argument @var{include-directories} is non-@code{nil}, they are "
"included."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3048
msgid ""
"By default, all subdirectories are descended into. If @var{predicate} is "
"@code{t}, errors when trying to descend into a subdirectory (for instance, "
"if it's not readable by this user) are ignored. If it's neither @code{nil} "
"nor @code{t}, it should be a function that takes one parameter (the "
"subdirectory name) and should return non-@code{nil} if the directory is to "
"be descended into."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3051
msgid ""
"Symbolic links to subdirectories are not followed by default, but if "
"@var{follow-symlinks} is non-@code{nil}, they are followed."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3054
#, no-wrap
msgid "locate-dominating-file file name"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3064
msgid ""
"Starting at @var{file}, go up the directory tree hierarchy looking for the "
"first directory where @var{name}, a string, exists, and return that "
"directory. If @var{file} is a file, its directory will serve as the "
"starting point for the search; otherwise @var{file} should be a directory "
"from which to start. The function looks in the starting directory, then in "
"its parent, then in its parent's parent, etc., until it either finds a "
"directory with @var{name} or reaches the root directory of the filesystem "
"without finding @var{name} -- in the latter case the function returns "
"@code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3070
msgid ""
"The argument @code{name} can also be a predicate function. The predicate is "
"called for every directory examined by the function, starting from "
"@var{file} (even if @var{file} is not a directory). It is called with one "
"argument (the file or directory) and should return non-@code{nil} if that "
"directory is the one it is looking for."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3072
#, no-wrap
msgid ""
"directory-files-and-attributes directory &optional full-name match-regexp "
"nosort id-format count"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3081
msgid ""
"This is similar to @code{directory-files} in deciding which files to report "
"on and how to report their names. However, instead of returning a list of "
"file names, it returns for each file a list @code{(@var{filename} "
". @var{attributes})}, where @var{attributes} is what @code{file-attributes} "
"returns for that file. The optional argument @var{id-format} has the same "
"meaning as the corresponding argument to @code{file-attributes} "
"(@pxref{Definition of file-attributes})."
msgstr ""
#. type: defvr
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3083
#, no-wrap
msgid "Constant directory-files-no-dot-files-regexp"
msgstr ""
#. type: defvr
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3088
msgid ""
"This regular expression matches any file name except @samp{.} and "
"@samp{..}. More precisely, it matches parts of any nonempty string except "
"those two. It is useful as the @var{match-regexp} argument to "
"@code{directory-files} and @code{directory-files-and-attributes}:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3091
#, no-wrap
msgid "(directory-files \"/foo\" nil directory-files-no-dot-files-regexp)\n"
msgstr ""
#. type: defvr
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3094
msgid "returns @code{nil}, if directory @samp{/foo} is empty."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3096
#, no-wrap
msgid "file-expand-wildcards pattern &optional full"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3099
msgid ""
"This function expands the wildcard pattern @var{pattern}, returning a list "
"of file names that match it."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3102
msgid ""
"If @var{pattern} is written as an absolute file name, the values are "
"absolute also."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3107
msgid ""
"If @var{pattern} is written as a relative file name, it is interpreted "
"relative to the current default directory. The file names returned are "
"normally also relative to the current default directory. However, if "
"@var{full} is non-@code{nil}, they are absolute."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3109
#, no-wrap
msgid "insert-directory file switches &optional wildcard full-directory-p"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3115
msgid ""
"This function inserts (in the current buffer) a directory listing for "
"directory @var{file}, formatted with @code{ls} according to @var{switches}. "
"It leaves point after the inserted text. @var{switches} may be a string of "
"options, or a list of strings representing individual options."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3120
msgid ""
"The argument @var{file} may be either a directory or a file specification "
"including wildcard characters. If @var{wildcard} is non-@code{nil}, that "
"means treat @var{file} as a file specification with wildcards."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3127
msgid ""
"If @var{full-directory-p} is non-@code{nil}, that means the directory "
"listing is expected to show the full contents of a directory. You should "
"specify @code{t} when @var{file} is a directory and switches do not contain "
"@samp{-d}. (The @samp{-d} option to @code{ls} says to describe a directory "
"itself as a file, rather than showing its contents.)"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3132
msgid ""
"On most systems, this function works by running a directory listing program "
"whose name is in the variable @code{insert-directory-program}. If "
"@var{wildcard} is non-@code{nil}, it also runs the shell specified by "
"@code{shell-file-name}, to expand the wildcards."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3136
msgid ""
"MS-DOS and MS-Windows systems usually lack the standard Unix program "
"@code{ls}, so this function emulates the standard Unix program @code{ls} "
"with Lisp code."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3142
msgid ""
"As a technical detail, when @var{switches} contains the long @samp{--dired} "
"option, @code{insert-directory} treats it specially, for the sake of dired. "
"However, the normally equivalent short @samp{-D} option is just passed on to "
"@code{insert-directory-program}, as any other option."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3144
#, no-wrap
msgid "insert-directory-program"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3148
msgid ""
"This variable's value is the program to run to generate a directory listing "
"for the function @code{insert-directory}. It is ignored on systems which "
"generate the listing with Lisp code."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3151
#, no-wrap
msgid "Creating, Copying and Deleting Directories"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3152
#, no-wrap
msgid "creating, copying and deleting directories"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3158
msgid ""
"Most Emacs Lisp file-manipulation functions get errors when used on files "
"that are directories. For example, you cannot delete a directory with "
"@code{delete-file}. These special functions exist to create and delete "
"directories."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3159
#, no-wrap
msgid "mkdir"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3160
#, no-wrap
msgid "Command make-directory dirname &optional parents"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3166
msgid ""
"This command creates a directory named @var{dirname}. If @var{parents} is "
"non-@code{nil}, as is always the case in an interactive call, that means to "
"create the parent directories first, if they don't already exist. "
"@code{mkdir} is an alias for this."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3168
#, no-wrap
msgid "Command make-empty-file filename &optional parents"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3173
msgid ""
"This command creates an empty file named @var{filename}. As "
"@code{make-directory}, this command creates parent directories if "
"@var{parents} is non-@code{nil}. If @var{filename} already exists, this "
"command signals an error."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3175
#, no-wrap
msgid ""
"Command copy-directory dirname newname &optional keep-time parents "
"copy-contents"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3180
msgid ""
"This command copies the directory named @var{dirname} to @var{newname}. If "
"@var{newname} is a directory name, @var{dirname} will be copied to a "
"subdirectory there. @xref{Directory Names}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3183
msgid ""
"It always sets the file modes of the copied files to match the corresponding "
"original file."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3187
msgid ""
"The third argument @var{keep-time} non-@code{nil} means to preserve the "
"modification time of the copied files. A prefix arg makes @var{keep-time} "
"non-@code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3191
msgid ""
"The fourth argument @var{parents} says whether to create parent directories "
"if they don't exist. Interactively, this happens by default."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3196
msgid ""
"The fifth argument @var{copy-contents}, if non-@code{nil}, means to copy the "
"contents of @var{dirname} directly into @var{newname} if the latter is a "
"directory name, instead of copying @var{dirname} into it as a subdirectory."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3200
#, no-wrap
msgid "Command delete-directory dirname &optional recursive trash"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3209
msgid ""
"This command deletes the directory named @var{dirname}. The function "
"@code{delete-file} does not work for files that are directories; you must "
"use @code{delete-directory} for them. If @var{recursive} is @code{nil}, and "
"the directory contains any files, @code{delete-directory} signals an error. "
"If recursive is non-@code{nil}, there is no error merely because the "
"directory or its files are deleted by some other process before "
"@code{delete-directory} gets to them."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3212
msgid ""
"@code{delete-directory} only follows symbolic links at the level of parent "
"directories."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3222
#, no-wrap
msgid "Making Certain File Names ``Magic''"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3223
#, no-wrap
msgid "magic file names"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3229
msgid ""
"You can implement special handling for certain file names. This is called "
"making those names @dfn{magic}. The principal use for this feature is in "
"implementing access to remote files (@pxref{Remote Files,, Remote Files, "
"emacs, The GNU Emacs Manual})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3234
msgid ""
"To define a kind of magic file name, you must supply a regular expression to "
"define the class of names (all those that match the regular expression), "
"plus a handler that implements all the primitive Emacs file operations for "
"file names that match."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3235
#, no-wrap
msgid "file name handler"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3236
#, no-wrap
msgid "file-name-handler-alist"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3240
msgid ""
"The variable @code{file-name-handler-alist} holds a list of handlers, "
"together with regular expressions that determine when to apply each "
"handler. Each element has this form:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3243
#, no-wrap
msgid "(@var{regexp} . @var{handler})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3250
msgid ""
"All the Emacs primitives for file access and file name transformation check "
"the given file name against @code{file-name-handler-alist}. If the file "
"name matches @var{regexp}, the primitives handle that file by calling "
"@var{handler}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3255
msgid ""
"The first argument given to @var{handler} is the name of the primitive, as a "
"symbol; the remaining arguments are the arguments that were passed to that "
"primitive. (The first of these arguments is most often the file name "
"itself.) For example, if you do this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3258
#, no-wrap
msgid "(file-exists-p @var{filename})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3263
msgid ""
"and @var{filename} has handler @var{handler}, then @var{handler} is called "
"like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3266
#, no-wrap
msgid "(funcall @var{handler} 'file-exists-p @var{filename})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3271
msgid ""
"When a function takes two or more arguments that must be file names, it "
"checks each of those names for a handler. For example, if you do this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3274
#, no-wrap
msgid "(expand-file-name @var{filename} @var{dirname})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3280
msgid ""
"then it checks for a handler for @var{filename} and then for a handler for "
"@var{dirname}. In either case, the @var{handler} is called like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3283
#, no-wrap
msgid "(funcall @var{handler} 'expand-file-name @var{filename} @var{dirname})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3288
msgid ""
"The @var{handler} then needs to figure out whether to handle @var{filename} "
"or @var{dirname}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3293
msgid ""
"If the specified file name matches more than one handler, the one whose "
"match starts last in the file name gets precedence. This rule is chosen so "
"that handlers for jobs such as uncompression are handled first, before "
"handlers for jobs such as remote file access."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3295
msgid "Here are the operations that a magic file name handler gets to handle:"
msgstr ""
#. type: ifnottex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3354
msgid ""
"@code{access-file}, @code{add-name-to-file}, "
"@code{byte-compiler-base-file-name},@* @code{copy-directory}, "
"@code{copy-file}, @code{delete-directory}, @code{delete-file}, "
"@code{diff-latest-backup-file}, @code{directory-file-name}, "
"@code{directory-files}, @code{directory-files-and-attributes}, "
"@code{dired-compress-file}, @code{dired-uncache}, @code{exec-path}, "
"@code{expand-file-name},@* @code{file-accessible-directory-p}, "
"@code{file-acl}, @code{file-attributes}, @code{file-directory-p}, "
"@code{file-equal-p}, @code{file-executable-p}, @code{file-exists-p}, "
"@code{file-in-directory-p}, @code{file-local-copy}, @code{file-locked-p}, "
"@code{file-modes}, @code{file-name-all-completions}, "
"@code{file-name-as-directory}, @code{file-name-case-insensitive-p}, "
"@code{file-name-completion}, @code{file-name-directory}, "
"@code{file-name-nondirectory}, @code{file-name-sans-versions}, "
"@code{file-newer-than-file-p}, @code{file-notify-add-watch}, "
"@code{file-notify-rm-watch}, @code{file-notify-valid-p}, "
"@code{file-ownership-preserved-p}, @code{file-readable-p}, "
"@code{file-regular-p}, @code{file-remote-p}, @code{file-selinux-context}, "
"@code{file-symlink-p}, @code{file-system-info}, @code{file-truename}, "
"@code{file-writable-p}, @code{find-backup-file-name},@* "
"@code{get-file-buffer}, @code{insert-directory}, "
"@code{insert-file-contents},@* @code{load}, @code{lock-file}, "
"@code{make-auto-save-file-name}, @code{make-directory}, "
"@code{make-directory-internal}, @code{make-lock-file-name}, "
"@code{make-nearby-temp-file}, @code{make-process}, "
"@code{make-symbolic-link},@* @code{process-file}, @code{rename-file}, "
"@code{set-file-acl}, @code{set-file-modes}, @code{set-file-selinux-context}, "
"@code{set-file-times}, @code{set-visited-file-modtime}, "
"@code{shell-command}, @code{start-file-process}, "
"@code{substitute-in-file-name},@* @code{temporary-file-directory}, "
"@code{unhandled-file-name-directory}, @code{unlock-file}, "
"@code{vc-registered}, @code{verify-visited-file-modtime},@* "
"@code{write-region}."
msgstr ""
#. type: flushleft
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3414
#, no-wrap
msgid ""
"@code{access-file}, @code{add-name-to-file},\n"
"@code{byte-com@discretionary{}{}{}piler-base-file-name},\n"
"@code{copy-directory}, @code{copy-file},\n"
"@code{delete-directory}, @code{delete-file},\n"
"@code{diff-latest-backup-file},\n"
"@code{directory-file-name},\n"
"@code{directory-files},\n"
"@code{directory-files-and-at@discretionary{}{}{}tributes},\n"
"@code{dired-compress-file}, @code{dired-uncache},\n"
"@code{exec-path}, @code{expand-file-name},\n"
"@code{file-accessible-direc@discretionary{}{}{}tory-p},\n"
"@code{file-acl},\n"
"@code{file-attributes},\n"
"@code{file-direc@discretionary{}{}{}tory-p},\n"
"@code{file-equal-p},\n"
"@code{file-executable-p}, @code{file-exists-p},\n"
"@code{file-in-directory-p},\n"
"@code{file-local-copy}, @code{file-locked-p},\n"
"@code{file-modes}, @code{file-name-all-completions},\n"
"@code{file-name-as-directory},\n"
"@code{file-name-case-insensitive-p},\n"
"@code{file-name-completion},\n"
"@code{file-name-directory},\n"
"@code{file-name-nondirec@discretionary{}{}{}tory},\n"
"@code{file-name-sans-versions}, @code{file-newer-than-file-p},\n"
"@code{file-notify-add-watch}, @code{file-notify-rm-watch},\n"
"@code{file-notify-valid-p},\n"
"@code{file-ownership-pre@discretionary{}{}{}served-p},\n"
"@code{file-readable-p}, @code{file-regular-p},\n"
"@code{file-remote-p}, @code{file-selinux-context},\n"
"@code{file-symlink-p}, @code{file-system-info},\n"
"@code{file-truename}, @code{file-writable-p},\n"
"@code{find-backup-file-name},\n"
"@code{get-file-buffer},\n"
"@code{insert-directory},\n"
"@code{insert-file-contents},\n"
"@code{load}, @code{lock-file},\n"
"@code{make-auto-save-file-name},\n"
"@code{make-direc@discretionary{}{}{}tory},\n"
"@code{make-direc@discretionary{}{}{}tory-internal},\n"
"@code{make-lock-file-name},\n"
"@code{make-nearby-temp-file},\n"
"@code{make-process},\n"
"@code{make-symbolic-link},\n"
"@code{process-file},\n"
"@code{rename-file}, @code{set-file-acl}, @code{set-file-modes},\n"
"@code{set-file-selinux-context}, @code{set-file-times},\n"
"@code{set-visited-file-modtime}, @code{shell-command},\n"
"@code{start-file-process},\n"
"@code{substitute-in-file-name},\n"
"@code{temporary-file-directory},\n"
"@code{unhandled-file-name-directory},\n"
"@code{unlock-file},\n"
"@code{vc-regis@discretionary{}{}{}tered},\n"
"@code{verify-visited-file-modtime},\n"
"@code{write-region}.\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3421
msgid ""
"Handlers for @code{insert-file-contents} typically need to clear the "
"buffer's modified flag, with @code{(set-buffer-modified-p nil)}, if the "
"@var{visit} argument is non-@code{nil}. This also has the effect of "
"unlocking the buffer if it is locked."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3428
msgid ""
"The handler function must handle all of the above operations, and possibly "
"others to be added in the future. It need not implement all these "
"operations itself---when it has nothing special to do for a certain "
"operation, it can reinvoke the primitive, to handle the operation in the "
"usual way. It should always reinvoke the primitive for an operation it does "
"not recognize. Here's one way to do this:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3443
#, no-wrap
msgid ""
"(defun my-file-handler (operation &rest args)\n"
" ;; @r{First check for the specific operations}\n"
" ;; @r{that we have special handling for.}\n"
" (cond ((eq operation 'insert-file-contents) @dots{})\n"
" ((eq operation 'write-region) @dots{})\n"
" @dots{}\n"
" ;; @r{Handle any operation we don't know about.}\n"
" (t (let ((inhibit-file-name-handlers\n"
" (cons 'my-file-handler\n"
" (and (eq inhibit-file-name-operation operation)\n"
" inhibit-file-name-handlers)))\n"
" (inhibit-file-name-operation operation))\n"
" (apply operation args)))))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3454
msgid ""
"When a handler function decides to call the ordinary Emacs primitive for the "
"operation at hand, it needs to prevent the primitive from calling the same "
"handler once again, thus leading to an infinite recursion. The example "
"above shows how to do this, with the variables "
"@code{inhibit-file-name-handlers} and @code{inhibit-file-name-operation}. "
"Be careful to use them exactly as shown above; the details are crucial for "
"proper behavior in the case of multiple handlers, and for operations that "
"have two file names that may each have handlers."
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3455
#, no-wrap
msgid "safe-magic @r{(property)}"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3465
msgid ""
"Handlers that don't really do anything special for actual access to the "
"file---such as the ones that implement completion of host names for remote "
"file names---should have a non-@code{nil} @code{safe-magic} property. For "
"instance, Emacs normally protects directory names it finds in @code{PATH} "
"from becoming magic, if they look like magic file names, by prefixing them "
"with @samp{/:}. But if the handler that would be used for them has a "
"non-@code{nil} @code{safe-magic} property, the @samp{/:} is not added."
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3466
#, no-wrap
msgid "operations @r{(property)}"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3474
msgid ""
"A file name handler can have an @code{operations} property to declare which "
"operations it handles in a nontrivial way. If this property has a "
"non-@code{nil} value, it should be a list of operations; then only those "
"operations will call the handler. This avoids inefficiency, but its main "
"purpose is for autoloaded handler functions, so that they won't be loaded "
"except when they have real work to do."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3482
msgid ""
"Simply deferring all operations to the usual primitives does not work. For "
"instance, if the file name handler applies to @code{file-exists-p}, then it "
"must handle @code{load} itself, because the usual @code{load} code won't "
"work properly in that case. However, if the handler uses the "
"@code{operations} property to say it doesn't handle @code{file-exists-p}, "
"then it need not handle @code{load} nontrivially."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3483
#, no-wrap
msgid "inhibit-file-name-handlers"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3486
msgid ""
"This variable holds a list of handlers whose use is presently inhibited for "
"a certain operation."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3488
#, no-wrap
msgid "inhibit-file-name-operation"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3490
msgid "The operation for which certain handlers are presently inhibited."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3492
#, no-wrap
msgid "find-file-name-handler file operation"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3500
msgid ""
"This function returns the handler function for file name @var{file}, or "
"@code{nil} if there is none. The argument @var{operation} should be the "
"operation to be performed on the file---the value you will pass to the "
"handler as its first argument when you call it. If @var{operation} equals "
"@code{inhibit-file-name-operation}, or if it is not found in the "
"@code{operations} property of the handler, this function returns @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3502
#, no-wrap
msgid "file-local-copy filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3510
msgid ""
"This function copies file @var{filename} to an ordinary non-magic file on "
"the local machine, if it isn't on the local machine already. Magic file "
"names should handle the @code{file-local-copy} operation if they refer to "
"files on other machines. A magic file name that is used for other purposes "
"than remote file access should not handle @code{file-local-copy}; then this "
"function will treat the file as local."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3514
msgid ""
"If @var{filename} is local, whether magic or not, this function does nothing "
"and returns @code{nil}. Otherwise it returns the file name of the local "
"copy file."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3516
#, no-wrap
msgid "file-remote-p filename &optional identification connected"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3521
msgid ""
"This function tests whether @var{filename} is a remote file. If "
"@var{filename} is local (not remote), the return value is @code{nil}. If "
"@var{filename} is indeed remote, the return value is a string that "
"identifies the remote system."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3526
msgid ""
"This identifier string can include a host name and a user name, as well as "
"characters designating the method used to access the remote system. For "
"example, the remote identifier string for the file name "
"@code{/sudo::/some/file} is @code{/sudo:root@@localhost:}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3533
msgid ""
"If @code{file-remote-p} returns the same identifier for two different file "
"names, that means they are stored on the same file system and can be "
"accessed locally with respect to each other. This means, for example, that "
"it is possible to start a remote process accessing both files at the same "
"time. Implementers of file name handlers need to ensure this principle is "
"valid."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3540
msgid ""
"@var{identification} specifies which part of the identifier shall be "
"returned as string. @var{identification} can be the symbol @code{method}, "
"@code{user} or @code{host}; any other value is handled like @code{nil} and "
"means to return the complete identifier string. In the example above, the "
"remote @code{user} identifier string would be @code{root}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3545
msgid ""
"If @var{connected} is non-@code{nil}, this function returns @code{nil} even "
"if @var{filename} is remote, if Emacs has no network connection to its "
"host. This is useful when you want to avoid the delay of making connections "
"when they don't exist."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3547
#, no-wrap
msgid "unhandled-file-name-directory filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3554
msgid ""
"This function returns the name of a directory that is not magic. For a "
"non-magic @var{filename} it returns the corresponding directory name "
"(@pxref{Directory Names}). For a magic @var{filename}, it invokes the file "
"name handler, which therefore decides what value to return. If "
"@var{filename} is not accessible from a local process, then the file name "
"handler should indicate that by returning @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3558
msgid ""
"This is useful for running a subprocess; every subprocess must have a "
"non-magic directory to serve as its current directory, and this function is "
"a good way to come up with one."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3560
#, no-wrap
msgid "local part of remote file name"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3561
#, no-wrap
msgid "file-local-name filename"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3567
msgid ""
"This function returns the @dfn{local part} of @var{filename}. This is the "
"part of the file's name that identifies it on the remote host, and is "
"typically obtained by removing from the remote file name the parts that "
"specify the remote host and the method of accessing it. For example:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3571
#, no-wrap
msgid ""
"(file-local-name \"/ssh:@var{user}@@@var{host}:/foo/bar\")\n"
" @result{} \"/foo/bar\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3578
msgid ""
"For a remote @var{filename}, this function returns a file name which could "
"be used directly as an argument of a remote process (@pxref{Asynchronous "
"Processes}, and @pxref{Synchronous Processes}), and as the program to run on "
"the remote host. If @var{filename} is local, this function returns it "
"unchanged."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3580
#, no-wrap
msgid "remote-file-name-inhibit-cache"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3584
msgid ""
"The attributes of remote files can be cached for better performance. If "
"they are changed outside of Emacs's control, the cached values become "
"invalid, and must be reread."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3590
msgid ""
"When this variable is set to @code{nil}, cached values are never expired. "
"Use this setting with caution, only if you are sure nothing other than Emacs "
"ever changes the remote files. If it is set to @code{t}, cached values are "
"never used. This is the safest value, but could result in performance "
"degradation."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3596
msgid ""
"A compromise is to set it to a positive number. This means that cached "
"values are used for that amount of seconds since they were cached. If a "
"remote file is checked regularly, it might be a good idea to let-bind this "
"variable to a value less than the time period between consecutive checks. "
"For example:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3605
#, no-wrap
msgid ""
"(defun display-time-file-nonempty-p (file)\n"
" (let ((remote-file-name-inhibit-cache\n"
" (- display-time-interval 5)))\n"
" (and (file-exists-p file)\n"
" (< 0 (file-attribute-size\n"
" (file-attributes\n"
" (file-chase-links file)))))))\n"
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3609
#, no-wrap
msgid "File Format Conversion"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3611
#, no-wrap
msgid "file format conversion"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3612
#, no-wrap
msgid "encoding file formats"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3613
#, no-wrap
msgid "decoding file formats"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3614
#, no-wrap
msgid "text properties in files"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3615
#, no-wrap
msgid "saving text properties"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3622
msgid ""
"Emacs performs several steps to convert the data in a buffer (text, text "
"properties, and possibly other information) to and from a representation "
"suitable for storing into a file. This section describes the fundamental "
"functions that perform this @dfn{format conversion}, namely "
"@code{insert-file-contents} for reading a file into a buffer, and "
"@code{write-region} for writing a buffer into a file."
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3627
msgid "Overview: Format Conversion Overview"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3627
msgid "@code{insert-file-contents} and @code{write-region}."
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3627
msgid "Round-Trip: Format Conversion Round-Trip"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3627
msgid "Using @code{format-alist}."
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3627
msgid "Piecemeal: Format Conversion Piecemeal"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3627
msgid "Specifying non-paired conversion."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3629
#, no-wrap
msgid "Format Conversion Overview"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3630
#, no-wrap
msgid "Overview"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3633
msgid "The function @code{insert-file-contents}:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3635
#, no-wrap
msgid "initially, inserts bytes from the file into the buffer;"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3636
#, no-wrap
msgid "decodes bytes to characters as appropriate;"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3637
#, no-wrap
msgid "processes formats as defined by entries in @code{format-alist}; and"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3638
#, no-wrap
msgid "calls functions in @code{after-insert-file-functions}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3643
msgid "The function @code{write-region}:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3645
#, no-wrap
msgid "initially, calls functions in @code{write-region-annotate-functions};"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3646
#, no-wrap
msgid "processes formats as defined by entries in @code{format-alist};"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3647
#, no-wrap
msgid "encodes characters to bytes as appropriate; and"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3648
#, no-wrap
msgid "modifies the file with the bytes."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3656
msgid ""
"This shows the symmetry of the lowest-level operations; reading and writing "
"handle things in opposite order. The rest of this section describes the two "
"facilities surrounding the three variables named above, as well as some "
"related functions. @ref{Coding Systems}, for details on character encoding "
"and decoding."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3657
#, no-wrap
msgid "Format Conversion Round-Trip"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3658
#, no-wrap
msgid "Round-Trip Specification"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3666
msgid ""
"The most general of the two facilities is controlled by the variable "
"@code{format-alist}, a list of @dfn{file format} specifications, which "
"describe textual representations used in files for the data in an Emacs "
"buffer. The descriptions for reading and writing are paired, which is why "
"we call this ``round-trip'' specification (@pxref{Format Conversion "
"Piecemeal}, for non-paired specification)."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3667
#, no-wrap
msgid "format-alist"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3670
msgid ""
"This list contains one format definition for each defined file format. Each "
"format definition is a list of this form:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3673
#, no-wrap
msgid ""
"(@var{name} @var{doc-string} @var{regexp} @var{from-fn} @var{to-fn} "
"@var{modify} @var{mode-fn} @var{preserve})\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3676
#, no-wrap
msgid "format definition"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3679
msgid "Here is what the elements in a format definition mean:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3681
#, no-wrap
msgid "name"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3683
msgid "The name of this format."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3684
#, no-wrap
msgid "doc-string"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3686
msgid "A documentation string for the format."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3687
#, no-wrap
msgid "regexp"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3690
msgid ""
"A regular expression which is used to recognize files represented in this "
"format. If @code{nil}, the format is never applied automatically."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3691
#, no-wrap
msgid "from-fn"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3694
msgid ""
"A shell command or function to decode data in this format (to convert file "
"data into the usual Emacs data representation)."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3697
msgid ""
"A shell command is represented as a string; Emacs runs the command as a "
"filter to perform the conversion."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3703
msgid ""
"If @var{from-fn} is a function, it is called with two arguments, @var{begin} "
"and @var{end}, which specify the part of the buffer it should convert. It "
"should convert the text by editing it in place. Since this can change the "
"length of the text, @var{from-fn} should return the modified end position."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3709
msgid ""
"One responsibility of @var{from-fn} is to make sure that the beginning of "
"the file no longer matches @var{regexp}. Otherwise it is likely to get "
"called again. Also, @var{from-fn} must not involve buffers or files other "
"than the one being decoded, otherwise the internal buffer used for "
"formatting might be overwritten."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3710
#, no-wrap
msgid "to-fn"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3713
msgid ""
"A shell command or function to encode data in this format---that is, to "
"convert the usual Emacs data representation into this format."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3716
msgid ""
"If @var{to-fn} is a string, it is a shell command; Emacs runs the command as "
"a filter to perform the conversion."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3721
msgid ""
"If @var{to-fn} is a function, it is called with three arguments: @var{begin} "
"and @var{end}, which specify the part of the buffer it should convert, and "
"@var{buffer}, which specifies which buffer. There are two ways it can do "
"the conversion:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3726
msgid ""
"By editing the buffer in place. In this case, @var{to-fn} should return the "
"end-position of the range of text, as modified."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3733
msgid ""
"By returning a list of annotations. This is a list of elements of the form "
"@code{(@var{position} . @var{string})}, where @var{position} is an integer "
"specifying the relative position in the text to be written, and @var{string} "
"is the annotation to add there. The list must be sorted in order of "
"position when @var{to-fn} returns it."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3737
msgid ""
"When @code{write-region} actually writes the text from the buffer to the "
"file, it intermixes the specified annotations at the corresponding "
"positions. All this takes place without modifying the buffer."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3742
msgid ""
"@var{to-fn} must not involve buffers or files other than the one being "
"encoded, otherwise the internal buffer used for formatting might be "
"overwritten."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3743
#, no-wrap
msgid "modify"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3746
msgid ""
"A flag, @code{t} if the encoding function modifies the buffer, and "
"@code{nil} if it works by returning a list of annotations."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3747
#, no-wrap
msgid "mode-fn"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3751
msgid ""
"A minor-mode function to call after visiting a file converted from this "
"format. The function is called with one argument, the integer 1; that tells "
"a minor-mode function to enable the mode."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3752
#, no-wrap
msgid "preserve"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3755
msgid ""
"A flag, @code{t} if @code{format-write-file} should not remove this format "
"from @code{buffer-file-format}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3763
msgid ""
"The function @code{insert-file-contents} automatically recognizes file "
"formats when it reads the specified file. It checks the text of the "
"beginning of the file against the regular expressions of the format "
"definitions, and if it finds a match, it calls the decoding function for "
"that format. Then it checks all the known formats over again. It keeps "
"checking them until none of them is applicable."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3769
msgid ""
"Visiting a file, with @code{find-file-noselect} or the commands that use it, "
"performs conversion likewise (because it calls @code{insert-file-contents}); "
"it also calls the mode function for each format that it decodes. It stores "
"a list of the format names in the buffer-local variable "
"@code{buffer-file-format}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3770
#, no-wrap
msgid "buffer-file-format"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3775
msgid ""
"This variable states the format of the visited file. More precisely, this "
"is a list of the file format names that were decoded in the course of "
"visiting the current buffer's file. It is always buffer-local in all "
"buffers."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3780
msgid ""
"When @code{write-region} writes data into a file, it first calls the "
"encoding functions for the formats listed in @code{buffer-file-format}, in "
"the order of appearance in the list."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3781
#, no-wrap
msgid "Command format-write-file file format &optional confirm"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3793
msgid ""
"This command writes the current buffer contents into the file @var{file} in "
"a format based on @var{format}, which is a list of format names. It "
"constructs the actual format starting from @var{format}, then appending any "
"elements from the value of @code{buffer-file-format} with a non-@code{nil} "
"@var{preserve} flag (see above), if they are not already present in "
"@var{format}. It then updates @code{buffer-file-format} with this format, "
"making it the default for future saves. Except for the @var{format} "
"argument, this command is similar to @code{write-file}. In particular, "
"@var{confirm} has the same meaning and interactive treatment as the "
"corresponding argument to @code{write-file}. @xref{Definition of "
"write-file}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3795
#, no-wrap
msgid "Command format-find-file file format"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3799
msgid ""
"This command finds the file @var{file}, converting it according to format "
"@var{format}. It also makes @var{format} the default if the buffer is saved "
"later."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3803
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3818
msgid ""
"The argument @var{format} is a list of format names. If @var{format} is "
"@code{nil}, no conversion takes place. Interactively, typing just @key{RET} "
"for @var{format} specifies @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3805
#, no-wrap
msgid "Command format-insert-file file format &optional beg end"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3810
msgid ""
"This command inserts the contents of file @var{file}, converting it "
"according to format @var{format}. If @var{beg} and @var{end} are "
"non-@code{nil}, they specify which part of the file to read, as in "
"@code{insert-file-contents} (@pxref{Reading from Files})."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3814
msgid ""
"The return value is like what @code{insert-file-contents} returns: a list of "
"the absolute file name and the length of the data inserted (after "
"conversion)."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3820
#, no-wrap
msgid "buffer-auto-save-file-format"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3828
msgid ""
"This variable specifies the format to use for auto-saving. Its value is a "
"list of format names, just like the value of @code{buffer-file-format}; "
"however, it is used instead of @code{buffer-file-format} for writing "
"auto-save files. If the value is @code{t}, the default, auto-saving uses "
"the same format as a regular save in the same buffer. This variable is "
"always buffer-local in all buffers."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3830
#, no-wrap
msgid "Format Conversion Piecemeal"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3831
#, no-wrap
msgid "Piecemeal Specification"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3837
msgid ""
"In contrast to the round-trip specification described in the previous "
"subsection (@pxref{Format Conversion Round-Trip}), you can use the variables "
"@code{after-insert-file-functions} and "
"@code{write-region-annotate-functions} to separately control the respective "
"reading and writing conversions."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3843
msgid ""
"Conversion starts with one representation and produces another "
"representation. When there is only one conversion to do, there is no "
"conflict about what to start with. However, when there are multiple "
"conversions involved, conflict may arise when two conversions need to start "
"with the same data."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3851
msgid ""
"This situation is best understood in the context of converting text "
"properties during @code{write-region}. For example, the character at "
"position 42 in a buffer is @samp{X} with a text property @code{foo}. If the "
"conversion for @code{foo} is done by inserting into the buffer, say, "
"@samp{FOO:}, then that changes the character at position 42 from @samp{X} to "
"@samp{F}. The next conversion will start with the wrong data straight away."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3856
msgid ""
"To avoid conflict, cooperative conversions do not modify the buffer, but "
"instead specify @dfn{annotations}, a list of elements of the form "
"@code{(@var{position} . @var{string})}, sorted in order of increasing "
"@var{position}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3862
msgid ""
"If there is more than one conversion, @code{write-region} merges their "
"annotations destructively into one sorted list. Later, when the text from "
"the buffer is actually written to the file, it intermixes the specified "
"annotations at the corresponding positions. All this takes place without "
"modifying the buffer."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3878
msgid ""
"In contrast, when reading, the annotations intermixed with the text are "
"handled immediately. @code{insert-file-contents} sets point to the "
"beginning of some text to be converted, then calls the conversion functions "
"with the length of that text. These functions should always return with "
"point at the beginning of the inserted text. This approach makes sense for "
"reading because annotations removed by the first converter can't be "
"mistakenly processed by a later converter. Each conversion function should "
"scan for the annotations it recognizes, remove the annotation, modify the "
"buffer text (to set a text property, for example), and return the updated "
"length of the text, as it stands after those changes. The value returned by "
"one function becomes the argument to the next function."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3879
#, no-wrap
msgid "write-region-annotate-functions"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3884
msgid ""
"A list of functions for @code{write-region} to call. Each function in the "
"list is called with two arguments: the start and end of the region to be "
"written. These functions should not alter the contents of the buffer. "
"Instead, they should return annotations."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3892
msgid ""
"As a special case, a function may return with a different buffer current. "
"Emacs takes this to mean that the current buffer contains altered text to be "
"output. It therefore changes the @var{start} and @var{end} arguments of the "
"@code{write-region} call, giving them the values of @code{point-min} and "
"@code{point-max} in the new buffer, respectively. It also discards all "
"previous annotations, because they should have been dealt with by this "
"function."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3894
#, no-wrap
msgid "write-region-post-annotation-function"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3898
msgid ""
"The value of this variable, if non-@code{nil}, should be a function. This "
"function is called, with no arguments, after @code{write-region} has "
"completed."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3904
msgid ""
"If any function in @code{write-region-annotate-functions} returns with a "
"different buffer current, Emacs calls "
"@code{write-region-post-annotation-function} more than once. Emacs calls it "
"with the last buffer that was current, and again with the buffer before "
"that, and so on back to the original buffer."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3909
msgid ""
"Thus, a function in @code{write-region-annotate-functions} can create a "
"buffer, give this variable the local value of @code{kill-buffer} in that "
"buffer, set up the buffer with altered text, and make the buffer current. "
"The buffer will be killed after @code{write-region} is done."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3911
#, no-wrap
msgid "after-insert-file-functions"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3919
msgid ""
"Each function in this list is called by @code{insert-file-contents} with one "
"argument, the number of characters inserted, and with point at the beginning "
"of the inserted text. Each function should leave point unchanged, and "
"return the new character count describing the inserted text as modified by "
"the function."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3925
msgid ""
"We invite users to write Lisp programs to store and retrieve text properties "
"in files, using these hooks, and thus to experiment with various data "
"formats and find good ones. Eventually we hope users will produce good, "
"general extensions we can install in Emacs."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/files.texi:3929
msgid ""
"We suggest not trying to handle arbitrary Lisp objects as text property "
"names or values---because a program that general is probably difficult to "
"write, and slow. Instead, choose a set of possible data types that are "
"reasonably flexible, and not too hard to encode."
msgstr ""