8470 lines
305 KiB
Plaintext
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 ""
|