annotate lisp/select.el @ 111412:cc7702f421a0

chapter, part, section are all DocBook elements
author Sam Steingold <sds@gnu.org>
date Fri, 05 Nov 2010 15:30:18 -0400
parents 029e4783cbae
children 417b1e4d63cd
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
38414
67b464da13ec Some fixes to follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents: 33914
diff changeset
1 ;;; select.el --- lisp portion of standard selection support
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
2
111135
600f564fdc23 Sync Lisp and C docs of next-selection-coding-system.
Glenn Morris <rgm@gnu.org>
parents: 110145
diff changeset
3 ;; Copyright (C) 1993, 1994, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
600f564fdc23 Sync Lisp and C docs of next-selection-coding-system.
Glenn Morris <rgm@gnu.org>
parents: 110145
diff changeset
4 ;; 2008, 2009, 2010 Free Software Foundation, Inc.
600f564fdc23 Sync Lisp and C docs of next-selection-coding-system.
Glenn Morris <rgm@gnu.org>
parents: 110145
diff changeset
5
45078
829beb9a6a4b Follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents: 42028
diff changeset
6 ;; Maintainer: FSF
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
7 ;; Keywords: internal
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
8
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
9 ;; This file is part of GNU Emacs.
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
10
94678
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94205
diff changeset
11 ;; GNU Emacs is free software: you can redistribute it and/or modify
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
12 ;; it under the terms of the GNU General Public License as published by
94678
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94205
diff changeset
13 ;; the Free Software Foundation, either version 3 of the License, or
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94205
diff changeset
14 ;; (at your option) any later version.
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
15
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
16 ;; GNU Emacs is distributed in the hope that it will be useful,
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
19 ;; GNU General Public License for more details.
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
20
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
21 ;; You should have received a copy of the GNU General Public License
94678
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94205
diff changeset
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
23
38414
67b464da13ec Some fixes to follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents: 33914
diff changeset
24 ;;; Commentary:
67b464da13ec Some fixes to follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents: 33914
diff changeset
25
111135
600f564fdc23 Sync Lisp and C docs of next-selection-coding-system.
Glenn Morris <rgm@gnu.org>
parents: 110145
diff changeset
26 ;; Based partially on earlier release by Lucid.
600f564fdc23 Sync Lisp and C docs of next-selection-coding-system.
Glenn Morris <rgm@gnu.org>
parents: 110145
diff changeset
27
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
28 ;;; Code:
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
29
91674
31216f583b8a (selection-coding-system): Make it a defcustom, and add the properties
Glenn Morris <rgm@gnu.org>
parents: 91327
diff changeset
30 (defcustom selection-coding-system nil
111136
bc1274182cc8 Sync docs of selection-coding-system between C and Lisp.
Glenn Morris <rgm@gnu.org>
parents: 111135
diff changeset
31 "Coding system for communicating with other programs.
91103
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
32
111136
bc1274182cc8 Sync docs of selection-coding-system between C and Lisp.
Glenn Morris <rgm@gnu.org>
parents: 111135
diff changeset
33 For MS-Windows and MS-DOS:
bc1274182cc8 Sync docs of selection-coding-system between C and Lisp.
Glenn Morris <rgm@gnu.org>
parents: 111135
diff changeset
34 When sending or receiving text via selection and clipboard, the text
bc1274182cc8 Sync docs of selection-coding-system between C and Lisp.
Glenn Morris <rgm@gnu.org>
parents: 111135
diff changeset
35 is encoded or decoded by this coding system. The default value is
bc1274182cc8 Sync docs of selection-coding-system between C and Lisp.
Glenn Morris <rgm@gnu.org>
parents: 111135
diff changeset
36 the current system default encoding on 9x/Me, `utf-16le-dos'
bc1274182cc8 Sync docs of selection-coding-system between C and Lisp.
Glenn Morris <rgm@gnu.org>
parents: 111135
diff changeset
37 \(Unicode) on NT/W2K/XP, and `iso-latin-1-dos' on MS-DOS.
bc1274182cc8 Sync docs of selection-coding-system between C and Lisp.
Glenn Morris <rgm@gnu.org>
parents: 111135
diff changeset
38
bc1274182cc8 Sync docs of selection-coding-system between C and Lisp.
Glenn Morris <rgm@gnu.org>
parents: 111135
diff changeset
39 For X Windows:
91103
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
40 When sending text via selection and clipboard, if the target
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
41 data-type matches with the type of this coding system, it is used
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
42 for encoding the text. Otherwise (including the case that this
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
43 variable is nil), a proper coding system is used as below:
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
44
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
45 data-type coding system
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
46 --------- -------------
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
47 UTF8_STRING utf-8
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
48 COMPOUND_TEXT compound-text-with-extensions
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
49 STRING iso-latin-1
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
50 C_STRING no-conversion
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
51
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
52 When receiving text, if this coding system is non-nil, it is used
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
53 for decoding regardless of the data-type. If this is nil, a
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
54 proper coding system is used according to the data-type as above.
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
55
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
56 See also the documentation of the variable `x-select-request-type' how
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
57 to control which data-type to request for receiving text.
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
58
91674
31216f583b8a (selection-coding-system): Make it a defcustom, and add the properties
Glenn Morris <rgm@gnu.org>
parents: 91327
diff changeset
59 The default value is nil."
31216f583b8a (selection-coding-system): Make it a defcustom, and add the properties
Glenn Morris <rgm@gnu.org>
parents: 91327
diff changeset
60 :type 'coding-system
31216f583b8a (selection-coding-system): Make it a defcustom, and add the properties
Glenn Morris <rgm@gnu.org>
parents: 91327
diff changeset
61 :group 'mule
31216f583b8a (selection-coding-system): Make it a defcustom, and add the properties
Glenn Morris <rgm@gnu.org>
parents: 91327
diff changeset
62 ;; Default was compound-text-with-extensions in 22.x (pre-unicode).
31216f583b8a (selection-coding-system): Make it a defcustom, and add the properties
Glenn Morris <rgm@gnu.org>
parents: 91327
diff changeset
63 :version "23.1"
31216f583b8a (selection-coding-system): Make it a defcustom, and add the properties
Glenn Morris <rgm@gnu.org>
parents: 91327
diff changeset
64 :set (lambda (symbol value)
31216f583b8a (selection-coding-system): Make it a defcustom, and add the properties
Glenn Morris <rgm@gnu.org>
parents: 91327
diff changeset
65 (set-selection-coding-system value)
31216f583b8a (selection-coding-system): Make it a defcustom, and add the properties
Glenn Morris <rgm@gnu.org>
parents: 91327
diff changeset
66 (set symbol value)))
91103
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
67
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
68 (defvar next-selection-coding-system nil
111135
600f564fdc23 Sync Lisp and C docs of next-selection-coding-system.
Glenn Morris <rgm@gnu.org>
parents: 110145
diff changeset
69 "Coding system for the next communication with other programs.
91103
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
70 Usually, `selection-coding-system' is used for communicating with
111135
600f564fdc23 Sync Lisp and C docs of next-selection-coding-system.
Glenn Morris <rgm@gnu.org>
parents: 110145
diff changeset
71 other programs (X Windows clients or MS Windows programs). But, if this
600f564fdc23 Sync Lisp and C docs of next-selection-coding-system.
Glenn Morris <rgm@gnu.org>
parents: 110145
diff changeset
72 variable is set, it is used for the next communication only.
600f564fdc23 Sync Lisp and C docs of next-selection-coding-system.
Glenn Morris <rgm@gnu.org>
parents: 110145
diff changeset
73 After the communication, this variable is set to nil.")
91103
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
74
95841
b4e36ff621b3 Add some compiler declarations, for builds without X.
Glenn Morris <rgm@gnu.org>
parents: 95458
diff changeset
75 (declare-function x-get-selection-internal "xselect.c"
b4e36ff621b3 Add some compiler declarations, for builds without X.
Glenn Morris <rgm@gnu.org>
parents: 95458
diff changeset
76 (selection-symbol target-type &optional time-stamp))
b4e36ff621b3 Add some compiler declarations, for builds without X.
Glenn Morris <rgm@gnu.org>
parents: 95458
diff changeset
77
111255
d74f09f8c82d * lisp/select.el (x-selection): Mark it as an obsolete alias.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
78 ;; Only declared obsolete in 23.3.
d74f09f8c82d * lisp/select.el (x-selection): Mark it as an obsolete alias.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
79 (define-obsolete-function-alias 'x-selection 'x-get-selection "at least 19.34")
d74f09f8c82d * lisp/select.el (x-selection): Mark it as an obsolete alias.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
80
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
81 (defun x-get-selection (&optional type data-type)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
82 "Return the value of an X Windows selection.
49514
10a6fd9d8e9c (x-set-cut-buffer): Fix docstring. Check type with `stringp' instead of
Juanma Barranquero <lekktu@gmail.com>
parents: 46879
diff changeset
83 The argument TYPE (default `PRIMARY') says which selection,
19142
fffebc19fe53 (x-get-selection): Change default for data-type
Richard M. Stallman <rms@gnu.org>
parents: 17012
diff changeset
84 and the argument DATA-TYPE (default `STRING') says
33914
5876bde45199 (x-get-selection): Docstring dix.
Eli Zaretskii <eliz@gnu.org>
parents: 26423
diff changeset
85 how to convert the data.
5876bde45199 (x-get-selection): Docstring dix.
Eli Zaretskii <eliz@gnu.org>
parents: 26423
diff changeset
86
56531
9cfffd03fbfa (x-get-selection, x-set-selection): Doc fixes.
Luc Teirlinck <teirllm@auburn.edu>
parents: 55344
diff changeset
87 TYPE may be any symbol \(but nil stands for `PRIMARY'). However,
9cfffd03fbfa (x-get-selection, x-set-selection): Doc fixes.
Luc Teirlinck <teirllm@auburn.edu>
parents: 55344
diff changeset
88 only a few symbols are commonly used. They conventionally have
9cfffd03fbfa (x-get-selection, x-set-selection): Doc fixes.
Luc Teirlinck <teirllm@auburn.edu>
parents: 55344
diff changeset
89 all upper-case names. The most often used ones, in addition to
9cfffd03fbfa (x-get-selection, x-set-selection): Doc fixes.
Luc Teirlinck <teirllm@auburn.edu>
parents: 55344
diff changeset
90 `PRIMARY', are `SECONDARY' and `CLIPBOARD'.
9cfffd03fbfa (x-get-selection, x-set-selection): Doc fixes.
Luc Teirlinck <teirllm@auburn.edu>
parents: 55344
diff changeset
91
33914
5876bde45199 (x-get-selection): Docstring dix.
Eli Zaretskii <eliz@gnu.org>
parents: 26423
diff changeset
92 DATA-TYPE is usually `STRING', but can also be one of the symbols
5876bde45199 (x-get-selection): Docstring dix.
Eli Zaretskii <eliz@gnu.org>
parents: 26423
diff changeset
93 in `selection-converter-alist', which see."
51600
16b245345247 (x-get-selection): If the string returned by
Kenichi Handa <handa@m17n.org>
parents: 49514
diff changeset
94 (let ((data (x-get-selection-internal (or type 'PRIMARY)
16b245345247 (x-get-selection): If the string returned by
Kenichi Handa <handa@m17n.org>
parents: 49514
diff changeset
95 (or data-type 'STRING)))
16b245345247 (x-get-selection): If the string returned by
Kenichi Handa <handa@m17n.org>
parents: 49514
diff changeset
96 coding)
16b245345247 (x-get-selection): If the string returned by
Kenichi Handa <handa@m17n.org>
parents: 49514
diff changeset
97 (when (and (stringp data)
16b245345247 (x-get-selection): If the string returned by
Kenichi Handa <handa@m17n.org>
parents: 49514
diff changeset
98 (setq data-type (get-text-property 0 'foreign-selection data)))
91103
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
99 (setq coding (or next-selection-coding-system
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
100 selection-coding-system
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
101 (cond ((eq data-type 'UTF8_STRING)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
102 'utf-8)
95458
590265a51ebf (x-get-selection): Fix typo.
Juanma Barranquero <lekktu@gmail.com>
parents: 94678
diff changeset
103 ((eq data-type 'COMPOUND_TEXT)
91103
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
104 'compound-text-with-extensions)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
105 ((eq data-type 'C_STRING)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
106 nil)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
107 ((eq data-type 'STRING)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
108 'iso-8859-1)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
109 (t
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
110 (error "Unknow selection data type: %S" type))))
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
111 data (if coding (decode-coding-string data coding)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
112 (string-to-multibyte data)))
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
113 (setq next-selection-coding-system nil)
51600
16b245345247 (x-get-selection): If the string returned by
Kenichi Handa <handa@m17n.org>
parents: 49514
diff changeset
114 (put-text-property 0 (length data) 'foreign-selection data-type data))
16b245345247 (x-get-selection): If the string returned by
Kenichi Handa <handa@m17n.org>
parents: 49514
diff changeset
115 data))
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
116
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
117 (defun x-get-clipboard ()
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
118 "Return text pasted to the clipboard."
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
119 (x-get-selection-internal 'CLIPBOARD 'STRING))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
120
95841
b4e36ff621b3 Add some compiler declarations, for builds without X.
Glenn Morris <rgm@gnu.org>
parents: 95458
diff changeset
121 (declare-function x-own-selection-internal "xselect.c"
b4e36ff621b3 Add some compiler declarations, for builds without X.
Glenn Morris <rgm@gnu.org>
parents: 95458
diff changeset
122 (selection-name selection-value))
b4e36ff621b3 Add some compiler declarations, for builds without X.
Glenn Morris <rgm@gnu.org>
parents: 95458
diff changeset
123 (declare-function x-disown-selection-internal "xselect.c"
b4e36ff621b3 Add some compiler declarations, for builds without X.
Glenn Morris <rgm@gnu.org>
parents: 95458
diff changeset
124 (selection &optional time))
b4e36ff621b3 Add some compiler declarations, for builds without X.
Glenn Morris <rgm@gnu.org>
parents: 95458
diff changeset
125
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
126 (defun x-set-selection (type data)
104135
decfa3e02ba0 * select.el (x-set-selection): Doc fix (Bug#4021).
Chong Yidong <cyd@stupidchicken.com>
parents: 104066
diff changeset
127 "Make an X selection of type TYPE and value DATA.
104066
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
128 The argument TYPE (nil means `PRIMARY') says which selection, and
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
129 DATA specifies the contents. TYPE must be a symbol. \(It can also
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
130 be a string, which stands for the symbol with that name, but this
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
131 is considered obsolete.) DATA may be a string, a symbol, an
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
132 integer (or a cons of two integers or list of two integers).
11406
dc4b96a8dc2e (x-set-selection): Fix up interactive defaults.
Richard M. Stallman <rms@gnu.org>
parents: 7300
diff changeset
133
104066
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
134 The selection may also be a cons of two markers pointing to the same buffer,
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
135 or an overlay. In these cases, the selection is considered to be the text
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
136 between the markers *at whatever time the selection is examined*.
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
137 Thus, editing done in the buffer after you specify the selection
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
138 can alter the effective value of the selection.
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
139
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
140 The data may also be a vector of valid non-vector selection values.
11406
dc4b96a8dc2e (x-set-selection): Fix up interactive defaults.
Richard M. Stallman <rms@gnu.org>
parents: 7300
diff changeset
141
56531
9cfffd03fbfa (x-get-selection, x-set-selection): Doc fixes.
Luc Teirlinck <teirllm@auburn.edu>
parents: 55344
diff changeset
142 The return value is DATA.
9cfffd03fbfa (x-get-selection, x-set-selection): Doc fixes.
Luc Teirlinck <teirllm@auburn.edu>
parents: 55344
diff changeset
143
9cfffd03fbfa (x-get-selection, x-set-selection): Doc fixes.
Luc Teirlinck <teirllm@auburn.edu>
parents: 55344
diff changeset
144 Interactively, this command sets the primary selection. Without
9cfffd03fbfa (x-get-selection, x-set-selection): Doc fixes.
Luc Teirlinck <teirllm@auburn.edu>
parents: 55344
diff changeset
145 prefix argument, it reads the selection in the minibuffer. With
104066
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
146 prefix argument, it uses the text of the region as the selection value.
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
147
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
148 Note that on MS-Windows, primary and secondary selections set by Emacs
b564cde0cb8b Fix Bug#3888:
Eli Zaretskii <eliz@gnu.org>
parents: 103893
diff changeset
149 are not available to other programs."
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
150 (interactive (if (not current-prefix-arg)
11406
dc4b96a8dc2e (x-set-selection): Fix up interactive defaults.
Richard M. Stallman <rms@gnu.org>
parents: 7300
diff changeset
151 (list 'PRIMARY (read-string "Set text for pasting: "))
26423
73efdb6af008 (x-set-selection): Call buffer-substring, not
Gerd Moellmann <gerd@gnu.org>
parents: 19142
diff changeset
152 (list 'PRIMARY (buffer-substring (region-beginning) (region-end)))))
103891
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
153 (if (stringp type) (setq type (intern type)))
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
154 (or (x-valid-simple-selection-p data)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
155 (and (vectorp data)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
156 (let ((valid t)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
157 (i (1- (length data))))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
158 (while (>= i 0)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
159 (or (x-valid-simple-selection-p (aref data i))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
160 (setq valid nil))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
161 (setq i (1- i)))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
162 valid))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
163 (signal 'error (list "invalid selection" data)))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
164 (or type (setq type 'PRIMARY))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
165 (if data
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
166 (x-own-selection-internal type data)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
167 (x-disown-selection-internal type))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
168 data)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
169
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
170 (defun x-valid-simple-selection-p (data)
103893
c75839749e65 * simple.el (deactivate-mark): Optional argument FORCE.
Chong Yidong <cyd@stupidchicken.com>
parents: 103891
diff changeset
171 (or (bufferp data)
c75839749e65 * simple.el (deactivate-mark): Optional argument FORCE.
Chong Yidong <cyd@stupidchicken.com>
parents: 103891
diff changeset
172 (and (consp data)
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
173 (markerp (car data))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
174 (markerp (cdr data))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
175 (marker-buffer (car data))
103891
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
176 (buffer-name (marker-buffer (car data)))
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
177 (eq (marker-buffer (car data))
103891
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
178 (marker-buffer (cdr data))))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
179 (stringp data)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
180 (and (overlayp data)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
181 (overlay-buffer data)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
182 (buffer-name (overlay-buffer data)))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
183 (symbolp data)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
184 (integerp data)))
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
185
98175
dc54ec9cb542 Fix commenting convenition.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95841
diff changeset
186 ;; Functions to convert the selection into various other selection types.
dc54ec9cb542 Fix commenting convenition.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95841
diff changeset
187 ;; Every selection type that Emacs handles is implemented this way, except
dc54ec9cb542 Fix commenting convenition.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 95841
diff changeset
188 ;; for TIMESTAMP, which is a special case.
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
189
103891
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
190 (defun xselect--selection-bounds (value)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
191 "Return bounds of X selection value VALUE.
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
192 The return value is a list (BEG END BUF) if VALUE is a cons of
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
193 two markers or an overlay. Otherwise, it is nil."
103893
c75839749e65 * simple.el (deactivate-mark): Optional argument FORCE.
Chong Yidong <cyd@stupidchicken.com>
parents: 103891
diff changeset
194 (cond ((bufferp value)
c75839749e65 * simple.el (deactivate-mark): Optional argument FORCE.
Chong Yidong <cyd@stupidchicken.com>
parents: 103891
diff changeset
195 (with-current-buffer value
c75839749e65 * simple.el (deactivate-mark): Optional argument FORCE.
Chong Yidong <cyd@stupidchicken.com>
parents: 103891
diff changeset
196 (when (mark t)
c75839749e65 * simple.el (deactivate-mark): Optional argument FORCE.
Chong Yidong <cyd@stupidchicken.com>
parents: 103891
diff changeset
197 (list (mark t) (point) value))))
c75839749e65 * simple.el (deactivate-mark): Optional argument FORCE.
Chong Yidong <cyd@stupidchicken.com>
parents: 103891
diff changeset
198 ((and (consp value)
103891
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
199 (markerp (car value))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
200 (markerp (cdr value)))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
201 (when (and (marker-buffer (car value))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
202 (buffer-name (marker-buffer (car value)))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
203 (eq (marker-buffer (car value))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
204 (marker-buffer (cdr value))))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
205 (list (marker-position (car value))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
206 (marker-position (cdr value))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
207 (marker-buffer (car value)))))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
208 ((overlayp value)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
209 (when (overlay-buffer value)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
210 (list (overlay-start value)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
211 (overlay-end value)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
212 (overlay-buffer value))))))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
213
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
214 (defun xselect--int-to-cons (n)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
215 (cons (ash n -16) (logand n 65535)))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
216
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
217 (defun xselect-convert-to-string (selection type value)
46879
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
218 (let (str coding)
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
219 ;; Get the actual string from VALUE.
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
220 (cond ((stringp value)
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
221 (setq str value))
103891
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
222 ((setq value (xselect--selection-bounds value))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
223 (with-current-buffer (nth 2 value)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
224 (setq str (buffer-substring (nth 0 value)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
225 (nth 1 value))))))
46879
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
226 (when str
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
227 ;; If TYPE is nil, this is a local request, thus return STR as
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
228 ;; is. Otherwise, encode STR.
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
229 (if (not type)
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
230 str
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
231 (setq coding (or next-selection-coding-system selection-coding-system))
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
232 (if coding
91103
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
233 (setq coding (coding-system-base coding)))
55331
0b7159e6ae8f (xselect-convert-to-string): Bind `inhibit-read-only' to t.
Luc Teirlinck <teirllm@auburn.edu>
parents: 52401
diff changeset
234 (let ((inhibit-read-only t))
55344
f2f742f020fb (xselect-convert-to-string): Move comment to intended line.
Luc Teirlinck <teirllm@auburn.edu>
parents: 55331
diff changeset
235 ;; Suppress producing escape sequences for compositions.
55331
0b7159e6ae8f (xselect-convert-to-string): Bind `inhibit-read-only' to t.
Luc Teirlinck <teirllm@auburn.edu>
parents: 52401
diff changeset
236 (remove-text-properties 0 (length str) '(composition nil) str)
94205
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
237 (if (eq type 'TEXT)
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
238 ;; TEXT is a polymorphic target. We must select the
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
239 ;; actual type from `UTF8_STRING', `COMPOUND_TEXT',
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
240 ;; `STRING', and `C_STRING'.
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
241 (if (not (multibyte-string-p str))
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
242 (setq type 'C_STRING)
91103
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
243 (let (non-latin-1 non-unicode eight-bit)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
244 (mapc #'(lambda (x)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
245 (if (>= x #x100)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
246 (if (< x #x110000)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
247 (setq non-latin-1 t)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
248 (if (< x #x3FFF80)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
249 (setq non-unicode t)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
250 (setq eight-bit t)))))
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
251 str)
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
252 (setq type (if non-unicode 'COMPOUND_TEXT
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
253 (if non-latin-1 'UTF8_STRING
94205
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
254 (if eight-bit 'C_STRING 'STRING)))))))
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
255 (cond
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
256 ((eq type 'UTF8_STRING)
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
257 (if (or (not coding)
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
258 (not (eq (coding-system-type coding) 'utf-8)))
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
259 (setq coding 'utf-8))
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
260 (setq str (encode-coding-string str coding)))
49514
10a6fd9d8e9c (x-set-cut-buffer): Fix docstring. Check type with `stringp' instead of
Juanma Barranquero <lekktu@gmail.com>
parents: 46879
diff changeset
261
94205
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
262 ((eq type 'STRING)
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
263 (if (or (not coding)
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
264 (not (eq (coding-system-type coding) 'charset)))
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
265 (setq coding 'iso-8859-1))
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
266 (setq str (encode-coding-string str coding)))
46879
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
267
94205
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
268 ((eq type 'COMPOUND_TEXT)
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
269 (if (or (not coding)
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
270 (not (eq (coding-system-type coding) 'iso-2022)))
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
271 (setq coding 'compound-text-with-extensions))
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
272 (setq str (encode-coding-string str coding)))
91103
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
273
94205
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
274 ((eq type 'C_STRING)
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
275 (setq str (string-make-unibyte str)))
91103
5b63818330eb (selection-coding-system)
Kenichi Handa <handa@m17n.org>
parents: 91005
diff changeset
276
94205
e60145f49fea (xselect-convert-to-string): Send a C_STRING only if the polymorphic
Chong Yidong <cyd@stupidchicken.com>
parents: 93975
diff changeset
277 (t
103891
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
278 (error "Unknown selection type: %S" type)))))
46879
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
279
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
280 (setq next-selection-coding-system nil)
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
281 (cons type str))))
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
282
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
283 (defun xselect-convert-to-length (selection type value)
103891
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
284 (let ((len (cond ((stringp value)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
285 (length value))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
286 ((setq value (xselect--selection-bounds value))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
287 (abs (- (nth 0 value) (nth 1 value)))))))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
288 (if len
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
289 (xselect--int-to-cons len))))
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
290
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
291 (defun xselect-convert-to-targets (selection type value)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
292 ;; return a vector of atoms, but remove duplicates first.
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
293 (let* ((all (cons 'TIMESTAMP (mapcar 'car selection-converter-alist)))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
294 (rest all))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
295 (while rest
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
296 (cond ((memq (car rest) (cdr rest))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
297 (setcdr rest (delq (car rest) (cdr rest))))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
298 ((eq (car (cdr rest)) '_EMACS_INTERNAL) ; shh, it's a secret
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
299 (setcdr rest (cdr (cdr rest))))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
300 (t
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
301 (setq rest (cdr rest)))))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
302 (apply 'vector all)))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
303
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
304 (defun xselect-convert-to-delete (selection type value)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
305 (x-disown-selection-internal selection)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
306 ;; A return value of nil means that we do not know how to do this conversion,
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
307 ;; and replies with an "error". A return value of NULL means that we have
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
308 ;; done the conversion (and any side-effects) but have no value to return.
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
309 'NULL)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
310
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
311 (defun xselect-convert-to-filename (selection type value)
103891
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
312 (when (setq value (xselect--selection-bounds value))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
313 (buffer-file-name (nth 2 value))))
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
314
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
315 (defun xselect-convert-to-charpos (selection type value)
103891
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
316 (when (setq value (xselect--selection-bounds value))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
317 (let ((beg (1- (nth 0 value))) ; zero-based
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
318 (end (1- (nth 1 value))))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
319 (cons 'SPAN (vector (xselect--int-to-cons (min beg end))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
320 (xselect--int-to-cons (max beg end)))))))
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
321
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
322 (defun xselect-convert-to-lineno (selection type value)
103891
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
323 (when (setq value (xselect--selection-bounds value))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
324 (with-current-buffer (nth 2 value)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
325 (let ((beg (line-number-at-pos (nth 0 value)))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
326 (end (line-number-at-pos (nth 1 value))))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
327 (cons 'SPAN (vector (xselect--int-to-cons (min beg end))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
328 (xselect--int-to-cons (max beg end))))))))
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
329
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
330 (defun xselect-convert-to-colno (selection type value)
103891
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
331 (when (setq value (xselect--selection-bounds value))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
332 (with-current-buffer (nth 2 value)
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
333 (let ((beg (progn (goto-char (nth 0 value)) (current-column)))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
334 (end (progn (goto-char (nth 1 value)) (current-column))))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
335 (cons 'SPAN (vector (xselect--int-to-cons (min beg end))
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
336 (xselect--int-to-cons (max beg end))))))))
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
337
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
338 (defun xselect-convert-to-os (selection type size)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
339 (symbol-name system-type))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
340
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
341 (defun xselect-convert-to-host (selection type size)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
342 (system-name))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
343
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
344 (defun xselect-convert-to-user (selection type size)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
345 (user-full-name))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
346
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
347 (defun xselect-convert-to-class (selection type size)
42028
5f0fca416a2f (xselect-convert-to-class, xselect-convert-to-name): Documented.
Pavel Janík <Pavel@Janik.cz>
parents: 41989
diff changeset
348 "Convert selection to class.
5f0fca416a2f (xselect-convert-to-class, xselect-convert-to-name): Documented.
Pavel Janík <Pavel@Janik.cz>
parents: 41989
diff changeset
349 This function returns the string \"Emacs\"."
2879
48dd9b2361df * select.el (xselect-convert-to-class): Just return "Emacs" here.
Jim Blandy <jimb@redhat.com>
parents: 2571
diff changeset
350 "Emacs")
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
351
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
352 ;; We do not try to determine the name Emacs was invoked with,
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
353 ;; because it is not clean for a program's behavior to depend on that.
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
354 (defun xselect-convert-to-name (selection type size)
42028
5f0fca416a2f (xselect-convert-to-class, xselect-convert-to-name): Documented.
Pavel Janík <Pavel@Janik.cz>
parents: 41989
diff changeset
355 "Convert selection to name.
5f0fca416a2f (xselect-convert-to-class, xselect-convert-to-name): Documented.
Pavel Janík <Pavel@Janik.cz>
parents: 41989
diff changeset
356 This function returns the string \"emacs\"."
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
357 "emacs")
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
358
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
359 (defun xselect-convert-to-integer (selection type value)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
360 (and (integerp value)
103891
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
361 (xselect--int-to-cons value)))
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
362
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
363 (defun xselect-convert-to-atom (selection type value)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
364 (and (symbolp value) value))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
365
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
366 (defun xselect-convert-to-identity (selection type value) ; used internally
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
367 (vector value))
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
368
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
369 (setq selection-converter-alist
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
370 '((TEXT . xselect-convert-to-string)
17012
f1932b36f01d (x-get-selection): Set default data-type of selection
Karl Heuer <kwzh@gnu.org>
parents: 14169
diff changeset
371 (COMPOUND_TEXT . xselect-convert-to-string)
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
372 (STRING . xselect-convert-to-string)
46879
f7c325954eca (xselect-convert-to-string): If TYPE is non-nil,
Kenichi Handa <handa@m17n.org>
parents: 45647
diff changeset
373 (UTF8_STRING . xselect-convert-to-string)
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
374 (TARGETS . xselect-convert-to-targets)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
375 (LENGTH . xselect-convert-to-length)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
376 (DELETE . xselect-convert-to-delete)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
377 (FILE_NAME . xselect-convert-to-filename)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
378 (CHARACTER_POSITION . xselect-convert-to-charpos)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
379 (LINE_NUMBER . xselect-convert-to-lineno)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
380 (COLUMN_NUMBER . xselect-convert-to-colno)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
381 (OWNER_OS . xselect-convert-to-os)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
382 (HOST_NAME . xselect-convert-to-host)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
383 (USER . xselect-convert-to-user)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
384 (CLASS . xselect-convert-to-class)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
385 (NAME . xselect-convert-to-name)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
386 (ATOM . xselect-convert-to-atom)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
387 (INTEGER . xselect-convert-to-integer)
103891
77139c3e3747 * select.el (x-set-selection): Doc fix.
Chong Yidong <cyd@stupidchicken.com>
parents: 100908
diff changeset
388 (_EMACS_INTERNAL . xselect-convert-to-identity)))
2234
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
389
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
390 (provide 'select)
53ce64806d58 Initial revision
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
diff changeset
391
38414
67b464da13ec Some fixes to follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents: 33914
diff changeset
392 ;;; select.el ends here