From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: master 9e9bc2af514: Correct documentation of selection-coding-system Date: Tue, 24 Oct 2023 01:45:20 -0700 Message-ID: References: <169813276237.32360.18004840007685572644@vcs2.savannah.gnu.org> <20231024073242.D7D2DC09BE2@vcs2.savannah.gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="6622"; mail-complaints-to="usenet@ciao.gmane.io" To: Po Lu , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Oct 24 10:46:17 2023 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1qvD3G-0001S0-B4 for ged-emacs-devel@m.gmane-mx.org; Tue, 24 Oct 2023 10:46:14 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qvD2a-0003Ok-RN; Tue, 24 Oct 2023 04:45:32 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qvD2S-0003DM-MG for emacs-devel@gnu.org; Tue, 24 Oct 2023 04:45:24 -0400 Original-Received: from mail-lj1-x22a.google.com ([2a00:1450:4864:20::22a]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qvD2R-0004Em-33 for emacs-devel@gnu.org; Tue, 24 Oct 2023 04:45:24 -0400 Original-Received: by mail-lj1-x22a.google.com with SMTP id 38308e7fff4ca-2c5071165d5so29538071fa.0 for ; Tue, 24 Oct 2023 01:45:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1698137121; x=1698741921; darn=gnu.org; h=to:subject:message-id:date:mime-version:references:in-reply-to:from :from:to:cc:subject:date:message-id:reply-to; bh=5KxaizS/CupwmLQW26FkeJloqj8d+yInVZbhYkqxSio=; b=CWrB9Ujd8KPVpExL/R60aQx6dSBKeYqLwn63cn+Mt+HCO5KdJJKx134hbgU22u47CN LLjsgW+oxD+9wpGZ3faAP5EGFVGM0U5/JZpKGhYZ1HRuSRbxSxOPqxKQ8zs7DAKggLQm tT8req/iqO5UfuuwyrisgyD6e75IAuZ/21uHbfzuikwOikQIApEJLKCY6LMfcymreIW+ MWtj6hzHs74rdpn+SWOj5wU46qStMFpbF7ER3+OS4ITV71euk/S2xaByxiymCgnrQ2nZ MJurbXa/us9U43NmHBfnD4RruzxBIN98aBWuv0Nut8sbvGYESB1LxW0aVPPWrT2grqzA Qdmw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1698137121; x=1698741921; h=to:subject:message-id:date:mime-version:references:in-reply-to:from :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=5KxaizS/CupwmLQW26FkeJloqj8d+yInVZbhYkqxSio=; b=g9XL/pbr1X5JvaSxHuzcSDvRh9r3YH+V5YQzEfw1tsTcWzKJ6m6xvJo019MSU6JCDW RGNK9xgJ5wjT06ioE6epZfP11x7fPjTBS13Xh9KWWQI71R4CYkh1q0xf3Skbh+uCRaV7 iRxLjKCLPxk3db/Sq5ZOzAbwb/4CM3WPnZb0DjP8k1j37SG4EGMGymQ76WdB78x248vG q+XNeNp07E1SeijTEduby57Z5TatPba6wXnuo8I2wewcz8TAqLxy9aK+7HkVD+txUOoZ 6bUwioDdqsxlWDkealWgDjsAPHNAVd1Dx9WYrr5xRvgos1uTn3AB8NZN/onAcoaL9CLg 6FXg== X-Gm-Message-State: AOJu0YyNWWkjx1B66IXp66aFNEiSv2hVqAHAoCO8GZi++mPKZunN5tGF 6eqqZB9z8gvuvFZoEddIwIGIDDxTRX67qqb+obbiqAigsgE= X-Google-Smtp-Source: AGHT+IGzj7hhy9oij1P9DQtkxkXCDB5s/bhsW1PUOCZskRl5L+jnwQa7OaKNhG0z/UPibVKhfGRvhJ5tQJloC7BO3Rc= X-Received: by 2002:a05:651c:c2:b0:2c5:aff:f936 with SMTP id 2-20020a05651c00c200b002c50afff936mr7785689ljr.53.1698137121134; Tue, 24 Oct 2023 01:45:21 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Tue, 24 Oct 2023 01:45:20 -0700 In-Reply-To: <20231024073242.D7D2DC09BE2@vcs2.savannah.gnu.org> Received-SPF: pass client-ip=2a00:1450:4864:20::22a; envelope-from=stefankangas@gmail.com; helo=mail-lj1-x22a.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:311758 Archived-At: Po Lu via Mailing list for Emacs changes 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.