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

13751 lines
488 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/text.texi:5 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:6
#, no-wrap
msgid "Text"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:7
#, no-wrap
msgid "text"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:14
msgid ""
"This chapter describes the functions that deal with the text in a buffer. "
"Most examine, insert, or delete text in the current buffer, often operating "
"at point or on text adjacent to point. Many are interactive. All the "
"functions that change the text provide for undoing the changes "
"(@pxref{Undo})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:25
msgid ""
"Many text-related functions operate on a region of text defined by two "
"buffer positions passed in arguments named @var{start} and @var{end}. These "
"arguments should be either markers (@pxref{Markers}) or numeric character "
"positions (@pxref{Positions}). The order of these arguments does not "
"matter; it is all right for @var{start} to be the end of the region and "
"@var{end} the beginning. For example, @code{(delete-region 1 10)} and "
"@code{(delete-region 10 1)} are equivalent. An @code{args-out-of-range} "
"error is signaled if either @var{start} or @var{end} is outside the "
"accessible portion of the buffer. In an interactive call, point and the "
"mark are used for these arguments."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:26
#, no-wrap
msgid "buffer contents"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:31
msgid ""
"Throughout this chapter, ``text'' refers to the characters in the buffer, "
"together with their properties (when relevant). Keep in mind that point is "
"always between two characters, and the cursor appears on the character after "
"point."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:70
#, no-wrap
msgid "Near Point"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Examining text in the vicinity of point."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:168
#, no-wrap
msgid "Buffer Contents"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Examining text in a general fashion."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:361
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:362
#, no-wrap
msgid "Comparing Text"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Comparing substrings of buffers."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:396
#, no-wrap
msgid "Insertion"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Adding new text to a buffer."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:520
#, no-wrap
msgid "Commands for Insertion"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "User-level commands to insert text."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:624
#, no-wrap
msgid "Deletion"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Removing text from a buffer."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:730
#, no-wrap
msgid "User-Level Deletion"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "User-level commands to delete text."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:891
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:892
#, no-wrap
msgid "The Kill Ring"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Where removed text sometimes is saved for later use."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:1348
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1349
#, no-wrap
msgid "Undo"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Undoing changes to the text of a buffer."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:1515
#, no-wrap
msgid "Maintaining Undo"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid ""
"How to enable and disable undo information. How to control how much "
"information is kept."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:1590
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1591
#, no-wrap
msgid "Filling"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Functions for explicit filling."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:1790
#, no-wrap
msgid "Margins"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "How to specify margins for filling commands."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:1892
#, no-wrap
msgid "Adaptive Fill"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Adaptive Fill mode chooses a fill prefix from context."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:1982
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1983
#, no-wrap
msgid "Auto Filling"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "How auto-fill mode is implemented to break lines."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:2028
#, no-wrap
msgid "Sorting"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Functions for sorting parts of the buffer."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:2291
#, no-wrap
msgid "Columns"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Computing horizontal positions, and using them."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:2353
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2354
#, no-wrap
msgid "Indentation"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Functions to insert or adjust indentation."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:2762
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2763
#, no-wrap
msgid "Case Changes"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Case conversion of parts of the buffer."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:2854
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2855
#, no-wrap
msgid "Text Properties"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Assigning Lisp property lists to text characters."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:4423
#, no-wrap
msgid "Substitution"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Replacing a given character wherever it appears."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:4491
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4492
#, no-wrap
msgid "Registers"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid ""
"How registers are implemented. Accessing the text or position stored in a "
"register."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:4598
#, no-wrap
msgid "Transposition"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Swapping two portions of a buffer."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:4617
#, no-wrap
msgid "Replacing"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Replacing the text of one buffer with the text of another buffer."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:4676
#, no-wrap
msgid "Decompression"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Dealing with compressed data."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:4708
#, no-wrap
msgid "Base 64"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Conversion to or from base 64 encoding."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:4791
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4792
#, no-wrap
msgid "Checksum/Hash"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Computing cryptographic hashes."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:4878
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4879
#, no-wrap
msgid "GnuTLS Cryptography"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Cryptographic algorithms imported from GnuTLS."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:5070
#, no-wrap
msgid "Parsing HTML/XML"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Parsing HTML and XML."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:5285
#, no-wrap
msgid "Parsing JSON"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Parsing and generating JSON values."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:5420
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5423
#, no-wrap
msgid "JSONRPC"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "JSON Remote Procedure Call protocol"
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:5637
#, no-wrap
msgid "Atomic Changes"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Installing several buffer changes atomically."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68 /Users/suzume/Documents/Repositories/Projet
#: OmegaT de Documentation Emacs - Sources/doc/lispref/text.texi:5740
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5741
#, no-wrap
msgid "Change Hooks"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:68
msgid "Supplying functions to be run when text is changed."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:71
#, no-wrap
msgid "Examining Text Near Point"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:72
#, no-wrap
msgid "text near point"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:77
msgid ""
"Many functions are provided to look at the characters around point. Several "
"simple functions are described here. See also @code{looking-at} in "
"@ref{Regexp Search}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:80
msgid ""
"In the following four functions, ``beginning'' or ``end'' of buffer refers "
"to the beginning or end of the accessible portion."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:81
#, no-wrap
msgid "char-after &optional position"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:87
msgid ""
"This function returns the character in the current buffer at (i.e., "
"immediately after) position @var{position}. If @var{position} is out of "
"range for this purpose, either before the beginning of the buffer, or at or "
"beyond the end, then the value is @code{nil}. The default for "
"@var{position} is point."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:90
msgid ""
"In the following example, assume that the first character in the buffer is "
"@samp{@@}:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:95
#, no-wrap
msgid ""
"(string (char-after 1))\n"
" @result{} \"@@\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:99
#, no-wrap
msgid "char-before &optional position"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:105
msgid ""
"This function returns the character in the current buffer immediately before "
"position @var{position}. If @var{position} is out of range for this "
"purpose, either at or before the beginning of the buffer, or beyond the end, "
"then the value is @code{nil}. The default for @var{position} is point."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:107
#, no-wrap
msgid "following-char"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:111
msgid ""
"This function returns the character following point in the current buffer. "
"This is similar to @code{(char-after (point))}. However, if point is at the "
"end of the buffer, then @code{following-char} returns 0."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:116
msgid ""
"Remember that point is always between characters, and the cursor normally "
"appears over the character following point. Therefore, the character "
"returned by @code{following-char} is the character the cursor is over."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:118
msgid "In this example, point is between the @samp{a} and the @samp{c}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:125
#, no-wrap
msgid ""
"---------- Buffer: foo ----------\n"
"Gentlemen may cry ``Pea@point{}ce! Peace!,''\n"
"but there is no peace.\n"
"---------- Buffer: foo ----------\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:132
#, no-wrap
msgid ""
"(string (preceding-char))\n"
" @result{} \"a\"\n"
"(string (following-char))\n"
" @result{} \"c\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:136
#, no-wrap
msgid "preceding-char"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:141
msgid ""
"This function returns the character preceding point in the current buffer. "
"See above, under @code{following-char}, for an example. If point is at the "
"beginning of the buffer, @code{preceding-char} returns 0."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:143
#, no-wrap
msgid "bobp"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:148
msgid ""
"This function returns @code{t} if point is at the beginning of the buffer. "
"If narrowing is in effect, this means the beginning of the accessible "
"portion of the text. See also @code{point-min} in @ref{Point}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:150
#, no-wrap
msgid "eobp"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:154
msgid ""
"This function returns @code{t} if point is at the end of the buffer. If "
"narrowing is in effect, this means the end of accessible portion of the "
"text. See also @code{point-max} in @xref{Point}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:156
#, no-wrap
msgid "bolp"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:160
msgid ""
"This function returns @code{t} if point is at the beginning of a line. "
"@xref{Text Lines}. The beginning of the buffer (or of its accessible "
"portion) always counts as the beginning of a line."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:162
#, no-wrap
msgid "eolp"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:166
msgid ""
"This function returns @code{t} if point is at the end of a line. The end of "
"the buffer (or of its accessible portion) is always considered the end of a "
"line."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:169
#, no-wrap
msgid "Examining Buffer Contents"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:170
#, no-wrap
msgid "buffer portion as string"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:174
msgid ""
"This section describes functions that allow a Lisp program to convert any "
"portion of the text in the buffer into a string."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:175
#, no-wrap
msgid "buffer-substring start end"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:181
msgid ""
"This function returns a string containing a copy of the text of the region "
"defined by positions @var{start} and @var{end} in the current buffer. If "
"the arguments are not positions in the accessible portion of the buffer, "
"@code{buffer-substring} signals an @code{args-out-of-range} error."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:183
msgid "Here's an example which assumes Font-Lock mode is not enabled:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:188
#, no-wrap
msgid ""
"---------- Buffer: foo ----------\n"
"This is the contents of buffer foo\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:190
#, no-wrap
msgid "---------- Buffer: foo ----------\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:195
#, no-wrap
msgid ""
"(buffer-substring 1 10)\n"
" @result{} \"This is t\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:199
#, no-wrap
msgid ""
"(buffer-substring (point-max) 10)\n"
" @result{} \"he contents of buffer foo\\n\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:206
msgid ""
"If the text being copied has any text properties, these are copied into the "
"string along with the characters they belong to. @xref{Text Properties}. "
"However, overlays (@pxref{Overlays}) in the buffer and their properties are "
"ignored, not copied."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:209
msgid "For example, if Font-Lock mode is enabled, you might get results like these:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:214
#, no-wrap
msgid ""
"(buffer-substring 1 10)\n"
" @result{} #(\"This is t\" 0 1 (fontified t) 1 9 (fontified t))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:218
#, no-wrap
msgid "buffer-substring-no-properties start end"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:221
msgid ""
"This is like @code{buffer-substring}, except that it does not copy text "
"properties, just the characters themselves. @xref{Text Properties}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:223
#, no-wrap
msgid "buffer-string"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:228
msgid ""
"This function returns the contents of the entire accessible portion of the "
"current buffer, as a string. If the text being copied has any text "
"properties, these are copied into the string along with the characters they "
"belong to."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:235
msgid ""
"If you need to make sure the resulting string, when copied to a different "
"location, will not change its visual appearance due to reordering of "
"bidirectional text, use the @code{buffer-substring-with-bidi-context} "
"function (@pxref{Bidirectional Display, "
"buffer-substring-with-bidi-context})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:236
#, no-wrap
msgid "filter-buffer-substring start end &optional delete"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:240
msgid ""
"This function filters the buffer text between @var{start} and @var{end} "
"using a function specified by the variable "
"@code{filter-buffer-substring-function}, and returns the result."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:248
msgid ""
"The default filter function consults the obsolete wrapper hook "
"@code{filter-buffer-substring-functions} (see the documentation string of "
"the macro @code{with-wrapper-hook} for the details about this obsolete "
"facility), and the obsolete variable @code{buffer-substring-filters}. If "
"both of these are @code{nil}, it returns the unaltered text from the buffer, "
"i.e., what @code{buffer-substring} would return."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:252
msgid ""
"If @var{delete} is non-@code{nil}, the function deletes the text between "
"@var{start} and @var{end} after copying it, like "
"@code{delete-and-extract-region}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:259
msgid ""
"Lisp code should use this function instead of @code{buffer-substring}, "
"@code{buffer-substring-no-properties}, or @code{delete-and-extract-region} "
"when copying into user-accessible data structures such as the kill-ring, X "
"clipboard, and registers. Major and minor modes can modify "
"@code{filter-buffer-substring-function} to alter such text as it is copied "
"out of the buffer."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:261
#, no-wrap
msgid "filter-buffer-substring-function"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:267
msgid ""
"The value of this variable is a function that @code{filter-buffer-substring} "
"will call to do the actual work. The function receives three arguments, the "
"same as those of @code{filter-buffer-substring}, which it should treat as "
"per the documentation of that function. It should return the filtered text "
"(and optionally delete the source text)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:272
msgid ""
"@code{filter-buffer-substring-function}, but are still supported for "
"backward compatibility."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:273
#, no-wrap
msgid "filter-buffer-substring-functions"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:280
msgid ""
"This obsolete variable is a wrapper hook, whose members should be functions "
"that accept four arguments: @var{fun}, @var{start}, @var{end}, and "
"@var{delete}. @var{fun} is a function that takes three arguments "
"(@var{start}, @var{end}, and @var{delete}), and returns a string. In both "
"cases, the @var{start}, @var{end}, and @var{delete} arguments are the same "
"as those of @code{filter-buffer-substring}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:290
msgid ""
"The first hook function is passed a @var{fun} that is equivalent to the "
"default operation of @code{filter-buffer-substring}, i.e., it returns the "
"buffer-substring between @var{start} and @var{end} (processed by any "
"@code{buffer-substring-filters}) and optionally deletes the original text "
"from the buffer. In most cases, the hook function will call @var{fun} once, "
"and then do its own processing of the result. The next hook function "
"receives a @var{fun} equivalent to this, and so on. The actual return value "
"is the result of all the hook functions acting in sequence."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:292
#, no-wrap
msgid "buffer-substring-filters"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:299
msgid ""
"The value of this obsolete variable should be a list of functions that "
"accept a single string argument and return another string. The default "
"@code{filter-buffer-substring} function passes the buffer substring to the "
"first function in this list, and the return value of each function is passed "
"to the next function. The return value of the last function is passed to "
"@code{filter-buffer-substring-functions}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:301
#, no-wrap
msgid "current-word &optional strict really-word"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:304
msgid ""
"This function returns the symbol (or word) at or near point, as a string. "
"The return value includes no text properties."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:308
msgid ""
"If the optional argument @var{really-word} is non-@code{nil}, it finds a "
"word; otherwise, it finds a symbol (which includes both word characters and "
"symbol constituent characters)."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:313
msgid ""
"If the optional argument @var{strict} is non-@code{nil}, then point must be "
"in or next to the symbol or word---if no symbol or word is there, the "
"function returns @code{nil}. Otherwise, a nearby symbol or word on the same "
"line is acceptable."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:315
#, no-wrap
msgid "thing-at-point thing &optional no-properties"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:317
msgid "Return the @var{thing} around or next to point, as a string."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:323
msgid ""
"The argument @var{thing} is a symbol which specifies a kind of syntactic "
"entity. Possibilities include @code{symbol}, @code{list}, @code{sexp}, "
"@code{defun}, @code{filename}, @code{existing-filename}, @code{url}, "
"@code{word}, @code{sentence}, @code{whitespace}, @code{line}, @code{page}, "
"@code{string}, and others."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:326
msgid ""
"When the optional argument @var{no-properties} is non-@code{nil}, this "
"function strips text properties from the return value."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:332
#, no-wrap
msgid ""
"---------- Buffer: foo ----------\n"
"Gentlemen may cry ``Pea@point{}ce! Peace!,''\n"
"but there is no peace.\n"
"---------- Buffer: foo ----------\n"
"\n"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:339
#, no-wrap
msgid ""
"(thing-at-point 'word)\n"
" @result{} \"Peace\"\n"
"(thing-at-point 'line)\n"
" @result{} \"Gentlemen may cry ``Peace! Peace!,''\\n\"\n"
"(thing-at-point 'whitespace)\n"
" @result{} nil\n"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:341
#, no-wrap
msgid "thing-at-point-provider-alist"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:347
msgid ""
"This variable allows users and modes to tweak how @code{thing-at-point} "
"works. It's an association list of @var{thing}s and functions (called with "
"zero parameters) to return that thing. Entries for @var{thing} will be "
"evaluated in turn until a non-@code{nil} result is returned."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:349
msgid "For instance, a major mode could say:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:354
#, no-wrap
msgid ""
"(setq-local thing-at-point-provider-alist\n"
" (append thing-at-point-provider-alist\n"
" '((url . my-mode--url-at-point))))\n"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:358
msgid ""
"If no providers have a non-@code{nil} return, the @var{thing} will be "
"computed the standard way."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:363
#, no-wrap
msgid "comparing buffer text"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:367
msgid ""
"This function lets you compare portions of the text in a buffer, without "
"copying them into strings first."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:368
#, no-wrap
msgid "compare-buffer-substrings buffer1 start1 end1 buffer2 start2 end2"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:375
msgid ""
"This function lets you compare two substrings of the same buffer or two "
"different buffers. The first three arguments specify one substring, giving "
"a buffer (or a buffer name) and two positions within the buffer. The last "
"three arguments specify the other substring in the same way. You can use "
"@code{nil} for @var{buffer1}, @var{buffer2}, or both to stand for the "
"current buffer."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:380
msgid ""
"The value is negative if the first substring is less, positive if the first "
"is greater, and zero if they are equal. The absolute value of the result is "
"one plus the index of the first differing characters within the substrings."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:384
msgid ""
"This function ignores case when comparing characters if "
"@code{case-fold-search} is non-@code{nil}. It always ignores text "
"properties."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:389
msgid ""
"Suppose you have the text @w{@samp{foobarbar haha!rara!}} in the current "
"buffer; then in this example the two substrings are @samp{rbar } and "
"@samp{rara!}. The value is 2 because the first substring is greater at the "
"second character."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:393
#, no-wrap
msgid ""
"(compare-buffer-substrings nil 6 11 nil 16 21)\n"
" @result{} 2\n"
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:397
#, no-wrap
msgid "Inserting Text"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:398
#, no-wrap
msgid "insertion of text"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:399
#, no-wrap
msgid "text insertion"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:401
#, no-wrap
msgid "insertion before point"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:402
#, no-wrap
msgid "before point, insertion"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:408
msgid ""
"@dfn{Insertion} means adding new text to a buffer. The inserted text goes "
"at point---between the character before point and the character after "
"point. Some insertion functions leave point before the inserted text, while "
"other functions leave it after. We call the former insertion @dfn{after "
"point} and the latter insertion @dfn{before point}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:416
msgid ""
"Insertion moves markers located at positions after the insertion point, so "
"that they stay with the surrounding text (@pxref{Markers}). When a marker "
"points at the place of insertion, insertion may or may not relocate the "
"marker, depending on the marker's insertion type (@pxref{Marker Insertion "
"Types}). Certain special functions such as @code{insert-before-markers} "
"relocate all such markers to point after the inserted text, regardless of "
"the markers' insertion type."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:420
msgid ""
"Insertion functions signal an error if the current buffer is read-only "
"(@pxref{Read Only Buffers}) or if they insert within read-only text "
"(@pxref{Special Properties})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:426
msgid ""
"These functions copy text characters from strings and buffers along with "
"their properties. The inserted characters have exactly the same properties "
"as the characters they were copied from. By contrast, characters specified "
"as separate arguments, not part of a string or buffer, inherit their text "
"properties from the neighboring text."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:433
msgid ""
"The insertion functions convert text from unibyte to multibyte in order to "
"insert in a multibyte buffer, and vice versa---if the text comes from a "
"string or from a buffer. However, they do not convert unibyte character "
"codes 128 through 255 to multibyte characters, not even if the current "
"buffer is a multibyte buffer. @xref{Converting Representations}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:434
#, no-wrap
msgid "insert &rest args"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:439
msgid ""
"This function inserts the strings and/or characters @var{args} into the "
"current buffer, at point, moving point forward. In other words, it inserts "
"the text before point. An error is signaled unless all @var{args} are "
"either strings or characters. The value is @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:441
#, no-wrap
msgid "insert-before-markers &rest args"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:446
msgid ""
"This function inserts the strings and/or characters @var{args} into the "
"current buffer, at point, moving point forward. An error is signaled unless "
"all @var{args} are either strings or characters. The value is @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:453
msgid ""
"This function is unlike the other insertion functions in that it relocates "
"markers initially pointing at the insertion point, to point after the "
"inserted text. If an overlay begins at the insertion point, the inserted "
"text falls outside the overlay; if a nonempty overlay ends at the insertion "
"point, the inserted text falls inside that overlay."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:455
#, no-wrap
msgid "Command insert-char character &optional count inherit"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:459
msgid ""
"This command inserts @var{count} instances of @var{character} into the "
"current buffer before point. The argument @var{count} must be an integer, "
"and @var{character} must be a character."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:463
msgid ""
"If called interactively, this command prompts for @var{character} using its "
"Unicode name or its code point. @xref{Inserting Text,,, emacs, The GNU "
"Emacs Manual}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:467
msgid ""
"This function does not convert unibyte character codes 128 through 255 to "
"multibyte characters, not even if the current buffer is a multibyte buffer. "
"@xref{Converting Representations}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:471
msgid ""
"If @var{inherit} is non-@code{nil}, the inserted characters inherit sticky "
"text properties from the two characters before and after the insertion "
"point. @xref{Sticky Properties}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:473
#, no-wrap
msgid "insert-buffer-substring from-buffer-or-name &optional start end"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:479
msgid ""
"This function inserts a portion of buffer @var{from-buffer-or-name} into the "
"current buffer before point. The text inserted is the region between "
"@var{start} (inclusive) and @var{end} (exclusive). (These arguments default "
"to the beginning and end of the accessible portion of that buffer.) This "
"function returns @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:482
msgid ""
"In this example, the form is executed with buffer @samp{bar} as the current "
"buffer. We assume that buffer @samp{bar} is initially empty."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:488
#, no-wrap
msgid ""
"---------- Buffer: foo ----------\n"
"We hold these truths to be self-evident, that all\n"
"---------- Buffer: foo ----------\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:493
#, no-wrap
msgid ""
"(insert-buffer-substring \"foo\" 1 20)\n"
" @result{} nil\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:497
#, no-wrap
msgid ""
"---------- Buffer: bar ----------\n"
"We hold these truth@point{}\n"
"---------- Buffer: bar ----------\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:501
#, no-wrap
msgid ""
"insert-buffer-substring-no-properties from-buffer-or-name &optional start "
"end"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:504
msgid ""
"This is like @code{insert-buffer-substring} except that it does not copy any "
"text properties."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:506
#, no-wrap
msgid "insert-into-buffer to-buffer &optional start end"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:513
msgid ""
"This is like @code{insert-buffer-substring}, but works in the opposite "
"direction: The text is copied from the current buffer into @var{to-buffer}. "
"The block of text is copied to the current point in @var{to-buffer}, and "
"point (in that buffer) is advanced to after the end of the copied text. Is "
"@code{start}/@code{end} is @code{nil}, the entire text in the current buffer "
"is copied over."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:519
msgid ""
"@xref{Sticky Properties}, for other insertion functions that inherit text "
"properties from the nearby text in addition to inserting it. Whitespace "
"inserted by indentation functions also inherits text properties."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:521
#, no-wrap
msgid "User-Level Insertion Commands"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:526
msgid ""
"This section describes higher-level commands for inserting text, commands "
"intended primarily for the user but useful also in Lisp programs."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:527
#, no-wrap
msgid "Command insert-buffer from-buffer-or-name"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:532
msgid ""
"This command inserts the entire accessible contents of "
"@var{from-buffer-or-name} (which must exist) into the current buffer after "
"point. It leaves the mark after the inserted text. The value is "
"@code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:534
#, no-wrap
msgid "Command self-insert-command count &optional char"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:535
#, no-wrap
msgid "character insertion"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:536
#, no-wrap
msgid "self-insertion"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:542
msgid ""
"This command inserts the character @var{char} (the last character typed); it "
"does so @var{count} times, before point, and returns @code{nil}. Most "
"printing characters are bound to this command. In routine use, "
"@code{self-insert-command} is the most frequently called function in Emacs, "
"but programs rarely use it except to install it on a keymap."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:544
msgid "In an interactive call, @var{count} is the numeric prefix argument."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:548
msgid ""
"Self-insertion translates the input character through "
"@code{translation-table-for-input}. @xref{Translation of Characters}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:552
msgid ""
"This command calls @code{auto-fill-function} whenever that is non-@code{nil} "
"and the character inserted is in the table @code{auto-fill-chars} "
"(@pxref{Auto Filling})."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:559
msgid ""
"This command performs abbrev expansion if Abbrev mode is enabled and the "
"inserted character does not have word-constituent syntax. (@xref{Abbrevs}, "
"and @ref{Syntax Class Table}.) It is also responsible for calling "
"@code{blink-paren-function} when the inserted character has close "
"parenthesis syntax (@pxref{Blinking})."
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:560
#, no-wrap
msgid "post-self-insert-hook"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:561
#, no-wrap
msgid "self-insert-uses-region-functions"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:572
msgid ""
"The final thing this command does is to run the hook "
"@code{post-self-insert-hook}. You could use this to automatically reindent "
"text as it is typed, for example. If any function on this hook needs to act "
"on the region (@pxref{The Region}), it should make sure Delete Selection "
"mode (@pxref{Using Region, Delete Selection, , emacs, The GNU Emacs Manual}) "
"doesn't delete the region before @code{post-self-insert-hook} functions are "
"invoked. The way to do so is to add a function that returns @code{nil} to "
"@code{self-insert-uses-region-functions}, a special hook that tells Delete "
"Selection mode it should not delete the region."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:576
msgid ""
"Do not try substituting your own definition of @code{self-insert-command} "
"for the standard one. The editor command loop handles this function "
"specially."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:578
#, no-wrap
msgid "Command newline &optional number-of-newlines interactive"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:583
msgid ""
"This command inserts newlines into the current buffer before point. If "
"@var{number-of-newlines} is supplied, that many newline characters are "
"inserted. In an interactive call, @var{number-of-newlines} is the numeric "
"prefix argument."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:584
#, no-wrap
msgid "newline and Auto Fill mode"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:592
msgid ""
"This command calls @code{self-insert-command} to insert newlines, which may "
"subsequently break the preceding line by calling @code{auto-fill-function} "
"(@pxref{Auto Filling}). Typically what @code{auto-fill-function} does is "
"insert a newline; thus, the overall result in this case is to insert two "
"newlines at different places: one at point, and another earlier in the "
"line. @code{newline} does not auto-fill if @var{number-of-newlines} is "
"non-@code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:595
msgid ""
"This command does not run the hook @code{post-self-insert-hook} unless "
"called interactively or @var{interactive} is non-@code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:598
msgid ""
"This command indents to the left margin if that is not zero. "
"@xref{Margins}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:600
msgid "The value returned is @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:602
#, no-wrap
msgid "Command ensure-empty-lines &optional number-of-empty-lines"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:608
msgid ""
"This command can be used to ensure that you have a specific number of empty "
"lines before point. (An ``empty line'' is here defined as a line with no "
"characters on it---a line with space characters isn't an empty line.) It "
"defaults to ensuring that there's a single empty line before point."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:613
msgid ""
"If point isn't at the beginning of a line, a newline character is inserted "
"first. If there's more empty lines before point than specified, the number "
"of empty lines is reduced. Otherwise it's increased to the specified "
"number."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:615
#, no-wrap
msgid "overwrite-mode"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:622
msgid ""
"This variable controls whether overwrite mode is in effect. The value "
"should be @code{overwrite-mode-textual}, @code{overwrite-mode-binary}, or "
"@code{nil}. @code{overwrite-mode-textual} specifies textual overwrite mode "
"(treats newlines and tabs specially), and @code{overwrite-mode-binary} "
"specifies binary overwrite mode (treats newlines and tabs like any other "
"characters)."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:625
#, no-wrap
msgid "Deleting Text"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:626
#, no-wrap
msgid "text deletion"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:628
#, no-wrap
msgid "deleting text vs killing"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:634
msgid ""
"Deletion means removing part of the text in a buffer, without saving it in "
"the kill ring (@pxref{The Kill Ring}). Deleted text can't be yanked, but "
"can be reinserted using the undo mechanism (@pxref{Undo}). Some deletion "
"functions do save text in the kill ring in some special cases."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:636
msgid "All of the deletion functions operate on the current buffer."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:637
#, no-wrap
msgid "Command erase-buffer"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:644
msgid ""
"This function deletes the entire text of the current buffer (@emph{not} just "
"the accessible portion), leaving it empty. If the buffer is read-only, it "
"signals a @code{buffer-read-only} error; if some of the text in it is "
"read-only, it signals a @code{text-read-only} error. Otherwise, it deletes "
"the text without asking for any confirmation. It returns @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:650
msgid ""
"Normally, deleting a large amount of text from a buffer inhibits further "
"auto-saving of that buffer because it has shrunk. However, "
"@code{erase-buffer} does not do this, the idea being that the future text is "
"not really related to the former text, and its size should not be compared "
"with that of the former text."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:652
#, no-wrap
msgid "Command delete-region start end"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:657
msgid ""
"This command deletes the text between positions @var{start} and @var{end} in "
"the current buffer, and returns @code{nil}. If point was inside the deleted "
"region, its value afterward is @var{start}. Otherwise, point relocates with "
"the surrounding text, as markers do."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:659
#, no-wrap
msgid "delete-and-extract-region start end"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:663
msgid ""
"This function deletes the text between positions @var{start} and @var{end} "
"in the current buffer, and returns a string containing the text just "
"deleted."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:667
msgid ""
"If point was inside the deleted region, its value afterward is @var{start}. "
"Otherwise, point relocates with the surrounding text, as markers do."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:669
#, no-wrap
msgid "Command delete-char count &optional killp"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:673
msgid ""
"This command deletes @var{count} characters directly after point, or before "
"point if @var{count} is negative. If @var{killp} is non-@code{nil}, then it "
"saves the deleted characters in the kill ring."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:679
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:694
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:716
msgid ""
"In an interactive call, @var{count} is the numeric prefix argument, and "
"@var{killp} is the unprocessed prefix argument. Therefore, if a prefix "
"argument is supplied, the text is saved in the kill ring. If no prefix "
"argument is supplied, then one character is deleted, but not saved in the "
"kill ring."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:681
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:696
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:718
msgid "The value returned is always @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:683
#, no-wrap
msgid "Command delete-backward-char count &optional killp"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:684
#, no-wrap
msgid "deleting previous char"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:688
msgid ""
"This command deletes @var{count} characters directly before point, or after "
"point if @var{count} is negative. If @var{killp} is non-@code{nil}, then it "
"saves the deleted characters in the kill ring."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:698
#, no-wrap
msgid "Command backward-delete-char-untabify count &optional killp"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:699
#, no-wrap
msgid "tab deletion"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:706
msgid ""
"This command deletes @var{count} characters backward, changing tabs into "
"spaces. When the next character to be deleted is a tab, it is first "
"replaced with the proper number of spaces to preserve alignment and then one "
"of those spaces is deleted instead of the tab. If @var{killp} is "
"non-@code{nil}, then the command saves the deleted characters in the kill "
"ring."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:710
msgid ""
"Conversion of tabs to spaces happens only if @var{count} is positive. If it "
"is negative, exactly @minus{}@var{count} characters after point are deleted."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:720
#, no-wrap
msgid "backward-delete-char-untabify-method"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:728
msgid ""
"This option specifies how @code{backward-delete-char-untabify} should deal "
"with whitespace. Possible values include @code{untabify}, the default, "
"meaning convert a tab to many spaces and delete one; @code{hungry}, meaning "
"delete all tabs and spaces before point with one command; @code{all} meaning "
"delete all tabs, spaces and newlines before point, and @code{nil}, meaning "
"do nothing special for whitespace characters."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:731
#, no-wrap
msgid "User-Level Deletion Commands"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:736
msgid ""
"This section describes higher-level commands for deleting text, commands "
"intended primarily for the user but useful also in Lisp programs."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:737
#, no-wrap
msgid "Command delete-horizontal-space &optional backward-only"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:738
#, no-wrap
msgid "deleting whitespace"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:741
msgid ""
"This function deletes all spaces and tabs around point. It returns "
"@code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:744
msgid ""
"If @var{backward-only} is non-@code{nil}, the function deletes spaces and "
"tabs before point, but not after point."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:748
msgid ""
"In the following examples, we call @code{delete-horizontal-space} four "
"times, once on each line, with point between the second and third characters "
"on the line each time."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:757
#, no-wrap
msgid ""
"---------- Buffer: foo ----------\n"
"I @point{}thought\n"
"I @point{} thought\n"
"We@point{} thought\n"
"Yo@point{}u thought\n"
"---------- Buffer: foo ----------\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:762
#, no-wrap
msgid ""
"(delete-horizontal-space) ; @r{Four times.}\n"
" @result{} nil\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:769
#, no-wrap
msgid ""
"---------- Buffer: foo ----------\n"
"Ithought\n"
"Ithought\n"
"Wethought\n"
"You thought\n"
"---------- Buffer: foo ----------\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:773
#, no-wrap
msgid "Command delete-indentation &optional join-following-p beg end"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:780
msgid ""
"This function joins the line point is on to the previous line, deleting any "
"whitespace at the join and in some cases replacing it with one space. If "
"@var{join-following-p} is non-@code{nil}, @code{delete-indentation} joins "
"this line to the following line instead. Otherwise, if @var{beg} and "
"@var{end} are non-@code{nil}, this function joins all lines in the region "
"they define."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:785
msgid ""
"In an interactive call, @var{join-following-p} is the prefix argument, and "
"@var{beg} and @var{end} are, respectively, the start and end of the region "
"if it is active, else @code{nil}. The function returns @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:789
msgid ""
"If there is a fill prefix, and the second of the lines being joined starts "
"with the prefix, then @code{delete-indentation} deletes the fill prefix "
"before joining the lines. @xref{Margins}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:793
msgid ""
"In the example below, point is located on the line starting @samp{events}, "
"and it makes no difference if there are trailing spaces in the preceding "
"line."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:800
#, no-wrap
msgid ""
"---------- Buffer: foo ----------\n"
"When in the course of human\n"
"@point{} events, it becomes necessary\n"
"---------- Buffer: foo ----------\n"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:804
#, no-wrap
msgid ""
"(delete-indentation)\n"
" @result{} nil\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:809
#, no-wrap
msgid ""
"---------- Buffer: foo ----------\n"
"When in the course of human@point{} events, it becomes necessary\n"
"---------- Buffer: foo ----------\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:814
msgid ""
"After the lines are joined, the function @code{fixup-whitespace} is "
"responsible for deciding whether to leave a space at the junction."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:816
#, no-wrap
msgid "Command fixup-whitespace"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:820
msgid ""
"This function replaces all the horizontal whitespace surrounding point with "
"either one space or no space, according to the context. It returns "
"@code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:826
msgid ""
"At the beginning or end of a line, the appropriate amount of space is none. "
"Before a character with close parenthesis syntax, or after a character with "
"open parenthesis or expression-prefix syntax, no space is also appropriate. "
"Otherwise, one space is appropriate. @xref{Syntax Class Table}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:830
msgid ""
"In the example below, @code{fixup-whitespace} is called the first time with "
"point before the word @samp{spaces} in the first line. For the second "
"invocation, point is directly after the @samp{(}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:837
#, no-wrap
msgid ""
"---------- Buffer: foo ----------\n"
"This has too many @point{}spaces\n"
"This has too many spaces at the start of (@point{} this list)\n"
"---------- Buffer: foo ----------\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:844
#, no-wrap
msgid ""
"(fixup-whitespace)\n"
" @result{} nil\n"
"(fixup-whitespace)\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:851
#, no-wrap
msgid ""
"---------- Buffer: foo ----------\n"
"This has too many spaces\n"
"This has too many spaces at the start of (this list)\n"
"---------- Buffer: foo ----------\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:855
#, no-wrap
msgid "Command just-one-space &optional n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:860
msgid ""
"This command replaces any spaces and tabs around point with a single space, "
"or @var{n} spaces if @var{n} is specified. It returns @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:865
#, no-wrap
msgid "Command delete-blank-lines"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:871
msgid ""
"This function deletes blank lines surrounding point. If point is on a blank "
"line with one or more blank lines before or after it, then all but one of "
"them are deleted. If point is on an isolated blank line, then it is "
"deleted. If point is on a nonblank line, the command deletes all blank "
"lines immediately following it."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:874
msgid "A blank line is defined as a line containing only tabs and spaces."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:876
msgid "@code{delete-blank-lines} returns @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:878
#, no-wrap
msgid "Command delete-trailing-whitespace &optional start end"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:881
msgid ""
"Delete trailing whitespace in the region defined by @var{start} and "
"@var{end}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:884
msgid ""
"This command deletes whitespace characters after the last non-whitespace "
"character in each line in the region."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:889
msgid ""
"If this command acts on the entire buffer (i.e., if called interactively "
"with the mark inactive, or called from Lisp with @var{end} @code{nil}), it "
"also deletes all trailing lines at the end of the buffer if the variable "
"@code{delete-trailing-lines} is non-@code{nil}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:893
#, no-wrap
msgid "kill ring"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:901
msgid ""
"@dfn{Kill functions} delete text like the deletion functions, but save it so "
"that the user can reinsert it by @dfn{yanking}. Most of these functions "
"have @samp{kill-} in their name. By contrast, the functions whose names "
"start with @samp{delete-} normally do not save text for yanking (though they "
"can still be undone); these are deletion functions."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:909
msgid ""
"Most of the kill commands are primarily for interactive use, and are not "
"described here. What we do describe are the functions provided for use in "
"writing such commands. You can use these functions to write commands for "
"killing text. When you need to delete text for internal purposes within a "
"Lisp function, you should normally use deletion functions, so as not to "
"disturb the kill ring contents. @xref{Deletion}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:917
msgid ""
"Killed text is saved for later yanking in the @dfn{kill ring}. This is a "
"list that holds a number of recent kills, not just the last text kill. We "
"call this a ``ring'' because yanking treats it as having elements in a "
"cyclic order. The list is kept in the variable @code{kill-ring}, and can be "
"operated on with the usual functions for lists; there are also specialized "
"functions, described in this section, that treat it as a ring."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:926
msgid ""
"Some people think this use of the word ``kill'' is unfortunate, since it "
"refers to operations that specifically @emph{do not} destroy the entities "
"killed. This is in sharp contrast to ordinary life, in which death is "
"permanent and killed entities do not come back to life. Therefore, other "
"metaphors have been proposed. For example, the term ``cut ring'' makes "
"sense to people who, in pre-computer days, used scissors and paste to cut up "
"and rearrange manuscripts. However, it would be difficult to change the "
"terminology now."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:934
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:936
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:937
#, no-wrap
msgid "Kill Ring Concepts"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:934
msgid "What text looks like in the kill ring."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:934
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:962
#, no-wrap
msgid "Kill Functions"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:934
msgid "Functions that kill text."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:934
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1021
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1022
#, no-wrap
msgid "Yanking"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:934
msgid "How yanking is done."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:934
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1110
#, no-wrap
msgid "Yank Commands"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:934
msgid "Commands that access the kill ring."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:934
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1186
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1187
#, no-wrap
msgid "Low-Level Kill Ring"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:934
msgid "Functions and variables for kill ring access."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:934
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1276
#, no-wrap
msgid "Internals of Kill Ring"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:934
msgid "Variables that hold kill ring data."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:941
msgid ""
"The kill ring records killed text as strings in a list, most recent first. "
"A short kill ring, for example, might look like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:944
#, no-wrap
msgid "(\"some text\" \"a different piece of text\" \"even older text\")\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:949
msgid ""
"When the list reaches @code{kill-ring-max} entries in length, adding a new "
"entry automatically deletes the last entry."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:955
msgid ""
"When kill commands are interwoven with other commands, each kill command "
"makes a new entry in the kill ring. Multiple kill commands in succession "
"build up a single kill ring entry, which would be yanked as a unit; the "
"second and subsequent consecutive kill commands add text to the entry made "
"by the first one."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:961
msgid ""
"For yanking, one entry in the kill ring is designated the front of the "
"ring. Some yank commands rotate the ring by designating a different element "
"as the front. But this virtual rotation doesn't change the list "
"itself---the most recent entry always comes first in the list."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:963
#, no-wrap
msgid "Functions for Killing"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:972
msgid ""
"@code{kill-region} is the usual subroutine for killing text. Any command "
"that calls this function is a kill command (and should probably have "
"@samp{kill} in its name). @code{kill-region} puts the newly killed text in "
"a new element at the beginning of the kill ring or adds it to the most "
"recent element. It determines automatically (using @code{last-command}) "
"whether the previous command was a kill command, and if so appends the "
"killed text to the most recent entry."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:973
#, no-wrap
msgid "filtering killed text"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:980
msgid ""
"The commands described below can filter the killed text before they save it "
"in the kill ring. They call @code{filter-buffer-substring} (@pxref{Buffer "
"Contents}) to perform the filtering. By default, there's no filtering, but "
"major and minor modes and hook functions can set up filtering, so that text "
"saved in the kill ring is different from what was in the buffer."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:981
#, no-wrap
msgid "Command kill-region start end &optional region"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:988
msgid ""
"This function kills the stretch of text between @var{start} and @var{end}; "
"but if the optional argument @var{region} is non-@code{nil}, it ignores "
"@var{start} and @var{end}, and kills the text in the current region "
"instead. The text is deleted but saved in the kill ring, along with its "
"text properties. The value is always @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:992
msgid ""
"In an interactive call, @var{start} and @var{end} are point and the mark, "
"and @var{region} is always non-@code{nil}, so the command always kills the "
"text in the current region."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:997
msgid ""
"If the buffer or text is read-only, @code{kill-region} modifies the kill "
"ring just the same, then signals an error without modifying the buffer. "
"This is convenient because it lets the user use a series of kill commands to "
"copy text from a read-only buffer into the kill ring."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:999
#, no-wrap
msgid "kill-read-only-ok"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1003
msgid ""
"If this option is non-@code{nil}, @code{kill-region} does not signal an "
"error if the buffer or text is read-only. Instead, it simply returns, "
"updating the kill ring but not changing the buffer."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1005
#, no-wrap
msgid "Command copy-region-as-kill start end &optional region"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1012
msgid ""
"This function saves the stretch of text between @var{start} and @var{end} on "
"the kill ring (including text properties), but does not delete the text from "
"the buffer. However, if the optional argument @var{region} is "
"non-@code{nil}, the function ignores @var{start} and @var{end}, and saves "
"the current region instead. It always returns @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1016
msgid ""
"In an interactive call, @var{start} and @var{end} are point and the mark, "
"and @var{region} is always non-@code{nil}, so the command always saves the "
"text in the current region."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1019
msgid ""
"The command does not set @code{this-command} to @code{kill-region}, so a "
"subsequent kill command does not append to the same kill ring entry."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1028
msgid ""
"Yanking means inserting text from the kill ring, but it does not insert the "
"text blindly. The @code{yank} command, and related commands, use "
"@code{insert-for-yank} to perform special processing on the text before it "
"is inserted."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1029
#, no-wrap
msgid "insert-for-yank string"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1035
msgid ""
"This function works like @code{insert}, except that it processes the text in "
"@var{string} according to the @code{yank-handler} text property, as well as "
"the variables @code{yank-handled-properties} and "
"@code{yank-excluded-properties} (see below), before inserting the result "
"into the current buffer."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1037
#, no-wrap
msgid "insert-buffer-substring-as-yank buf &optional start end"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1043
msgid ""
"This function resembles @code{insert-buffer-substring}, except that it "
"processes the text according to @code{yank-handled-properties} and "
"@code{yank-excluded-properties}. (It does not handle the "
"@code{yank-handler} property, which does not normally occur in buffer text "
"anyway.)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1053
msgid ""
"If you put a @code{yank-handler} text property on all or part of a string, "
"that alters how @code{insert-for-yank} inserts the string. If different "
"parts of the string have different @code{yank-handler} values (comparison "
"being done with @code{eq}), each substring is handled separately. The "
"property value must be a list of one to four elements, with the following "
"format (where elements after the first may be omitted):"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1056
#, no-wrap
msgid "(@var{function} @var{param} @var{noexclude} @var{undo})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1059
msgid "Here is what the elements do:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1061
#, no-wrap
msgid "function"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1065
msgid ""
"When @var{function} is non-@code{nil}, it is called instead of @code{insert} "
"to insert the string, with one argument---the string to insert."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1066
#, no-wrap
msgid "param"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1072
msgid ""
"If @var{param} is present and non-@code{nil}, it replaces @var{string} (or "
"the substring of @var{string} being processed) as the object passed to "
"@var{function} (or @code{insert}). For example, if @var{function} is "
"@code{yank-rectangle}, @var{param} should be a list of strings to insert as "
"a rectangle."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1073
#, no-wrap
msgid "noexclude"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1077
msgid ""
"If @var{noexclude} is present and non-@code{nil}, that disables the normal "
"action of @code{yank-handled-properties} and @code{yank-excluded-properties} "
"on the inserted string."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1078
#, no-wrap
msgid "undo"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1084
msgid ""
"If @var{undo} is present and non-@code{nil}, it is a function that will be "
"called by @code{yank-pop} to undo the insertion of the current object. It "
"is called with two arguments, the start and end of the current region. "
"@var{function} can set @code{yank-undo-function} to override the @var{undo} "
"value."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1086
#, no-wrap
msgid "yanking and text properties"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1087
#, no-wrap
msgid "yank-handled-properties"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1092
msgid ""
"This variable specifies special text property handling conditions for yanked "
"text. It takes effect after the text has been inserted (either normally, or "
"via the @code{yank-handler} property), and prior to "
"@code{yank-excluded-properties} taking effect."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1099
msgid ""
"The value should be an alist of elements @code{(@var{prop} . @var{fun})}. "
"Each alist element is handled in order. The inserted text is scanned for "
"stretches of text having text properties @code{eq} to @var{prop}; for each "
"such stretch, @var{fun} is called with three arguments: the value of the "
"property, and the start and end positions of the text."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1101
#, no-wrap
msgid "yank-excluded-properties"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1107
msgid ""
"The value of this variable is the list of properties to remove from inserted "
"text. Its default value contains properties that might lead to annoying "
"results, such as causing the text to respond to the mouse or specifying key "
"bindings. It takes effect after @code{yank-handled-properties}."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1111
#, no-wrap
msgid "Functions for Yanking"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1118
msgid ""
"This section describes higher-level commands for yanking, which are intended "
"primarily for the user but useful also in Lisp programs. Both @code{yank} "
"and @code{yank-pop} honor the @code{yank-excluded-properties} variable and "
"@code{yank-handler} text property (@pxref{Yanking})."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1119
#, no-wrap
msgid "Command yank &optional arg"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1120
#, no-wrap
msgid "inserting killed text"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1124
msgid ""
"This command inserts before point the text at the front of the kill ring. "
"It sets the mark at the beginning of that text, using @code{push-mark} "
"(@pxref{The Mark}), and puts point at the end."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1129
msgid ""
"If @var{arg} is a non-@code{nil} list (which occurs interactively when the "
"user types @kbd{C-u} with no digits), then @code{yank} inserts the text as "
"described above, but puts point before the yanked text and sets the mark "
"after it."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1134
msgid ""
"If @var{arg} is a number, then @code{yank} inserts the @var{arg}th most "
"recently killed text---the @var{arg}th element of the kill ring list, "
"counted cyclically from the front, which is considered the first element for "
"this purpose."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1139
msgid ""
"@code{yank} does not alter the contents of the kill ring, unless it used "
"text provided by another program, in which case it pushes that text onto the "
"kill ring. However if @var{arg} is an integer different from one, it "
"rotates the kill ring to place the yanked string at the front."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1141
msgid "@code{yank} returns @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1143
#, no-wrap
msgid "Command yank-pop &optional arg"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1153
msgid ""
"When invoked immediately after a @code{yank} or another @code{yank-pop}, "
"this command replaces the just-yanked entry from the kill ring with a "
"different entry from the kill ring. When this command is invoked like that, "
"the region contains text that was just inserted by another yank command. "
"@code{yank-pop} deletes that text and inserts in its place a different piece "
"of killed text. It does not add the deleted text to the kill ring, since it "
"is already in the kill ring somewhere. It does however rotate the kill ring "
"to place the newly yanked string at the front."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1158
msgid ""
"If @var{arg} is @code{nil}, then the replacement text is the previous "
"element of the kill ring. If @var{arg} is numeric, the replacement is the "
"@var{arg}th previous kill. If @var{arg} is negative, a more recent kill is "
"the replacement."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1163
msgid ""
"The sequence of kills in the kill ring wraps around, so if @code{yank-pop} "
"is invoked repeatedly and reaches the oldest kill, the one that comes after "
"it is the newest one, and the one before the newest one is the oldest one."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1170
msgid ""
"This command can also be invoked after a command that is not a yank "
"command. In that case, it prompts in the minibuffer for a kill-ring entry, "
"with completion, and uses the kill ring elements as the minibuffer history "
"(@pxref{Minibuffer History}). This allows the user to interactively select "
"one of the previous kills recorded in the kill ring."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1172
msgid "The return value is always @code{nil}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1174
#, no-wrap
msgid "yank-undo-function"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1180
msgid ""
"If this variable is non-@code{nil}, the function @code{yank-pop} uses its "
"value instead of @code{delete-region} to delete the text inserted by the "
"previous @code{yank} or @code{yank-pop} command. The value must be a "
"function of two arguments, the start and end of the current region."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1184
msgid ""
"The function @code{insert-for-yank} automatically sets this variable "
"according to the @var{undo} element of the @code{yank-handler} text "
"property, if there is one."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1193
msgid ""
"These functions and variables provide access to the kill ring at a lower "
"level, but are still convenient for use in Lisp programs, because they take "
"care of interaction with window system selections (@pxref{Window System "
"Selections})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1194
#, no-wrap
msgid "current-kill n &optional do-not-move"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1198
msgid ""
"The function @code{current-kill} rotates the yanking pointer, which "
"designates the front of the kill ring, by @var{n} places (from newer kills "
"to older ones), and returns the text at that place in the ring."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1202
msgid ""
"If the optional second argument @var{do-not-move} is non-@code{nil}, then "
"@code{current-kill} doesn't alter the yanking pointer; it just returns the "
"@var{n}th kill, counting from the current yanking pointer."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1215
msgid ""
"If @var{n} is zero, indicating a request for the latest kill, "
"@code{current-kill} calls the value of @code{interprogram-paste-function} "
"(documented below) before consulting the kill ring. If that value is a "
"function and calling it returns a string or a list of several strings, "
"@code{current-kill} pushes the strings onto the kill ring and returns the "
"first string. It also sets the yanking pointer to point to the kill-ring "
"entry of the first string returned by @code{interprogram-paste-function}, "
"regardless of the value of @var{do-not-move}. Otherwise, "
"@code{current-kill} does not treat a zero value for @var{n} specially: it "
"returns the entry pointed at by the yanking pointer and does not move the "
"yanking pointer."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1217
#, no-wrap
msgid "kill-new string &optional replace"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1224
msgid ""
"This function pushes the text @var{string} onto the kill ring and makes the "
"yanking pointer point to it. It discards the oldest entry if appropriate. "
"It also invokes the values of @code{interprogram-paste-function} (subject to "
"the user option @code{save-interprogram-paste-before-kill}) and "
"@code{interprogram-cut-function} (see below)."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1228
msgid ""
"If @var{replace} is non-@code{nil}, then @code{kill-new} replaces the first "
"element of the kill ring with @var{string}, rather than pushing @var{string} "
"onto the kill ring."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1230
#, no-wrap
msgid "kill-append string before-p"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1239
msgid ""
"This function appends the text @var{string} to the first entry in the kill "
"ring and makes the yanking pointer point to the combined entry. Normally "
"@var{string} goes at the end of the entry, but if @var{before-p} is "
"non-@code{nil}, it goes at the beginning. This function calls "
"@code{kill-new} as a subroutine, thus causing the values of "
"@code{interprogram-cut-function} and possibly "
"@code{interprogram-paste-function} (see below) to be invoked by extension."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1241
#, no-wrap
msgid "interprogram-paste-function"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1245
msgid ""
"This variable provides a way of transferring killed text from other "
"programs, when you are using a window system. Its value should be "
"@code{nil} or a function of no arguments."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1250
msgid ""
"If the value is a function, @code{current-kill} calls it to get the most "
"recent kill. If the function returns a non-@code{nil} value, then that "
"value is used as the most recent kill. If it returns @code{nil}, then the "
"front of the kill ring is used."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1256
msgid ""
"To facilitate support for window systems that support multiple selections, "
"this function may also return a list of strings. In that case, the first "
"string is used as the most recent kill, and all the other strings are pushed "
"onto the kill ring, for easy access by @code{yank-pop}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1262
msgid ""
"The normal use of this function is to get the window system's clipboard as "
"the most recent kill, even if the selection belongs to another application. "
"@xref{Window System Selections}. However, if the clipboard contents come "
"from the current Emacs session, this function should return @code{nil}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1264
#, no-wrap
msgid "interprogram-cut-function"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1268
msgid ""
"This variable provides a way of communicating killed text to other programs, "
"when you are using a window system. Its value should be @code{nil} or a "
"function of one required argument."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1271
msgid ""
"If the value is a function, @code{kill-new} and @code{kill-append} call it "
"with the new first element of the kill ring as the argument."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1274
msgid ""
"The normal use of this function is to put newly killed text in the window "
"system's clipboard. @xref{Window System Selections}."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1277
#, no-wrap
msgid "Internals of the Kill Ring"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1282
msgid ""
"The variable @code{kill-ring} holds the kill ring contents, in the form of a "
"list of strings. The most recent kill is always at the front of the list."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1291
msgid ""
"The @code{kill-ring-yank-pointer} variable points to a link in the kill ring "
"list, whose @sc{car} is the text to yank next. We say it identifies the "
"front of the ring. Moving @code{kill-ring-yank-pointer} to a different link "
"is called @dfn{rotating the kill ring}. We call the kill ring a ``ring'' "
"because the functions that move the yank pointer wrap around from the end of "
"the list to the beginning, or vice-versa. Rotation of the kill ring is "
"virtual; it does not change the value of @code{kill-ring}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1297
msgid ""
"Both @code{kill-ring} and @code{kill-ring-yank-pointer} are Lisp variables "
"whose values are normally lists. The word ``pointer'' in the name of the "
"@code{kill-ring-yank-pointer} indicates that the variable's purpose is to "
"identify one element of the list for use by the next yank command."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1303
msgid ""
"The value of @code{kill-ring-yank-pointer} is always @code{eq} to one of the "
"links in the kill ring list. The element it identifies is the @sc{car} of "
"that link. Kill commands, which change the kill ring, also set this "
"variable to the value of @code{kill-ring}. The effect is to rotate the ring "
"so that the newly killed text is at the front."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1307
msgid ""
"Here is a diagram that shows the variable @code{kill-ring-yank-pointer} "
"pointing to the second entry in the kill ring @code{(\"some text\" \"a "
"different piece of text\" \"yet older text\")}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1323
#, no-wrap
msgid ""
"kill-ring ---- kill-ring-yank-pointer\n"
" | |\n"
" | v\n"
" | --- --- --- --- --- ---\n"
" --> | | |------> | | |--> | | |--> nil\n"
" --- --- --- --- --- ---\n"
" | | |\n"
" | | |\n"
" | | -->\"yet older text\"\n"
" | |\n"
" | --> \"a different piece of text\"\n"
" |\n"
" --> \"some text\"\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1329
msgid ""
"This state of affairs might occur after @kbd{C-y} (@code{yank}) immediately "
"followed by @kbd{M-y} (@code{yank-pop})."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1330
#, no-wrap
msgid "kill-ring"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1333
msgid ""
"This variable holds the list of killed text sequences, most recently killed "
"first."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1335
#, no-wrap
msgid "kill-ring-yank-pointer"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1340
msgid ""
"This variable's value indicates which element of the kill ring is at the "
"front of the ring for yanking. More precisely, the value is a tail of the "
"value of @code{kill-ring}, and its @sc{car} is the kill string that "
"@kbd{C-y} should yank."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1342
#, no-wrap
msgid "kill-ring-max"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1346
msgid ""
"The value of this variable is the maximum length to which the kill ring can "
"grow, before elements are thrown away at the end. The default value for "
"@code{kill-ring-max} is 120."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1350
#, no-wrap
msgid "redo"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1360
msgid ""
"Most buffers have an @dfn{undo list}, which records all changes made to the "
"buffer's text so that they can be undone. (The buffers that don't have one "
"are usually special-purpose buffers for which Emacs assumes that undoing is "
"not useful. In particular, any buffer whose name begins with a space has "
"its undo recording off by default; see @ref{Buffer Names}.) All the "
"primitives that modify the text in the buffer automatically add elements to "
"the front of the undo list, which is in the variable "
"@code{buffer-undo-list}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1361
#, no-wrap
msgid "buffer-undo-list"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1364
msgid ""
"This buffer-local variable's value is the undo list of the current buffer. "
"A value of @code{t} disables the recording of undo information."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1367
msgid "Here are the kinds of elements an undo list can have:"
msgstr ""
#. type: var{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1369
#, no-wrap
msgid "position"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1374
msgid ""
"This kind of element records a previous value of point; undoing this element "
"moves point to @var{position}. Ordinary cursor motion does not make any "
"sort of undo record, but deletion operations use these entries to record "
"where point was before the command."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1375
#, no-wrap
msgid "(@var{beg} . @var{end})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1379
msgid ""
"This kind of element indicates how to delete text that was inserted. Upon "
"insertion, the text occupied the range @var{beg}--@var{end} in the buffer."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1380
#, no-wrap
msgid "(@var{text} . @var{position})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1387
msgid ""
"This kind of element indicates how to reinsert text that was deleted. The "
"deleted text itself is the string @var{text}. The place to reinsert it is "
"@code{(abs @var{position})}. If @var{position} is positive, point was at "
"the beginning of the deleted text, otherwise it was at the end. Zero or "
"more (@var{marker} . @var{adjustment}) elements follow immediately after "
"this element."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1388
#, no-wrap
msgid "(t . @var{time-flag})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1399
msgid ""
"This kind of element indicates that an unmodified buffer became modified. A "
"@var{time-flag} that is a non-integer Lisp timestamp represents the visited "
"file's modification time as of when it was previously visited or saved, "
"using the same format as @code{current-time}; see @ref{Time of Day}. A "
"@var{time-flag} of 0 means the buffer does not correspond to any file; "
"@minus{}1 means the visited file previously did not exist. "
"@code{primitive-undo} uses these values to determine whether to mark the "
"buffer as unmodified once again; it does so only if the file's status "
"matches that of @var{time-flag}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1400
#, no-wrap
msgid "(nil @var{property} @var{value} @var{beg} . @var{end})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1403
msgid ""
"This kind of element records a change in a text property. Here's how you "
"might undo the change:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1406
#, no-wrap
msgid "(put-text-property @var{beg} @var{end} @var{property} @var{value})\n"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1408
#, no-wrap
msgid "(@var{marker} . @var{adjustment})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1415
msgid ""
"This kind of element records the fact that the marker @var{marker} was "
"relocated due to deletion of surrounding text, and that it moved "
"@var{adjustment} character positions. If the marker's location is "
"consistent with the (@var{text} . @var{position}) element preceding it in "
"the undo list, then undoing this element moves @var{marker} @minus{} "
"@var{adjustment} characters."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1416
#, no-wrap
msgid "(apply @var{funname} . @var{args})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1419
msgid ""
"This is an extensible undo item, which is undone by calling @var{funname} "
"with arguments @var{args}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1420
#, no-wrap
msgid "(apply @var{delta} @var{beg} @var{end} @var{funname} . @var{args})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1425
msgid ""
"This is an extensible undo item, which records a change limited to the range "
"@var{beg} to @var{end}, which increased the size of the buffer by "
"@var{delta} characters. It is undone by calling @var{funname} with "
"arguments @var{args}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1428
msgid ""
"This kind of element enables undo limited to a region to determine whether "
"the element pertains to that region."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1429
#, no-wrap
msgid "nil"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1434
msgid ""
"This element is a boundary. The elements between two boundaries are called "
"a @dfn{change group}; normally, each change group corresponds to one "
"keyboard command, and undo commands normally undo an entire group as a unit."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1436
#, no-wrap
msgid "undo-boundary"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1440
msgid ""
"This function places a boundary element in the undo list. The undo command "
"stops at such a boundary, and successive undo commands undo to earlier and "
"earlier boundaries. This function returns @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1445
msgid ""
"Calling this function explicitly is useful for splitting the effects of a "
"command into more than one unit. For example, @code{query-replace} calls "
"@code{undo-boundary} after each replacement, so that the user can undo "
"individual replacements one by one."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1448
msgid ""
"Mostly, however, this function is called automatically at an appropriate "
"time."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1450
#, no-wrap
msgid "undo-auto-amalgamate"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1451
#, no-wrap
msgid "amalgamating commands, and undo"
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1452
#, no-wrap
msgid "amalgamating-undo-limit"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1466
msgid ""
"The editor command loop automatically calls @code{undo-boundary} just before "
"executing each key sequence, so that each undo normally undoes the effects "
"of one command. A few exceptional commands are @dfn{amalgamating}: these "
"commands generally cause small changes to buffers, so with these a boundary "
"is inserted only every 20th command, allowing the changes to be undone as a "
"group. By default, the commands @code{self-insert-command}, which produces "
"self-inserting input characters (@pxref{Commands for Insertion}), and "
"@code{delete-char}, which deletes characters (@pxref{Deletion}), are "
"amalgamating. Where a command affects the contents of several buffers, as "
"may happen, for example, when a function on the @code{post-command-hook} "
"affects a buffer other than the @code{current-buffer}, then "
"@code{undo-boundary} will be called in each of the affected buffers."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1470
msgid ""
"This function can be called before an amalgamating command. It removes the "
"previous @code{undo-boundary} if a series of such calls have been made."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1474
msgid ""
"The maximum number of changes that can be amalgamated is controlled by the "
"@code{amalgamating-undo-limit} variable. If this variable is 1, no changes "
"are amalgamated."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1480
msgid ""
"A Lisp program can amalgamate a series of changes into a single change group "
"by calling @code{undo-amalgamate-change-group} (@pxref{Atomic Changes}). "
"Note that @code{amalgamating-undo-limit} has no effect on the groups "
"produced by that function."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1481
#, no-wrap
msgid "undo-auto-current-boundary-timer"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1486
msgid ""
"Some buffers, such as process buffers, can change even when no commands are "
"executing. In these cases, @code{undo-boundary} is normally called "
"periodically by the timer in this variable. Setting this variable to "
"non-@code{nil} prevents this behavior."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1488
#, no-wrap
msgid "undo-in-progress"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1492
msgid ""
"This variable is normally @code{nil}, but the undo commands bind it to "
"@code{t}. This is so that various kinds of change hooks can tell when "
"they're being called for the sake of undoing."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1494
#, no-wrap
msgid "primitive-undo count list"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1498
msgid ""
"This is the basic function for undoing elements of an undo list. It undoes "
"the first @var{count} elements of @var{list}, returning the rest of "
"@var{list}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1505
msgid ""
"@code{primitive-undo} adds elements to the buffer's undo list when it "
"changes the buffer. Undo commands avoid confusion by saving the undo list "
"value at the beginning of a sequence of undo operations. Then the undo "
"operations use and update the saved value. The new elements added by "
"undoing are not part of this saved value, so they don't interfere with "
"continuing to undo."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1507
msgid "This function does not bind @code{undo-in-progress}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1514
msgid ""
"Some commands leave the region active after execution in such a way that it "
"interferes with selective undo of that command. To make @code{undo} ignore "
"the active region when invoked immediately after such a command, set the "
"property @code{undo-inhibit-region} of the command's function symbol to a "
"non-nil value. @xref{Standard Properties}."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1516
#, no-wrap
msgid "Maintaining Undo Lists"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1521
msgid ""
"This section describes how to enable and disable undo information for a "
"given buffer. It also explains how the undo list is truncated automatically "
"so it doesn't get too big."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1527
msgid ""
"Recording of undo information in a newly created buffer is normally enabled "
"to start with; but if the buffer name starts with a space, the undo "
"recording is initially disabled. You can explicitly enable or disable undo "
"recording with the following two functions, or by setting "
"@code{buffer-undo-list} yourself."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1528
#, no-wrap
msgid "Command buffer-enable-undo &optional buffer-or-name"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1534
msgid ""
"This command enables recording undo information for buffer "
"@var{buffer-or-name}, so that subsequent changes can be undone. If no "
"argument is supplied, then the current buffer is used. This function does "
"nothing if undo recording is already enabled in the buffer. It returns "
"@code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1537
msgid ""
"In an interactive call, @var{buffer-or-name} is the current buffer. You "
"cannot specify any other buffer."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1539
#, no-wrap
msgid "Command buffer-disable-undo &optional buffer-or-name"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1540
#, no-wrap
msgid "disabling undo"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1546
msgid ""
"This function discards the undo list of @var{buffer-or-name}, and disables "
"further recording of undo information. As a result, it is no longer "
"possible to undo either previous changes or any subsequent changes. If the "
"undo list of @var{buffer-or-name} is already disabled, this function has no "
"effect."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1549
msgid ""
"In an interactive call, BUFFER-OR-NAME is the current buffer. You cannot "
"specify any other buffer. This function returns @code{nil}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1560
msgid ""
"As editing continues, undo lists get longer and longer. To prevent them "
"from using up all available memory space, garbage collection trims them back "
"to size limits you can set. (For this purpose, the size of an undo list "
"measures the cons cells that make up the list, plus the strings of deleted "
"text.) Three variables control the range of acceptable sizes: "
"@code{undo-limit}, @code{undo-strong-limit} and @code{undo-outer-limit}. In "
"these variables, size is counted as the number of bytes occupied, which "
"includes both saved text and other data."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1561
#, no-wrap
msgid "undo-limit"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1564
msgid ""
"This is the soft limit for the acceptable size of an undo list. The change "
"group at which this size is exceeded is the last one kept."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1566
#, no-wrap
msgid "undo-strong-limit"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1571
msgid ""
"This is the upper limit for the acceptable size of an undo list. The change "
"group at which this size is exceeded is discarded itself (along with all "
"older change groups). There is one exception: the very latest change group "
"is only discarded if it exceeds @code{undo-outer-limit}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1573
#, no-wrap
msgid "undo-outer-limit"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1577
msgid ""
"If at garbage collection time the undo info for the current command exceeds "
"this limit, Emacs discards the info and displays a warning. This is a last "
"ditch limit to prevent memory overflow."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1579
#, no-wrap
msgid "undo-ask-before-discard"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1584
msgid ""
"If this variable is non-@code{nil}, when the undo info exceeds "
"@code{undo-outer-limit}, Emacs asks in the echo area whether to discard the "
"info. The default value is @code{nil}, which means to discard it "
"automatically."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1588
msgid ""
"This option is mainly intended for debugging. Garbage collection is "
"inhibited while the question is asked, which means that Emacs might leak "
"memory if the user waits too long before answering the question."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1592
#, no-wrap
msgid "filling text"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1600
msgid ""
"@dfn{Filling} means adjusting the lengths of lines (by moving the line "
"breaks) so that they are nearly (but no greater than) a specified maximum "
"width. Additionally, lines can be @dfn{justified}, which means inserting "
"spaces to make the left and/or right margins line up precisely. The width "
"is controlled by the variable @code{fill-column}. For ease of reading, "
"lines should be no longer than 70 or so columns."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1604
msgid ""
"You can use Auto Fill mode (@pxref{Auto Filling}) to fill text automatically "
"as you insert it, but changes to existing text may leave it improperly "
"filled. Then you must fill the text explicitly."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1610
msgid ""
"Most of the commands in this section return values that are not meaningful. "
"All the functions that do filling take note of the current left margin, "
"current right margin, and current justification style (@pxref{Margins}). If "
"the current justification style is @code{none}, the filling functions don't "
"actually do anything."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1618
msgid ""
"Several of the filling functions have an argument @var{justify}. If it is "
"non-@code{nil}, that requests some kind of justification. It can be "
"@code{left}, @code{right}, @code{full}, or @code{center}, to request a "
"specific style of justification. If it is @code{t}, that means to use the "
"current justification style for this part of the text (see "
"@code{current-justification}, below). Any other value is treated as "
"@code{full}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1621
msgid ""
"When you call the filling functions interactively, using a prefix argument "
"implies the value @code{full} for @var{justify}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1622
#, no-wrap
msgid "Command fill-paragraph &optional justify region"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1627
msgid ""
"This command fills the paragraph at or after point. If @var{justify} is "
"non-@code{nil}, each line is justified as well. It uses the ordinary "
"paragraph motion commands to find paragraph boundaries. @xref{Paragraphs,,, "
"emacs, The GNU Emacs Manual}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1633
msgid ""
"When @var{region} is non-@code{nil}, then if Transient Mark mode is enabled "
"and the mark is active, this command calls @code{fill-region} to fill all "
"the paragraphs in the region, instead of filling only the current "
"paragraph. When this command is called interactively, @var{region} is "
"@code{t}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1635
#, no-wrap
msgid "Command fill-region start end &optional justify nosqueeze to-eop"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1639
msgid ""
"This command fills each of the paragraphs in the region from @var{start} to "
"@var{end}. It justifies as well if @var{justify} is non-@code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1644
msgid ""
"If @var{nosqueeze} is non-@code{nil}, that means to leave whitespace other "
"than line breaks untouched. If @var{to-eop} is non-@code{nil}, that means "
"to keep filling to the end of the paragraph---or the next hard newline, if "
"@code{use-hard-newlines} is enabled (see below)."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1647
msgid ""
"The variable @code{paragraph-separate} controls how to distinguish "
"paragraphs. @xref{Standard Regexps}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1649
#, no-wrap
msgid ""
"Command fill-individual-paragraphs start end &optional justify "
"citation-regexp"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1654
msgid ""
"This command fills each paragraph in the region according to its individual "
"fill prefix. Thus, if the lines of a paragraph were indented with spaces, "
"the filled paragraph will remain indented in the same fashion."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1664
msgid ""
"The first two arguments, @var{start} and @var{end}, are the beginning and "
"end of the region to be filled. The third and fourth arguments, "
"@var{justify} and @var{citation-regexp}, are optional. If @var{justify} is "
"non-@code{nil}, the paragraphs are justified as well as filled. If "
"@var{citation-regexp} is non-@code{nil}, it means the function is operating "
"on a mail message and therefore should not fill the header lines. If "
"@var{citation-regexp} is a string, it is used as a regular expression; if it "
"matches the beginning of a line, that line is treated as a citation marker."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1671
msgid ""
"Ordinarily, @code{fill-individual-paragraphs} regards each change in "
"indentation as starting a new paragraph. If "
"@code{fill-individual-varying-indent} is non-@code{nil}, then only separator "
"lines separate paragraphs. That mode can handle indented paragraphs with "
"additional indentation on the first line."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1673
#, no-wrap
msgid "fill-individual-varying-indent"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1676
msgid ""
"This variable alters the action of @code{fill-individual-paragraphs} as "
"described above."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1678
#, no-wrap
msgid ""
"Command fill-region-as-paragraph start end &optional justify nosqueeze "
"squeeze-after"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1683
msgid ""
"This command considers a region of text as a single paragraph and fills it. "
"If the region was made up of many paragraphs, the blank lines between "
"paragraphs are removed. This function justifies as well as filling when "
"@var{justify} is non-@code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1688
msgid ""
"If @var{nosqueeze} is non-@code{nil}, that means to leave whitespace other "
"than line breaks untouched. If @var{squeeze-after} is non-@code{nil}, it "
"specifies a position in the region, and means don't canonicalize spaces "
"before that position."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1691
msgid ""
"In Adaptive Fill mode, this command calls @code{fill-context-prefix} to "
"choose a fill prefix by default. @xref{Adaptive Fill}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1693
#, no-wrap
msgid "Command justify-current-line &optional how eop nosqueeze"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1697
msgid ""
"This command inserts spaces between the words of the current line so that "
"the line ends exactly at @code{fill-column}. It returns @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1703
msgid ""
"The argument @var{how}, if non-@code{nil} specifies explicitly the style of "
"justification. It can be @code{left}, @code{right}, @code{full}, "
"@code{center}, or @code{none}. If it is @code{t}, that means to follow "
"specified justification style (see @code{current-justification}, below). "
"@code{nil} means to do full justification."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1708
msgid ""
"If @var{eop} is non-@code{nil}, that means do only left-justification if "
"@code{current-justification} specifies full justification. This is used for "
"the last line of a paragraph; even if the paragraph as a whole is fully "
"justified, the last line should not be."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1711
msgid ""
"If @var{nosqueeze} is non-@code{nil}, that means do not change interior "
"whitespace."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1713
#, no-wrap
msgid "default-justification"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1718
msgid ""
"This variable's value specifies the style of justification to use for text "
"that doesn't specify a style with a text property. The possible values are "
"@code{left}, @code{right}, @code{full}, @code{center}, or @code{none}. The "
"default value is @code{left}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1720
#, no-wrap
msgid "current-justification"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1723
msgid ""
"This function returns the proper justification style to use for filling the "
"text around point."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1728
msgid ""
"This returns the value of the @code{justification} text property at point, "
"or the variable @code{default-justification} if there is no such text "
"property. However, it returns @code{nil} rather than @code{none} to mean "
"``don't justify''."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1730
#, no-wrap
msgid "sentence-end-double-space"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1735
msgid "Definition of sentence-end-double-space"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1735
msgid ""
"If this variable is non-@code{nil}, a period followed by just one space does "
"not count as the end of a sentence, and the filling functions avoid breaking "
"the line at such a place."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1737
#, no-wrap
msgid "sentence-end-without-period"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1741
msgid ""
"If this variable is non-@code{nil}, a sentence can end without a period. "
"This is used for languages like Thai, where sentences end with a double "
"space but without a period."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1743
#, no-wrap
msgid "sentence-end-without-space"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1746
msgid ""
"If this variable is non-@code{nil}, it should be a string of characters that "
"can end a sentence without following spaces."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1748
#, no-wrap
msgid "fill-separate-heterogeneous-words-with-space"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1753
msgid ""
"If this variable is non-@code{nil}, two words of different kind (e.g., "
"English and CJK) will be separated with a space when concatenating one that "
"is in the end of a line and the other that is in the beginning of the next "
"line for filling."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1755
#, no-wrap
msgid "fill-paragraph-function"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1761
msgid ""
"This variable provides a way to override the filling of paragraphs. If its "
"value is non-@code{nil}, @code{fill-paragraph} calls this function to do the "
"work. If the function returns a non-@code{nil} value, @code{fill-paragraph} "
"assumes the job is done, and immediately returns that value."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1765
msgid ""
"The usual use of this feature is to fill comments in programming language "
"modes. If the function needs to fill a paragraph in the usual way, it can "
"do so as follows:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1769
#, no-wrap
msgid ""
"(let ((fill-paragraph-function nil))\n"
" (fill-paragraph arg))\n"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1772
#, no-wrap
msgid "fill-forward-paragraph-function"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1781
msgid ""
"This variable provides a way to override how the filling functions, such as "
"@code{fill-region} and @code{fill-paragraph}, move forward to the next "
"paragraph. Its value should be a function, which is called with a single "
"argument @var{n}, the number of paragraphs to move, and should return the "
"difference between @var{n} and the number of paragraphs actually moved. The "
"default value of this variable is @code{forward-paragraph}. "
"@xref{Paragraphs,,, emacs, The GNU Emacs Manual}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1783
#, no-wrap
msgid "use-hard-newlines"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1788
msgid ""
"If this variable is non-@code{nil}, the filling functions do not delete "
"newlines that have the @code{hard} text property. These hard newlines act "
"as paragraph separators. @xref{Hard and Soft Newlines,, Hard and Soft "
"Newlines, emacs, The GNU Emacs Manual}."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1791
#, no-wrap
msgid "Margins for Filling"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1792
#, no-wrap
msgid "margins, filling"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1794
#, no-wrap
msgid "fill-prefix"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1803
msgid ""
"This buffer-local variable, if non-@code{nil}, specifies a string of text "
"that appears at the beginning of normal text lines and should be disregarded "
"when filling them. Any line that fails to start with the fill prefix is "
"considered the start of a paragraph; so is any line that starts with the "
"fill prefix followed by additional whitespace. Lines that start with the "
"fill prefix but no additional whitespace are ordinary text lines that can be "
"filled together. The resulting filled lines also start with the fill "
"prefix."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1805
msgid "The fill prefix follows the left margin whitespace, if any."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1807
#, no-wrap
msgid "fill-column"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1812
msgid ""
"This buffer-local variable specifies the maximum width of filled lines. Its "
"value should be an integer, which is a number of columns. All the filling, "
"justification, and centering commands are affected by this variable, "
"including Auto Fill mode (@pxref{Auto Filling})."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1817
msgid ""
"As a practical matter, if you are writing text for other people to read, you "
"should set @code{fill-column} to no more than 70. Otherwise the line will "
"be too long for people to read comfortably, and this can make the text seem "
"clumsy."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1820
msgid ""
"The default value for @code{fill-column} is 70. To disable Auto Fill mode "
"in a specific mode, you could say something like:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1823
#, no-wrap
msgid "(add-hook 'foo-mode-hook (lambda () (auto-fill-mode -1))\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1826
#, no-wrap
msgid "Command set-left-margin from to margin"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1830
msgid ""
"This sets the @code{left-margin} property on the text from @var{from} to "
"@var{to} to the value @var{margin}. If Auto Fill mode is enabled, this "
"command also refills the region to fit the new margin."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1832
#, no-wrap
msgid "Command set-right-margin from to margin"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1836
msgid ""
"This sets the @code{right-margin} property on the text from @var{from} to "
"@var{to} to the value @var{margin}. If Auto Fill mode is enabled, this "
"command also refills the region to fit the new margin."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1838
#, no-wrap
msgid "current-left-margin"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1843
msgid ""
"This function returns the proper left margin value to use for filling the "
"text around point. The value is the sum of the @code{left-margin} property "
"of the character at the start of the current line (or zero if none), and the "
"value of the variable @code{left-margin}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1845
#, no-wrap
msgid "current-fill-column"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1850
msgid ""
"This function returns the proper fill column value to use for filling the "
"text around point. The value is the value of the @code{fill-column} "
"variable, minus the value of the @code{right-margin} property of the "
"character after point."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1852
#, no-wrap
msgid "Command move-to-left-margin &optional n force"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1857
msgid ""
"This function moves point to the left margin of the current line. The "
"column moved to is determined by calling the function "
"@code{current-left-margin}. If the argument @var{n} is non-@code{nil}, "
"@code{move-to-left-margin} moves forward @var{n}@minus{}1 lines first."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1860
msgid ""
"If @var{force} is non-@code{nil}, that says to fix the line's indentation if "
"that doesn't match the left margin value."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1862
#, no-wrap
msgid "delete-to-left-margin &optional from to"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1868
msgid ""
"This function removes left margin indentation from the text between "
"@var{from} and @var{to}. The amount of indentation to delete is determined "
"by calling @code{current-left-margin}. In no case does this function delete "
"non-whitespace. If @var{from} and @var{to} are omitted, they default to the "
"whole buffer."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1870
#, no-wrap
msgid "indent-to-left-margin"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1875
msgid ""
"This function adjusts the indentation at the beginning of the current line "
"to the value specified by the variable @code{left-margin}. (That may "
"involve either inserting or deleting whitespace.) This function is value of "
"@code{indent-line-function} in Paragraph-Indent Text mode."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1877
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3919
#, no-wrap
msgid "left-margin"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1881
msgid ""
"This variable specifies the base left margin column. In Fundamental mode, "
"@key{RET} indents to this column. This variable automatically becomes "
"buffer-local when set in any fashion."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1883
#, no-wrap
msgid "fill-nobreak-predicate"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1890
msgid ""
"This variable gives major modes a way to specify not to break a line at "
"certain places. Its value should be a list of functions. Whenever filling "
"considers breaking the line at a certain place in the buffer, it calls each "
"of these functions with no arguments and with point located at that place. "
"If any of the functions returns non-@code{nil}, then the line won't be "
"broken there."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1893
#, no-wrap
msgid "Adaptive Fill Mode"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1902
msgid ""
"When @dfn{Adaptive Fill Mode} is enabled, Emacs determines the fill prefix "
"automatically from the text in each paragraph being filled rather than using "
"a predetermined value. During filling, this fill prefix gets inserted at "
"the start of the second and subsequent lines of the paragraph as described "
"in @ref{Filling}, and in @ref{Auto Filling}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1903
#, no-wrap
msgid "adaptive-fill-mode"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1906
msgid ""
"Adaptive Fill mode is enabled when this variable is non-@code{nil}. It is "
"@code{t} by default."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1908
#, no-wrap
msgid "fill-context-prefix from to"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1917
msgid ""
"This function implements the heart of Adaptive Fill mode; it chooses a fill "
"prefix based on the text between @var{from} and @var{to}, typically the "
"start and end of a paragraph. It does this by looking at the first two "
"lines of the paragraph, based on the variables described below."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1923
msgid ""
"Usually, this function returns the fill prefix, a string. However, before "
"doing this, the function makes a final check (not specially mentioned in the "
"following) that a line starting with this prefix wouldn't look like the "
"start of a paragraph. Should this happen, the function signals the anomaly "
"by returning @code{nil} instead."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1925
msgid "In detail, @code{fill-context-prefix} does this:"
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1933
msgid ""
"It takes a candidate for the fill prefix from the first line---it tries "
"first the function in @code{adaptive-fill-function} (if any), then the "
"regular expression @code{adaptive-fill-regexp} (see below). The first "
"non-@code{nil} result of these, or the empty string if they're both "
"@code{nil}, becomes the first line's candidate."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1938
msgid ""
"If the paragraph has as yet only one line, the function tests the validity "
"of the prefix candidate just found. The function then returns the candidate "
"if it's valid, or a string of spaces otherwise. (see the description of "
"@code{adaptive-fill-first-line-regexp} below)."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1942
msgid ""
"When the paragraph already has two lines, the function next looks for a "
"prefix candidate on the second line, in just the same way it did for the "
"first line. If it doesn't find one, it returns @code{nil}."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1948
msgid ""
"The function now compares the two candidate prefixes heuristically: if the "
"non-whitespace characters in the line 2 candidate occur in the same order in "
"the line 1 candidate, the function returns the line 2 candidate. Otherwise, "
"it returns the largest initial substring which is common to both candidates "
"(which might be the empty string)."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1951
#, no-wrap
msgid "adaptive-fill-regexp"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1955
msgid ""
"Adaptive Fill mode matches this regular expression against the text starting "
"after the left margin whitespace (if any) on a line; the characters it "
"matches are that line's candidate for the fill prefix."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1958
msgid ""
"The default value matches whitespace with certain punctuation characters "
"intermingled."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1960
#, no-wrap
msgid "adaptive-fill-first-line-regexp"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1967
msgid ""
"Used only in one-line paragraphs, this regular expression acts as an "
"additional check of the validity of the one available candidate fill prefix: "
"the candidate must match this regular expression, or match "
"@code{comment-start-skip}. If it doesn't, @code{fill-context-prefix} "
"replaces the candidate with a string of spaces of the same width as it."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1972
msgid ""
"The default value of this variable is @w{@code{\"\\\\`[ \\t]*\\\\'\"}}, "
"which matches only a string of whitespace. The effect of this default is to "
"force the fill prefixes found in one-line paragraphs always to be pure "
"whitespace."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1974
#, no-wrap
msgid "adaptive-fill-function"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1980
msgid ""
"You can specify more complex ways of choosing a fill prefix automatically by "
"setting this variable to a function. The function is called with point "
"after the left margin (if any) of a line, and it must preserve point. It "
"should return either that line's fill prefix or @code{nil}, meaning it has "
"failed to determine a prefix."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1984
#, no-wrap
msgid "filling, automatic"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1985
#, no-wrap
msgid "Auto Fill mode"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1992
msgid ""
"Auto Fill mode is a minor mode that fills lines automatically as text is "
"inserted. @xref{Auto Fill,,, emacs, The GNU Emacs Manual}. This section "
"describes some variables used by Auto Fill mode. For a description of "
"functions that you can call explicitly to fill and justify existing text, "
"see @ref{Filling}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1995
msgid ""
"Auto Fill mode also enables the functions that change the margins and "
"justification style to refill portions of the text. @xref{Margins}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:1996
#, no-wrap
msgid "auto-fill-function"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2001
msgid ""
"The value of this buffer-local variable should be a function (of no "
"arguments) to be called after self-inserting a character from the table "
"@code{auto-fill-chars}, see below. It may be @code{nil}, in which case "
"nothing special is done in that case."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2005
msgid ""
"The value of @code{auto-fill-function} is @code{do-auto-fill} when Auto Fill "
"mode is enabled. That is a function whose sole purpose is to implement the "
"usual strategy for breaking a line."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2007
#, no-wrap
msgid "normal-auto-fill-function"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2012
msgid ""
"This variable specifies the function to use for @code{auto-fill-function}, "
"if and when Auto Fill is turned on. Major modes can set buffer-local values "
"for this variable to alter how Auto Fill works."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2014
#, no-wrap
msgid "auto-fill-chars"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2018
msgid ""
"A char table of characters which invoke @code{auto-fill-function} when "
"self-inserted---space and newline in most language environments. They have "
"an entry @code{t} in the table."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2020
#, no-wrap
msgid "comment-auto-fill-only-comments"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2025
msgid ""
"This variable, if non-@code{nil}, means to fill lines automatically within "
"comments only. More precisely, this means that if a comment syntax was "
"defined for the current buffer, then self-inserting a character outside of a "
"comment will not call @code{auto-fill-function}."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2029
#, no-wrap
msgid "Sorting Text"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2030
#, no-wrap
msgid "sorting text"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2036
msgid ""
"The sorting functions described in this section all rearrange text in a "
"buffer. This is in contrast to the function @code{sort}, which rearranges "
"the order of the elements of a list (@pxref{Rearrangement}). The values "
"returned by these functions are not meaningful."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2037
#, no-wrap
msgid ""
"sort-subr reverse nextrecfun endrecfun &optional startkeyfun endkeyfun "
"predicate"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2041
msgid ""
"This function is the general text-sorting routine that subdivides a buffer "
"into records and then sorts them. Most of the commands in this section use "
"this function."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2048
msgid ""
"To understand how @code{sort-subr} works, consider the whole accessible "
"portion of the buffer as being divided into disjoint pieces called @dfn{sort "
"records}. The records may or may not be contiguous, but they must not "
"overlap. A portion of each sort record (perhaps all of it) is designated as "
"the sort key. Sorting rearranges the records in order by their sort keys."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2053
msgid ""
"Usually, the records are rearranged in order of ascending sort key. If the "
"first argument to the @code{sort-subr} function, @var{reverse}, is "
"non-@code{nil}, the sort records are rearranged in order of descending sort "
"key."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2057
msgid ""
"The next four arguments to @code{sort-subr} are functions that are called to "
"move point across a sort record. They are called many times from within "
"@code{sort-subr}."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2065
msgid ""
"@var{nextrecfun} is called with point at the end of a record. This function "
"moves point to the start of the next record. The first record is assumed to "
"start at the position of point when @code{sort-subr} is called. Therefore, "
"you should usually move point to the beginning of the buffer before calling "
"@code{sort-subr}."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2068
msgid ""
"This function can indicate there are no more sort records by leaving point "
"at the end of the buffer."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2072
msgid ""
"@var{endrecfun} is called with point within a record. It moves point to the "
"end of the record."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2081
msgid ""
"@var{startkeyfun} is called to move point from the start of a record to the "
"start of the sort key. This argument is optional; if it is omitted, the "
"whole record is the sort key. If supplied, the function should either "
"return a non-@code{nil} value to be used as the sort key, or return "
"@code{nil} to indicate that the sort key is in the buffer starting at "
"point. In the latter case, @var{endkeyfun} is called to find the end of the "
"sort key."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2089
msgid ""
"@var{endkeyfun} is called to move point from the start of the sort key to "
"the end of the sort key. This argument is optional. If @var{startkeyfun} "
"returns @code{nil} and this argument is omitted (or @code{nil}), then the "
"sort key extends to the end of the record. There is no need for "
"@var{endkeyfun} if @var{startkeyfun} returns a non-@code{nil} value."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2101
msgid ""
"The argument @var{predicate} is the function to use to compare keys. It is "
"called with two arguments, the keys to compare, and should return "
"non-@code{nil} if the first key should come before the second in the sorting "
"order. What exactly are the key arguments depends on what @var{startkeyfun} "
"and @var{endkeyfun} return. If @var{predicate} is omitted or @code{nil}, it "
"defaults to @code{<} if the keys are numbers, to "
"@code{compare-buffer-substrings} if the keys are cons cells (whose "
"@code{car} and @code{cdr} are start and end buffer positions of the key), "
"and to @code{string<} otherwise (with keys assumed to be strings)."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2104
msgid ""
"As an example of @code{sort-subr}, here is the complete function definition "
"for @code{sort-lines}:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2113
#, no-wrap
msgid ""
";; @r{Note that the first two lines of doc string}\n"
";; @r{are effectively one line when viewed by a user.}\n"
"(defun sort-lines (reverse beg end)\n"
" \"Sort lines in region alphabetically;\\\n"
" argument means descending order.\n"
"Called from a program, there are three arguments:\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2120
#, no-wrap
msgid ""
"REVERSE (non-nil means reverse order),\\\n"
" BEG and END (region to sort).\n"
"The variable `sort-fold-case' determines\\\n"
" whether alphabetic case affects\n"
"the sort order.\"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2129
#, no-wrap
msgid ""
" (interactive \"P\\nr\")\n"
" (save-excursion\n"
" (save-restriction\n"
" (narrow-to-region beg end)\n"
" (goto-char (point-min))\n"
" (let ((inhibit-field-text-motion t))\n"
" (sort-subr reverse 'forward-line 'end-of-line)))))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2136
msgid ""
"Here @code{forward-line} moves point to the start of the next record, and "
"@code{end-of-line} moves point to the end of record. We do not pass the "
"arguments @var{startkeyfun} and @var{endkeyfun}, because the entire record "
"is used as the sort key."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2139
msgid ""
"The @code{sort-paragraphs} function is very much the same, except that its "
"@code{sort-subr} call looks like this:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2148
#, no-wrap
msgid ""
"(sort-subr reverse\n"
" (lambda ()\n"
" (while (and (not (eobp))\n"
" (looking-at paragraph-separate))\n"
" (forward-line 1)))\n"
" 'forward-paragraph)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2153
msgid ""
"Markers pointing into any sort records are left with no useful position "
"after @code{sort-subr} returns."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2155
#, no-wrap
msgid "sort-fold-case"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2158
msgid ""
"If this variable is non-@code{nil}, @code{sort-subr} and the other buffer "
"sorting functions ignore case when comparing strings."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2160
#, no-wrap
msgid "Command sort-regexp-fields reverse record-regexp key-regexp start end"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2165
msgid ""
"This command sorts the region between @var{start} and @var{end} "
"alphabetically as specified by @var{record-regexp} and @var{key-regexp}. If "
"@var{reverse} is a negative integer, then sorting is in reverse order."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2172
msgid ""
"Alphabetical sorting means that two sort keys are compared by comparing the "
"first characters of each, the second characters of each, and so on. If a "
"mismatch is found, it means that the sort keys are unequal; the sort key "
"whose character is less at the point of first mismatch is the lesser sort "
"key. The individual characters are compared according to their numerical "
"character codes in the Emacs character set."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2180
msgid ""
"The value of the @var{record-regexp} argument specifies how to divide the "
"buffer into sort records. At the end of each record, a search is done for "
"this regular expression, and the text that matches it is taken as the next "
"record. For example, the regular expression @samp{^.+$}, which matches "
"lines with at least one character besides a newline, would make each such "
"line into a sort record. @xref{Regular Expressions}, for a description of "
"the syntax and meaning of regular expressions."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2186
msgid ""
"The value of the @var{key-regexp} argument specifies what part of each "
"record is the sort key. The @var{key-regexp} could match the whole record, "
"or only a part. In the latter case, the rest of the record has no effect on "
"the sorted order of records, but it is carried along when the record moves "
"to its new position."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2190
msgid ""
"The @var{key-regexp} argument can refer to the text matched by a "
"subexpression of @var{record-regexp}, or it can be a regular expression on "
"its own."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2192
msgid "If @var{key-regexp} is:"
msgstr ""
#. type: samp{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2194
#, no-wrap
msgid "\\@var{digit}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2197
msgid ""
"then the text matched by the @var{digit}th @samp{\\(...\\)} parenthesis "
"grouping in @var{record-regexp} is the sort key."
msgstr ""
#. type: samp{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2198
#, no-wrap
msgid "\\&"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2200
msgid "then the whole record is the sort key."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2201
#, no-wrap
msgid "a regular expression"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2207
msgid ""
"then @code{sort-regexp-fields} searches for a match for the regular "
"expression within the record. If such a match is found, it is the sort "
"key. If there is no match for @var{key-regexp} within a record then that "
"record is ignored, which means its position in the buffer is not changed. "
"(The other records may move around it.)"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2213
msgid ""
"For example, if you plan to sort all the lines in the region by the first "
"word on each line starting with the letter @samp{f}, you should set "
"@var{record-regexp} to @samp{^.*$} and set @var{key-regexp} to "
"@samp{\\<f\\w*\\>}. The resulting expression looks like this:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2219
#, no-wrap
msgid ""
"(sort-regexp-fields nil \"^.*$\" \"\\\\<f\\\\w*\\\\>\"\n"
" (region-beginning)\n"
" (region-end))\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2224
msgid ""
"If you call @code{sort-regexp-fields} interactively, it prompts for "
"@var{record-regexp} and @var{key-regexp} in the minibuffer."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2226
#, no-wrap
msgid "Command sort-lines reverse start end"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2230
msgid ""
"This command alphabetically sorts lines in the region between @var{start} "
"and @var{end}. If @var{reverse} is non-@code{nil}, the sort is in reverse "
"order."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2232
#, no-wrap
msgid "Command sort-paragraphs reverse start end"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2236
msgid ""
"This command alphabetically sorts paragraphs in the region between "
"@var{start} and @var{end}. If @var{reverse} is non-@code{nil}, the sort is "
"in reverse order."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2238
#, no-wrap
msgid "Command sort-pages reverse start end"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2242
msgid ""
"This command alphabetically sorts pages in the region between @var{start} "
"and @var{end}. If @var{reverse} is non-@code{nil}, the sort is in reverse "
"order."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2244
#, no-wrap
msgid "Command sort-fields field start end"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2251
msgid ""
"This command sorts lines in the region between @var{start} and @var{end}, "
"comparing them alphabetically by the @var{field}th field of each line. "
"Fields are separated by whitespace and numbered starting from 1. If "
"@var{field} is negative, sorting is by the @w{@minus{}@var{field}th} field "
"from the end of the line. This command is useful for sorting tables."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2253
#, no-wrap
msgid "Command sort-numeric-fields field start end"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2260
msgid ""
"This command sorts lines in the region between @var{start} and @var{end}, "
"comparing them numerically by the @var{field}th field of each line. Fields "
"are separated by whitespace and numbered starting from 1. The specified "
"field must contain a number in each line of the region. Numbers starting "
"with 0 are treated as octal, and numbers starting with @samp{0x} are treated "
"as hexadecimal."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2264
msgid ""
"If @var{field} is negative, sorting is by the @w{@minus{}@var{field}th} "
"field from the end of the line. This command is useful for sorting tables."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2266
#, no-wrap
msgid "sort-numeric-base"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2269
msgid ""
"This variable specifies the default radix for @code{sort-numeric-fields} to "
"parse numbers."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2271
#, no-wrap
msgid "Command sort-columns reverse &optional beg end"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2276
msgid ""
"This command sorts the lines in the region between @var{beg} and @var{end}, "
"comparing them alphabetically by a certain range of columns. The column "
"positions of @var{beg} and @var{end} bound the range of columns to sort on."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2278
msgid "If @var{reverse} is non-@code{nil}, the sort is in reverse order."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2282
msgid ""
"One unusual thing about this command is that the entire line containing "
"position @var{beg}, and the entire line containing position @var{end}, are "
"included in the region sorted."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2286
msgid ""
"Note that @code{sort-columns} rejects text that contains tabs, because tabs "
"could be split across the specified columns. Use @kbd{M-x untabify} to "
"convert tabs to spaces before sorting."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2289
msgid ""
"When possible, this command actually works by calling the @code{sort} "
"utility program."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2292
#, no-wrap
msgid "Counting Columns"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2293
#, no-wrap
msgid "columns"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2294
#, no-wrap
msgid "counting columns"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2295
#, no-wrap
msgid "horizontal position"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2300
msgid ""
"The column functions convert between a character position (counting "
"characters from the beginning of the buffer) and a column position (counting "
"screen characters from the beginning of a line)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2307
msgid ""
"These functions count each character according to the number of columns it "
"occupies on the screen. This means control characters count as occupying 2 "
"or 4 columns, depending upon the value of @code{ctl-arrow}, and tabs count "
"as occupying a number of columns that depends on the value of "
"@code{tab-width} and on the column where the tab begins. @xref{Usual "
"Display}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2312
msgid ""
"Column number computations ignore the width of the window and the amount of "
"horizontal scrolling. Consequently, a column value can be arbitrarily "
"high. The first (or leftmost) column is numbered 0. They also ignore "
"overlays and text properties, aside from invisibility."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2313
#, no-wrap
msgid "current-column"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2318
msgid ""
"This function returns the horizontal position of point, measured in columns, "
"counting from 0 at the left margin. The column position is the sum of the "
"widths of all the displayed representations of the characters between the "
"start of the current line and point."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2320
#, no-wrap
msgid "Command move-to-column column &optional force"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2325
msgid ""
"This function moves point to @var{column} in the current line. The "
"calculation of @var{column} takes into account the widths of the displayed "
"representations of the characters between the start of the line and point."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2328
msgid ""
"When called interactively, @var{column} is the value of prefix numeric "
"argument. If @var{column} is not an integer, an error is signaled."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2345
msgid ""
"If it is impossible to move to column @var{column} because that is in the "
"middle of a multicolumn character such as a tab, point moves to the end of "
"that character. However, if @var{force} is non-@code{nil}, and @var{column} "
"is in the middle of a tab, then @code{move-to-column} either converts the "
"tab into spaces (when @code{indent-tabs-mode} is @code{nil}), or inserts "
"enough spaces before it (otherwise), so that point can move precisely to "
"column @var{column}. Other multicolumn characters can cause anomalies "
"despite @var{force}, since there is no way to split them."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2349
msgid ""
"The argument @var{force} also has an effect if the line isn't long enough to "
"reach column @var{column}; if it is @code{t}, that means to add whitespace "
"at the end of the line to reach that column."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2351
msgid "The return value is the column number actually moved to."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2355
#, no-wrap
msgid "indentation"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2361
msgid ""
"The indentation functions are used to examine, move to, and change "
"whitespace that is at the beginning of a line. Some of the functions can "
"also change whitespace elsewhere on a line. Columns and indentation count "
"from zero at the left margin."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2369
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2371
#, no-wrap
msgid "Primitive Indent"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2369
msgid "Functions used to count and insert indentation."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2369
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2409
#, no-wrap
msgid "Mode-Specific Indent"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2369
msgid "Customize indentation for different modes."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2369
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2557
#, no-wrap
msgid "Region Indent"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2369
msgid "Indent all the lines in a region."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2369
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2624
#, no-wrap
msgid "Relative Indent"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2369
msgid "Indent the current line based on previous lines."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2369
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2704
#, no-wrap
msgid "Indent Tabs"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2369
msgid "Adjustable, typewriter-like tab stops."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2369
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2735
#, no-wrap
msgid "Motion by Indent"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2369
msgid "Move to first non-blank character."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2372
#, no-wrap
msgid "Indentation Primitives"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2377
msgid ""
"This section describes the primitive functions used to count and insert "
"indentation. The functions in the following sections use these primitives. "
"@xref{Size of Displayed Text}, for related functions."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2378
#, no-wrap
msgid "current-indentation"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2385
msgid ""
"This function returns the indentation of the current line, which is the "
"horizontal position of the first nonblank character. If the contents are "
"entirely blank, then this is the horizontal position of the end of the line."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2387
#, no-wrap
msgid "Command indent-to column &optional minimum"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2396
msgid ""
"This function indents from point with tabs and spaces until @var{column} is "
"reached. If @var{minimum} is specified and non-@code{nil}, then at least "
"that many spaces are inserted even if this requires going beyond "
"@var{column}. Otherwise the function does nothing if point is already "
"beyond @var{column}. The value is the column at which the inserted "
"indentation ends."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2400
msgid ""
"The inserted whitespace characters inherit text properties from the "
"surrounding text (usually, from the preceding text only). @xref{Sticky "
"Properties}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2402
#, no-wrap
msgid "indent-tabs-mode"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2407
msgid ""
"If this variable is non-@code{nil}, indentation functions can insert tabs as "
"well as spaces. Otherwise, they insert only spaces. Setting this variable "
"automatically makes it buffer-local in the current buffer."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2410
#, no-wrap
msgid "Indentation Controlled by Major Mode"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2416
msgid ""
"An important function of each major mode is to customize the @key{TAB} key "
"to indent properly for the language being edited. This section describes "
"the mechanism of the @key{TAB} key and how to control it. The functions in "
"this section return unpredictable values."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2417
#, no-wrap
msgid "Command indent-for-tab-command &optional rigid"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2421
msgid ""
"This is the command bound to @key{TAB} in most editing modes. Its usual "
"action is to indent the current line, but it can alternatively insert a tab "
"character or indent a region."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2423
msgid "Here is what it does:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2429
msgid ""
"First, it checks whether Transient Mark mode is enabled and the region is "
"active. If so, it calls @code{indent-region} to indent all the text in the "
"region (@pxref{Region Indent})."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2436
msgid ""
"Otherwise, if the indentation function in @code{indent-line-function} is "
"@code{indent-to-left-margin} (a trivial command that inserts a tab "
"character), or if the variable @code{tab-always-indent} specifies that a tab "
"character ought to be inserted (see below), then it inserts a tab character."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2442
msgid ""
"Otherwise, it indents the current line; this is done by calling the function "
"in @code{indent-line-function}. If the line is already indented, and the "
"value of @code{tab-always-indent} is @code{complete} (see below), it tries "
"completing the text at point."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2450
msgid ""
"If @var{rigid} is non-@code{nil} (interactively, with a prefix argument), "
"then after this command indents a line or inserts a tab, it also rigidly "
"indents the entire balanced expression which starts at the beginning of the "
"current line, in order to reflect the new indentation. This argument is "
"ignored if the command indents the region."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2452
#, no-wrap
msgid "indent-line-function"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2459
msgid ""
"This variable's value is the function to be used by "
"@code{indent-for-tab-command}, and various other indentation commands, to "
"indent the current line. It is usually assigned by the major mode; for "
"instance, Lisp mode sets it to @code{lisp-indent-line}, C mode sets it to "
"@code{c-indent-line}, and so on. The default value is "
"@code{indent-relative}. @xref{Auto-Indentation}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2461
#, no-wrap
msgid "Command indent-according-to-mode"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2464
msgid ""
"This command calls the function in @code{indent-line-function} to indent the "
"current line in a way appropriate for the current major mode."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2466
#, no-wrap
msgid "Command newline-and-indent"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2470
msgid ""
"This function inserts a newline, then indents the new line (the one "
"following the newline just inserted) according to the major mode. It does "
"indentation by calling @code{indent-according-to-mode}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2472
#, no-wrap
msgid "Command reindent-then-newline-and-indent"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2477
msgid ""
"This command reindents the current line, inserts a newline at point, and "
"then indents the new line (the one following the newline just inserted). It "
"does indentation on both lines by calling @code{indent-according-to-mode}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2479
#, no-wrap
msgid "tab-always-indent"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2489
msgid ""
"This variable can be used to customize the behavior of the @key{TAB} "
"(@code{indent-for-tab-command}) command. If the value is @code{t} (the "
"default), the command normally just indents the current line. If the value "
"is @code{nil}, the command indents the current line only if point is at the "
"left margin or in the line's indentation; otherwise, it inserts a tab "
"character. If the value is @code{complete}, the command first tries to "
"indent the current line, and if the line was already indented, it calls "
"@code{completion-at-point} to complete the text at point (@pxref{Completion "
"in Buffers})."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2491
#, no-wrap
msgid "tab-first-completion"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2495
msgid ""
"If @code{tab-always-indent} is @code{complete}, whether to expand or indent "
"can be further customized via the @code{tab-first-completion} variable. The "
"following values can be used:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2496
#, no-wrap
msgid "eol"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2498
msgid "Only complete if point is at the end of a line."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2499
#, no-wrap
msgid "word"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2501
msgid "Complete unless the next character has word syntax."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2502
#, no-wrap
msgid "word-or-paren"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2505
msgid "Complete unless the next character has word syntax or is a parenthesis."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2506
#, no-wrap
msgid "word-or-paren-or-punct"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2509
msgid ""
"Complete unless the next character has word syntax, or is a parenthesis, or "
"is punctuation."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2513
msgid "In any case, typing @kbd{TAB} a second time always results in completion."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2515
#, no-wrap
msgid "literate programming"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2516
#, no-wrap
msgid "multi-mode indentation"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2528
msgid ""
"Some major modes need to support embedded regions of text whose syntax "
"belongs to a different major mode. Examples include @dfn{literate "
"programming} source files that combine documentation and snippets of source "
"code, Yacc/Bison programs that include snippets of Python or JS code, etc. "
"To correctly indent the embedded chunks, the primary mode needs to delegate "
"the indentation to another mode's indentation engine (e.g., call "
"@code{js-indent-line} for JS code or @code{python-indent-line} for Python), "
"while providing it with some context to guide the indentation. Major modes, "
"for their part, should avoid calling @code{widen} in their indentation code "
"and obey @code{prog-first-column}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2529
#, no-wrap
msgid "prog-indentation-context"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2534
msgid ""
"This variable, when non-@code{nil}, holds the indentation context for the "
"sub-mode's indentation engine provided by the superior major mode. The "
"value should be a list of the form @code{(@var{first-column} . @var{rest}}. "
"The members of the list have the following meaning:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2536
#, no-wrap
msgid "first-column"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2540
msgid ""
"The column to be used for top-level constructs. This replaces the default "
"value of the top-level column used by the sub-mode, usually zero."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2540
#, no-wrap
msgid "rest"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2542
msgid "This value is currently unused."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2548
msgid ""
"The following convenience function should be used by major mode's "
"indentation engine in support of invocations as sub-modes of another major "
"mode."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2549
#, no-wrap
msgid "prog-first-column"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2554
msgid ""
"Call this function instead of using a literal value (usually, zero) of the "
"column number for indenting top-level program constructs. The function's "
"value is the column number to use for top-level constructs. When no "
"superior mode is in effect, this function returns zero."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2558
#, no-wrap
msgid "Indenting an Entire Region"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2562
msgid ""
"This section describes commands that indent all the lines in the region. "
"They return unpredictable values."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2563
#, no-wrap
msgid "Command indent-region start end &optional to-column"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2569
msgid ""
"This command indents each nonblank line starting between @var{start} "
"(inclusive) and @var{end} (exclusive). If @var{to-column} is @code{nil}, "
"@code{indent-region} indents each nonblank line by calling the current "
"mode's indentation function, the value of @code{indent-line-function}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2574
msgid ""
"If @var{to-column} is non-@code{nil}, it should be an integer specifying the "
"number of columns of indentation; then this function gives each line exactly "
"that much indentation, by either adding or deleting whitespace."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2577
msgid ""
"If there is a fill prefix, @code{indent-region} indents each line by making "
"it start with the fill prefix."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2579
#, no-wrap
msgid "indent-region-function"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2585
msgid ""
"The value of this variable is a function that can be used by "
"@code{indent-region} as a short cut. It should take two arguments, the "
"start and end of the region. You should design the function so that it will "
"produce the same results as indenting the lines of the region one by one, "
"but presumably faster."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2588
msgid ""
"If the value is @code{nil}, there is no short cut, and @code{indent-region} "
"actually works line by line."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2595
msgid ""
"A short-cut function is useful in modes such as C mode and Lisp mode, where "
"the @code{indent-line-function} must scan from the beginning of the function "
"definition: applying it to each line would be quadratic in time. The short "
"cut can update the scan information as it moves through the lines indenting "
"them; this takes linear time. In a mode where indenting a line individually "
"is fast, there is no need for a short cut."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2598
msgid ""
"@code{indent-region} with a non-@code{nil} argument @var{to-column} has a "
"different meaning and does not use this variable."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2600
#, no-wrap
msgid "Command indent-rigidly start end count"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2605
msgid ""
"This function indents all lines starting between @var{start} (inclusive) and "
"@var{end} (exclusive) sideways by @var{count} columns. This preserves the "
"shape of the affected region, moving it as a rigid unit."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2610
msgid ""
"This is useful not only for indenting regions of unindented text, but also "
"for indenting regions of formatted code. For example, if @var{count} is 3, "
"this command adds 3 columns of indentation to every line that begins in the "
"specified region."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2614
msgid ""
"If called interactively with no prefix argument, this command invokes a "
"transient mode for adjusting indentation rigidly. @xref{Indentation "
"Commands,,, emacs, The GNU Emacs Manual}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2616
#, no-wrap
msgid "Command indent-code-rigidly start end columns &optional nochange-regexp"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2619
msgid ""
"This is like @code{indent-rigidly}, except that it doesn't alter lines that "
"start within strings or comments."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2622
msgid ""
"In addition, it doesn't alter a line if @var{nochange-regexp} matches at the "
"beginning of the line (if @var{nochange-regexp} is non-@code{nil})."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2625
#, no-wrap
msgid "Indentation Relative to Previous Lines"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2629
msgid ""
"This section describes two commands that indent the current line based on "
"the contents of previous lines."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2630
#, no-wrap
msgid "Command indent-relative &optional first-only unindented-ok"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2638
msgid ""
"This command inserts whitespace at point, extending to the same column as "
"the next @dfn{indent point} of the previous nonblank line. An indent point "
"is a non-whitespace character following whitespace. The next indent point "
"is the first one at a column greater than the current column of point. For "
"example, if point is underneath and to the left of the first non-blank "
"character of a line of text, it moves to that column by inserting "
"whitespace."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2645
msgid ""
"If the previous nonblank line has no next indent point (i.e., none at a "
"great enough column position), @code{indent-relative} either does nothing "
"(if @var{unindented-ok} is non-@code{nil}) or calls @code{tab-to-tab-stop}. "
"Thus, if point is underneath and to the right of the last column of a short "
"line of text, this command ordinarily moves point to the next tab stop by "
"inserting whitespace."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2648
msgid ""
"If @var{first-only} is non-@code{nil}, only the first indent point is "
"considered."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2650
msgid "The return value of @code{indent-relative} is unpredictable."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2653
msgid "In the following example, point is at the beginning of the second line:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2658
#, no-wrap
msgid ""
" This line is indented twelve spaces.\n"
"@point{}The quick brown fox jumped.\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2664
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2685
msgid ""
"Evaluation of the expression @code{(indent-relative nil)} produces the "
"following:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2669
#, no-wrap
msgid ""
" This line is indented twelve spaces.\n"
" @point{}The quick brown fox jumped.\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2674
msgid ""
"In this next example, point is between the @samp{m} and @samp{p} of "
"@samp{jumped}:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2679
#, no-wrap
msgid ""
" This line is indented twelve spaces.\n"
"The quick brown fox jum@point{}ped.\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2690
#, no-wrap
msgid ""
" This line is indented twelve spaces.\n"
"The quick brown fox jum @point{}ped.\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2694
#, no-wrap
msgid "Command indent-relative-first-indent-point"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2699
msgid ""
"This command indents the current line like the previous nonblank line, by "
"calling @code{indent-relative} with @code{t} as the @var{first-only} "
"argument. The return value is unpredictable."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2702
msgid ""
"If the previous nonblank line has no indent points beyond the current "
"column, this command does nothing."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2705
#, no-wrap
msgid "Adjustable Tab Stops"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2706
#, no-wrap
msgid "tabs stops for indentation"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2717
msgid ""
"This section explains the mechanism for user-specified tab stops and the "
"mechanisms that use and set them. The name ``tab stops'' is used because "
"the feature is similar to that of the tab stops on a typewriter. The "
"feature works by inserting an appropriate number of spaces and tab "
"characters to reach the next tab stop column; it does not affect the display "
"of tab characters in the buffer (@pxref{Usual Display}). Note that the "
"@key{TAB} character as input uses this tab stop feature only in a few major "
"modes, such as Text mode. @xref{Tab Stops,,, emacs, The GNU Emacs Manual}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2718
#, no-wrap
msgid "Command tab-to-tab-stop"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2721
msgid ""
"This command inserts spaces or tabs before point, up to the next tab stop "
"column defined by @code{tab-stop-list}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2723
#, no-wrap
msgid "tab-stop-list"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2731
msgid ""
"This variable defines the tab stop columns used by @code{tab-to-tab-stop}. "
"It should be either @code{nil}, or a list of increasing integers, which need "
"not be evenly spaced. The list is implicitly extended to infinity through "
"repetition of the interval between the last and penultimate elements (or "
"@code{tab-width} if the list has fewer than two elements). A value of "
"@code{nil} means a tab stop every @code{tab-width} columns."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2733
msgid ""
"Use @kbd{M-x edit-tab-stops} to edit the location of tab stops "
"interactively."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2736
#, no-wrap
msgid "Indentation-Based Motion Commands"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2740
msgid ""
"These commands, primarily for interactive use, act based on the indentation "
"in the text."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2741
#, no-wrap
msgid "Command back-to-indentation"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2746
msgid ""
"This command moves point to the first non-whitespace character in the "
"current line (which is the line in which point is located). It returns "
"@code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2748
#, no-wrap
msgid "Command backward-to-indentation &optional arg"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2753
msgid ""
"This command moves point backward @var{arg} lines and then to the first "
"nonblank character on that line. It returns @code{nil}. If @var{arg} is "
"omitted or @code{nil}, it defaults to 1."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2755
#, no-wrap
msgid "Command forward-to-indentation &optional arg"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2760
msgid ""
"This command moves point forward @var{arg} lines and then to the first "
"nonblank character on that line. It returns @code{nil}. If @var{arg} is "
"omitted or @code{nil}, it defaults to 1."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2764
#, no-wrap
msgid "case conversion in buffers"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2770
msgid ""
"The case change commands described here work on text in the current buffer. "
"@xref{Case Conversion}, for case conversion functions that work on strings "
"and characters. @xref{Case Tables}, for how to customize which characters "
"are upper or lower case and how to convert them."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2771
#, no-wrap
msgid "Command capitalize-region start end"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2776
msgid ""
"This function capitalizes all words in the region defined by @var{start} and "
"@var{end}. To capitalize means to convert each word's first character to "
"upper case and convert the rest of each word to lower case. The function "
"returns @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2779
msgid ""
"If one end of the region is in the middle of a word, the part of the word "
"within the region is treated as an entire word."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2782
msgid ""
"When @code{capitalize-region} is called interactively, @var{start} and "
"@var{end} are point and the mark, with the smallest first."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2788
#, no-wrap
msgid ""
"---------- Buffer: foo ----------\n"
"This is the contents of the 5th foo.\n"
"---------- Buffer: foo ----------\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2793
#, no-wrap
msgid ""
"(capitalize-region 1 37)\n"
"@result{} nil\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2797
#, no-wrap
msgid ""
"---------- Buffer: foo ----------\n"
"This Is The Contents Of The 5th Foo.\n"
"---------- Buffer: foo ----------\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2801
#, no-wrap
msgid "Command downcase-region start end"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2805
msgid ""
"This function converts all of the letters in the region defined by "
"@var{start} and @var{end} to lower case. The function returns @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2808
msgid ""
"When @code{downcase-region} is called interactively, @var{start} and "
"@var{end} are point and the mark, with the smallest first."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2810
#, no-wrap
msgid "Command upcase-region start end"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2814
msgid ""
"This function converts all of the letters in the region defined by "
"@var{start} and @var{end} to upper case. The function returns @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2817
msgid ""
"When @code{upcase-region} is called interactively, @var{start} and @var{end} "
"are point and the mark, with the smallest first."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2819
#, no-wrap
msgid "Command capitalize-word count"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2826
msgid ""
"This function capitalizes @var{count} words after point, moving point over "
"as it does. To capitalize means to convert each word's first character to "
"upper case and convert the rest of each word to lower case. If @var{count} "
"is negative, the function capitalizes the @minus{}@var{count} previous words "
"but does not move point. The value is @code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2829
msgid ""
"If point is in the middle of a word, the part of the word before point is "
"ignored when moving forward. The rest is treated as an entire word."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2832
msgid ""
"When @code{capitalize-word} is called interactively, @var{count} is set to "
"the numeric prefix argument."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2834
#, no-wrap
msgid "Command downcase-word count"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2839
msgid ""
"This function converts the @var{count} words after point to all lower case, "
"moving point over as it does. If @var{count} is negative, it converts the "
"@minus{}@var{count} previous words but does not move point. The value is "
"@code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2842
msgid ""
"When @code{downcase-word} is called interactively, @var{count} is set to the "
"numeric prefix argument."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2844
#, no-wrap
msgid "Command upcase-word count"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2849
msgid ""
"This function converts the @var{count} words after point to all upper case, "
"moving point over as it does. If @var{count} is negative, it converts the "
"@minus{}@var{count} previous words but does not move point. The value is "
"@code{nil}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2852
msgid ""
"When @code{upcase-word} is called interactively, @var{count} is set to the "
"numeric prefix argument."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2856
#, no-wrap
msgid "text properties"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2857
#, no-wrap
msgid "attributes of text"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2858
#, no-wrap
msgid "properties of text"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2867
msgid ""
"Each character position in a buffer or a string can have a @dfn{text "
"property list}, much like the property list of a symbol (@pxref{Property "
"Lists}). The properties belong to a particular character at a particular "
"place, such as, the letter @samp{T} at the beginning of this sentence or the "
"first @samp{o} in @samp{foo}---if the same character occurs in two different "
"places, the two occurrences in general have different properties."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2874
msgid ""
"Each property has a name and a value. Both of these can be any Lisp object, "
"but the name is normally a symbol. Typically each property name symbol is "
"used for a particular purpose; for instance, the text property @code{face} "
"specifies the faces for displaying the character (@pxref{Special "
"Properties}). The usual way to access the property list is to specify a "
"name and ask what value corresponds to it."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2879
msgid ""
"If a character has a @code{category} property, we call it the @dfn{property "
"category} of the character. It should be a symbol. The properties of the "
"symbol serve as defaults for the properties of the character."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2883
msgid ""
"Copying text between strings and buffers preserves the properties along with "
"the characters; this includes such diverse functions as @code{substring}, "
"@code{insert}, and @code{buffer-substring}."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2902
#, no-wrap
msgid "Examining Properties"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
msgid "Looking at the properties of one character."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3011
#, no-wrap
msgid "Changing Properties"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
msgid "Setting the properties of a range of text."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3182
#, no-wrap
msgid "Property Search"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
msgid "Searching for where a property changes value."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3413
#, no-wrap
msgid "Special Properties"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
msgid "Particular properties with special meanings."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3900
#, no-wrap
msgid "Format Properties"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
msgid "Properties for representing formatting of text."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3928
#, no-wrap
msgid "Sticky Properties"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
msgid "How inserted text gets properties from neighboring text."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4015
#, no-wrap
msgid "Lazy Properties"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
msgid "Computing text properties in a lazy fashion only when text is examined."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4060
#, no-wrap
msgid "Clickable Text"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
msgid ""
"Using text properties to make regions of text do something when you click on "
"them."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4257
#, no-wrap
msgid "Fields"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
msgid "The @code{field} property defines fields within the buffer."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4374
#, no-wrap
msgid "Not Intervals"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2900
msgid "Why text properties do not use Lisp-visible text intervals."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2903
#, no-wrap
msgid "Examining Text Properties"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2904
#, no-wrap
msgid "examining text properties"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2905
#, no-wrap
msgid "text properties, examining"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2912
msgid ""
"The simplest way to examine text properties is to ask for the value of a "
"particular property of a particular character. For that, use "
"@code{get-text-property}. Use @code{text-properties-at} to get the entire "
"property list of a character. @xref{Property Search}, for functions to "
"examine the properties of a number of characters at once."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2916
msgid ""
"These functions handle both strings and buffers. Keep in mind that "
"positions in a string start from 0, whereas positions in a buffer start from "
"1. Passing a buffer other than the current buffer may be slow."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2917
#, no-wrap
msgid "get-text-property pos prop &optional object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2922
msgid ""
"This function returns the value of the @var{prop} property of the character "
"after position @var{pos} in @var{object} (a buffer or string). The argument "
"@var{object} is optional and defaults to the current buffer."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2926
msgid ""
"If there is no @var{prop} property strictly speaking, but the character has "
"a property category that is a symbol, then @code{get-text-property} returns "
"the @var{prop} property of that symbol."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2928
#, no-wrap
msgid "get-char-property position prop &optional object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2931
msgid ""
"This function is like @code{get-text-property}, except that it checks "
"overlays first and then text properties. @xref{Overlays}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2939
msgid ""
"The argument @var{object} may be a string, a buffer, or a window. If it is "
"a window, then the buffer displayed in that window is used for text "
"properties and overlays, but only the overlays active for that window are "
"considered. If @var{object} is a buffer, then overlays in that buffer are "
"considered first, in order of decreasing priority, followed by the text "
"properties. If @var{object} is a string, only text properties are "
"considered, since strings never have overlays."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2941
#, no-wrap
msgid "get-pos-property position prop &optional object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2946
msgid ""
"This function is like @code{get-char-property}, except that it pays "
"attention to properties' stickiness and overlays' advancement settings "
"instead of the property of the character at (i.e., right after) "
"@var{position}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2948
#, no-wrap
msgid "get-char-property-and-overlay position prop &optional object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2951
msgid ""
"This is like @code{get-char-property}, but gives extra information about the "
"overlay that the property value comes from."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2957
msgid ""
"Its value is a cons cell whose @sc{car} is the property value, the same "
"value @code{get-char-property} would return with the same arguments. Its "
"@sc{cdr} is the overlay in which the property was found, or @code{nil}, if "
"it was found as a text property or not found at all."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2960
msgid ""
"If @var{position} is at the end of @var{object}, both the @sc{car} and the "
"@sc{cdr} of the value are @code{nil}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2962
#, no-wrap
msgid "char-property-alias-alist"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2969
msgid ""
"This variable holds an alist which maps property names to a list of "
"alternative property names. If a character does not specify a direct value "
"for a property, the alternative property names are consulted in order; the "
"first non-@code{nil} value is used. This variable takes precedence over "
"@code{default-text-properties}, and @code{category} properties take "
"precedence over this variable."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2971
#, no-wrap
msgid "text-properties-at position &optional object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2975
msgid ""
"This function returns the entire property list of the character at "
"@var{position} in the string or buffer @var{object}. If @var{object} is "
"@code{nil}, it defaults to the current buffer."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2977
#, no-wrap
msgid "default-text-properties"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2983
msgid ""
"This variable holds a property list giving default values for text "
"properties. Whenever a character does not specify a value for a property, "
"neither directly, through a category symbol, or through "
"@code{char-property-alias-alist}, the value stored in this list is used "
"instead. Here is an example:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2992
#, no-wrap
msgid ""
"(setq default-text-properties '(foo 69)\n"
" char-property-alias-alist nil)\n"
";; @r{Make sure character 1 has no properties of its own.}\n"
"(set-text-properties 1 2 nil)\n"
";; @r{What we get, when we ask, is the default value.}\n"
"(get-text-property 1 'foo)\n"
" @result{} 69\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:2995
#, no-wrap
msgid "object-intervals OBJECT"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3000
msgid ""
"This function returns a copy of the intervals (i.e., text properties) in "
"@var{object} as a list of intervals. @var{object} must be a string or a "
"buffer. Altering the structure of this list does not change the intervals "
"in the object."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3004
#, no-wrap
msgid ""
"(object-intervals (propertize \"foo\" 'face 'bold))\n"
" @result{} ((0 3 (face bold)))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3009
msgid ""
"Each element in the returned list represents one interval. Each interval "
"has three parts: The first is the start, the second is the end, and the "
"third part is the text property itself."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3012
#, no-wrap
msgid "Changing Text Properties"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3013
#, no-wrap
msgid "changing text properties"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3014
#, no-wrap
msgid "text properties, changing"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3021
msgid ""
"The primitives for changing properties apply to a specified range of text in "
"a buffer or string. The function @code{set-text-properties} (see end of "
"section) sets the entire property list of the text in that range; more "
"often, it is useful to add, change, or delete just certain properties "
"specified by name."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3028
msgid ""
"Since text properties are considered part of the contents of the buffer (or "
"string), and can affect how a buffer looks on the screen, any change in "
"buffer text properties marks the buffer as modified. Buffer text property "
"changes are undoable also (@pxref{Undo}). Positions in a string start from "
"0, whereas positions in a buffer start from 1."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3029
#, no-wrap
msgid "put-text-property start end prop value &optional object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3033
msgid ""
"This function sets the @var{prop} property to @var{value} for the text "
"between @var{start} and @var{end} in the string or buffer @var{object}. If "
"@var{object} is @code{nil}, it defaults to the current buffer."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3035
#, no-wrap
msgid "add-text-properties start end props &optional object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3039
msgid ""
"This function adds or overrides text properties for the text between "
"@var{start} and @var{end} in the string or buffer @var{object}. If "
"@var{object} is @code{nil}, it defaults to the current buffer."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3044
msgid ""
"The argument @var{props} specifies which properties to add. It should have "
"the form of a property list (@pxref{Property Lists}): a list whose elements "
"include the property names followed alternately by the corresponding values."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3048
msgid ""
"The return value is @code{t} if the function actually changed some "
"property's value; @code{nil} otherwise (if @var{props} is @code{nil} or its "
"values agree with those in the text)."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3051
msgid ""
"For example, here is how to set the @code{comment} and @code{face} "
"properties of a range of text:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3055
#, no-wrap
msgid ""
"(add-text-properties @var{start} @var{end}\n"
" '(comment t face highlight))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3058
#, no-wrap
msgid "remove-text-properties start end props &optional object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3062
msgid ""
"This function deletes specified text properties from the text between "
"@var{start} and @var{end} in the string or buffer @var{object}. If "
"@var{object} is @code{nil}, it defaults to the current buffer."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3068
msgid ""
"The argument @var{props} specifies which properties to delete. It should "
"have the form of a property list (@pxref{Property Lists}): a list whose "
"elements are property names alternating with corresponding values. But only "
"the names matter---the values that accompany them are ignored. For example, "
"here's how to remove the @code{face} property."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3071
#, no-wrap
msgid "(remove-text-properties @var{start} @var{end} '(face nil))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3076
msgid ""
"The return value is @code{t} if the function actually changed some "
"property's value; @code{nil} otherwise (if @var{props} is @code{nil} or if "
"no character in the specified text had any of those properties)."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3080
msgid ""
"To remove all text properties from certain text, use "
"@code{set-text-properties} and specify @code{nil} for the new property list."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3082
#, no-wrap
msgid "remove-list-of-text-properties start end list-of-properties &optional object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3086
msgid ""
"Like @code{remove-text-properties} except that @var{list-of-properties} is a "
"list of property names only, not an alternating list of property names and "
"values."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3088
#, no-wrap
msgid "set-text-properties start end props &optional object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3092
msgid ""
"This function completely replaces the text property list for the text "
"between @var{start} and @var{end} in the string or buffer @var{object}. If "
"@var{object} is @code{nil}, it defaults to the current buffer."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3095
msgid ""
"The argument @var{props} is the new property list. It should be a list "
"whose elements are property names alternating with corresponding values."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3098
msgid ""
"After @code{set-text-properties} returns, all the characters in the "
"specified range have identical properties."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3101
msgid ""
"If @var{props} is @code{nil}, the effect is to get rid of all properties "
"from the specified range of text. Here's an example:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3104
#, no-wrap
msgid "(set-text-properties @var{start} @var{end} nil)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3107
msgid "Do not rely on the return value of this function."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3109
#, no-wrap
msgid "add-face-text-property start end face &optional appendp object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3115
msgid ""
"This function acts on the text between @var{start} and @var{end}, adding the "
"face @var{face} to the @code{face} text property. @var{face} should be a "
"valid value for the @code{face} property (@pxref{Special Properties}), such "
"as a face name or an anonymous face (@pxref{Faces})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3123
msgid ""
"If any text in the region already has a non-@code{nil} @code{face} property, "
"those face(s) are retained. This function sets the @code{face} property to "
"a list of faces, with @var{face} as the first element (by default) and the "
"pre-existing faces as the remaining elements. If the optional argument "
"@var{appendp} is non-@code{nil}, @var{face} is appended to the end of the "
"list instead. Note that in a face list, the first occurring value for each "
"attribute takes precedence."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3126
msgid ""
"For example, the following code would assign an italicized green face to the "
"text between @var{start} and @var{end}:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3131
#, no-wrap
msgid ""
"(add-face-text-property @var{start} @var{end} 'italic)\n"
"(add-face-text-property @var{start} @var{end} '(:foreground \"red\"))\n"
"(add-face-text-property @var{start} @var{end} '(:foreground \"green\"))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3137
msgid ""
"The optional argument @var{object}, if non-@code{nil}, specifies a buffer or "
"string to act on, rather than the current buffer. If @var{object} is a "
"string, then @var{start} and @var{end} are zero-based indices into the "
"string."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3141
msgid ""
"The easiest way to make a string with text properties is with "
"@code{propertize}:"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3142
#, no-wrap
msgid "propertize string &rest properties"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3147
msgid ""
"This function returns a copy of @var{string} with the text properties "
"@var{properties} added. These properties apply to all the characters in the "
"string that is returned. Here is an example that constructs a string with a "
"@code{face} property and a @code{mouse-face} property:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3152
#, no-wrap
msgid ""
"(propertize \"foo\" 'face 'italic\n"
" 'mouse-face 'bold-italic)\n"
" @result{} #(\"foo\" 0 3 (mouse-face bold-italic face italic))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3157
msgid ""
"To put different properties on various parts of a string, you can construct "
"each part with @code{propertize} and then combine them with @code{concat}:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3169
#, no-wrap
msgid ""
"(concat\n"
" (propertize \"foo\" 'face 'italic\n"
" 'mouse-face 'bold-italic)\n"
" \" and \"\n"
" (propertize \"bar\" 'face 'italic\n"
" 'mouse-face 'bold-italic))\n"
" @result{} #(\"foo and bar\"\n"
" 0 3 (face italic mouse-face bold-italic)\n"
" 3 8 nil\n"
" 8 11 (face italic mouse-face bold-italic))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3175
msgid ""
"@xref{Buffer Contents}, for the function "
"@code{buffer-substring-no-properties}, which copies text from the buffer but "
"does not copy its properties."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3176
#, no-wrap
msgid "with-silent-modifications, and changes in text properties"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3181
msgid ""
"If you wish to add text properties to a buffer or remove them without "
"marking the buffer as modified, you can wrap the calls above in the "
"@code{with-silent-modifications} macro. @xref{Buffer Modification}."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3183
#, no-wrap
msgid "Text Property Search Functions"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3184
#, no-wrap
msgid "searching text properties"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3185
#, no-wrap
msgid "text properties, searching"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3191
msgid ""
"In typical use of text properties, most of the time several or many "
"consecutive characters have the same value for a property. Rather than "
"writing your programs to examine characters one by one, it is much faster to "
"process chunks of text that have the same property value."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3195
msgid ""
"Here are functions you can use to do this. They use @code{eq} for comparing "
"property values. In all cases, @var{object} defaults to the current buffer."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3200
msgid ""
"For good performance, it's very important to use the @var{limit} argument to "
"these functions, especially the ones that search for a single "
"property---otherwise, they may spend a long time scanning to the end of the "
"buffer, if the property you are interested in does not change."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3205
msgid ""
"These functions do not move point; instead, they return a position (or "
"@code{nil}). Remember that a position is always between two characters; the "
"position returned by these functions is between two characters with "
"different properties."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3206
#, no-wrap
msgid "next-property-change pos &optional object limit"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3213
msgid ""
"The function scans the text forward from position @var{pos} in the string or "
"buffer @var{object} until it finds a change in some text property, then "
"returns the position of the change. In other words, it returns the position "
"of the first character beyond @var{pos} whose properties are not identical "
"to those of the character just after @var{pos}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3217
msgid ""
"If @var{limit} is non-@code{nil}, then the scan ends at position "
"@var{limit}. If there is no property change before that point, this "
"function returns @var{limit}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3222
msgid ""
"The value is @code{nil} if the properties remain unchanged all the way to "
"the end of @var{object} and @var{limit} is @code{nil}. If the value is "
"non-@code{nil}, it is a position greater than or equal to @var{pos}. The "
"value equals @var{pos} only when @var{limit} equals @var{pos}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3225
msgid ""
"Here is an example of how to scan the buffer by chunks of text within which "
"all properties are constant:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3234
#, no-wrap
msgid ""
"(while (not (eobp))\n"
" (let ((plist (text-properties-at (point)))\n"
" (next-change\n"
" (or (next-property-change (point) (current-buffer))\n"
" (point-max))))\n"
" @r{Process text from point to @var{next-change}@dots{}}\n"
" (goto-char next-change)))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3237
#, no-wrap
msgid "previous-property-change pos &optional object limit"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3242
msgid ""
"This is like @code{next-property-change}, but scans back from @var{pos} "
"instead of forward. If the value is non-@code{nil}, it is a position less "
"than or equal to @var{pos}; it equals @var{pos} only if @var{limit} equals "
"@var{pos}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3244
#, no-wrap
msgid "next-single-property-change pos prop &optional object limit"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3251
msgid ""
"The function scans text for a change in the @var{prop} property, then "
"returns the position of the change. The scan goes forward from position "
"@var{pos} in the string or buffer @var{object}. In other words, this "
"function returns the position of the first character beyond @var{pos} whose "
"@var{prop} property differs from that of the character just after @var{pos}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3255
msgid ""
"If @var{limit} is non-@code{nil}, then the scan ends at position "
"@var{limit}. If there is no property change before that point, "
"@code{next-single-property-change} returns @var{limit}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3260
msgid ""
"The value is @code{nil} if the property remains unchanged all the way to the "
"end of @var{object} and @var{limit} is @code{nil}. If the value is "
"non-@code{nil}, it is a position greater than or equal to @var{pos}; it "
"equals @var{pos} only if @var{limit} equals @var{pos}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3262
#, no-wrap
msgid "previous-single-property-change pos prop &optional object limit"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3267
msgid ""
"This is like @code{next-single-property-change}, but scans back from "
"@var{pos} instead of forward. If the value is non-@code{nil}, it is a "
"position less than or equal to @var{pos}; it equals @var{pos} only if "
"@var{limit} equals @var{pos}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3269
#, no-wrap
msgid "next-char-property-change pos &optional limit"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3278
msgid ""
"This is like @code{next-property-change} except that it considers overlay "
"properties as well as text properties, and if no change is found before the "
"end of the buffer, it returns the maximum buffer position rather than "
"@code{nil} (in this sense, it resembles the corresponding overlay function "
"@code{next-overlay-change}, rather than @code{next-property-change}). There "
"is no @var{object} operand because this function operates only on the "
"current buffer. It returns the next address at which either kind of "
"property changes."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3280
#, no-wrap
msgid "previous-char-property-change pos &optional limit"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3284
msgid ""
"This is like @code{next-char-property-change}, but scans back from @var{pos} "
"instead of forward, and returns the minimum buffer position if no change is "
"found."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3286
#, no-wrap
msgid "next-single-char-property-change pos prop &optional object limit"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3294
msgid ""
"This is like @code{next-single-property-change} except that it considers "
"overlay properties as well as text properties, and if no change is found "
"before the end of the @var{object}, it returns the maximum valid position in "
"@var{object} rather than @code{nil}. Unlike "
"@code{next-char-property-change}, this function @emph{does} have an "
"@var{object} operand; if @var{object} is not a buffer, only text-properties "
"are considered."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3296
#, no-wrap
msgid "previous-single-char-property-change pos prop &optional object limit"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3300
msgid ""
"This is like @code{next-single-char-property-change}, but scans back from "
"@var{pos} instead of forward, and returns the minimum valid position in "
"@var{object} if no change is found."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3302
#, no-wrap
msgid "text-property-any start end prop value &optional object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3307
msgid ""
"This function returns non-@code{nil} if at least one character between "
"@var{start} and @var{end} has a property @var{prop} whose value is "
"@var{value}. More precisely, it returns the position of the first such "
"character. Otherwise, it returns @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3311
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3322
msgid ""
"The optional fifth argument, @var{object}, specifies the string or buffer to "
"scan. Positions are relative to @var{object}. The default for @var{object} "
"is the current buffer."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3313
#, no-wrap
msgid "text-property-not-all start end prop value &optional object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3318
msgid ""
"This function returns non-@code{nil} if at least one character between "
"@var{start} and @var{end} does not have a property @var{prop} with value "
"@var{value}. More precisely, it returns the position of the first such "
"character. Otherwise, it returns @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3324
#, no-wrap
msgid "text-property-search-forward prop &optional value predicate not-current"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3327
msgid ""
"Search for the next region that has text property @var{prop} set to "
"@var{value} according to @var{predicate}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3331
msgid ""
"This function is modelled after @code{search-forward} and friends in that it "
"moves point, but it returns a structure that describes the match instead of "
"returning it in @code{match-beginning} and friends."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3335
msgid ""
"If the text property can't be found, the function returns @code{nil}. If "
"it's found, point is placed at the end of the region that has this text "
"property match, and a @code{prop-match} structure is returned."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3340
msgid ""
"@var{predicate} can either be @code{t} (which is a synonym for "
"@code{equal}), @code{nil} (which means ``not equal''), or a predicate that "
"will be called with two parameters: The first is @var{value}, and the second "
"is the value of the text property we're inspecting."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3343
msgid ""
"If @var{not-current}, if point is in a region where we have a match, then "
"skip past that and find the next instance instead."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3349
msgid ""
"The @code{prop-match} structure has the following accessors: "
"@code{prop-match-beginning} (the start of the match), @code{prop-match-end} "
"(the end of the match), and @code{prop-match-value} (the value of "
"@var{property} at the start of the match)."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3352
msgid "In the examples below, imagine that you're in a buffer that looks like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3355
#, no-wrap
msgid "This is a bold and here's bolditalic and this is the end.\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3359
msgid ""
"That is, the ``bold'' words are the @code{bold} face, and the ``italic'' "
"word is in the @code{italic} face."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3361
msgid "With point at the start:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3367
#, no-wrap
msgid ""
"(while (setq match (text-property-search-forward 'face 'bold t))\n"
" (push (buffer-substring (prop-match-beginning match)\n"
" (prop-match-end match))\n"
" words))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3370
msgid "This will pick out all the words that use the @code{bold} face."
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3376
#, no-wrap
msgid ""
"(while (setq match (text-property-search-forward 'face nil t))\n"
" (push (buffer-substring (prop-match-beginning match)\n"
" (prop-match-end match))\n"
" words))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3381
msgid ""
"This will pick out all the bits that have no face properties, which will "
"result in the list @samp{(\"This is a \" \"and here's \" \"and this is the "
"end\")} (only reversed, since we used @code{push})."
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3387
#, no-wrap
msgid ""
"(while (setq match (text-property-search-forward 'face nil nil))\n"
" (push (buffer-substring (prop-match-beginning match)\n"
" (prop-match-end match))\n"
" words))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3392
msgid ""
"This will pick out all the regions where @code{face} is set to something, "
"but this is split up into where the properties change, so the result here "
"will be @samp{(\"bold\" \"bold\" \"italic\")}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3396
msgid ""
"For a more realistic example where you might use this, consider that you "
"have a buffer where certain sections represent URLs, and these are tagged "
"with @code{shr-url}."
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3400
#, no-wrap
msgid ""
"(while (setq match (text-property-search-forward 'shr-url nil nil))\n"
" (push (prop-match-value match) urls))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3403
msgid "This will give you a list of all those URLs."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3406
#, no-wrap
msgid "text-property-search-backward prop &optional value predicate not-current"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3410
msgid ""
"This is just like @code{text-property-search-backward}, but searches "
"backward instead. Point is placed at the beginning of the matched region "
"instead of the end, though."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3414
#, no-wrap
msgid "Properties with Special Meanings"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3420
msgid ""
"Here is a table of text property names that have special built-in meanings. "
"The following sections list a few additional special property names that "
"control filling and property inheritance. All other names have no standard "
"meaning, and you can use them as you like."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3425
msgid ""
"Note: the properties @code{composition}, @code{display}, @code{invisible} "
"and @code{intangible} can also cause point to move to an acceptable place, "
"after each Emacs command. @xref{Adjusting Point}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3427
#, no-wrap
msgid "property category of text character"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3429
#, no-wrap
msgid "category @r{(text property)}"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3430
#, no-wrap
msgid "category"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3435
msgid ""
"If a character has a @code{category} property, we call it the @dfn{property "
"category} of the character. It should be a symbol. The properties of this "
"symbol serve as defaults for the properties of the character."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3436
#, no-wrap
msgid "face"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3437
#, no-wrap
msgid "face codes of text"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3438
#, no-wrap
msgid "face @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3441
msgid ""
"The @code{face} property controls the appearance of the character "
"(@pxref{Faces}). The value of the property can be the following:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3445
msgid "A face name (a symbol or string)."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3450
msgid ""
"An anonymous face: a property list of the form @code{(@var{keyword} "
"@var{value} @dots{})}, where each @var{keyword} is a face attribute name and "
"@var{value} is a value for that attribute."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3456
msgid ""
"A list of faces. Each list element should be either a face name or an "
"anonymous face. This specifies a face which is an aggregate of the "
"attributes of each of the listed faces. Faces occurring earlier in the list "
"have higher priority."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3464
msgid ""
"A cons cell of the form @code{(foreground-color . @var{color-name})} or "
"@code{(background-color . @var{color-name})}. This specifies the foreground "
"or background color, similar to @code{(:foreground @var{color-name})} or "
"@code{(:background @var{color-name})}. This form is supported for backward "
"compatibility only, and should be avoided."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3475
msgid ""
"A cons cell of the form @w{@code{(:filtered @var{filter} @var{face-spec})}}, "
"that specifies the face given by @var{face-spec}, but only if @var{filter} "
"matches when the face is used for display. The @var{face-spec} can use any "
"of the forms mentioned above. The @var{filter} should be of the form "
"@w{@code{(:window @var{param} @var{value})}}, which matches for windows "
"whose parameter @var{param} is @code{eq} to @var{value}. If the variable "
"@code{face-filters-always-match} is non-@code{nil}, all face filters are "
"deemed to have matched."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3480
msgid ""
"Font Lock mode (@pxref{Font Lock Mode}) works in most buffers by dynamically "
"updating the @code{face} property of characters based on the context."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3483
msgid ""
"The @code{add-face-text-property} function provides a convenient way to set "
"this text property. @xref{Changing Properties}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3484
#, no-wrap
msgid "font-lock-face"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3485
#, no-wrap
msgid "font-lock-face @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3492
msgid ""
"This property specifies a value for the @code{face} property that Font Lock "
"mode should apply to the underlying text. It is one of the fontification "
"methods used by Font Lock mode, and is useful for special modes that "
"implement their own highlighting. @xref{Precalculated Fontification}. When "
"Font Lock mode is disabled, @code{font-lock-face} has no effect."
msgstr ""
#. type: code{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3493
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4172
#, no-wrap
msgid "mouse-face"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3494
#, no-wrap
msgid "mouse-face @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3499
msgid ""
"This property is used instead of @code{face} when the mouse is on or near "
"the character. For this purpose, ``near'' means that all text between the "
"character and where the mouse is have the same @code{mouse-face} property "
"value."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3504
msgid ""
"Emacs ignores all face attributes from the @code{mouse-face} property that "
"alter the text size (e.g., @code{:height}, @code{:weight}, and "
"@code{:slant}). Those attributes are always the same as for the "
"unhighlighted text."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3505
#, no-wrap
msgid "fontified"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3506
#, no-wrap
msgid "fontified @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3512
msgid ""
"This property says whether the text is ready for display. If @code{nil}, "
"Emacs's redisplay routine calls the functions in "
"@code{fontification-functions} (@pxref{Auto Faces}) to prepare this part of "
"the buffer before it is displayed. It is used internally by the "
"just-in-time font locking code."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3513
#, no-wrap
msgid "display"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3518
msgid ""
"This property activates various features that change the way text is "
"displayed. For example, it can make text appear taller or shorter, higher "
"or lower, wider or narrow, or replaced with an image. @xref{Display "
"Property}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3519
#, no-wrap
msgid "help-echo"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3520
#, no-wrap
msgid "help-echo @r{(text property)}"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3521
#, no-wrap
msgid "tooltip for help strings"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3527
msgid "Text help-echo"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3527
msgid ""
"If text has a string as its @code{help-echo} property, then when you move "
"the mouse onto that text, Emacs displays that string in the echo area, or in "
"the tooltip window (@pxref{Tooltips}), after passing it through "
"@code{substitute-command-keys}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3535
msgid ""
"If the value of the @code{help-echo} property is a function, that function "
"is called with three arguments, @var{window}, @var{object} and @var{pos} and "
"should return a help string or @code{nil} for none. The first argument, "
"@var{window} is the window in which the help was found. The second, "
"@var{object}, is the buffer, overlay or string which had the "
"@code{help-echo} property. The @var{pos} argument is as follows:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3539
msgid "If @var{object} is a buffer, @var{pos} is the position in the buffer."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3542
msgid ""
"If @var{object} is an overlay, that overlay has a @code{help-echo} property, "
"and @var{pos} is the position in the overlay's buffer."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3546
msgid ""
"If @var{object} is a string (an overlay string or a string displayed with "
"the @code{display} property), @var{pos} is the position in that string."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3550
msgid ""
"If the value of the @code{help-echo} property is neither a function nor a "
"string, it is evaluated to obtain a help string."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3553
msgid ""
"You can alter the way help text is displayed by setting the variable "
"@code{show-help-function} (@pxref{Help display})."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3555
msgid "This feature is used in the mode line and for other active text."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3556
#, no-wrap
msgid "help-echo-inhibit-substitution"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3557
#, no-wrap
msgid "help-echo text, avoid command-key substitution"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3558
#, no-wrap
msgid "help-echo-inhibit-substitution @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3563
msgid ""
"If the first character of a @code{help-echo} string has a non-@code{nil} "
"@code{help-echo-inhibit-substitution} property, then it is displayed as-is "
"by @code{show-help-function}, without being passed through "
"@code{substitute-command-keys}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3564
#, no-wrap
msgid "keymap"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3565
#, no-wrap
msgid "keymap of character"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3566
#, no-wrap
msgid "keymap @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3572
msgid ""
"The @code{keymap} property specifies an additional keymap for commands. "
"When this keymap applies, it is used for key lookup before the minor mode "
"keymaps and before the buffer's local map. @xref{Active Keymaps}. If the "
"property value is a symbol, the symbol's function definition is used as the "
"keymap."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3578
msgid ""
"The property's value for the character before point applies if it is "
"non-@code{nil} and rear-sticky, and the property's value for the character "
"after point applies if it is non-@code{nil} and front-sticky. (For mouse "
"clicks, the position of the click is used instead of the position of point.)"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3579
#, no-wrap
msgid "local-map"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3580
#, no-wrap
msgid "local-map @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3585
msgid ""
"This property works like @code{keymap} except that it specifies a keymap to "
"use @emph{instead of} the buffer's local map. For most purposes (perhaps "
"all purposes), it is better to use the @code{keymap} property."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3586
#, no-wrap
msgid "syntax-table"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3589
msgid ""
"The @code{syntax-table} property overrides what the syntax table says about "
"this particular character. @xref{Syntax Properties}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3590
#, no-wrap
msgid "read-only"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3591
#, no-wrap
msgid "read-only character"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3592
#, no-wrap
msgid "read-only @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3597
msgid ""
"If a character has the property @code{read-only}, then modifying that "
"character is not allowed. Any command that would do so gets an error, "
"@code{text-read-only}. If the property value is a string, that string is "
"used as the error message."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3602
msgid ""
"Insertion next to a read-only character is an error if inserting ordinary "
"text there would inherit the @code{read-only} property due to stickiness. "
"Thus, you can control permission to insert next to read-only text by "
"controlling the stickiness. @xref{Sticky Properties}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3607
msgid ""
"Since changing properties counts as modifying the buffer, it is not possible "
"to remove a @code{read-only} property unless you know the special trick: "
"bind @code{inhibit-read-only} to a non-@code{nil} value and then remove the "
"property. @xref{Read Only Buffers}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3608
#, no-wrap
msgid "inhibit-read-only"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3609
#, no-wrap
msgid "inhibit-read-only @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3612
msgid ""
"Characters that have the property @code{inhibit-read-only} can be edited "
"even in read-only buffers. @xref{Read Only Buffers}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3613
#, no-wrap
msgid "invisible"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3614
#, no-wrap
msgid "invisible @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3617
msgid ""
"A non-@code{nil} @code{invisible} property can make a character invisible on "
"the screen. @xref{Invisible Text}, for details."
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3618
#, no-wrap
msgid "inhibit-isearch @r{(text property)}"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3619
#, no-wrap
msgid "inhibit-isearch"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3622
msgid ""
"A non-@code{nil} @code{inhibit-isearch} property will make isearch skip the "
"text."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3623
#, no-wrap
msgid "intangible"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3624
#, no-wrap
msgid "intangible @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3630
msgid ""
"If a group of consecutive characters have equal and non-@code{nil} "
"@code{intangible} properties, then you cannot place point between them. If "
"you try to move point forward into the group, point actually moves to the "
"end of the group. If you try to move point backward into the group, point "
"actually moves to the start of the group."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3634
msgid ""
"If consecutive characters have unequal non-@code{nil} @code{intangible} "
"properties, they belong to separate groups; each group is separately treated "
"as described above."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3637
msgid ""
"When the variable @code{inhibit-point-motion-hooks} is non-@code{nil} (as it "
"is by default), the @code{intangible} property is ignored."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3644
msgid ""
"Beware: this property operates at a very low level, and affects a lot of "
"code in unexpected ways. So use it with extreme caution. A common misuse "
"is to put an intangible property on invisible text, which is actually "
"unnecessary since the command loop will move point outside of the invisible "
"text at the end of each command anyway. @xref{Adjusting Point}. For these "
"reasons, this property is obsolete; use the @code{cursor-intangible} "
"property instead."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3645
#, no-wrap
msgid "cursor-intangible"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3646
#, no-wrap
msgid "cursor-intangible @r{(text property)}"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3647
#, no-wrap
msgid "cursor-intangible-mode"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3651
msgid ""
"When the minor mode @code{cursor-intangible-mode} is turned on, point is "
"moved away from any position that has a non-@code{nil} "
"@code{cursor-intangible} property, just before redisplay happens."
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3652
#, no-wrap
msgid "cursor-sensor-inhibit"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3656
msgid ""
"When the variable @code{cursor-sensor-inhibit} is non-@code{nil}, the "
"@code{cursor-intangible} property and the @code{cursor-sensor-functions} "
"property (described below) are ignored."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3657
#, no-wrap
msgid "field"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3658
#, no-wrap
msgid "field @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3663
msgid ""
"Consecutive characters with the same @code{field} property constitute a "
"@dfn{field}. Some motion functions including @code{forward-word} and "
"@code{beginning-of-line} stop moving at a field boundary. @xref{Fields}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3664
#, no-wrap
msgid "cursor"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3665
#, no-wrap
msgid "cursor @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3681
msgid ""
"Normally, the cursor is displayed at the beginning or the end of any overlay "
"and text property strings present at the current buffer position. You can "
"place the cursor on any desired character of these strings by giving that "
"character a non-@code{nil} @code{cursor} text property. In addition, if the "
"value of the @code{cursor} property is an integer, it specifies the number "
"of buffer's character positions, starting with the position where the "
"overlay or the @code{display} property begins, for which the cursor should "
"be displayed on that character. Specifically, if the value of the "
"@code{cursor} property of a character is the number @var{n}, the cursor will "
"be displayed on this character for any buffer position in the range "
"@code{[@var{ovpos}..@var{ovpos}+@var{n})}, where @var{ovpos} is the "
"overlay's starting position given by @code{overlay-start} (@pxref{Managing "
"Overlays}), or the position where the @code{display} text property begins in "
"the buffer."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3692
msgid ""
"In other words, the string character with the @code{cursor} property of any "
"non-@code{nil} value is the character where to display the cursor. The "
"value of the property says for which buffer positions to display the cursor "
"there. If the value is an integer @var{n}, the cursor is displayed there "
"when point is anywhere between the beginning of the overlay or "
"@code{display} property and @var{n} positions after that. If the value is "
"anything else and non-@code{nil}, the cursor is displayed there only when "
"point is at the beginning of the @code{display} property or at "
"@code{overlay-start}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3693
#, no-wrap
msgid "cursor position for @code{display} properties and overlays"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3703
msgid ""
"When the buffer has many overlay strings (e.g., @pxref{Overlay Properties, "
"before-string}) that conceal some of the buffer text or @code{display} "
"properties that are strings, it is a good idea to use the @code{cursor} "
"property on these strings to cue the Emacs display about the places where to "
"put the cursor while traversing these strings. This directly communicates "
"to the display engine where the Lisp program wants to put the cursor, or "
"where the user would expect the cursor, when point is located on some buffer "
"position that is ``covered'' by the display or overlay string."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3704
#, no-wrap
msgid "pointer"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3705
#, no-wrap
msgid "pointer @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3709
msgid ""
"This specifies a specific pointer shape when the mouse pointer is over this "
"text or image. @xref{Pointer Shape}, for possible pointer shapes."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3710
#, no-wrap
msgid "line-spacing"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3711
#, no-wrap
msgid "line-spacing @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3716
msgid ""
"A newline can have a @code{line-spacing} text or overlay property that "
"controls the height of the display line ending with that newline. The "
"property value overrides the default frame line spacing and the buffer local "
"@code{line-spacing} variable. @xref{Line Height}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3717
#, no-wrap
msgid "line-height"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3718
#, no-wrap
msgid "line-height @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3722
msgid ""
"A newline can have a @code{line-height} text or overlay property that "
"controls the total height of the display line ending in that newline. "
"@xref{Line Height}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3723
#, no-wrap
msgid "wrap-prefix"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3731
msgid ""
"If text has a @code{wrap-prefix} property, the prefix it defines will be "
"added at display time to the beginning of every continuation line due to "
"text wrapping (so if lines are truncated, the wrap-prefix is never used). "
"It may be a string or an image (@pxref{Other Display Specs}), or a stretch "
"of whitespace such as specified by the @code{:width} or @code{:align-to} "
"display properties (@pxref{Specified Space})."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3736
msgid ""
"A wrap-prefix may also be specified for an entire buffer using the "
"@code{wrap-prefix} buffer-local variable (however, a @code{wrap-prefix} "
"text-property takes precedence over the value of the @code{wrap-prefix} "
"variable). @xref{Truncation}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3737
#, no-wrap
msgid "line-prefix"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3744
msgid ""
"If text has a @code{line-prefix} property, the prefix it defines will be "
"added at display time to the beginning of every non-continuation line. It "
"may be a string or an image (@pxref{Other Display Specs}), or a stretch of "
"whitespace such as specified by the @code{:width} or @code{:align-to} "
"display properties (@pxref{Specified Space})."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3749
msgid ""
"A line-prefix may also be specified for an entire buffer using the "
"@code{line-prefix} buffer-local variable (however, a @code{line-prefix} "
"text-property takes precedence over the value of the @code{line-prefix} "
"variable). @xref{Truncation}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3750
#, no-wrap
msgid "modification-hooks"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3751
#, no-wrap
msgid "change hooks for a character"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3752
#, no-wrap
msgid "hooks for changing a character"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3753
#, no-wrap
msgid "modification-hooks @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3765
msgid ""
"If a character has the property @code{modification-hooks}, then its value "
"should be a list of functions; modifying that character calls all of those "
"functions before the actual modification. Each function receives two "
"arguments: the beginning and end of the part of the buffer being modified. "
"Note that if a particular modification hook function appears on several "
"characters being modified by a single primitive, you can't predict how many "
"times the function will be called. Furthermore, insertion will not modify "
"any existing character, so this hook will only be run when removing some "
"characters, replacing them with others, or changing their text-properties."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3772
msgid ""
"Unlike with other similar hooks, when Emacs calls these functions, "
"@code{inhibit-modification-hooks} does @emph{not} get bound to "
"non-@code{nil}. If the functions modify the buffer, you should consider "
"binding this variable to non-@code{nil} to prevent any buffer changes "
"running the change hooks. Otherwise, you must be prepared for recursive "
"calls. @xref{Change Hooks}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3775
msgid ""
"Overlays also support the @code{modification-hooks} property, but the "
"details are somewhat different (@pxref{Overlay Properties})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3776
#, no-wrap
msgid "insert-in-front-hooks"
msgstr ""
#. type: itemx
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3777
#, no-wrap
msgid "insert-behind-hooks"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3778
#, no-wrap
msgid "insert-in-front-hooks @r{(text property)}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3779
#, no-wrap
msgid "insert-behind-hooks @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3786
msgid ""
"The operation of inserting text in a buffer also calls the functions listed "
"in the @code{insert-in-front-hooks} property of the following character and "
"in the @code{insert-behind-hooks} property of the preceding character. "
"These functions receive two arguments, the beginning and end of the inserted "
"text. The functions are called @emph{after} the actual insertion takes "
"place."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3793
msgid ""
"When these functions are called, @code{inhibit-modification-hooks} is bound "
"to non-@code{nil}. If the functions modify the buffer, you might want to "
"bind @code{inhibit-modification-hooks} to @code{nil}, so as to cause the "
"change hooks to run for these modifications. However, doing this may call "
"your own change hook recursively, so be sure to prepare for that."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3796
msgid ""
"See also @ref{Change Hooks}, for other hooks that are called when you change "
"text in a buffer."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3797
#, no-wrap
msgid "point-entered"
msgstr ""
#. type: itemx
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3798
#, no-wrap
msgid "point-left"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3799
#, no-wrap
msgid "hooks for motion of point"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3800
#, no-wrap
msgid "point-entered @r{(text property)}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3801
#, no-wrap
msgid "point-left @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3805
msgid ""
"The special properties @code{point-entered} and @code{point-left} record "
"hook functions that report motion of point. Each time point moves, Emacs "
"compares these two property values:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3810
msgid "the @code{point-left} property of the character after the old location, and"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3813
msgid "the @code{point-entered} property of the character after the new location."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3818
msgid ""
"If these two values differ, each of them is called (if not @code{nil}) with "
"two arguments: the old value of point, and the new one."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3825
msgid ""
"The same comparison is made for the characters before the old and new "
"locations. The result may be to execute two @code{point-left} functions "
"(which may be the same function) and/or two @code{point-entered} functions "
"(which may be the same function). In any case, all the @code{point-left} "
"functions are called first, followed by all the @code{point-entered} "
"functions."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3829
msgid ""
"It is possible to use @code{char-after} to examine characters at various "
"buffer positions without moving point to those positions. Only an actual "
"change in the value of point runs these hook functions."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3833
msgid ""
"The variable @code{inhibit-point-motion-hooks} by default inhibits running "
"the @code{point-left} and @code{point-entered} hooks, see @ref{Inhibit point "
"motion hooks}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3836
msgid ""
"These properties are obsolete; please use @code{cursor-sensor-functions} "
"instead."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3837
#, no-wrap
msgid "cursor-sensor-functions"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3838
#, no-wrap
msgid "cursor-sensor-functions @r{(text property)}"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3839
#, no-wrap
msgid "cursor-sensor-mode"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3847
msgid ""
"This special property records a list of functions that react to cursor "
"motion. Each function in the list is called, just before redisplay, with 3 "
"arguments: the affected window, the previous known position of the cursor, "
"and one of the symbols @code{entered} or @code{left}, depending on whether "
"the cursor is entering the text that has this property or leaving it. The "
"functions are called only when the minor mode @code{cursor-sensor-mode} is "
"turned on."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3850
msgid ""
"When the variable @code{cursor-sensor-inhibit} is non-@code{nil}, the "
"@code{cursor-sensor-functions} property is ignored."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3851
#, no-wrap
msgid "composition"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3852
#, no-wrap
msgid "composition @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3857
msgid ""
"This text property is used to display a sequence of characters as a single "
"glyph composed from components. But the value of the property itself is "
"completely internal to Emacs and should not be manipulated directly by, for "
"instance, @code{put-text-property}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3858
#, no-wrap
msgid "minibuffer-message"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3859
#, no-wrap
msgid "minibuffer-message @r{(text property)}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3867
msgid ""
"This text property tells where to display temporary messages in an active "
"minibuffer. Specifically, the first character of the minibuffer text which "
"has this property will have the temporary message displayed before it. The "
"default is to display temporary messages at the end of the minibuffer text. "
"This text property is used by the function that is the default value of "
"@code{set-message-function} (@pxref{Displaying Messages})."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3870
#, no-wrap
msgid "inhibit-point-motion-hooks"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3877
msgid "Inhibit point motion hooks"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3877
msgid ""
"When this obsolete variable is non-@code{nil}, @code{point-left} and "
"@code{point-entered} hooks are not run, and the @code{intangible} property "
"has no effect. Do not set this variable globally; bind it with @code{let}. "
"Since the affected properties are obsolete, this variable's default value is "
"@code{t}, to effectively disable them."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3879
#, no-wrap
msgid "show-help-function"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3892
msgid "Help display"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3892
msgid ""
"If this variable is non-@code{nil}, it specifies a function called to "
"display help strings. These may be @code{help-echo} properties, menu help "
"strings (@pxref{Simple Menu Items}, @pxref{Extended Menu Items}), or tool "
"bar help strings (@pxref{Tool Bar}). The specified function is called with "
"one argument, the help string to display, which is passed through "
"@code{substitute-command-keys} before being given to the function, unless "
"the help string has a non-@code{nil} @code{help-echo-inhibit-substitution} "
"property on its first character; see @ref{Keys in Documentation}. See the "
"code of Tooltip mode (@pxref{Tooltips,,, emacs, The GNU Emacs Manual}) for "
"an example of a mode that uses @code{show-help-function}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3894
#, no-wrap
msgid "face-filters-always-match"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3898
msgid ""
"If this variable is non-@code{nil}, face filters that specify attributes "
"applied only when certain conditions are met will be deemed to match always."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3901
#, no-wrap
msgid "Formatted Text Properties"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3906
msgid ""
"These text properties affect the behavior of the fill commands. They are "
"used for representing formatted text. @xref{Filling}, and @ref{Margins}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3908
#, no-wrap
msgid "hard"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3914
msgid ""
"If a newline character has this property, it is a ``hard'' newline. The "
"fill commands do not alter hard newlines and do not move words across them. "
"However, this property takes effect only if the @code{use-hard-newlines} "
"minor mode is enabled. @xref{Hard and Soft Newlines,, Hard and Soft "
"Newlines, emacs, The GNU Emacs Manual}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3915
#, no-wrap
msgid "right-margin"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3918
msgid ""
"This property specifies an extra right margin for filling this part of the "
"text."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3922
msgid ""
"This property specifies an extra left margin for filling this part of the "
"text."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3923
#, no-wrap
msgid "justification"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3926
msgid ""
"This property specifies the style of justification for filling this part of "
"the text."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3929
#, no-wrap
msgid "Stickiness of Text Properties"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3930
#, no-wrap
msgid "sticky text properties"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3931
#, no-wrap
msgid "inheritance, text property"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3937
msgid ""
"Self-inserting characters, the ones that get inserted into a buffer when the "
"user types them (@pxref{Commands for Insertion}), normally take on the same "
"properties as the preceding character. This is called @dfn{inheritance} of "
"properties."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3947
msgid ""
"By contrast, a Lisp program can do insertion with inheritance or without, "
"depending on the choice of insertion primitive. The ordinary text insertion "
"functions, such as @code{insert}, do not inherit any properties. They "
"insert text with precisely the properties of the string being inserted, and "
"no others. This is correct for programs that copy text from one context to "
"another---for example, into or out of the kill ring. To insert with "
"inheritance, use the special primitives described in this section. "
"Self-inserting characters inherit properties because they work using these "
"primitives."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3955
msgid ""
"When you do insertion with inheritance, @emph{which} properties are "
"inherited, and from where, depends on which properties are @dfn{sticky}. "
"Insertion after a character inherits those of its properties that are "
"@dfn{rear-sticky}. Insertion before a character inherits those of its "
"properties that are @dfn{front-sticky}. When both sides offer different "
"sticky values for the same property, the previous character's value takes "
"precedence."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3959
msgid ""
"By default, a text property is rear-sticky but not front-sticky; thus, the "
"default is to inherit all the properties of the preceding character, and "
"nothing from the following character."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3966
msgid ""
"You can control the stickiness of various text properties with two specific "
"text properties, @code{front-sticky} and @code{rear-nonsticky}, and with the "
"variable @code{text-property-default-nonsticky}. You can use the variable "
"to specify a different default for a given property. You can use those two "
"text properties to make any specific properties sticky or nonsticky in any "
"particular part of the text."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3974
msgid ""
"If a character's @code{front-sticky} property is @code{t}, then all its "
"properties are front-sticky. If the @code{front-sticky} property is a list, "
"then the sticky properties of the character are those whose names are in the "
"list. For example, if a character has a @code{front-sticky} property whose "
"value is @code{(face read-only)}, then insertion before the character can "
"inherit its @code{face} property and its @code{read-only} property, but no "
"others."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3982
msgid ""
"The @code{rear-nonsticky} property works the opposite way. Most properties "
"are rear-sticky by default, so the @code{rear-nonsticky} property says which "
"properties are @emph{not} rear-sticky. If a character's "
"@code{rear-nonsticky} property is @code{t}, then none of its properties are "
"rear-sticky. If the @code{rear-nonsticky} property is a list, properties "
"are rear-sticky @emph{unless} their names are in the list."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3983
#, no-wrap
msgid "text-property-default-nonsticky"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3988
msgid ""
"This variable holds an alist which defines the default rear-stickiness of "
"various text properties. Each element has the form @code{(@var{property} "
". @var{nonstickiness})}, and it defines the stickiness of a particular text "
"property, @var{property}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3993
msgid ""
"If @var{nonstickiness} is non-@code{nil}, this means that the property "
"@var{property} is rear-nonsticky by default. Since all properties are "
"front-nonsticky by default, this makes @var{property} nonsticky in both "
"directions by default."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:3997
msgid ""
"The text properties @code{front-sticky} and @code{rear-nonsticky}, when "
"used, take precedence over the default @var{nonstickiness} specified in "
"@code{text-property-default-nonsticky}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4000
msgid "Here are the functions that insert text with inheritance of properties:"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4001
#, no-wrap
msgid "insert-and-inherit &rest strings"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4004
msgid ""
"Insert the strings @var{strings}, just like the function @code{insert}, but "
"inherit any sticky properties from the adjoining text."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4006
#, no-wrap
msgid "insert-before-markers-and-inherit &rest strings"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4010
msgid ""
"Insert the strings @var{strings}, just like the function "
"@code{insert-before-markers}, but inherit any sticky properties from the "
"adjoining text."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4014
msgid "@xref{Insertion}, for the ordinary insertion functions which do not inherit."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4016
#, no-wrap
msgid "Lazy Computation of Text Properties"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4021
msgid ""
"Instead of computing text properties for all the text in the buffer, you can "
"arrange to compute the text properties for parts of the text when and if "
"something depends on them."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4025
msgid ""
"The primitive that extracts text from the buffer along with its properties "
"is @code{buffer-substring}. Before examining the properties, this function "
"runs the abnormal hook @code{buffer-access-fontify-functions}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4026
#, no-wrap
msgid "buffer-access-fontify-functions"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4033
msgid ""
"This variable holds a list of functions for computing text properties. "
"Before @code{buffer-substring} copies the text and text properties for a "
"portion of the buffer, it calls all the functions in this list. Each of the "
"functions receives two arguments that specify the range of the buffer being "
"accessed. (The buffer itself is always the current buffer.)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4037
msgid ""
"The function @code{buffer-substring-no-properties} does not call these "
"functions, since it ignores text properties anyway."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4041
msgid ""
"In order to prevent the hook functions from being called more than once for "
"the same part of the buffer, you can use the variable "
"@code{buffer-access-fontified-property}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4042
#, no-wrap
msgid "buffer-access-fontified-property"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4047
msgid ""
"If this variable's value is non-@code{nil}, it is a symbol which is used as "
"a text property name. A non-@code{nil} value for that text property means "
"the other text properties for this character have already been computed."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4053
msgid ""
"If all the characters in the range specified for @code{buffer-substring} "
"have a non-@code{nil} value for this property, @code{buffer-substring} does "
"not call the @code{buffer-access-fontify-functions} functions. It assumes "
"these characters already have the right text properties, and just copies the "
"properties they already have."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4058
msgid ""
"The normal way to use this feature is that the "
"@code{buffer-access-fontify-functions} functions add this property, as well "
"as others, to the characters they operate on. That way, they avoid being "
"called over and over for the same text."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4061
#, no-wrap
msgid "Defining Clickable Text"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4062
#, no-wrap
msgid "clickable text"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4063
#, no-wrap
msgid "follow links"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4064
#, no-wrap
msgid "mouse-1"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4070
msgid ""
"@dfn{Clickable text} is text that can be clicked, with either the mouse or "
"via a keyboard command, to produce some result. Many major modes use "
"clickable text to implement textual hyper-links, or @dfn{links} for short."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4076
msgid ""
"The easiest way to insert and manipulate links is to use the @code{button} "
"package. @xref{Buttons}. In this section, we will explain how to manually "
"set up clickable text in a buffer, using text properties. For simplicity, "
"we will refer to the clickable text as a @dfn{link}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4082
msgid ""
"Implementing a link involves three separate steps: (1) indicating "
"clickability when the mouse moves over the link; (2) making @key{RET} or "
"@kbd{mouse-2} on that link do something; and (3) setting up a "
"@code{follow-link} condition so that the link obeys "
"@code{mouse-1-click-follows-link}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4089
msgid ""
"To indicate clickability, add the @code{mouse-face} text property to the "
"text of the link; then Emacs will highlight the link when the mouse moves "
"over it. In addition, you should define a tooltip or echo area message, "
"using the @code{help-echo} text property. @xref{Special Properties}. For "
"instance, here is how Dired indicates that file names are clickable:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4099
#, no-wrap
msgid ""
" (if (dired-move-to-filename)\n"
" (add-text-properties\n"
" (point)\n"
" (save-excursion\n"
" (dired-move-to-end-of-filename)\n"
" (point))\n"
" '(mouse-face highlight\n"
" help-echo \"mouse-2: visit this file in other window\")))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4106
msgid ""
"To make the link clickable, bind @key{RET} and @kbd{mouse-2} to commands "
"that perform the desired action. Each command should check to see whether "
"it was called on a link, and act accordingly. For instance, Dired's major "
"mode keymap binds @kbd{mouse-2} to the following command:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4127
#, no-wrap
msgid ""
"(defun dired-mouse-find-file-other-window (event)\n"
" \"In Dired, visit the file or directory name you click on.\"\n"
" (interactive \"e\")\n"
" (let ((window (posn-window (event-end event)))\n"
" (pos (posn-point (event-end event)))\n"
" file)\n"
" (if (not (windowp window))\n"
" (error \"No file chosen\"))\n"
" (with-current-buffer (window-buffer window)\n"
" (goto-char pos)\n"
" (setq file (dired-get-file-for-visit)))\n"
" (if (file-directory-p file)\n"
" (or (and (cdr dired-subdir-alist)\n"
" (dired-goto-subdir file))\n"
" (progn\n"
" (select-window window)\n"
" (dired-other-window file)))\n"
" (select-window window)\n"
" (find-file-other-window (file-name-sans-versions file t)))))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4133
msgid ""
"This command uses the functions @code{posn-window} and @code{posn-point} to "
"determine where the click occurred, and @code{dired-get-file-for-visit} to "
"determine which file to visit."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4137
msgid ""
"Instead of binding the mouse command in a major mode keymap, you can bind it "
"within the link text, using the @code{keymap} text property (@pxref{Special "
"Properties}). For instance:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4142
#, no-wrap
msgid ""
"(let ((map (make-sparse-keymap)))\n"
" (define-key map [mouse-2] 'operate-this-button)\n"
" (put-text-property link-start link-end 'keymap map))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4148
msgid ""
"With this method, you can easily define different commands for different "
"links. Furthermore, the global definition of @key{RET} and @kbd{mouse-2} "
"remain available for the rest of the text in the buffer."
msgstr ""
#. type: vindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4149
#, no-wrap
msgid "mouse-1-click-follows-link"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4156
msgid ""
"The basic Emacs command for clicking on links is @kbd{mouse-2}. However, "
"for compatibility with other graphical applications, Emacs also recognizes "
"@kbd{mouse-1} clicks on links, provided the user clicks on the link quickly "
"without moving the mouse. This behavior is controlled by the user option "
"@code{mouse-1-click-follows-link}. @xref{Mouse References,,, emacs, The GNU "
"Emacs Manual}."
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4157
#, no-wrap
msgid "follow-link @r{(text or overlay property)}"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4170
msgid ""
"To set up the link so that it obeys @code{mouse-1-click-follows-link}, you "
"must either (1) apply a @code{follow-link} text or overlay property to the "
"link text, or (2) bind the @code{follow-link} event to a keymap (which can "
"be a major mode keymap or a local keymap specified via the @code{keymap} "
"text property). The value of the @code{follow-link} property, or the "
"binding for the @code{follow-link} event, acts as a condition for the link "
"action. This condition tells Emacs two things: the circumstances under "
"which a @kbd{mouse-1} click should be regarded as occurring inside the link, "
"and how to compute an action code that says what to translate the "
"@kbd{mouse-1} click into. The link action condition can be one of the "
"following:"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4176
msgid ""
"If the condition is the symbol @code{mouse-face}, a position is inside a "
"link if there is a non-@code{nil} @code{mouse-face} property at that "
"position. The action code is always @code{t}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4178
msgid "For example, here is how Info mode handles @key{mouse-1}:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4181
#, no-wrap
msgid "(define-key Info-mode-map [follow-link] 'mouse-face)\n"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4183
#, no-wrap
msgid "a function"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4188
msgid ""
"If the condition is a function, @var{func}, then a position @var{pos} is "
"inside a link if @code{(@var{func} @var{pos})} evaluates to non-@code{nil}. "
"The value returned by @var{func} serves as the action code."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4191
msgid ""
"For example, here is how pcvs enables @kbd{mouse-1} to follow links on file "
"names only:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4196
#, no-wrap
msgid ""
"(define-key map [follow-link]\n"
" (lambda (pos)\n"
" (eq (get-char-property pos 'face) 'cvs-filename-face)))\n"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4198
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4218
#, no-wrap
msgid "anything else"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4204
msgid ""
"If the condition value is anything else, then the position is inside a link "
"and the condition itself is the action code. Clearly, you should specify "
"this kind of condition only when applying the condition via a text or "
"overlay property on the link text (so that it does not apply to the entire "
"buffer)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4208
msgid "The action code tells @kbd{mouse-1} how to follow the link:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4210
#, no-wrap
msgid "a string or vector"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4217
msgid ""
"If the action code is a string or vector, the @kbd{mouse-1} event is "
"translated into the first element of the string or vector; i.e., the action "
"of the @kbd{mouse-1} click is the local or global binding of that character "
"or symbol. Thus, if the action code is @code{\"foo\"}, @kbd{mouse-1} "
"translates into @kbd{f}. If it is @code{[foo]}, @kbd{mouse-1} translates "
"into @key{foo}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4221
msgid ""
"For any other non-@code{nil} action code, the @kbd{mouse-1} event is "
"translated into a @kbd{mouse-2} event at the same position."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4228
msgid ""
"To define @kbd{mouse-1} to activate a button defined with "
"@code{define-button-type}, give the button a @code{follow-link} property. "
"The property value should be a link action condition, as described above. "
"@xref{Buttons}. For example, here is how Help mode handles @kbd{mouse-1}:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4233
#, no-wrap
msgid ""
"(define-button-type 'help-xref\n"
" 'follow-link t\n"
" 'action #'help-button-action)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4240
msgid ""
"To define @kbd{mouse-1} on a widget defined with @code{define-widget}, give "
"the widget a @code{:follow-link} property. The property value should be a "
"link action condition, as described above. For example, here is how the "
"@code{link} widget specifies that a @key{mouse-1} click shall be translated "
"to @key{RET}:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4249
#, no-wrap
msgid ""
"(define-widget 'link 'item\n"
" \"An embedded link.\"\n"
" :button-prefix 'widget-link-prefix\n"
" :button-suffix 'widget-link-suffix\n"
" :follow-link \"\\C-m\"\n"
" :help-echo \"Follow the link.\"\n"
" :format \"%[%t%]\")\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4251
#, no-wrap
msgid "mouse-on-link-p pos"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4255
msgid ""
"This function returns non-@code{nil} if position @var{pos} in the current "
"buffer is on a link. @var{pos} can also be a mouse event location, as "
"returned by @code{event-start} (@pxref{Accessing Mouse})."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4258
#, no-wrap
msgid "Defining and Using Fields"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4259
#, no-wrap
msgid "fields"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4266
msgid ""
"A field is a range of consecutive characters in the buffer that are "
"identified by having the same value (comparing with @code{eq}) of the "
"@code{field} property (either a text-property or an overlay property). This "
"section describes special functions that are available for operating on "
"fields."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4270
msgid ""
"You specify a field with a buffer position, @var{pos}. We think of each "
"field as containing a range of buffer positions, so the position you specify "
"stands for the field containing that position."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4278
msgid ""
"When the characters before and after @var{pos} are part of the same field, "
"there is no doubt which field contains @var{pos}: the one those characters "
"both belong to. When @var{pos} is at a boundary between fields, which field "
"it belongs to depends on the stickiness of the @code{field} properties of "
"the two surrounding characters (@pxref{Sticky Properties}). The field whose "
"property would be inherited by text inserted at @var{pos} is the field that "
"contains @var{pos}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4286
msgid ""
"There is an anomalous case where newly inserted text at @var{pos} would not "
"inherit the @code{field} property from either side. This happens if the "
"previous character's @code{field} property is not rear-sticky, and the "
"following character's @code{field} property is not front-sticky. In this "
"case, @var{pos} belongs to neither the preceding field nor the following "
"field; the field functions treat it as belonging to an empty field whose "
"beginning and end are both at @var{pos}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4290
msgid ""
"In all of these functions, if @var{pos} is omitted or @code{nil}, the value "
"of point is used by default. If narrowing is in effect, then @var{pos} "
"should fall within the accessible portion. @xref{Narrowing}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4291
#, no-wrap
msgid "field-beginning &optional pos escape-from-edge limit"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4293
msgid "This function returns the beginning of the field specified by @var{pos}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4299
msgid ""
"If @var{pos} is at the beginning of its field, and @var{escape-from-edge} is "
"non-@code{nil}, then the return value is always the beginning of the "
"preceding field that @emph{ends} at @var{pos}, regardless of the stickiness "
"of the @code{field} properties around @var{pos}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4303
msgid ""
"If @var{limit} is non-@code{nil}, it is a buffer position; if the beginning "
"of the field is before @var{limit}, then @var{limit} will be returned "
"instead."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4305
#, no-wrap
msgid "field-end &optional pos escape-from-edge limit"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4307
msgid "This function returns the end of the field specified by @var{pos}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4312
msgid ""
"If @var{pos} is at the end of its field, and @var{escape-from-edge} is "
"non-@code{nil}, then the return value is always the end of the following "
"field that @emph{begins} at @var{pos}, regardless of the stickiness of the "
"@code{field} properties around @var{pos}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4316
msgid ""
"If @var{limit} is non-@code{nil}, it is a buffer position; if the end of the "
"field is after @var{limit}, then @var{limit} will be returned instead."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4318
#, no-wrap
msgid "field-string &optional pos"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4321
msgid ""
"This function returns the contents of the field specified by @var{pos}, as a "
"string."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4323
#, no-wrap
msgid "field-string-no-properties &optional pos"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4326
msgid ""
"This function returns the contents of the field specified by @var{pos}, as a "
"string, discarding text properties."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4328
#, no-wrap
msgid "delete-field &optional pos"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4330
msgid "This function deletes the text of the field specified by @var{pos}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4332
#, no-wrap
msgid ""
"constrain-to-field new-pos old-pos &optional escape-from-edge only-in-line "
"inhibit-capture-property"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4336
msgid ""
"This function constrains @var{new-pos} to the field that @var{old-pos} "
"belongs to---in other words, it returns the position closest to "
"@var{new-pos} that is in the same field as @var{old-pos}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4340
msgid ""
"If @var{new-pos} is @code{nil}, then @code{constrain-to-field} uses the "
"value of point instead, and moves point to the resulting position in "
"addition to returning that position."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4352
msgid ""
"If @var{old-pos} is at the boundary of two fields, then the acceptable final "
"positions depend on the argument @var{escape-from-edge}. If "
"@var{escape-from-edge} is @code{nil}, then @var{new-pos} must be in the "
"field whose @code{field} property equals what new characters inserted at "
"@var{old-pos} would inherit. (This depends on the stickiness of the "
"@code{field} property for the characters before and after @var{old-pos}.) "
"If @var{escape-from-edge} is non-@code{nil}, @var{new-pos} can be anywhere "
"in the two adjacent fields. Additionally, if two fields are separated by "
"another field with the special value @code{boundary}, then any point within "
"this special field is also considered to be on the boundary."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4357
msgid ""
"Commands like @kbd{C-a} with no argument, that normally move backward to a "
"specific kind of location and stay there once there, probably should specify "
"@code{nil} for @var{escape-from-edge}. Other motion commands that check "
"fields should probably pass @code{t}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4364
msgid ""
"If the optional argument @var{only-in-line} is non-@code{nil}, and "
"constraining @var{new-pos} in the usual way would move it to a different "
"line, @var{new-pos} is returned unconstrained. This used in commands that "
"move by line, such as @code{next-line} and @code{beginning-of-line}, so that "
"they respect field boundaries only in the case where they can still move to "
"the right line."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4368
msgid ""
"If the optional argument @var{inhibit-capture-property} is non-@code{nil}, "
"and @var{old-pos} has a non-@code{nil} property of that name, then any field "
"boundaries are ignored."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4372
msgid ""
"You can cause @code{constrain-to-field} to ignore all field boundaries (and "
"so never constrain anything) by binding the variable "
"@code{inhibit-field-text-motion} to a non-@code{nil} value."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4375
#, no-wrap
msgid "Why Text Properties are not Intervals"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4376
#, no-wrap
msgid "intervals"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4384
msgid ""
"Some editors that support adding attributes to text in the buffer do so by "
"letting the user specify intervals within the text, and adding the "
"properties to the intervals. Those editors permit the user or the "
"programmer to determine where individual intervals start and end. We "
"deliberately provided a different sort of interface in Emacs Lisp to avoid "
"certain paradoxical behavior associated with text modification."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4389
msgid ""
"If the actual subdivision into intervals is meaningful, that means you can "
"distinguish between a buffer that is just one interval with a certain "
"property, and a buffer containing the same text subdivided into two "
"intervals, both of which have that property."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4396
msgid ""
"Suppose you take the buffer with just one interval and kill part of the "
"text. The text remaining in the buffer is one interval, and the copy in the "
"kill ring (and the undo list) becomes a separate interval. Then if you yank "
"back the killed text, you get two intervals with the same properties. Thus, "
"editing does not preserve the distinction between one interval and two."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4405
msgid ""
"Suppose we attempt to fix this problem by coalescing the two intervals when "
"the text is inserted. That works fine if the buffer originally was a single "
"interval. But suppose instead that we have two adjacent intervals with the "
"same properties, and we kill the text of one interval and yank it back. The "
"same interval-coalescence feature that rescues the other case causes trouble "
"in this one: after yanking, we have just one interval. Once again, editing "
"does not preserve the distinction between one interval and two."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4408
msgid ""
"Insertion of text at the border between intervals also raises questions that "
"have no satisfactory answer."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4414
msgid ""
"However, it is easy to arrange for editing to behave consistently for "
"questions of the form, ``What are the properties of text at this buffer or "
"string position?'' So we have decided these are the only questions that make "
"sense; we have not implemented asking questions about where intervals start "
"or end."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4419
msgid ""
"In practice, you can usually use the text property search functions in place "
"of explicit interval boundaries. You can think of them as finding the "
"boundaries of intervals, assuming that intervals are always coalesced "
"whenever possible. @xref{Property Search}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4422
msgid ""
"Emacs also provides explicit intervals as a presentation feature; see "
"@ref{Overlays}."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4424
#, no-wrap
msgid "Substituting for a Character Code"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4425
#, no-wrap
msgid "replace characters in region"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4426
#, no-wrap
msgid "substitute characters"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4430
msgid ""
"The following functions replace characters within a specified region based "
"on their character codes."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4431
#, no-wrap
msgid "subst-char-in-region start end old-char new-char &optional noundo"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4432
#, no-wrap
msgid "replace characters"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4437
msgid ""
"This function replaces all occurrences of the character @var{old-char} with "
"the character @var{new-char} in the region of the current buffer defined by "
"@var{start} and @var{end}. Both characters must have the same length of "
"their multibyte form."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4438
#, no-wrap
msgid "undo avoidance"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4443
msgid ""
"If @var{noundo} is non-@code{nil}, then @code{subst-char-in-region} does not "
"record the change for undo and does not mark the buffer as modified. This "
"was useful for controlling the old selective display feature "
"(@pxref{Selective Display})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4446
msgid "@code{subst-char-in-region} does not move point and returns @code{nil}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4452
#, no-wrap
msgid ""
"---------- Buffer: foo ----------\n"
"This is the contents of the buffer before.\n"
"---------- Buffer: foo ----------\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4457
#, no-wrap
msgid ""
"(subst-char-in-region 1 20 ?i ?X)\n"
" @result{} nil\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4461
#, no-wrap
msgid ""
"---------- Buffer: foo ----------\n"
"ThXs Xs the contents of the buffer before.\n"
"---------- Buffer: foo ----------\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4466
#, no-wrap
msgid "subst-char-in-string fromchar tochar string &optional inplace"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4467
#, no-wrap
msgid "replace characters in string"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4473
msgid ""
"This function replaces all occurrences of the character @var{fromchar} with "
"@var{tochar} in @var{string}. By default, substitution occurs in a copy of "
"@var{string}, but if the optional argument @var{inplace} is non-@code{nil}, "
"the function modifies the @var{string} itself. In any case, the function "
"returns the resulting string."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4475
#, no-wrap
msgid "Command translate-region start end table"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4478
msgid ""
"This function applies a translation table to the characters in the buffer "
"between positions @var{start} and @var{end}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4484
msgid ""
"The translation table @var{table} is a string or a char-table; @code{(aref "
"@var{table} @var{ochar})} gives the translated character corresponding to "
"@var{ochar}. If @var{table} is a string, any characters with codes larger "
"than the length of @var{table} are not altered by the translation."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4489
msgid ""
"The return value of @code{translate-region} is the number of characters that "
"were actually changed by the translation. This does not count characters "
"that were mapped into themselves in the translation table."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4493
#, no-wrap
msgid "registers"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4501
msgid ""
"A register is a sort of variable used in Emacs editing that can hold a "
"variety of different kinds of values. Each register is named by a single "
"character. All @acronym{ASCII} characters and their meta variants (but with "
"the exception of @kbd{C-g}) can be used to name registers. Thus, there are "
"255 possible registers. A register is designated in Emacs Lisp by the "
"character that is its name."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4502
#, no-wrap
msgid "register-alist"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4506
msgid ""
"This variable is an alist of elements of the form @code{(@var{name} . "
"@var{contents})}. Normally, there is one element for each Emacs register "
"that has been used."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4509
msgid "The object @var{name} is a character (an integer) identifying the register."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4512
msgid "The @var{contents} of a register can have several possible types:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4514
#, no-wrap
msgid "a number"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4517
msgid ""
"A number stands for itself. If @code{insert-register} finds a number in the "
"register, it converts the number to decimal."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4518
#, no-wrap
msgid "a marker"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4520
msgid "A marker represents a buffer position to jump to."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4521
#, no-wrap
msgid "a string"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4523
msgid "A string is text saved in the register."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4524
#, no-wrap
msgid "a rectangle"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4525
#, no-wrap
msgid "rectangle, as contents of a register"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4527
msgid "A rectangle is represented by a list of strings."
msgstr ""
#. type: code{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4528
#, no-wrap
msgid "(@var{window-configuration} @var{position})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4531
msgid ""
"This represents a window configuration to restore in one frame, and a "
"position to jump to in the current buffer."
msgstr ""
#. type: code{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4533
#, no-wrap
msgid "(@var{frame-configuration} @var{position})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4536
msgid ""
"This represents a frame configuration to restore, and a position to jump to "
"in the current buffer."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4537
#, no-wrap
msgid "(file @var{filename})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4540
msgid ""
"This represents a file to visit; jumping to this value visits file "
"@var{filename}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4541
#, no-wrap
msgid "(file-query @var{filename} @var{position})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4546
msgid ""
"This represents a file to visit and a position in it; jumping to this value "
"visits file @var{filename} and goes to buffer position @var{position}. "
"Restoring this type of position asks the user for confirmation first."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4550
msgid ""
"The functions in this section return unpredictable values unless otherwise "
"stated."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4551
#, no-wrap
msgid "get-register reg"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4554
msgid ""
"This function returns the contents of the register @var{reg}, or @code{nil} "
"if it has no contents."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4556
#, no-wrap
msgid "set-register reg value"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4560
msgid ""
"This function sets the contents of register @var{reg} to @var{value}. A "
"register can be set to any value, but the other register functions expect "
"only certain data types. The return value is @var{value}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4562
#, no-wrap
msgid "Command view-register reg"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4564
msgid "This command displays what is contained in register @var{reg}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4566
#, no-wrap
msgid "Command insert-register reg &optional beforep"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4569
msgid "This command inserts contents of register @var{reg} into the current buffer."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4573
msgid ""
"Normally, this command puts point before the inserted text, and the mark "
"after it. However, if the optional second argument @var{beforep} is "
"non-@code{nil}, it puts the mark before and point after."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4576
msgid ""
"When called interactively, the command defaults to putting point after text, "
"and a prefix argument inverts this behavior."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4580
msgid ""
"If the register contains a rectangle, then the rectangle is inserted with "
"its upper left corner at point. This means that text is inserted in the "
"current line and underneath it on successive lines."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4584
msgid ""
"If the register contains something other than saved text (a string) or a "
"rectangle (a list), currently useless things happen. This may be changed in "
"the future."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4586
#, no-wrap
msgid "register-read-with-preview prompt"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4587
#, no-wrap
msgid "register preview"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4596
msgid ""
"This function reads and returns a register name, prompting with @var{prompt} "
"and possibly showing a preview of the existing registers and their "
"contents. The preview is shown in a temporary window, after the delay "
"specified by the user option @code{register-preview-delay}, if its value and "
"@code{register-alist} are both non-@code{nil}. The preview is also shown if "
"the user requests help (e.g., by typing the help character). We recommend "
"that all interactive commands which read register names use this function."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4599
#, no-wrap
msgid "Transposition of Text"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4602
msgid "This function can be used to transpose stretches of text:"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4603
#, no-wrap
msgid "transpose-regions start1 end1 start2 end2 &optional leave-markers"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4608
msgid ""
"This function exchanges two nonoverlapping portions of the buffer (if they "
"overlap, the function signals an error). Arguments @var{start1} and "
"@var{end1} specify the bounds of one portion and arguments @var{start2} and "
"@var{end2} specify the bounds of the other portion."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4615
msgid ""
"Normally, @code{transpose-regions} relocates markers with the transposed "
"text; a marker previously positioned within one of the two transposed "
"portions moves along with that portion, thus remaining between the same two "
"characters in their new position. However, if @var{leave-markers} is "
"non-@code{nil}, @code{transpose-regions} does not do this---it leaves all "
"markers unrelocated."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4618
#, no-wrap
msgid "Replacing Buffer Text"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4622
msgid ""
"You can use the following function to replace the text of one buffer with "
"the text of another buffer:"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4623
#, no-wrap
msgid "Command replace-buffer-contents source &optional max-secs max-costs"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4630
msgid ""
"This function replaces the accessible portion of the current buffer with the "
"accessible portion of the buffer @var{source}. @var{source} may either be a "
"buffer object or the name of a buffer. When @code{replace-buffer-contents} "
"succeeds, the text of the accessible portion of the current buffer will be "
"equal to the text of the accessible portion of the @var{source} buffer."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4638
msgid ""
"This function attempts to keep point, markers, text properties, and overlays "
"in the current buffer intact. One potential case where this behavior is "
"useful is external code formatting programs: they typically write the "
"reformatted text into a temporary buffer or file, and using "
"@code{delete-region} and @code{insert-buffer-substring} would destroy these "
"properties. However, the latter combination is typically faster "
"(@xref{Deletion}, and @ref{Insertion})."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4645
msgid ""
"For its working, @code{replace-buffer-contents} needs to compare the "
"contents of the original buffer with that of @var{source} which is a costly "
"operation if the buffers are huge and there is a high number of differences "
"between them. In order to keep @code{replace-buffer-contents}'s runtime in "
"bounds, it has two optional arguments."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4649
msgid ""
"@var{max-secs} defines a hard boundary in terms of seconds. If given and "
"exceeded, it will fall back to @code{delete-region} and "
"@code{insert-buffer-substring}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4653
msgid ""
"@var{max-costs} defines the quality of the difference computation. If the "
"actual costs exceed this limit, heuristics are used to provide a faster but "
"suboptimal solution. The default value is 1000000."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4657
msgid ""
"@code{replace-buffer-contents} returns t if a non-destructive replacement "
"could be performed. Otherwise, i.e., if @var{max-secs} was exceeded, it "
"returns nil."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4659
#, no-wrap
msgid "replace-region-contents beg end replace-fn &optional max-secs max-costs"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4664
msgid ""
"This function replaces the region between @var{beg} and @var{end} using the "
"given @var{replace-fn}. The function @var{replace-fn} is run in the current "
"buffer narrowed to the specified region and it should return either a string "
"or a buffer replacing the region."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4668
msgid ""
"The replacement is performed using @code{replace-buffer-contents} (see "
"above) which also describes the @var{max-secs} and @var{max-costs} arguments "
"and the return value."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4674
msgid ""
"Note: If the replacement is a string, it will be placed in a temporary "
"buffer so that @code{replace-buffer-contents} can operate on it. Therefore, "
"if you already have the replacement in a buffer, it makes no sense to "
"convert it to a string using @code{buffer-substring} or similar."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4677
#, no-wrap
msgid "Dealing With Compressed Data"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4683
msgid ""
"When @code{auto-compression-mode} is enabled, Emacs automatically "
"uncompresses compressed files when you visit them, and automatically "
"recompresses them if you alter and save them. @xref{Compressed Files,,, "
"emacs, The GNU Emacs Manual}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4688
msgid ""
"The above feature works by calling an external executable (e.g., "
"@command{gzip}). Emacs can also be compiled with support for built-in "
"decompression using the zlib library, which is faster than calling an "
"external program."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4689
#, no-wrap
msgid "zlib-available-p"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4692
msgid ""
"This function returns non-@code{nil} if built-in zlib decompression is "
"available."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4694
#, no-wrap
msgid "zlib-decompress-region start end &optional allow-partial"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4705
msgid ""
"This function decompresses the region between @var{start} and @var{end}, "
"using built-in zlib decompression. The region should contain data that were "
"compressed with gzip or zlib. On success, the function replaces the "
"contents of the region with the decompressed data. If @var{allow-partial} "
"is @code{nil} or omitted, then on failure, the function leaves the region "
"unchanged and returns @code{nil}. Otherwise, it returns the number of bytes "
"that were not decompressed and replaces the region text by whatever data was "
"successfully decompressed. This function can be called only in unibyte "
"buffers."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4709
#, no-wrap
msgid "Base 64 Encoding"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4710
#, no-wrap
msgid "base 64 encoding"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4722
msgid ""
"Base 64 code is used in email to encode a sequence of 8-bit bytes as a "
"longer sequence of @acronym{ASCII} graphic characters. It is defined in "
"Internet RFC@footnote{ An RFC, an acronym for @dfn{Request for Comments}, is "
"a numbered Internet informational document describing a standard. RFCs are "
"usually written by technical experts acting on their own initiative, and are "
"traditionally written in a pragmatic, experience-driven manner. }2045 and "
"also in RFC 4648. This section describes the functions for converting to "
"and from this code."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4723
#, no-wrap
msgid "Command base64-encode-region beg end &optional no-line-break"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4730
msgid ""
"This function converts the region from @var{beg} to @var{end} into base 64 "
"code. It returns the length of the encoded text. An error is signaled if a "
"character in the region is multibyte, i.e., in a multibyte buffer the region "
"must contain only characters from the charsets @code{ascii}, "
"@code{eight-bit-control} and @code{eight-bit-graphic}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4735
msgid ""
"Normally, this function inserts newline characters into the encoded text, to "
"avoid overlong lines. However, if the optional argument @var{no-line-break} "
"is non-@code{nil}, these newlines are not added, so the output is just one "
"long line."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4737
#, no-wrap
msgid "Command base64url-encode-region beg end &optional no-pad"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4742
msgid ""
"This function is like @code{base64-encode-region}, but it implements the URL "
"variant of base 64 encoding, per RFC 4648, and it doesn't insert newline "
"characters into the encoded text, so the output is just one long line."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4745
msgid ""
"If the optional argument @var{no-pad} is non-@code{nil} then this function "
"doesn't generate the padding (@code{=})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4747
#, no-wrap
msgid "base64-encode-string string &optional no-line-break"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4752
msgid ""
"This function converts the string @var{string} into base 64 code. It "
"returns a string containing the encoded text. As for "
"@code{base64-encode-region}, an error is signaled if a character in the "
"string is multibyte."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4757
msgid ""
"Normally, this function inserts newline characters into the encoded text, to "
"avoid overlong lines. However, if the optional argument @var{no-line-break} "
"is non-@code{nil}, these newlines are not added, so the result string is "
"just one long line."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4759
#, no-wrap
msgid "base64url-encode-string string &optional no-pad"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4763
msgid ""
"Like @code{base64-encode-string}, but generates the URL variant of base 64, "
"and doesn't insert newline characters into the encoded text, so the result "
"is just one long line."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4766
msgid ""
"If the optional argument @var{no-pad} is non-@code{nil} then this function "
"doesn't generate the padding."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4768
#, no-wrap
msgid "Command base64-decode-region beg end &optional base64url"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4772
msgid ""
"This function converts the region from @var{beg} to @var{end} from base 64 "
"code into the corresponding decoded text. It returns the length of the "
"decoded text."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4774
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4785
msgid "The decoding functions ignore newline characters in the encoded text."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4777
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4789
msgid ""
"If optional argument @var{base64url} is non-@code{nil}, then padding is "
"optional, and the URL variant of base 64 encoding is used."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4779
#, no-wrap
msgid "base64-decode-string string &optional base64url"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4783
msgid ""
"This function converts the string @var{string} from base 64 code into the "
"corresponding decoded text. It returns a unibyte string containing the "
"decoded text."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4793
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4880
#, no-wrap
msgid "MD5 checksum"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4794
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4881
#, no-wrap
msgid "SHA hash"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4795
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4882
#, no-wrap
msgid "hash, cryptographic"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4796
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4883
#, no-wrap
msgid "cryptographic hash"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4802
msgid ""
"Emacs has built-in support for computing @dfn{cryptographic hashes}. A "
"cryptographic hash, or @dfn{checksum}, is a digital fingerprint of a piece "
"of data (e.g., a block of text) which can be used to check that you have an "
"unaltered copy of that data."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4803
#, no-wrap
msgid "message digest"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4814
msgid ""
"Emacs supports several common cryptographic hash algorithms: MD5, SHA-1, "
"SHA-2, SHA-224, SHA-256, SHA-384 and SHA-512. MD5 is the oldest of these "
"algorithms, and is commonly used in @dfn{message digests} to check the "
"integrity of messages transmitted over a network. MD5 and SHA-1 are not "
"collision resistant (i.e., it is possible to deliberately design different "
"pieces of data which have the same MD5 or SHA-1 hash), so you should not use "
"them for anything security-related. For security-related applications you "
"should use the other hash types, such as SHA-2 (e.g. @code{sha256} or "
"@code{sha512})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4815
#, no-wrap
msgid "secure-hash-algorithms"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4818
msgid ""
"This function returns a list of symbols representing algorithms that "
"@code{secure-hash} can use."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4820
#, no-wrap
msgid "secure-hash algorithm object &optional start end binary"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4826
msgid ""
"This function returns a hash for @var{object}. The argument @var{algorithm} "
"is a symbol stating which hash to compute: one of @code{md5}, @code{sha1}, "
"@code{sha224}, @code{sha256}, @code{sha384} or @code{sha512}. The argument "
"@var{object} should be a buffer or a string."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4831
msgid ""
"The optional arguments @var{start} and @var{end} are character positions "
"specifying the portion of @var{object} to compute the message digest for. "
"If they are @code{nil} or omitted, the hash is computed for the whole of "
"@var{object}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4836
msgid ""
"If the argument @var{binary} is omitted or @code{nil}, the function returns "
"the @dfn{text form} of the hash, as an ordinary Lisp string. If "
"@var{binary} is non-@code{nil}, it returns the hash in @dfn{binary form}, as "
"a sequence of bytes stored in a unibyte string."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4845
msgid ""
"This function does not compute the hash directly from the internal "
"representation of @var{object}'s text (@pxref{Text Representations}). "
"Instead, it encodes the text using a coding system (@pxref{Coding Systems}), "
"and computes the hash from that encoded text. If @var{object} is a buffer, "
"the coding system used is the one which would be chosen by default for "
"writing the text into a file. If @var{object} is a string, the user's "
"preferred coding system is used (@pxref{Recognize Coding,,, emacs, GNU Emacs "
"Manual})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4847
#, no-wrap
msgid "md5 object &optional start end coding-system noerror"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4853
msgid ""
"This function returns an MD5 hash. It is semi-obsolete, since for most "
"purposes it is equivalent to calling @code{secure-hash} with @code{md5} as "
"the @var{algorithm} argument. The @var{object}, @var{start} and @var{end} "
"arguments have the same meanings as in @code{secure-hash}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4857
msgid ""
"If @var{coding-system} is non-@code{nil}, it specifies a coding system to "
"use to encode the text; if omitted or @code{nil}, the default coding system "
"is used, like in @code{secure-hash}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4862
msgid ""
"Normally, @code{md5} signals an error if the text can't be encoded using the "
"specified or chosen coding system. However, if @var{noerror} is "
"non-@code{nil}, it silently uses @code{raw-text} coding instead."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4864
#, no-wrap
msgid "buffer-hash &optional buffer-or-name"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4876
msgid ""
"Return a hash of @var{buffer-or-name}. If @code{nil}, this defaults to the "
"current buffer. As opposed to @code{secure-hash}, this function computes "
"the hash based on the internal representation of the buffer, disregarding "
"any coding systems. It's therefore only useful when comparing two buffers "
"running in the same Emacs, and is not guaranteed to return the same hash "
"between different Emacs versions. It should be somewhat more efficient on "
"larger buffers than @code{secure-hash} is, and should not allocate more "
"memory."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4884
#, no-wrap
msgid "AEAD cipher"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4885
#, no-wrap
msgid "cipher, AEAD"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4886
#, no-wrap
msgid "symmetric cipher"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4887
#, no-wrap
msgid "cipher, symmetric"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4892
msgid ""
"If compiled with GnuTLS, Emacs offers built-in cryptographic support. "
"Following the GnuTLS API terminology, the available tools are digests, MACs, "
"symmetric ciphers, and AEAD ciphers."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4898
msgid ""
"The terms used herein, such as IV (Initialization Vector), require some "
"familiarity with cryptography and will not be defined in detail. Please "
"consult @uref{https://www.gnutls.org/} for specific documentation which may "
"help you understand the terminology and structure of the GnuTLS library."
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4902
msgid "Format of GnuTLS Cryptography Inputs::"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4902
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4942
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4943
#, no-wrap
msgid "GnuTLS Cryptographic Functions"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4904
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4905
#, no-wrap
msgid "Format of GnuTLS Cryptography Inputs"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4906
#, no-wrap
msgid "format of gnutls cryptography inputs"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4907
#, no-wrap
msgid "gnutls cryptography inputs format"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4911
msgid ""
"The inputs to GnuTLS cryptographic functions can be specified in several "
"ways, both as primitive Emacs Lisp types or as lists."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4914
msgid ""
"The list form is currently similar to how @code{md5} and @code{secure-hash} "
"operate."
msgstr ""
#. type: var{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4916
#, no-wrap
msgid "buffer"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4918
msgid "Simply passing a buffer as input means the whole buffer should be used."
msgstr ""
#. type: var{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4919
#, no-wrap
msgid "string"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4923
msgid ""
"A string as input will be used directly. It may be modified by the function "
"(unlike most other Emacs Lisp functions) to reduce the chance of exposing "
"sensitive data after the function does its work."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4924
#, no-wrap
msgid ""
"(@var{buffer-or-string} @var{start} @var{end} @var{coding-system} "
"@var{noerror})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4927
msgid ""
"This specifies a buffer or a string as described above, but an optional "
"range can be specified with @var{start} and @var{end}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4929
msgid "In addition an optional @var{coding-system} can be specified if needed."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4934
msgid ""
"The last optional item, @var{noerror}, overrides the normal error when the "
"text can't be encoded using the specified or chosen coding system. When "
"@var{noerror} is non-@code{nil}, this function silently uses @code{raw-text} "
"coding instead."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4935
#, no-wrap
msgid "(@code{iv-auto} @var{length})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4939
msgid ""
"This generates a random IV (Initialization Vector) of the specified length "
"and passes it to the function. This ensures that the IV is unpredictable "
"and unlikely to be reused in the same session."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4944
#, no-wrap
msgid "gnutls cryptographic functions"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4946
#, no-wrap
msgid "gnutls-digests"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4948
msgid "This function returns the alist of the GnuTLS digest algorithms."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4954
msgid ""
"Each entry has a key which represents the algorithm, followed by a plist "
"with internal details about the algorithm. The plist will have @code{:type "
"gnutls-digest-algorithm} and also will have the key "
"@code{:digest-algorithm-length 64} to indicate the size, in bytes, of the "
"resulting digest."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4957
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4986
msgid ""
"There is a name parallel between GnuTLS MAC and digest algorithms but they "
"are separate things internally and should not be mixed."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4959
#, no-wrap
msgid "gnutls-hash-digest digest-method input"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4963
msgid ""
"The @var{digest-method} can be the whole plist from @code{gnutls-digests}, "
"or just the symbol key, or a string with the name of that symbol."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4966
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4999
msgid ""
"The @var{input} can be specified as a buffer or string or in other ways "
"(@pxref{Format of GnuTLS Cryptography Inputs})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4970
msgid ""
"This function returns @code{nil} on error, and signals a Lisp error if the "
"@var{digest-method} or @var{input} are invalid. On success, it returns a "
"list of a binary string (the output) and the IV used."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4972
#, no-wrap
msgid "gnutls-macs"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4974
msgid "This function returns the alist of the GnuTLS MAC algorithms."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4981
msgid ""
"Each entry has a key which represents the algorithm, followed by a plist "
"with internal details about the algorithm. The plist will have @code{:type "
"gnutls-mac-algorithm} and also will have the keys "
"@code{:mac-algorithm-length} @code{:mac-algorithm-keysize} "
"@code{:mac-algorithm-noncesize} to indicate the size, in bytes, of the "
"resulting hash, the key, and the nonce respectively."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4983
msgid "The nonce is currently unused and only some MACs support it."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4988
#, no-wrap
msgid "gnutls-hash-mac hash-method key input"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4992
msgid ""
"The @var{hash-method} can be the whole plist from @code{gnutls-macs}, or "
"just the symbol key, or a string with the name of that symbol."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:4996
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5028
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5053
msgid ""
"The @var{key} can be specified as a buffer or string or in other ways "
"(@pxref{Format of GnuTLS Cryptography Inputs}). The @var{key} will be wiped "
"after use if it's a string."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5002
msgid ""
"This function returns @code{nil} on error, and signals a Lisp error if the "
"@var{hash-method} or @var{key} or @var{input} are invalid."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5005
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5043
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5068
msgid ""
"On success, it returns a list of a binary string (the output) and the IV "
"used."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5007
#, no-wrap
msgid "gnutls-ciphers"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5009
msgid "This function returns the alist of the GnuTLS ciphers."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5018
msgid ""
"Each entry has a key which represents the cipher, followed by a plist with "
"internal details about the algorithm. The plist will have @code{:type "
"gnutls-symmetric-cipher} and also will have the keys "
"@code{:cipher-aead-capable} set to @code{nil} or @code{t} to indicate AEAD "
"capability; and @code{:cipher-tagsize} @code{:cipher-blocksize} "
"@code{:cipher-keysize} @code{:cipher-ivsize} to indicate the size, in bytes, "
"of the tag, block size of the resulting data, the key, and the IV "
"respectively."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5020
#, no-wrap
msgid "gnutls-symmetric-encrypt cipher key iv input &optional aead_auth"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5024
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5049
msgid ""
"The @var{cipher} can be the whole plist from @code{gnutls-ciphers}, or just "
"the symbol key, or a string with the name of that symbol."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5032
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5057
msgid ""
"The @var{iv} and @var{input} and the optional @var{aead_auth} can be "
"specified as a buffer or string or in other ways (@pxref{Format of GnuTLS "
"Cryptography Inputs})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5035
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5060
msgid ""
"@var{aead_auth} is only checked with AEAD ciphers, that is, ciphers whose "
"plist has @code{:cipher-aead-capable t}. Otherwise it's ignored."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5040
msgid ""
"This function returns @code{nil} on error, and signals a Lisp error if the "
"@var{cipher} or @var{key}, @var{iv}, or @var{input} are invalid, or if "
"@var{aead_auth} was specified with an AEAD cipher and was invalid."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5045
#, no-wrap
msgid "gnutls-symmetric-decrypt cipher key iv input &optional aead_auth"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5065
msgid ""
"This function returns @code{nil} on decryption error, and signals a Lisp "
"error if the @var{cipher} or @var{key}, @var{iv}, or @var{input} are "
"invalid, or if @var{aead_auth} was specified with an AEAD cipher and was "
"invalid."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5071
#, no-wrap
msgid "Parsing HTML and XML"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5072
#, no-wrap
msgid "parsing html"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5075
msgid "Emacs can be compiled with built-in libxml2 support."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5076
#, no-wrap
msgid "libxml-available-p"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5079
msgid ""
"This function returns non-@code{nil} if built-in libxml2 support is "
"available in this Emacs session."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5083
msgid ""
"When libxml2 support is available, the following functions can be used to "
"parse HTML or XML text into Lisp object trees."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5084
#, no-wrap
msgid "libxml-parse-html-region start end &optional base-url discard-comments"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5089
msgid ""
"This function parses the text between @var{start} and @var{end} as HTML, and "
"returns a list representing the HTML @dfn{parse tree}. It attempts to "
"handle real-world HTML by robustly coping with syntax mistakes."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5092
msgid ""
"The optional argument @var{base-url}, if non-@code{nil}, should be a string "
"specifying the base URL for relative URLs occurring in links."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5098
msgid ""
"If the optional argument @var{discard-comments} is non-@code{nil}, any "
"top-level comment is discarded. (This argument is obsolete and will be "
"removed in future Emacs versions. To remove comments, use the "
"@code{xml-remove-comments} utility function on the data before you call the "
"parsing function.)"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5103
msgid ""
"In the parse tree, each HTML node is represented by a list in which the "
"first element is a symbol representing the node name, the second element is "
"an alist of node attributes, and the remaining elements are the subnodes."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5106
msgid ""
"The following example demonstrates this. Given this (malformed) HTML "
"document:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5109
#, no-wrap
msgid "<html><head></head><body width=101><div class=thing>Foo<div>Yes\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5114
msgid ""
"A call to @code{libxml-parse-html-region} returns this @acronym{DOM} "
"(document object model):"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5123
#, no-wrap
msgid ""
"(html nil\n"
" (head nil)\n"
" (body ((width . \"101\"))\n"
" (div ((class . \"thing\"))\n"
" \"Foo\"\n"
" (div nil\n"
" \"Yes\"))))\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5126
#, no-wrap
msgid "rendering html"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5127
#, no-wrap
msgid "shr-insert-document dom"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5132
msgid ""
"This function renders the parsed HTML in @var{dom} into the current buffer. "
"The argument @var{dom} should be a list as generated by "
"@code{libxml-parse-html-region}. This function is, e.g., used by @ref{Top, "
"EWW,, eww, The Emacs Web Wowser Manual}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5134
#, no-wrap
msgid "parsing xml"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5135
#, no-wrap
msgid "libxml-parse-xml-region start end &optional base-url discard-comments"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5139
msgid ""
"This function is the same as @code{libxml-parse-html-region}, except that it "
"parses the text as XML rather than HTML (so it is stricter about syntax)."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5143
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5145
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5146
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5150
#, no-wrap
msgid "Document Object Model"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5143
msgid "Access, manipulate and search the @acronym{DOM}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5147
#, no-wrap
msgid "HTML DOM"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5148
#, no-wrap
msgid "XML DOM"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5149
#, no-wrap
msgid "DOM"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5157
msgid ""
"The @acronym{DOM} returned by @code{libxml-parse-html-region} (and the other "
"@acronym{XML} parsing functions) is a tree structure where each node has a "
"node name (called a @dfn{tag}), and optional key/value @dfn{attribute} list, "
"and then a list of @dfn{child nodes}. The child nodes are either strings or "
"@acronym{DOM} objects."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5164
#, no-wrap
msgid ""
"(body ((width . \"101\"))\n"
" (div ((class . \"thing\"))\n"
" \"Foo\"\n"
" (div nil\n"
" \"Yes\")))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5166
#, no-wrap
msgid "dom-node tag &optional attributes &rest children"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5170
msgid ""
"This function creates a @acronym{DOM} node of type @var{tag}. If given, "
"@var{attributes} should be a key/value pair list. If given, @var{children} "
"should be @acronym{DOM} nodes."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5175
msgid ""
"The following functions can be used to work with this structure. Each "
"function takes a @acronym{DOM} node, or a list of nodes. In the latter "
"case, only the first node in the list is used."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5177
msgid "Simple accessors:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5179
#, no-wrap
msgid "dom-tag @var{node}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5181
msgid "Return the @dfn{tag} (also called ``node name'') of the node."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5182
#, no-wrap
msgid "dom-attr @var{node} @var{attribute}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5185
msgid "Return the value of @var{attribute} in the node. A common usage would be:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5189
#, no-wrap
msgid ""
"(dom-attr img 'href)\n"
"=> \"https://fsf.org/logo.png\"\n"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5191
#, no-wrap
msgid "dom-children @var{node}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5193
msgid "Return all the children of the node."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5194
#, no-wrap
msgid "dom-non-text-children @var{node}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5196
msgid "Return all the non-string children of the node."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5197
#, no-wrap
msgid "dom-attributes @var{node}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5199
msgid "Return the key/value pair list of attributes of the node."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5200
#, no-wrap
msgid "dom-text @var{node}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5202
msgid "Return all the textual elements of the node as a concatenated string."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5203
#, no-wrap
msgid "dom-texts @var{node}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5208
msgid ""
"Return all the textual elements of the node, as well as the textual elements "
"of all the children of the node, recursively, as a concatenated string. "
"This function also takes an optional separator to be inserted between the "
"textual elements."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5209
#, no-wrap
msgid "dom-parent @var{dom} @var{node}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5211
msgid "Return the parent of @var{node} in @var{dom}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5212
#, no-wrap
msgid "dom-remove @var{dom} @var{node}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5214
msgid "Remove @var{node} from @var{dom}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5217
msgid "The following are functions for altering the @acronym{DOM}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5219
#, no-wrap
msgid "dom-set-attribute @var{node} @var{attribute} @var{value}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5221
msgid "Set the @var{attribute} of the node to @var{value}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5222
#, no-wrap
msgid "dom-remove-attribute @var{node} @var{attribute}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5224
msgid "Remove @var{attribute} from @var{node}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5225
#, no-wrap
msgid "dom-append-child @var{node} @var{child}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5227
msgid "Append @var{child} as the last child of @var{node}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5228
#, no-wrap
msgid "dom-add-child-before @var{node} @var{child} @var{before}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5231
msgid ""
"Add @var{child} to @var{node}'s child list before the @var{before} node. If "
"@var{before} is @code{nil}, make @var{child} the first child."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5232
#, no-wrap
msgid "dom-set-attributes @var{node} @var{attributes}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5234
msgid "Replace all the attributes of the node with a new key/value list."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5238
msgid ""
"The following are functions for searching for elements in the "
"@acronym{DOM}. They all return lists of matching nodes."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5240
#, no-wrap
msgid "dom-by-tag @var{dom} @var{tag}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5243
msgid ""
"Return all nodes in @var{dom} that are of type @var{tag}. A typical use "
"would be:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5247
#, no-wrap
msgid ""
"(dom-by-tag dom 'td)\n"
"=> '((td ...) (td ...) (td ...))\n"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5249
#, no-wrap
msgid "dom-by-class @var{dom} @var{match}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5252
msgid ""
"Return all nodes in @var{dom} that have class names that match @var{match}, "
"which is a regular expression."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5253
#, no-wrap
msgid "dom-by-style @var{dom} @var{style}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5256
msgid ""
"Return all nodes in @var{dom} that have styles that match @var{match}, which "
"is a regular expression."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5257
#, no-wrap
msgid "dom-by-id @var{dom} @var{style}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5260
msgid ""
"Return all nodes in @var{dom} that have IDs that match @var{match}, which is "
"a regular expression."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5261
#, no-wrap
msgid "dom-search @var{dom} @var{predicate}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5265
msgid ""
"Return all nodes in @var{dom} where @var{predicate} returns a non-@code{nil} "
"value. @var{predicate} is called with the node to be tested as its "
"parameter."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5266
#, no-wrap
msgid "dom-strings @var{dom}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5268
msgid "Return all strings in @var{dom}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5272
msgid "Utility functions:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5274
#, no-wrap
msgid "dom-pp @var{dom} &optional @var{remove-empty}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5277
msgid ""
"Pretty-print @var{dom} at point. If @var{remove-empty}, don't print textual "
"nodes that just contain white-space."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5278
#, no-wrap
msgid "dom-print @var{dom} &optional @var{pretty} @var{xml}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5282
msgid ""
"Print @var{dom} at point. If @var{xml} is non-@code{nil}, print as "
"@acronym{XML}; otherwise, print as @acronym{HTML}. If @var{pretty} is "
"non-@code{nil}, indent the @acronym{HTML}/@acronym{XML} logically."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5286
#, no-wrap
msgid "Parsing and generating JSON values"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5287
#, no-wrap
msgid "JSON"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5288
#, no-wrap
msgid "JavaScript Object Notation"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5294
msgid ""
"When Emacs is compiled with @acronym{JSON} (@dfn{JavaScript Object "
"Notation}) support, it provides several functions to convert between Lisp "
"objects and JSON values. Any JSON value can be converted to a Lisp object, "
"but not vice versa. Specifically:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5301
msgid ""
"JSON uses three keywords: @code{true}, @code{null}, @code{false}. "
"@code{true} is represented by the symbol @code{t}. By default, the "
"remaining two are represented, respectively, by the symbols @code{:null} and "
"@code{:false}."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5305
msgid ""
"JSON only has floating-point numbers. They can represent both Lisp integers "
"and Lisp floating-point numbers."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5309
msgid ""
"JSON strings are always Unicode strings encoded in UTF-8. Lisp strings can "
"contain non-Unicode characters."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5313
msgid ""
"JSON has only one sequence type, the array. JSON arrays are represented "
"using Lisp vectors."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5320
msgid ""
"JSON has only one map type, the object. JSON objects are represented using "
"Lisp hashtables, alists or plists. When an alist or plist contains several "
"elements with the same key, Emacs uses only the first element for "
"serialization, in accordance with the behavior of @code{assq}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5327
msgid ""
"Note that @code{nil}, being both a valid alist and a valid plist, represents "
"@code{@{@}}, the empty JSON object; not @code{null}, @code{false}, or an "
"empty array, all of which are different JSON values."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5328
#, no-wrap
msgid "json-available-p"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5332
msgid ""
"This predicate returns non-@code{nil} if Emacs has been built with "
"@acronym{JSON} support, and the library is available on the current system."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5337
msgid ""
"If some Lisp object can't be represented in JSON, the serialization "
"functions will signal an error of type @code{wrong-type-argument}. The "
"parsing functions can also signal the following errors:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5339
#, no-wrap
msgid "json-unavailable"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5341
msgid "Signaled when the parsing library isn't available."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5342
#, no-wrap
msgid "json-end-of-file"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5344
msgid "Signaled when encountering a premature end of the input text."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5345
#, no-wrap
msgid "json-trailing-content"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5348
msgid ""
"Signaled when encountering unexpected input after the first JSON object "
"parsed."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5349
#, no-wrap
msgid "json-parse-error"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5351
msgid "Signaled when encountering invalid JSON syntax."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5356
msgid ""
"Top-level values and the subobjects within these top-level values can be "
"serialized to JSON@. Likewise, the parsing functions will return any of the "
"possible types described above."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5357
#, no-wrap
msgid "json-serialize object &rest args"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5361
msgid ""
"This function returns a new Lisp string which contains the JSON "
"representation of @var{object}. The argument @var{args} is a list of "
"keyword/argument pairs. The following keywords are accepted:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5363
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5401
#, no-wrap
msgid ":null-object"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5366
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5404
msgid ""
"The value decides which Lisp object to use to represent the JSON keyword "
"@code{null}. It defaults to the symbol @code{:null}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5367
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5405
#, no-wrap
msgid ":false-object"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5370
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5408
msgid ""
"The value decides which Lisp object to use to represent the JSON keyword "
"@code{false}. It defaults to the symbol @code{:false}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5374
#, no-wrap
msgid "json-insert object &rest args"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5378
msgid ""
"This function inserts the JSON representation of @var{object} into the "
"current buffer before point. The argument @var{args} are interpreted as in "
"@code{json-parse-string}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5380
#, no-wrap
msgid "json-parse-string string &rest args"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5384
msgid ""
"This function parses the JSON value in @var{string}, which must be a Lisp "
"string. If @var{string} doesn't contain a valid JSON object, this function "
"signals the @code{json-parse-error} error."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5387
msgid ""
"The argument @var{args} is a list of keyword/argument pairs. The following "
"keywords are accepted:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5389
#, no-wrap
msgid ":object-type"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5395
msgid ""
"The value decides which Lisp object to use for representing the key-value "
"mappings of a JSON object. It can be either @code{hash-table}, the default, "
"to make hashtables with strings as keys; @code{alist} to use alists with "
"symbols as keys; or @code{plist} to use plists with keyword symbols as keys."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5396
#, no-wrap
msgid ":array-type"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5400
msgid ""
"The value decides which Lisp object to use for representing a JSON array. "
"It can be either @code{array}, the default, to use Lisp arrays; or "
"@code{list} to use lists."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5412
#, no-wrap
msgid "json-parse-buffer &rest args"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5418
msgid ""
"This function reads the next JSON value from the current buffer, starting at "
"point. It moves point to the position immediately after the value if "
"contains a valid JSON object; otherwise it signals the "
"@code{json-parse-error} error and doesn't move point. The arguments "
"@var{args} are interpreted as in @code{json-parse-string}."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5421
#, no-wrap
msgid "JSONRPC communication"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5422
#, no-wrap
msgid "JSON remote procedure call protocol"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5431
msgid ""
"The @code{jsonrpc} library implements the @acronym{JSONRPC} specification, "
"version 2.0, as it is described in @uref{https://www.jsonrpc.org/}. As the "
"name suggests, JSONRPC is a generic @dfn{Remote Procedure Call} protocol "
"designed around @acronym{JSON} objects, which you can convert to and from "
"Lisp objects (@pxref{Parsing JSON})."
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5437
msgid "JSONRPC Overview::"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5437
msgid "Process-based JSONRPC connections::"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5437
msgid "JSONRPC JSON object format::"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5437
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5600
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5602
#, no-wrap
msgid "JSONRPC deferred requests"
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5439
#, no-wrap
msgid "JSONRPC Overview"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5440
#, no-wrap
msgid "Overview"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5446
msgid ""
"Quoting from the @uref{https://www.jsonrpc.org/, spec}, JSONRPC \"is "
"transport agnostic in that the concepts can be used within the same process, "
"over sockets, over http, or in many various message passing environments.\""
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5447
#, no-wrap
msgid "jsonrpc-connection"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5456
msgid ""
"To model this agnosticism, the @code{jsonrpc} library uses objects of a "
"@code{jsonrpc-connection} class, which represent a connection to a remote "
"JSON endpoint (for details on Emacs's object system, "
"@pxref{Top,EIEIO,,eieio,EIEIO}). In modern object-oriented parlance, this "
"class is ``abstract'', i.e.@: the actual class of a useful connection object "
"is always a subclass of @code{jsonrpc-connection}. Nevertheless, we can "
"define two distinct APIs around the @code{jsonrpc-connection} class:"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5457
#, no-wrap
msgid "JSONRPC application interfaces"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5460
#, no-wrap
msgid "A user interface for building JSONRPC applications"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5462
#, no-wrap
msgid ":request-dispatcher"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5463
#, no-wrap
msgid ":notification-dispatcher"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5464
#, no-wrap
msgid "jsonrpc-notify"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5465
#, no-wrap
msgid "jsonrpc-request"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5466
#, no-wrap
msgid "jsonrpc-async-request"
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5478
msgid ""
"In this scenario, the JSONRPC application selects a concrete subclass of "
"@code{jsonrpc-connection}, and proceeds to create objects of that subclass "
"using @code{make-instance}. To initiate a contact to the remote endpoint, "
"the JSONRPC application passes this object to the functions "
"@code{jsonrpc-notify}, @code{jsonrpc-request}, and/or "
"@code{jsonrpc-async-request}. For handling remotely initiated contacts, "
"which generally come in asynchronously, the instantiation should include "
"@code{:request-dispatcher} and @code{:notification-dispatcher} initargs, "
"which are both functions of 3 arguments: the connection object; a symbol "
"naming the JSONRPC method invoked remotely; and a JSONRPC @code{params} "
"object."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5479
#, no-wrap
msgid "jsonrpc-error"
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5495
msgid ""
"The function passed as @code{:request-dispatcher} is responsible for "
"handling the remote endpoint's requests, which expect a reply from the local "
"endpoint (in this case, the program you're building). Inside that function, "
"you may either return locally (a normal return) or non-locally (an error "
"return). A local return value must be a Lisp object that can be serialized "
"as JSON (@pxref{Parsing JSON}). This determines a success response, and the "
"object is forwarded to the server as the JSONRPC @code{result} object. A "
"non-local return, achieved by calling the function @code{jsonrpc-error}, "
"causes an error response to be sent to the server. The details of the "
"accompanying JSONRPC @code{error} are filled out with whatever was passed to "
"@code{jsonrpc-error}. A non-local return triggered by an unexpected error "
"of any other type also causes an error response to be sent (unless you have "
"set @code{debug-on-error}, in which case this calls the Lisp debugger, "
"@pxref{Error Debugging})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5496
#, no-wrap
msgid "A inheritance interface for building JSONRPC transport implementations"
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5504
msgid ""
"In this scenario, @code{jsonrpc-connection} is subclassed to implement a "
"different underlying transport strategy (for details on how to subclass, see "
"@ref{Inheritance,Inheritance,,eieio}.). Users of the application-building "
"interface can then instantiate objects of this concrete class (using the "
"@code{make-instance} function) and connect to JSONRPC endpoints using that "
"strategy."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5506
msgid "This API has mandatory and optional parts."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5507
#, no-wrap
msgid "jsonrpc-connection-send"
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5511
msgid ""
"To allow its users to initiate JSONRPC contacts (notifications or requests) "
"or reply to endpoint requests, the subclass must have an implementation of "
"the @code{jsonrpc-connection-send} method."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5512
#, no-wrap
msgid "jsonrpc-connection-receive"
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5518
msgid ""
"Likewise, for handling the three types of remote contacts (requests, "
"notifications, and responses to local requests), the transport "
"implementation must arrange for the function "
"@code{jsonrpc-connection-receive} to be called after noticing a new JSONRPC "
"message on the wire (whatever that \"wire\" may be)."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5519
#, no-wrap
msgid "jsonrpc-shutdown"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5520
#, no-wrap
msgid "jsonrpc-running-p"
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5528
msgid ""
"Finally, and optionally, the @code{jsonrpc-connection} subclass should "
"implement the @code{jsonrpc-shutdown} and @code{jsonrpc-running-p} methods "
"if these concepts apply to the transport. If they do, then any system "
"resources (e.g.@: processes, timers, etc.) used to listen for messages on "
"the wire should be released in @code{jsonrpc-shutdown}, i.e.@: they should "
"only be needed while @code{jsonrpc-running-p} is non-nil."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5531
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5532
#, no-wrap
msgid "Process-based JSONRPC connections"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5533
#, no-wrap
msgid "JSONRPC process-based connections"
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5535
#, no-wrap
msgid "jsonrpc-process-connection"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5541
msgid ""
"For convenience, the @code{jsonrpc} library comes with a built-in "
"@code{jsonrpc-process-connection} transport implementation that can talk to "
"local subprocesses (using the standard input and standard output); or TCP "
"hosts (using sockets); or any other remote endpoint that Emacs's process "
"object can represent (@pxref{Processes})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5545
msgid ""
"Using this transport, the JSONRPC messages are encoded on the wire as plain "
"text and prefaced by some basic HTTP-style enveloping headers, such as "
"``Content-Length''."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5550
msgid ""
"For an example of an application using this transport scheme on top of "
"JSONRPC, see the "
"@uref{https://microsoft.github.io/language-server-protocol/specification, "
"Language Server Protocol}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5551
#, no-wrap
msgid "JSONRPC connection initargs"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5556
msgid ""
"Along with the mandatory @code{:request-dispatcher} and "
"@code{:notification-dispatcher} initargs, users of the "
"@code{jsonrpc-process-connection} class should pass the following initargs "
"as keyword-value pairs to @code{make-instance}:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5558
#, no-wrap
msgid ":process"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5563
msgid ""
"Value must be a live process object or a function of no arguments producing "
"one such object. If passed a process object, the object is expected to "
"contain a pre-established connection; otherwise, the function is called "
"immediately after the object is made."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5564
#, no-wrap
msgid ":on-shutdown"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5570
msgid ""
"Value must be a function of a single argument, the "
"@code{jsonrpc-process-connection} object. The function is called after the "
"underlying process object has been deleted (either deliberately by "
"@code{jsonrpc-shutdown}, or unexpectedly, because of some external cause)."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5572
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5573
#, no-wrap
msgid "JSONRPC JSON object format"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5574
#, no-wrap
msgid "JSONRPC object format"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5581
msgid ""
"JSONRPC JSON objects are exchanged as Lisp plists (@pxref{Property Lists}): "
"JSON-compatible plists are handed to the dispatcher functions and, likewise, "
"JSON-compatible plists should be given to @code{jsonrpc-notify}, "
"@code{jsonrpc-request}, and @code{jsonrpc-async-request}."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5582
#, no-wrap
msgid "jsonrpc-lambda"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5588
msgid ""
"To facilitate handling plists, this library makes liberal use of "
"@code{cl-lib} library (@pxref{Top,cl-lib,,cl,Common Lisp Extensions for GNU "
"Emacs Lisp}) and suggests (but doesn't force) its clients to do the same. A "
"macro @code{jsonrpc-lambda} can be used to create a lambda for destructuring "
"a JSON-object like in this example:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5598
#, no-wrap
msgid ""
"(jsonrpc-async-request\n"
" myproc :frobnicate `(:foo \"trix\")\n"
" :success-fn (jsonrpc-lambda (&key bar baz &allow-other-keys)\n"
" (message \"Server replied back with %s and %s!\"\n"
" bar baz))\n"
" :error-fn (jsonrpc-lambda (&key code message _data)\n"
" (message \"Sadly, server reports %s: %s\"\n"
" code message)))\n"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5601
#, no-wrap
msgid "Deferred JSONRPC requests"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5613
msgid ""
"In many @acronym{RPC} situations, synchronization between the two "
"communicating endpoints is a matter of correctly designing the RPC "
"application: when synchronization is needed, requests (which are blocking) "
"should be used; when it isn't, notifications should suffice. However, when "
"Emacs acts as one of these endpoints, asynchronous events (e.g. timer- or "
"process-related) may be triggered while there is still uncertainty about the "
"state of the remote endpoint. Furthermore, acting on these events may only "
"sometimes demand synchronization, depending on the event's specific nature."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5614
#, no-wrap
msgid ":deferred@r{, JSONRPC keyword}"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5624
msgid ""
"The @code{:deferred} keyword argument to @code{jsonrpc-request} and "
"@code{jsonrpc-async-request} is designed to let the caller indicate that the "
"specific request needs synchronization and its actual issuance may be "
"delayed to the future, until some condition is satisfied. Specifying "
"@code{:deferred} for a request doesn't mean it @emph{will} be delayed, only "
"that it @emph{can} be. If the request isn't sent immediately, "
"@code{jsonrpc} will make renewed efforts to send it at certain key times "
"during communication, such as when receiving or sending other messages to "
"the endpoint."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5625
#, no-wrap
msgid "jsonrpc-connection-ready-p"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5636
msgid ""
"Before any attempt to send the request, the application-specific conditions "
"are checked. Since the @code{jsonrpc} library can't know what these "
"conditions are, the program can use the @code{jsonrpc-connection-ready-p} "
"generic function (@pxref{Generic Functions}) to specify them. The default "
"method for this function returns @code{t}, but you can add overriding "
"methods that return @code{nil} in some situations, based on the arguments "
"passed to it, which are the @code{jsonrpc-connection} object (@pxref{JSONRPC "
"Overview}) and whichever value you passed as the @code{:deferred} keyword "
"argument."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5638
#, no-wrap
msgid "Atomic Change Groups"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5639
#, no-wrap
msgid "atomic changes"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5647
msgid ""
"In database terminology, an @dfn{atomic} change is an indivisible "
"change---it can succeed entirely or it can fail entirely, but it cannot "
"partly succeed. A Lisp program can make a series of changes to one or "
"several buffers as an @dfn{atomic change group}, meaning that either the "
"entire series of changes will be installed in their buffers or, in case of "
"an error, none of them will be."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5651
msgid ""
"To do this for one buffer, the one already current, simply write a call to "
"@code{atomic-change-group} around the code that makes the changes, like "
"this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5656
#, no-wrap
msgid ""
"(atomic-change-group\n"
" (insert foo)\n"
" (delete-region x y))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5663
msgid ""
"If an error (or other nonlocal exit) occurs inside the body of "
"@code{atomic-change-group}, it unmakes all the changes in that buffer that "
"were during the execution of the body. This kind of change group has no "
"effect on any other buffers---any such changes remain."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5667
msgid ""
"If you need something more sophisticated, such as to make changes in various "
"buffers constitute one atomic group, you must directly call lower-level "
"functions that @code{atomic-change-group} uses."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5668
#, no-wrap
msgid "prepare-change-group &optional buffer"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5673
msgid ""
"This function sets up a change group for buffer @var{buffer}, which defaults "
"to the current buffer. It returns a handle that represents the change "
"group. You must use this handle to activate the change group and "
"subsequently to finish it."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5677
msgid ""
"To use the change group, you must @dfn{activate} it. You must do this "
"before making any changes in the text of @var{buffer}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5678
#, no-wrap
msgid "activate-change-group handle"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5680
msgid "This function activates the change group that @var{handle} designates."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5687
msgid ""
"After you activate the change group, any changes you make in that buffer "
"become part of it. Once you have made all the desired changes in the "
"buffer, you must @dfn{finish} the change group. There are two ways to do "
"this: you can either accept (and finalize) all the changes, or cancel them "
"all."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5688
#, no-wrap
msgid "accept-change-group handle"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5691
msgid ""
"This function accepts all the changes in the change group specified by "
"@var{handle}, making them final."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5693
#, no-wrap
msgid "cancel-change-group handle"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5696
msgid ""
"This function cancels and undoes all the changes in the change group "
"specified by @var{handle}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5701
msgid ""
"You can cause some or all of the changes in a change group to be considered "
"as a single unit for the purposes of the @code{undo} commands (@pxref{Undo}) "
"by using @code{undo-amalgamate-change-group}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5702
#, no-wrap
msgid "undo-amalgamate-change-group"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5709
msgid ""
"Amalgamate all the changes made in the change-group since the state "
"identified by @var{handle}. This function removes all undo boundaries "
"between undo records of changes since the state described by @var{handle}. "
"Usually, @var{handle} is the handle returned by @code{prepare-change-group}, "
"in which case all the changes since the beginning of the change-group are "
"amalgamated into a single undo unit."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5721
msgid ""
"Your code should use @code{unwind-protect} to make sure the group is always "
"finished. The call to @code{activate-change-group} should be inside the "
"@code{unwind-protect}, in case the user types @kbd{C-g} just after it runs. "
"(This is one reason why @code{prepare-change-group} and "
"@code{activate-change-group} are separate functions, because normally you "
"would call @code{prepare-change-group} before the start of that "
"@code{unwind-protect}.) Once you finish the group, don't use the handle "
"again---in particular, don't try to finish the same group twice."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5725
msgid ""
"To make a multibuffer change group, call @code{prepare-change-group} once "
"for each buffer you want to cover, then use @code{nconc} to combine the "
"returned values, like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5729
#, no-wrap
msgid ""
"(nconc (prepare-change-group buffer-1)\n"
" (prepare-change-group buffer-2))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5734
msgid ""
"You can then activate the multibuffer change group with a single call to "
"@code{activate-change-group}, and finish it with a single call to "
"@code{accept-change-group} or @code{cancel-change-group}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5739
msgid ""
"Nested use of several change groups for the same buffer works as you would "
"expect. Non-nested use of change groups for the same buffer will get Emacs "
"confused, so don't let it happen; the first change group you start for any "
"given buffer should be the last one finished."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5742
#, no-wrap
msgid "change hooks"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5743
#, no-wrap
msgid "hooks for text changes"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5749
msgid ""
"These hook variables let you arrange to take notice of changes in buffers "
"(or in a particular buffer, if you make them buffer-local). See also "
"@ref{Special Properties}, for how to detect changes to specific parts of the "
"text."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5754
msgid ""
"The functions you use in these hooks should save and restore the match data "
"if they do anything that uses regular expressions; otherwise, they will "
"interfere in bizarre ways with the editing operations that call them."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5755
#, no-wrap
msgid "before-change-functions"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5761
msgid ""
"This variable holds a list of functions to call when Emacs is about to "
"modify a buffer. Each function gets two arguments, the beginning and end of "
"the region that is about to change, represented as integers. The buffer "
"that is about to change is always the current buffer when the function is "
"called."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5763
#, no-wrap
msgid "after-change-functions"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5770
msgid ""
"This variable holds a list of functions to call after Emacs modifies a "
"buffer. Each function receives three arguments: the beginning and end of "
"the region just changed, and the length of the text that existed before the "
"change. All three arguments are integers. The buffer that has been changed "
"is always the current buffer when the function is called."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5775
msgid ""
"The length of the old text is the difference between the buffer positions "
"before and after that text as it was before the change. As for the changed "
"text, its length is simply the difference between the first two arguments."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5781
msgid ""
"Output of messages into the @file{*Messages*} buffer does not call these "
"functions, and neither do certain internal buffer changes, such as changes "
"in buffers created by Emacs internally for certain jobs, that should not be "
"visible to Lisp programs."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5797
msgid ""
"The vast majority of buffer changing primitives will call "
"@code{before-change-functions} and @code{after-change-functions} in balanced "
"pairs, once for each change, where the arguments to these hooks exactly "
"delimit the change being made. Yet, hook functions should not rely on this "
"always being the case, because some complex primitives call "
"@code{before-change-functions} once before making changes, and then call "
"@code{after-change-functions} zero or more times, depending on how many "
"individual changes the primitive is making. When that happens, the "
"arguments to @code{before-change-functions} will enclose a region in which "
"the individual changes are made, but won't necessarily be the minimal such "
"region, and the arguments to each successive call of "
"@code{after-change-functions} will then delimit the part of text being "
"changed exactly. In general, we advise using either the before- or the "
"after-change hook, but not both."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5798
#, no-wrap
msgid "combine-after-change-calls body@dots{}"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5802
msgid ""
"The macro executes @var{body} normally, but arranges to call the "
"after-change functions just once for a series of several changes---if that "
"seems safe."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5809
msgid ""
"If a program makes several text changes in the same area of the buffer, "
"using the macro @code{combine-after-change-calls} around that part of the "
"program can make it run considerably faster when after-change hooks are in "
"use. When the after-change hooks are ultimately called, the arguments "
"specify a portion of the buffer including all of the changes made within the "
"@code{combine-after-change-calls} body."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5813
msgid ""
"@strong{Warning:} You must not alter the values of "
"@code{after-change-functions} within the body of a "
"@code{combine-after-change-calls} form."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5818
msgid ""
"@strong{Warning:} If the changes you combine occur in widely scattered parts "
"of the buffer, this will still work, but it is not advisable, because it may "
"lead to inefficient behavior for some change hook functions."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5820
#, no-wrap
msgid "combine-change-calls beg end body@dots{}"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5827
msgid ""
"This executes @var{body} normally, except any buffer changes it makes do not "
"trigger the calls to @code{before-change-functions} and "
"@code{after-change-functions}. Instead there is a single call of each of "
"these hooks for the region enclosed by @var{beg} and @var{end}, the "
"parameters supplied to @code{after-change-functions} reflecting the changes "
"made to the size of the region by @var{body}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5829
msgid "The result of this macro is the result returned by @var{body}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5835
msgid ""
"This macro is useful when a function makes a possibly large number of "
"repetitive changes to the buffer, and the change hooks would otherwise take "
"a long time to run, were they to be run for each individual buffer "
"modification. Emacs itself uses this macro, for example, in the commands "
"@code{comment-region} and @code{uncomment-region}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5839
msgid ""
"@strong{Warning:} You must not alter the values of "
"@code{before-change-functions} or @code{after-change-function} within "
"@var{body}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5842
msgid ""
"@strong{Warning:} You must not make any buffer changes outside of the region "
"specified by @var{beg} and @var{end}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5844
#, no-wrap
msgid "first-change-hook"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5847
msgid ""
"This variable is a normal hook that is run whenever a buffer is changed that "
"was previously in the unmodified state."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5849
#, no-wrap
msgid "inhibit-modification-hooks"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5855
msgid ""
"If this variable is non-@code{nil}, all of the change hooks are disabled; "
"none of them run. This affects all the hook variables described above in "
"this section, as well as the hooks attached to certain special text "
"properties (@pxref{Special Properties}) and overlay properties "
"(@pxref{Overlay Properties})."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5865
msgid ""
"Also, this variable is bound to non-@code{nil} while running those same hook "
"variables, so that by default modifying the buffer from a modification hook "
"does not cause other modification hooks to be run. If you do want "
"modification hooks to be run in a particular piece of code that is itself "
"run from a modification hook, then rebind locally "
"@code{inhibit-modification-hooks} to @code{nil}. However, doing this may "
"cause recursive calls to the modification hooks, so be sure to prepare for "
"that (for example, by binding some variable which tells your hook to do "
"nothing)."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/text.texi:5872
msgid ""
"We recommend that you only bind this variable for modifications that do not "
"result in lasting changes to buffer text contents (for example face changes "
"or temporary modifications). If you need to delay change hooks during a "
"series of changes (typically for performance reasons), use "
"@code{combine-change-calls} or @code{combine-after-change-calls} instead."
msgstr ""