From: Stefan Kangas <stefankangas@gmail.com>
To: Po Lu <luangruo@yahoo.com>, emacs-devel@gnu.org
Subject: Re: master 9e9bc2af514: Correct documentation of selection-coding-system
Date: Tue, 24 Oct 2023 01:45:20 -0700 [thread overview]
Message-ID: <CADwFkm=EVhQrsdPUn8qH8nu6BvFiw7gX_++_qSucmjAKqk1kxw@mail.gmail.com> (raw)
In-Reply-To: <20231024073242.D7D2DC09BE2@vcs2.savannah.gnu.org>
Po Lu via Mailing list for Emacs changes <emacs-diffs@gnu.org> writes:
> 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
Could we please shift this around so that we mention free operating
systems before non-free ones (i.e. X before MS-Windows) and current
operating systems before obsolete ones (i.e. MS-Windows before XP and
MS-DOS)?
For example:
Its default value is @code{nil}. On old versions of MS-Windows ...
And so on for the other paragraphs.
Maybe the MS-DOS stuff could be moved to a footnote, or to some separate
file where we document that port.
Thanks in advance.
next parent reply other threads:[~2023-10-24 8:45 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <169813276237.32360.18004840007685572644@vcs2.savannah.gnu.org>
[not found] ` <20231024073242.D7D2DC09BE2@vcs2.savannah.gnu.org>
2023-10-24 8:45 ` Stefan Kangas [this message]
2023-10-24 10:40 ` master 9e9bc2af514: Correct documentation of selection-coding-system Po Lu
2023-10-24 11:33 ` Eli Zaretskii
2023-10-24 11:46 ` Po Lu
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='CADwFkm=EVhQrsdPUn8qH8nu6BvFiw7gX_++_qSucmjAKqk1kxw@mail.gmail.com' \
--to=stefankangas@gmail.com \
--cc=emacs-devel@gnu.org \
--cc=luangruo@yahoo.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).