From: Po Lu <luangruo@yahoo.com>
Date: Tue, 24 Oct 2023 07:32:25 +0000 (+0000)
Subject: Correct documentation of selection-coding-system
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=9e9bc2af51485f6a9ce9a37d504249af14ab909d;p=emacs.git

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

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