[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
master 9e9bc2af514: Correct documentation of selection-coding-system
From: |
Po Lu |
Subject: |
master 9e9bc2af514: Correct documentation of selection-coding-system |
Date: |
Tue, 24 Oct 2023 03:32:42 -0400 (EDT) |
branch: master
commit 9e9bc2af51485f6a9ce9a37d504249af14ab909d
Author: Po Lu <luangruo@yahoo.com>
Commit: Po Lu <luangruo@yahoo.com>
Correct documentation of selection-coding-system
* doc/lispref/frames.texi (Window System Selections): Don't
assert that selection-coding-system functions everywhere or that
its default value is always utf-16le-dos.
(Drag and Drop): Fix a typo.
---
doc/lispref/frames.texi | 26 ++++++++++++++++++--------
1 file changed, 18 insertions(+), 8 deletions(-)
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 9f969603023..56e4fe419e3 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -4053,10 +4053,20 @@ under X, and @xref{Other Selections} for those
elsewhere.
@end defun
@defopt selection-coding-system
-This variable specifies the coding system to use when reading and
-writing selections or the clipboard. @xref{Coding
-Systems}. The default is @code{compound-text-with-extensions}, which
-converts to the text representation that X11 normally uses.
+This variable provides a coding system (@pxref{Coding Systems}) which
+is used to encode selection data, and takes effect on MS-DOS,
+MS-Windows and X@.
+
+Under MS-DOS and MS-Windows, it is the coding system by which all
+clipboard text will be encoded and decoded, whereas on X it merely
+supplies the EOL format of the selection text sent in response to a
+request for text encoded by a matching coding system; which is to say
+that if its value is @code{utf-8-dos}, it will influence requests for
+@code{UTF8_STRING} data, but not those for @code{STRING}.
+
+Its default value is the system code page under MS-Windows 95, 98 or
+Me, @code{utf-16le-dos} under NT/W2K/XP, @code{iso-latin-1-dos} on
+MS-DOS, and @code{nil} elsewhere.
@end defopt
For backward compatibility, there are obsolete aliases
@@ -4810,10 +4820,10 @@ selection name such as @code{UTF8_STRING}.
@cindex direct save protocol
@vindex x-dnd-direct-save-function
The X Direct Save (@acronym{XDS}) protocol enables programs to
-devolve responsibility for naming a dropped file file upon the
-recipient. When such a drop transpires, DND handlers and the
-foregoing X-specific interface are largely circumvented, tasking a
-different function with responding to the drop.
+devolve responsibility for naming a dropped file upon the recipient.
+When such a drop transpires, DND handlers and the foregoing X-specific
+interface are largely circumvented, tasking a different function with
+responding to the drop.
@defvar x-dnd-direct-save-function
This variable should be set to a function that registers and names
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- master 9e9bc2af514: Correct documentation of selection-coding-system,
Po Lu <=