1 /* X Selection processing for Emacs.
2 Copyright (C) 1993, 1994, 1995, 1996, 1997 Free Software Foundation.
4 This file is part of GNU Emacs.
6 GNU Emacs is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs; see the file COPYING. If not, write to
18 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19 Boston, MA 02111-1307, USA. */
22 /* Rewritten by jwz */
26 #include "xterm.h" /* for all of the X includes */
27 #include "dispextern.h" /* frame.h seems to want this */
28 #include "frame.h" /* Need this to get the X window of selected_frame */
29 #include "blockinput.h"
35 #define CUT_BUFFER_SUPPORT
37 Lisp_Object QPRIMARY
, QSECONDARY
, QSTRING
, QINTEGER
, QCLIPBOARD
, QTIMESTAMP
,
38 QTEXT
, QDELETE
, QMULTIPLE
, QINCR
, QEMACS_TMP
, QTARGETS
, QATOM
, QNULL
,
41 Lisp_Object QCOMPOUND_TEXT
; /* This is a type of selection. */
43 #ifdef CUT_BUFFER_SUPPORT
44 Lisp_Object QCUT_BUFFER0
, QCUT_BUFFER1
, QCUT_BUFFER2
, QCUT_BUFFER3
,
45 QCUT_BUFFER4
, QCUT_BUFFER5
, QCUT_BUFFER6
, QCUT_BUFFER7
;
48 static Lisp_Object Vx_lost_selection_hooks
;
49 static Lisp_Object Vx_sent_selection_hooks
;
50 /* Coding system for communicating with other X clients via cutbuffer,
51 selection, and clipboard. */
52 static Lisp_Object Vselection_coding_system
;
54 /* Coding system for the next communicating with other X clients. */
55 static Lisp_Object Vnext_selection_coding_system
;
57 /* If this is a smaller number than the max-request-size of the display,
58 emacs will use INCR selection transfer when the selection is larger
59 than this. The max-request-size is usually around 64k, so if you want
60 emacs to use incremental selection transfers when the selection is
61 smaller than that, set this. I added this mostly for debugging the
62 incremental transfer stuff, but it might improve server performance. */
63 #define MAX_SELECTION_QUANTUM 0xFFFFFF
66 #define SELECTION_QUANTUM(dpy) ((XMaxRequestSize(dpy) << 2) - 100)
68 #define SELECTION_QUANTUM(dpy) (((dpy)->max_request_size << 2) - 100)
71 /* The timestamp of the last input event Emacs received from the X server. */
72 /* Defined in keyboard.c. */
73 extern unsigned long last_event_timestamp
;
75 /* This is an association list whose elements are of the form
76 ( SELECTION-NAME SELECTION-VALUE SELECTION-TIMESTAMP FRAME)
77 SELECTION-NAME is a lisp symbol, whose name is the name of an X Atom.
78 SELECTION-VALUE is the value that emacs owns for that selection.
79 It may be any kind of Lisp object.
80 SELECTION-TIMESTAMP is the time at which emacs began owning this selection,
81 as a cons of two 16-bit numbers (making a 32 bit time.)
82 FRAME is the frame for which we made the selection.
83 If there is an entry in this alist, then it can be assumed that Emacs owns
85 The only (eq) parts of this list that are visible from Lisp are the
87 static Lisp_Object Vselection_alist
;
89 /* This is an alist whose CARs are selection-types (whose names are the same
90 as the names of X Atoms) and whose CDRs are the names of Lisp functions to
91 call to convert the given Emacs selection value to a string representing
92 the given selection type. This is for Lisp-level extension of the emacs
93 selection handling. */
94 static Lisp_Object Vselection_converter_alist
;
96 /* If the selection owner takes too long to reply to a selection request,
97 we give up on it. This is in milliseconds (0 = no timeout.) */
98 static int x_selection_timeout
;
100 /* Utility functions */
102 static void lisp_data_to_selection_data ();
103 static Lisp_Object
selection_data_to_lisp_data ();
104 static Lisp_Object
x_get_window_property_as_lisp_data ();
106 /* This converts a Lisp symbol to a server Atom, avoiding a server
107 roundtrip whenever possible. */
110 symbol_to_x_atom (dpyinfo
, display
, sym
)
111 struct x_display_info
*dpyinfo
;
116 if (NILP (sym
)) return 0;
117 if (EQ (sym
, QPRIMARY
)) return XA_PRIMARY
;
118 if (EQ (sym
, QSECONDARY
)) return XA_SECONDARY
;
119 if (EQ (sym
, QSTRING
)) return XA_STRING
;
120 if (EQ (sym
, QINTEGER
)) return XA_INTEGER
;
121 if (EQ (sym
, QATOM
)) return XA_ATOM
;
122 if (EQ (sym
, QCLIPBOARD
)) return dpyinfo
->Xatom_CLIPBOARD
;
123 if (EQ (sym
, QTIMESTAMP
)) return dpyinfo
->Xatom_TIMESTAMP
;
124 if (EQ (sym
, QTEXT
)) return dpyinfo
->Xatom_TEXT
;
125 if (EQ (sym
, QCOMPOUND_TEXT
)) return dpyinfo
->Xatom_COMPOUND_TEXT
;
126 if (EQ (sym
, QDELETE
)) return dpyinfo
->Xatom_DELETE
;
127 if (EQ (sym
, QMULTIPLE
)) return dpyinfo
->Xatom_MULTIPLE
;
128 if (EQ (sym
, QINCR
)) return dpyinfo
->Xatom_INCR
;
129 if (EQ (sym
, QEMACS_TMP
)) return dpyinfo
->Xatom_EMACS_TMP
;
130 if (EQ (sym
, QTARGETS
)) return dpyinfo
->Xatom_TARGETS
;
131 if (EQ (sym
, QNULL
)) return dpyinfo
->Xatom_NULL
;
132 #ifdef CUT_BUFFER_SUPPORT
133 if (EQ (sym
, QCUT_BUFFER0
)) return XA_CUT_BUFFER0
;
134 if (EQ (sym
, QCUT_BUFFER1
)) return XA_CUT_BUFFER1
;
135 if (EQ (sym
, QCUT_BUFFER2
)) return XA_CUT_BUFFER2
;
136 if (EQ (sym
, QCUT_BUFFER3
)) return XA_CUT_BUFFER3
;
137 if (EQ (sym
, QCUT_BUFFER4
)) return XA_CUT_BUFFER4
;
138 if (EQ (sym
, QCUT_BUFFER5
)) return XA_CUT_BUFFER5
;
139 if (EQ (sym
, QCUT_BUFFER6
)) return XA_CUT_BUFFER6
;
140 if (EQ (sym
, QCUT_BUFFER7
)) return XA_CUT_BUFFER7
;
142 if (!SYMBOLP (sym
)) abort ();
145 fprintf (stderr
, " XInternAtom %s\n", (char *) XSYMBOL (sym
)->name
->data
);
148 val
= XInternAtom (display
, (char *) XSYMBOL (sym
)->name
->data
, False
);
154 /* This converts a server Atom to a Lisp symbol, avoiding server roundtrips
155 and calls to intern whenever possible. */
158 x_atom_to_symbol (dpyinfo
, display
, atom
)
159 struct x_display_info
*dpyinfo
;
165 if (! atom
) return Qnil
;
178 #ifdef CUT_BUFFER_SUPPORT
198 if (atom
== dpyinfo
->Xatom_CLIPBOARD
)
200 if (atom
== dpyinfo
->Xatom_TIMESTAMP
)
202 if (atom
== dpyinfo
->Xatom_TEXT
)
204 if (atom
== dpyinfo
->Xatom_COMPOUND_TEXT
)
205 return QCOMPOUND_TEXT
;
206 if (atom
== dpyinfo
->Xatom_DELETE
)
208 if (atom
== dpyinfo
->Xatom_MULTIPLE
)
210 if (atom
== dpyinfo
->Xatom_INCR
)
212 if (atom
== dpyinfo
->Xatom_EMACS_TMP
)
214 if (atom
== dpyinfo
->Xatom_TARGETS
)
216 if (atom
== dpyinfo
->Xatom_NULL
)
220 str
= XGetAtomName (display
, atom
);
223 fprintf (stderr
, " XGetAtomName --> %s\n", str
);
225 if (! str
) return Qnil
;
228 /* This was allocated by Xlib, so use XFree. */
234 /* Do protocol to assert ourself as a selection owner.
235 Update the Vselection_alist so that we can reply to later requests for
239 x_own_selection (selection_name
, selection_value
)
240 Lisp_Object selection_name
, selection_value
;
242 Window selecting_window
= FRAME_X_WINDOW (selected_frame
);
243 Display
*display
= FRAME_X_DISPLAY (selected_frame
);
244 Time time
= last_event_timestamp
;
246 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (selected_frame
);
249 CHECK_SYMBOL (selection_name
, 0);
250 selection_atom
= symbol_to_x_atom (dpyinfo
, display
, selection_name
);
253 count
= x_catch_errors (display
);
254 XSetSelectionOwner (display
, selection_atom
, selecting_window
, time
);
255 x_check_errors (display
, "Can't set selection: %s");
256 x_uncatch_errors (display
, count
);
259 /* Now update the local cache */
261 Lisp_Object selection_time
;
262 Lisp_Object selection_data
;
263 Lisp_Object prev_value
;
265 selection_time
= long_to_cons ((unsigned long) time
);
266 selection_data
= Fcons (selection_name
,
267 Fcons (selection_value
,
268 Fcons (selection_time
,
269 Fcons (Fselected_frame (), Qnil
))));
270 prev_value
= assq_no_quit (selection_name
, Vselection_alist
);
272 Vselection_alist
= Fcons (selection_data
, Vselection_alist
);
274 /* If we already owned the selection, remove the old selection data.
275 Perhaps we should destructively modify it instead.
276 Don't use Fdelq as that may QUIT. */
277 if (!NILP (prev_value
))
279 Lisp_Object rest
; /* we know it's not the CAR, so it's easy. */
280 for (rest
= Vselection_alist
; !NILP (rest
); rest
= Fcdr (rest
))
281 if (EQ (prev_value
, Fcar (XCONS (rest
)->cdr
)))
283 XCONS (rest
)->cdr
= Fcdr (XCONS (rest
)->cdr
);
290 /* Given a selection-name and desired type, look up our local copy of
291 the selection value and convert it to the type.
292 The value is nil or a string.
293 This function is used both for remote requests
294 and for local x-get-selection-internal.
296 This calls random Lisp code, and may signal or gc. */
299 x_get_local_selection (selection_symbol
, target_type
)
300 Lisp_Object selection_symbol
, target_type
;
302 Lisp_Object local_value
;
303 Lisp_Object handler_fn
, value
, type
, check
;
306 local_value
= assq_no_quit (selection_symbol
, Vselection_alist
);
308 if (NILP (local_value
)) return Qnil
;
310 /* TIMESTAMP and MULTIPLE are special cases 'cause that's easiest. */
311 if (EQ (target_type
, QTIMESTAMP
))
314 value
= XCONS (XCONS (XCONS (local_value
)->cdr
)->cdr
)->car
;
317 else if (EQ (target_type
, QDELETE
))
320 Fx_disown_selection_internal
322 XCONS (XCONS (XCONS (local_value
)->cdr
)->cdr
)->car
);
327 #if 0 /* #### MULTIPLE doesn't work yet */
328 else if (CONSP (target_type
)
329 && XCONS (target_type
)->car
== QMULTIPLE
)
334 pairs
= XCONS (target_type
)->cdr
;
335 size
= XVECTOR (pairs
)->size
;
336 /* If the target is MULTIPLE, then target_type looks like
337 (MULTIPLE . [[SELECTION1 TARGET1] [SELECTION2 TARGET2] ... ])
338 We modify the second element of each pair in the vector and
339 return it as [[SELECTION1 <value1>] [SELECTION2 <value2>] ... ]
341 for (i
= 0; i
< size
; i
++)
344 pair
= XVECTOR (pairs
)->contents
[i
];
345 XVECTOR (pair
)->contents
[1]
346 = x_get_local_selection (XVECTOR (pair
)->contents
[0],
347 XVECTOR (pair
)->contents
[1]);
354 /* Don't allow a quit within the converter.
355 When the user types C-g, he would be surprised
356 if by luck it came during a converter. */
357 count
= specpdl_ptr
- specpdl
;
358 specbind (Qinhibit_quit
, Qt
);
360 CHECK_SYMBOL (target_type
, 0);
361 handler_fn
= Fcdr (Fassq (target_type
, Vselection_converter_alist
));
362 if (!NILP (handler_fn
))
363 value
= call3 (handler_fn
,
364 selection_symbol
, target_type
,
365 XCONS (XCONS (local_value
)->cdr
)->car
);
368 unbind_to (count
, Qnil
);
371 /* Make sure this value is of a type that we could transmit
372 to another X client. */
376 && SYMBOLP (XCONS (value
)->car
))
377 type
= XCONS (value
)->car
,
378 check
= XCONS (value
)->cdr
;
386 /* Check for a value that cons_to_long could handle. */
387 else if (CONSP (check
)
388 && INTEGERP (XCONS (check
)->car
)
389 && (INTEGERP (XCONS (check
)->cdr
)
391 (CONSP (XCONS (check
)->cdr
)
392 && INTEGERP (XCONS (XCONS (check
)->cdr
)->car
)
393 && NILP (XCONS (XCONS (check
)->cdr
)->cdr
))))
398 Fcons (build_string ("invalid data returned by selection-conversion function"),
399 Fcons (handler_fn
, Fcons (value
, Qnil
))));
402 /* Subroutines of x_reply_selection_request. */
404 /* Send a SelectionNotify event to the requestor with property=None,
405 meaning we were unable to do what they wanted. */
408 x_decline_selection_request (event
)
409 struct input_event
*event
;
411 XSelectionEvent reply
;
412 reply
.type
= SelectionNotify
;
413 reply
.display
= SELECTION_EVENT_DISPLAY (event
);
414 reply
.requestor
= SELECTION_EVENT_REQUESTOR (event
);
415 reply
.selection
= SELECTION_EVENT_SELECTION (event
);
416 reply
.time
= SELECTION_EVENT_TIME (event
);
417 reply
.target
= SELECTION_EVENT_TARGET (event
);
418 reply
.property
= None
;
421 XSendEvent (reply
.display
, reply
.requestor
, False
, 0L,
423 XFlush (reply
.display
);
427 /* This is the selection request currently being processed.
428 It is set to zero when the request is fully processed. */
429 static struct input_event
*x_selection_current_request
;
431 /* Used as an unwind-protect clause so that, if a selection-converter signals
432 an error, we tell the requester that we were unable to do what they wanted
433 before we throw to top-level or go into the debugger or whatever. */
436 x_selection_request_lisp_error (ignore
)
439 if (x_selection_current_request
!= 0)
440 x_decline_selection_request (x_selection_current_request
);
445 /* This stuff is so that INCR selections are reentrant (that is, so we can
446 be servicing multiple INCR selection requests simultaneously.) I haven't
447 actually tested that yet. */
449 /* Keep a list of the property changes that are awaited. */
459 struct prop_location
*next
;
462 static struct prop_location
*expect_property_change ();
463 static void wait_for_property_change ();
464 static void unexpect_property_change ();
465 static int waiting_for_other_props_on_window ();
467 static int prop_location_identifier
;
469 static Lisp_Object property_change_reply
;
471 static struct prop_location
*property_change_reply_object
;
473 static struct prop_location
*property_change_wait_list
;
476 queue_selection_requests_unwind (frame
)
479 FRAME_PTR f
= XFRAME (frame
);
482 x_stop_queuing_selection_requests (FRAME_X_DISPLAY (f
));
486 /* Return some frame whose display info is DPYINFO.
487 Return nil if there is none. */
490 some_frame_on_display (dpyinfo
)
491 struct x_display_info
*dpyinfo
;
493 Lisp_Object list
, frame
;
495 FOR_EACH_FRAME (list
, frame
)
497 if (FRAME_X_DISPLAY_INFO (XFRAME (frame
)) == dpyinfo
)
504 /* Send the reply to a selection request event EVENT.
505 TYPE is the type of selection data requested.
506 DATA and SIZE describe the data to send, already converted.
507 FORMAT is the unit-size (in bits) of the data to be transmitted. */
510 x_reply_selection_request (event
, format
, data
, size
, type
)
511 struct input_event
*event
;
516 XSelectionEvent reply
;
517 Display
*display
= SELECTION_EVENT_DISPLAY (event
);
518 Window window
= SELECTION_EVENT_REQUESTOR (event
);
520 int format_bytes
= format
/8;
521 int max_bytes
= SELECTION_QUANTUM (display
);
522 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
525 if (max_bytes
> MAX_SELECTION_QUANTUM
)
526 max_bytes
= MAX_SELECTION_QUANTUM
;
528 reply
.type
= SelectionNotify
;
529 reply
.display
= display
;
530 reply
.requestor
= window
;
531 reply
.selection
= SELECTION_EVENT_SELECTION (event
);
532 reply
.time
= SELECTION_EVENT_TIME (event
);
533 reply
.target
= SELECTION_EVENT_TARGET (event
);
534 reply
.property
= SELECTION_EVENT_PROPERTY (event
);
535 if (reply
.property
== None
)
536 reply
.property
= reply
.target
;
538 /* #### XChangeProperty can generate BadAlloc, and we must handle it! */
540 count
= x_catch_errors (display
);
542 /* Store the data on the requested property.
543 If the selection is large, only store the first N bytes of it.
545 bytes_remaining
= size
* format_bytes
;
546 if (bytes_remaining
<= max_bytes
)
548 /* Send all the data at once, with minimal handshaking. */
550 fprintf (stderr
,"\nStoring all %d\n", bytes_remaining
);
552 XChangeProperty (display
, window
, reply
.property
, type
, format
,
553 PropModeReplace
, data
, size
);
554 /* At this point, the selection was successfully stored; ack it. */
555 XSendEvent (display
, window
, False
, 0L, (XEvent
*) &reply
);
559 /* Send an INCR selection. */
560 struct prop_location
*wait_object
;
564 frame
= some_frame_on_display (dpyinfo
);
566 /* If the display no longer has frames, we can't expect
567 to get many more selection requests from it, so don't
568 bother trying to queue them. */
571 x_start_queuing_selection_requests (display
);
573 record_unwind_protect (queue_selection_requests_unwind
,
577 if (x_window_to_frame (dpyinfo
, window
)) /* #### debug */
578 error ("Attempt to transfer an INCR to ourself!");
580 fprintf (stderr
, "\nINCR %d\n", bytes_remaining
);
582 wait_object
= expect_property_change (display
, window
, reply
.property
,
585 XChangeProperty (display
, window
, reply
.property
, dpyinfo
->Xatom_INCR
,
587 (unsigned char *) &bytes_remaining
, 1);
588 XSelectInput (display
, window
, PropertyChangeMask
);
589 /* Tell 'em the INCR data is there... */
590 XSendEvent (display
, window
, False
, 0L, (XEvent
*) &reply
);
593 had_errors
= x_had_errors_p (display
);
596 /* First, wait for the requester to ack by deleting the property.
597 This can run random lisp code (process handlers) or signal. */
599 wait_for_property_change (wait_object
);
601 while (bytes_remaining
)
603 int i
= ((bytes_remaining
< max_bytes
)
610 = expect_property_change (display
, window
, reply
.property
,
613 fprintf (stderr
," INCR adding %d\n", i
);
615 /* Append the next chunk of data to the property. */
616 XChangeProperty (display
, window
, reply
.property
, type
, format
,
617 PropModeAppend
, data
, i
/ format_bytes
);
618 bytes_remaining
-= i
;
621 had_errors
= x_had_errors_p (display
);
627 /* Now wait for the requester to ack this chunk by deleting the
628 property. This can run random lisp code or signal.
630 wait_for_property_change (wait_object
);
632 /* Now write a zero-length chunk to the property to tell the requester
635 fprintf (stderr
," INCR done\n");
638 if (! waiting_for_other_props_on_window (display
, window
))
639 XSelectInput (display
, window
, 0L);
641 XChangeProperty (display
, window
, reply
.property
, type
, format
,
642 PropModeReplace
, data
, 0);
646 x_uncatch_errors (display
, count
);
650 /* Handle a SelectionRequest event EVENT.
651 This is called from keyboard.c when such an event is found in the queue. */
654 x_handle_selection_request (event
)
655 struct input_event
*event
;
657 struct gcpro gcpro1
, gcpro2
, gcpro3
;
658 Lisp_Object local_selection_data
;
659 Lisp_Object selection_symbol
;
660 Lisp_Object target_symbol
;
661 Lisp_Object converted_selection
;
662 Time local_selection_time
;
663 Lisp_Object successful_p
;
665 struct x_display_info
*dpyinfo
666 = x_display_info_for_display (SELECTION_EVENT_DISPLAY (event
));
668 local_selection_data
= Qnil
;
669 target_symbol
= Qnil
;
670 converted_selection
= Qnil
;
673 GCPRO3 (local_selection_data
, converted_selection
, target_symbol
);
675 selection_symbol
= x_atom_to_symbol (dpyinfo
,
676 SELECTION_EVENT_DISPLAY (event
),
677 SELECTION_EVENT_SELECTION (event
));
679 local_selection_data
= assq_no_quit (selection_symbol
, Vselection_alist
);
681 if (NILP (local_selection_data
))
683 /* Someone asked for the selection, but we don't have it any more.
685 x_decline_selection_request (event
);
689 local_selection_time
= (Time
)
690 cons_to_long (XCONS (XCONS (XCONS (local_selection_data
)->cdr
)->cdr
)->car
);
692 if (SELECTION_EVENT_TIME (event
) != CurrentTime
693 && local_selection_time
> SELECTION_EVENT_TIME (event
))
695 /* Someone asked for the selection, and we have one, but not the one
698 x_decline_selection_request (event
);
702 count
= specpdl_ptr
- specpdl
;
703 x_selection_current_request
= event
;
704 record_unwind_protect (x_selection_request_lisp_error
, Qnil
);
706 target_symbol
= x_atom_to_symbol (dpyinfo
, SELECTION_EVENT_DISPLAY (event
),
707 SELECTION_EVENT_TARGET (event
));
709 #if 0 /* #### MULTIPLE doesn't work yet */
710 if (EQ (target_symbol
, QMULTIPLE
))
711 target_symbol
= fetch_multiple_target (event
);
714 /* Convert lisp objects back into binary data */
717 = x_get_local_selection (selection_symbol
, target_symbol
);
719 if (! NILP (converted_selection
))
727 lisp_data_to_selection_data (SELECTION_EVENT_DISPLAY (event
),
729 &data
, &type
, &size
, &format
, &nofree
);
731 x_reply_selection_request (event
, format
, data
, size
, type
);
734 /* Indicate we have successfully processed this event. */
735 x_selection_current_request
= 0;
737 /* Use xfree, not XFree, because lisp_data_to_selection_data
738 calls xmalloc itself. */
742 unbind_to (count
, Qnil
);
748 /* Let random lisp code notice that the selection has been asked for. */
751 rest
= Vx_sent_selection_hooks
;
752 if (!EQ (rest
, Qunbound
))
753 for (; CONSP (rest
); rest
= Fcdr (rest
))
754 call3 (Fcar (rest
), selection_symbol
, target_symbol
, successful_p
);
758 /* Handle a SelectionClear event EVENT, which indicates that some
759 client cleared out our previously asserted selection.
760 This is called from keyboard.c when such an event is found in the queue. */
763 x_handle_selection_clear (event
)
764 struct input_event
*event
;
766 Display
*display
= SELECTION_EVENT_DISPLAY (event
);
767 Atom selection
= SELECTION_EVENT_SELECTION (event
);
768 Time changed_owner_time
= SELECTION_EVENT_TIME (event
);
770 Lisp_Object selection_symbol
, local_selection_data
;
771 Time local_selection_time
;
772 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
773 struct x_display_info
*t_dpyinfo
;
775 /* If the new selection owner is also Emacs,
776 don't clear the new selection. */
778 /* Check each display on the same terminal,
779 to see if this Emacs job now owns the selection
780 through that display. */
781 for (t_dpyinfo
= x_display_list
; t_dpyinfo
; t_dpyinfo
= t_dpyinfo
->next
)
782 if (t_dpyinfo
->kboard
== dpyinfo
->kboard
)
785 = XGetSelectionOwner (t_dpyinfo
->display
, selection
);
786 if (x_window_to_frame (t_dpyinfo
, owner_window
) != 0)
794 selection_symbol
= x_atom_to_symbol (dpyinfo
, display
, selection
);
796 local_selection_data
= assq_no_quit (selection_symbol
, Vselection_alist
);
798 /* Well, we already believe that we don't own it, so that's just fine. */
799 if (NILP (local_selection_data
)) return;
801 local_selection_time
= (Time
)
802 cons_to_long (XCONS (XCONS (XCONS (local_selection_data
)->cdr
)->cdr
)->car
);
804 /* This SelectionClear is for a selection that we no longer own, so we can
805 disregard it. (That is, we have reasserted the selection since this
806 request was generated.) */
808 if (changed_owner_time
!= CurrentTime
809 && local_selection_time
> changed_owner_time
)
812 /* Otherwise, we're really honest and truly being told to drop it.
813 Don't use Fdelq as that may QUIT;. */
815 if (EQ (local_selection_data
, Fcar (Vselection_alist
)))
816 Vselection_alist
= Fcdr (Vselection_alist
);
820 for (rest
= Vselection_alist
; !NILP (rest
); rest
= Fcdr (rest
))
821 if (EQ (local_selection_data
, Fcar (XCONS (rest
)->cdr
)))
823 XCONS (rest
)->cdr
= Fcdr (XCONS (rest
)->cdr
);
828 /* Let random lisp code notice that the selection has been stolen. */
832 rest
= Vx_lost_selection_hooks
;
833 if (!EQ (rest
, Qunbound
))
835 for (; CONSP (rest
); rest
= Fcdr (rest
))
836 call1 (Fcar (rest
), selection_symbol
);
837 prepare_menu_bars ();
838 redisplay_preserve_echo_area ();
843 /* Clear all selections that were made from frame F.
844 We do this when about to delete a frame. */
847 x_clear_frame_selections (f
)
853 XSETFRAME (frame
, f
);
855 /* Otherwise, we're really honest and truly being told to drop it.
856 Don't use Fdelq as that may QUIT;. */
858 /* Delete elements from the beginning of Vselection_alist. */
859 while (!NILP (Vselection_alist
)
860 && EQ (frame
, Fcar (Fcdr (Fcdr (Fcdr (Fcar (Vselection_alist
)))))))
862 /* Let random Lisp code notice that the selection has been stolen. */
863 Lisp_Object hooks
, selection_symbol
;
865 hooks
= Vx_lost_selection_hooks
;
866 selection_symbol
= Fcar (Fcar (Vselection_alist
));
868 if (!EQ (hooks
, Qunbound
))
870 for (; CONSP (hooks
); hooks
= Fcdr (hooks
))
871 call1 (Fcar (hooks
), selection_symbol
);
872 #if 0 /* This can crash when deleting a frame
873 from x_connection_closed. Anyway, it seems unnecessary;
874 something else should cause a redisplay. */
875 redisplay_preserve_echo_area ();
879 Vselection_alist
= Fcdr (Vselection_alist
);
882 /* Delete elements after the beginning of Vselection_alist. */
883 for (rest
= Vselection_alist
; !NILP (rest
); rest
= Fcdr (rest
))
884 if (EQ (frame
, Fcar (Fcdr (Fcdr (Fcdr (Fcar (XCONS (rest
)->cdr
)))))))
886 /* Let random Lisp code notice that the selection has been stolen. */
887 Lisp_Object hooks
, selection_symbol
;
889 hooks
= Vx_lost_selection_hooks
;
890 selection_symbol
= Fcar (Fcar (XCONS (rest
)->cdr
));
892 if (!EQ (hooks
, Qunbound
))
894 for (; CONSP (hooks
); hooks
= Fcdr (hooks
))
895 call1 (Fcar (hooks
), selection_symbol
);
896 #if 0 /* See above */
897 redisplay_preserve_echo_area ();
900 XCONS (rest
)->cdr
= Fcdr (XCONS (rest
)->cdr
);
905 /* Nonzero if any properties for DISPLAY and WINDOW
906 are on the list of what we are waiting for. */
909 waiting_for_other_props_on_window (display
, window
)
913 struct prop_location
*rest
= property_change_wait_list
;
915 if (rest
->display
== display
&& rest
->window
== window
)
922 /* Add an entry to the list of property changes we are waiting for.
923 DISPLAY, WINDOW, PROPERTY, STATE describe what we will wait for.
924 The return value is a number that uniquely identifies
925 this awaited property change. */
927 static struct prop_location
*
928 expect_property_change (display
, window
, property
, state
)
934 struct prop_location
*pl
935 = (struct prop_location
*) xmalloc (sizeof (struct prop_location
));
936 pl
->identifier
= ++prop_location_identifier
;
937 pl
->display
= display
;
939 pl
->property
= property
;
940 pl
->desired_state
= state
;
941 pl
->next
= property_change_wait_list
;
943 property_change_wait_list
= pl
;
947 /* Delete an entry from the list of property changes we are waiting for.
948 IDENTIFIER is the number that uniquely identifies the entry. */
951 unexpect_property_change (location
)
952 struct prop_location
*location
;
954 struct prop_location
*prev
= 0, *rest
= property_change_wait_list
;
957 if (rest
== location
)
960 prev
->next
= rest
->next
;
962 property_change_wait_list
= rest
->next
;
971 /* Remove the property change expectation element for IDENTIFIER. */
974 wait_for_property_change_unwind (identifierval
)
975 Lisp_Object identifierval
;
977 unexpect_property_change ((struct prop_location
*)
978 (XFASTINT (XCONS (identifierval
)->car
) << 16
979 | XFASTINT (XCONS (identifierval
)->cdr
)));
983 /* Actually wait for a property change.
984 IDENTIFIER should be the value that expect_property_change returned. */
987 wait_for_property_change (location
)
988 struct prop_location
*location
;
991 int count
= specpdl_ptr
- specpdl
;
994 tem
= Fcons (Qnil
, Qnil
);
995 XSETFASTINT (XCONS (tem
)->car
, (EMACS_UINT
)location
>> 16);
996 XSETFASTINT (XCONS (tem
)->cdr
, (EMACS_UINT
)location
& 0xffff);
998 /* Make sure to do unexpect_property_change if we quit or err. */
999 record_unwind_protect (wait_for_property_change_unwind
, tem
);
1001 XCONS (property_change_reply
)->car
= Qnil
;
1003 property_change_reply_object
= location
;
1004 /* If the event we are waiting for arrives beyond here, it will set
1005 property_change_reply, because property_change_reply_object says so. */
1006 if (! location
->arrived
)
1008 secs
= x_selection_timeout
/ 1000;
1009 usecs
= (x_selection_timeout
% 1000) * 1000;
1010 wait_reading_process_input (secs
, usecs
, property_change_reply
, 0);
1012 if (NILP (XCONS (property_change_reply
)->car
))
1013 error ("Timed out waiting for property-notify event");
1016 unbind_to (count
, Qnil
);
1019 /* Called from XTread_socket in response to a PropertyNotify event. */
1022 x_handle_property_notify (event
)
1023 XPropertyEvent
*event
;
1025 struct prop_location
*prev
= 0, *rest
= property_change_wait_list
;
1028 if (rest
->property
== event
->atom
1029 && rest
->window
== event
->window
1030 && rest
->display
== event
->display
1031 && rest
->desired_state
== event
->state
)
1034 fprintf (stderr
, "Saw expected prop-%s on %s\n",
1035 (event
->state
== PropertyDelete
? "delete" : "change"),
1036 (char *) XSYMBOL (x_atom_to_symbol (dpyinfo
, event
->display
,
1043 /* If this is the one wait_for_property_change is waiting for,
1044 tell it to wake up. */
1045 if (rest
== property_change_reply_object
)
1046 XCONS (property_change_reply
)->car
= Qt
;
1049 prev
->next
= rest
->next
;
1051 property_change_wait_list
= rest
->next
;
1059 fprintf (stderr
, "Saw UNexpected prop-%s on %s\n",
1060 (event
->state
== PropertyDelete
? "delete" : "change"),
1061 (char *) XSYMBOL (x_atom_to_symbol (dpyinfo
,
1062 event
->display
, event
->atom
))
1069 #if 0 /* #### MULTIPLE doesn't work yet */
1072 fetch_multiple_target (event
)
1073 XSelectionRequestEvent
*event
;
1075 Display
*display
= event
->display
;
1076 Window window
= event
->requestor
;
1077 Atom target
= event
->target
;
1078 Atom selection_atom
= event
->selection
;
1083 x_get_window_property_as_lisp_data (display
, window
, target
,
1084 QMULTIPLE
, selection_atom
));
1088 copy_multiple_data (obj
)
1095 return Fcons (XCONS (obj
)->car
, copy_multiple_data (XCONS (obj
)->cdr
));
1097 CHECK_VECTOR (obj
, 0);
1098 vec
= Fmake_vector (size
= XVECTOR (obj
)->size
, Qnil
);
1099 for (i
= 0; i
< size
; i
++)
1101 Lisp_Object vec2
= XVECTOR (obj
)->contents
[i
];
1102 CHECK_VECTOR (vec2
, 0);
1103 if (XVECTOR (vec2
)->size
!= 2)
1104 /* ??? Confusing error message */
1105 Fsignal (Qerror
, Fcons (build_string ("vectors must be of length 2"),
1106 Fcons (vec2
, Qnil
)));
1107 XVECTOR (vec
)->contents
[i
] = Fmake_vector (2, Qnil
);
1108 XVECTOR (XVECTOR (vec
)->contents
[i
])->contents
[0]
1109 = XVECTOR (vec2
)->contents
[0];
1110 XVECTOR (XVECTOR (vec
)->contents
[i
])->contents
[1]
1111 = XVECTOR (vec2
)->contents
[1];
1119 /* Variables for communication with x_handle_selection_notify. */
1120 static Atom reading_which_selection
;
1121 static Lisp_Object reading_selection_reply
;
1122 static Window reading_selection_window
;
1124 /* Do protocol to read selection-data from the server.
1125 Converts this to Lisp data and returns it. */
1128 x_get_foreign_selection (selection_symbol
, target_type
)
1129 Lisp_Object selection_symbol
, target_type
;
1131 Window requestor_window
= FRAME_X_WINDOW (selected_frame
);
1132 Display
*display
= FRAME_X_DISPLAY (selected_frame
);
1133 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (selected_frame
);
1134 Time requestor_time
= last_event_timestamp
;
1135 Atom target_property
= dpyinfo
->Xatom_EMACS_TMP
;
1136 Atom selection_atom
= symbol_to_x_atom (dpyinfo
, display
, selection_symbol
);
1142 if (CONSP (target_type
))
1143 type_atom
= symbol_to_x_atom (dpyinfo
, display
, XCONS (target_type
)->car
);
1145 type_atom
= symbol_to_x_atom (dpyinfo
, display
, target_type
);
1148 count
= x_catch_errors (display
);
1149 XConvertSelection (display
, selection_atom
, type_atom
, target_property
,
1150 requestor_window
, requestor_time
);
1153 /* Prepare to block until the reply has been read. */
1154 reading_selection_window
= requestor_window
;
1155 reading_which_selection
= selection_atom
;
1156 XCONS (reading_selection_reply
)->car
= Qnil
;
1158 frame
= some_frame_on_display (dpyinfo
);
1160 /* If the display no longer has frames, we can't expect
1161 to get many more selection requests from it, so don't
1162 bother trying to queue them. */
1165 x_start_queuing_selection_requests (display
);
1167 record_unwind_protect (queue_selection_requests_unwind
,
1172 /* This allows quits. Also, don't wait forever. */
1173 secs
= x_selection_timeout
/ 1000;
1174 usecs
= (x_selection_timeout
% 1000) * 1000;
1175 wait_reading_process_input (secs
, usecs
, reading_selection_reply
, 0);
1178 x_check_errors (display
, "Cannot get selection: %s");
1179 x_uncatch_errors (display
, count
);
1182 if (NILP (XCONS (reading_selection_reply
)->car
))
1183 error ("Timed out waiting for reply from selection owner");
1184 if (EQ (XCONS (reading_selection_reply
)->car
, Qlambda
))
1185 error ("No `%s' selection", XSYMBOL (selection_symbol
)->name
->data
);
1187 /* Otherwise, the selection is waiting for us on the requested property. */
1189 x_get_window_property_as_lisp_data (display
, requestor_window
,
1190 target_property
, target_type
,
1194 /* Subroutines of x_get_window_property_as_lisp_data */
1196 /* Use xfree, not XFree, to free the data obtained with this function. */
1199 x_get_window_property (display
, window
, property
, data_ret
, bytes_ret
,
1200 actual_type_ret
, actual_format_ret
, actual_size_ret
,
1205 unsigned char **data_ret
;
1207 Atom
*actual_type_ret
;
1208 int *actual_format_ret
;
1209 unsigned long *actual_size_ret
;
1213 unsigned long bytes_remaining
;
1215 unsigned char *tmp_data
= 0;
1217 int buffer_size
= SELECTION_QUANTUM (display
);
1218 if (buffer_size
> MAX_SELECTION_QUANTUM
) buffer_size
= MAX_SELECTION_QUANTUM
;
1221 /* First probe the thing to find out how big it is. */
1222 result
= XGetWindowProperty (display
, window
, property
,
1223 0L, 0L, False
, AnyPropertyType
,
1224 actual_type_ret
, actual_format_ret
,
1226 &bytes_remaining
, &tmp_data
);
1227 if (result
!= Success
)
1234 /* This was allocated by Xlib, so use XFree. */
1235 XFree ((char *) tmp_data
);
1237 if (*actual_type_ret
== None
|| *actual_format_ret
== 0)
1243 total_size
= bytes_remaining
+ 1;
1244 *data_ret
= (unsigned char *) xmalloc (total_size
);
1246 /* Now read, until we've gotten it all. */
1247 while (bytes_remaining
)
1250 int last
= bytes_remaining
;
1253 = XGetWindowProperty (display
, window
, property
,
1254 (long)offset
/4, (long)buffer_size
/4,
1257 actual_type_ret
, actual_format_ret
,
1258 actual_size_ret
, &bytes_remaining
, &tmp_data
);
1260 fprintf (stderr
, "<< read %d\n", last
-bytes_remaining
);
1262 /* If this doesn't return Success at this point, it means that
1263 some clod deleted the selection while we were in the midst of
1264 reading it. Deal with that, I guess....
1266 if (result
!= Success
) break;
1267 *actual_size_ret
*= *actual_format_ret
/ 8;
1268 bcopy (tmp_data
, (*data_ret
) + offset
, *actual_size_ret
);
1269 offset
+= *actual_size_ret
;
1270 /* This was allocated by Xlib, so use XFree. */
1271 XFree ((char *) tmp_data
);
1276 *bytes_ret
= offset
;
1279 /* Use xfree, not XFree, to free the data obtained with this function. */
1282 receive_incremental_selection (display
, window
, property
, target_type
,
1283 min_size_bytes
, data_ret
, size_bytes_ret
,
1284 type_ret
, format_ret
, size_ret
)
1288 Lisp_Object target_type
; /* for error messages only */
1289 unsigned int min_size_bytes
;
1290 unsigned char **data_ret
;
1291 int *size_bytes_ret
;
1293 unsigned long *size_ret
;
1297 struct prop_location
*wait_object
;
1298 *size_bytes_ret
= min_size_bytes
;
1299 *data_ret
= (unsigned char *) xmalloc (*size_bytes_ret
);
1301 fprintf (stderr
, "\nread INCR %d\n", min_size_bytes
);
1304 /* At this point, we have read an INCR property.
1305 Delete the property to ack it.
1306 (But first, prepare to receive the next event in this handshake.)
1308 Now, we must loop, waiting for the sending window to put a value on
1309 that property, then reading the property, then deleting it to ack.
1310 We are done when the sender places a property of length 0.
1313 XSelectInput (display
, window
, STANDARD_EVENT_SET
| PropertyChangeMask
);
1314 XDeleteProperty (display
, window
, property
);
1315 wait_object
= expect_property_change (display
, window
, property
,
1322 unsigned char *tmp_data
;
1324 wait_for_property_change (wait_object
);
1325 /* expect it again immediately, because x_get_window_property may
1326 .. no it won't, I don't get it.
1327 .. Ok, I get it now, the Xt code that implements INCR is broken.
1329 x_get_window_property (display
, window
, property
,
1330 &tmp_data
, &tmp_size_bytes
,
1331 type_ret
, format_ret
, size_ret
, 1);
1333 if (tmp_size_bytes
== 0) /* we're done */
1336 fprintf (stderr
, " read INCR done\n");
1338 if (! waiting_for_other_props_on_window (display
, window
))
1339 XSelectInput (display
, window
, STANDARD_EVENT_SET
);
1340 unexpect_property_change (wait_object
);
1341 /* Use xfree, not XFree, because x_get_window_property
1342 calls xmalloc itself. */
1343 if (tmp_data
) xfree (tmp_data
);
1348 XDeleteProperty (display
, window
, property
);
1349 wait_object
= expect_property_change (display
, window
, property
,
1355 fprintf (stderr
, " read INCR %d\n", tmp_size_bytes
);
1357 if (*size_bytes_ret
< offset
+ tmp_size_bytes
)
1360 fprintf (stderr
, " read INCR realloc %d -> %d\n",
1361 *size_bytes_ret
, offset
+ tmp_size_bytes
);
1363 *size_bytes_ret
= offset
+ tmp_size_bytes
;
1364 *data_ret
= (unsigned char *) xrealloc (*data_ret
, *size_bytes_ret
);
1366 bcopy (tmp_data
, (*data_ret
) + offset
, tmp_size_bytes
);
1367 offset
+= tmp_size_bytes
;
1368 /* Use xfree, not XFree, because x_get_window_property
1369 calls xmalloc itself. */
1374 /* Once a requested selection is "ready" (we got a SelectionNotify event),
1375 fetch value from property PROPERTY of X window WINDOW on display DISPLAY.
1376 TARGET_TYPE and SELECTION_ATOM are used in error message if this fails. */
1379 x_get_window_property_as_lisp_data (display
, window
, property
, target_type
,
1384 Lisp_Object target_type
; /* for error messages only */
1385 Atom selection_atom
; /* for error messages only */
1389 unsigned long actual_size
;
1390 unsigned char *data
= 0;
1393 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
1395 x_get_window_property (display
, window
, property
, &data
, &bytes
,
1396 &actual_type
, &actual_format
, &actual_size
, 1);
1399 int there_is_a_selection_owner
;
1401 there_is_a_selection_owner
1402 = XGetSelectionOwner (display
, selection_atom
);
1405 there_is_a_selection_owner
1406 ? Fcons (build_string ("selection owner couldn't convert"),
1408 ? Fcons (target_type
,
1409 Fcons (x_atom_to_symbol (dpyinfo
, display
,
1412 : Fcons (target_type
, Qnil
))
1413 : Fcons (build_string ("no selection"),
1414 Fcons (x_atom_to_symbol (dpyinfo
, display
,
1419 if (actual_type
== dpyinfo
->Xatom_INCR
)
1421 /* That wasn't really the data, just the beginning. */
1423 unsigned int min_size_bytes
= * ((unsigned int *) data
);
1425 /* Use xfree, not XFree, because x_get_window_property
1426 calls xmalloc itself. */
1427 xfree ((char *) data
);
1429 receive_incremental_selection (display
, window
, property
, target_type
,
1430 min_size_bytes
, &data
, &bytes
,
1431 &actual_type
, &actual_format
,
1436 XDeleteProperty (display
, window
, property
);
1440 /* It's been read. Now convert it to a lisp object in some semi-rational
1442 val
= selection_data_to_lisp_data (display
, data
, bytes
,
1443 actual_type
, actual_format
);
1445 /* Use xfree, not XFree, because x_get_window_property
1446 calls xmalloc itself. */
1447 xfree ((char *) data
);
1451 /* These functions convert from the selection data read from the server into
1452 something that we can use from Lisp, and vice versa.
1454 Type: Format: Size: Lisp Type:
1455 ----- ------- ----- -----------
1458 ATOM 32 > 1 Vector of Symbols
1460 * 16 > 1 Vector of Integers
1461 * 32 1 if <=16 bits: Integer
1462 if > 16 bits: Cons of top16, bot16
1463 * 32 > 1 Vector of the above
1465 When converting a Lisp number to C, it is assumed to be of format 16 if
1466 it is an integer, and of format 32 if it is a cons of two integers.
1468 When converting a vector of numbers from Lisp to C, it is assumed to be
1469 of format 16 if every element in the vector is an integer, and is assumed
1470 to be of format 32 if any element is a cons of two integers.
1472 When converting an object to C, it may be of the form (SYMBOL . <data>)
1473 where SYMBOL is what we should claim that the type is. Format and
1474 representation are as above. */
1479 selection_data_to_lisp_data (display
, data
, size
, type
, format
)
1481 unsigned char *data
;
1485 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
1487 if (type
== dpyinfo
->Xatom_NULL
)
1490 /* Convert any 8-bit data to a string, for compactness. */
1491 else if (format
== 8)
1494 int require_encoding
= 0;
1500 ! NILP (buffer_defaults
.enable_multibyte_characters
)
1504 /* If TYPE is `TEXT' or `COMPOUND_TEXT', we should decode
1505 DATA to Emacs internal format because DATA may be encoded
1506 in compound text format. In addtion, if TYPE is `STRING'
1507 and DATA contains any 8-bit Latin-1 code, we should also
1509 if (type
== dpyinfo
->Xatom_TEXT
1510 || type
== dpyinfo
->Xatom_COMPOUND_TEXT
)
1511 require_encoding
= 1;
1512 else if (type
== XA_STRING
)
1515 for (i
= 0; i
< size
; i
++)
1517 if (data
[i
] >= 0x80)
1519 require_encoding
= 1;
1525 if (!require_encoding
)
1527 str
= make_unibyte_string ((char *) data
, size
);
1528 Vlast_coding_system_used
= Qraw_text
;
1534 struct coding_system coding
;
1536 if (NILP (Vnext_selection_coding_system
))
1537 Vnext_selection_coding_system
= Vselection_coding_system
;
1539 (Fcheck_coding_system(Vnext_selection_coding_system
), &coding
);
1540 Vnext_selection_coding_system
= Qnil
;
1541 coding
.mode
|= CODING_MODE_LAST_BLOCK
;
1542 bufsize
= decoding_buffer_size (&coding
, size
);
1543 buf
= (unsigned char *) xmalloc (bufsize
);
1544 decode_coding (&coding
, data
, buf
, size
, bufsize
);
1545 size
= (coding
.fake_multibyte
1546 ? multibyte_chars_in_text (buf
, coding
.produced
)
1547 : coding
.produced_char
);
1548 str
= make_string_from_bytes ((char *) buf
, size
, coding
.produced
);
1550 Vlast_coding_system_used
= coding
.symbol
;
1554 /* Convert a single atom to a Lisp_Symbol. Convert a set of atoms to
1555 a vector of symbols.
1557 else if (type
== XA_ATOM
)
1560 if (size
== sizeof (Atom
))
1561 return x_atom_to_symbol (dpyinfo
, display
, *((Atom
*) data
));
1564 Lisp_Object v
= Fmake_vector (make_number (size
/ sizeof (Atom
)),
1566 for (i
= 0; i
< size
/ sizeof (Atom
); i
++)
1567 Faset (v
, make_number (i
),
1568 x_atom_to_symbol (dpyinfo
, display
, ((Atom
*) data
) [i
]));
1573 /* Convert a single 16 or small 32 bit number to a Lisp_Int.
1574 If the number is > 16 bits, convert it to a cons of integers,
1575 16 bits in each half.
1577 else if (format
== 32 && size
== sizeof (long))
1578 return long_to_cons (((unsigned long *) data
) [0]);
1579 else if (format
== 16 && size
== sizeof (short))
1580 return make_number ((int) (((unsigned short *) data
) [0]));
1582 /* Convert any other kind of data to a vector of numbers, represented
1583 as above (as an integer, or a cons of two 16 bit integers.)
1585 else if (format
== 16)
1589 v
= Fmake_vector (make_number (size
/ 2), make_number (0));
1590 for (i
= 0; i
< size
/ 2; i
++)
1592 int j
= (int) ((unsigned short *) data
) [i
];
1593 Faset (v
, make_number (i
), make_number (j
));
1600 Lisp_Object v
= Fmake_vector (make_number (size
/ 4), make_number (0));
1601 for (i
= 0; i
< size
/ 4; i
++)
1603 unsigned long j
= ((unsigned long *) data
) [i
];
1604 Faset (v
, make_number (i
), long_to_cons (j
));
1611 /* Use xfree, not XFree, to free the data obtained with this function. */
1614 lisp_data_to_selection_data (display
, obj
,
1615 data_ret
, type_ret
, size_ret
,
1616 format_ret
, nofree_ret
)
1619 unsigned char **data_ret
;
1621 unsigned int *size_ret
;
1625 Lisp_Object type
= Qnil
;
1626 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
1630 if (CONSP (obj
) && SYMBOLP (XCONS (obj
)->car
))
1632 type
= XCONS (obj
)->car
;
1633 obj
= XCONS (obj
)->cdr
;
1634 if (CONSP (obj
) && NILP (XCONS (obj
)->cdr
))
1635 obj
= XCONS (obj
)->car
;
1638 if (EQ (obj
, QNULL
) || (EQ (type
, QNULL
)))
1639 { /* This is not the same as declining */
1645 else if (STRINGP (obj
))
1647 /* Since we are now handling multilingual text, we must consider
1648 sending back compound text. */
1649 int charsets
[MAX_CHARSET
+ 1];
1653 *size_ret
= STRING_BYTES (XSTRING (obj
));
1654 *data_ret
= XSTRING (obj
)->data
;
1655 bzero (charsets
, (MAX_CHARSET
+ 1) * sizeof (int));
1656 num
= ((*size_ret
<= 1 /* Check the possibility of short cut. */
1657 || !STRING_MULTIBYTE (obj
)
1658 || *size_ret
== XSTRING (obj
)->size
)
1660 : find_charset_in_str (*data_ret
, *size_ret
, charsets
, Qnil
, 0, 1));
1662 if (!num
|| (num
== 1 && charsets
[CHARSET_ASCII
]))
1664 /* No multibyte character in OBJ. We need not encode it. */
1666 if (NILP (type
)) type
= QSTRING
;
1667 Vlast_coding_system_used
= Qraw_text
;
1671 /* We must encode contents of OBJ to compound text format.
1672 The format is compatible with what the target `STRING'
1673 expects if OBJ contains only ASCII and Latin-1
1677 struct coding_system coding
;
1679 if (NILP (Vnext_selection_coding_system
))
1680 Vnext_selection_coding_system
= Vselection_coding_system
;
1682 (Fcheck_coding_system (Vnext_selection_coding_system
), &coding
);
1683 Vnext_selection_coding_system
= Qnil
;
1684 coding
.mode
|= CODING_MODE_LAST_BLOCK
;
1685 bufsize
= encoding_buffer_size (&coding
, *size_ret
);
1686 buf
= (unsigned char *) xmalloc (bufsize
);
1687 encode_coding (&coding
, *data_ret
, buf
, *size_ret
, bufsize
);
1688 *size_ret
= coding
.produced
;
1690 if (charsets
[charset_latin_iso8859_1
]
1691 && (num
== 1 || (num
== 2 && charsets
[CHARSET_ASCII
])))
1693 /* Ok, we can return it as `STRING'. */
1694 if (NILP (type
)) type
= QSTRING
;
1698 /* We must return it as `COMPOUND_TEXT'. */
1699 if (NILP (type
)) type
= QCOMPOUND_TEXT
;
1701 Vlast_coding_system_used
= coding
.symbol
;
1704 else if (SYMBOLP (obj
))
1708 *data_ret
= (unsigned char *) xmalloc (sizeof (Atom
) + 1);
1709 (*data_ret
) [sizeof (Atom
)] = 0;
1710 (*(Atom
**) data_ret
) [0] = symbol_to_x_atom (dpyinfo
, display
, obj
);
1711 if (NILP (type
)) type
= QATOM
;
1713 else if (INTEGERP (obj
)
1714 && XINT (obj
) < 0xFFFF
1715 && XINT (obj
) > -0xFFFF)
1719 *data_ret
= (unsigned char *) xmalloc (sizeof (short) + 1);
1720 (*data_ret
) [sizeof (short)] = 0;
1721 (*(short **) data_ret
) [0] = (short) XINT (obj
);
1722 if (NILP (type
)) type
= QINTEGER
;
1724 else if (INTEGERP (obj
)
1725 || (CONSP (obj
) && INTEGERP (XCONS (obj
)->car
)
1726 && (INTEGERP (XCONS (obj
)->cdr
)
1727 || (CONSP (XCONS (obj
)->cdr
)
1728 && INTEGERP (XCONS (XCONS (obj
)->cdr
)->car
)))))
1732 *data_ret
= (unsigned char *) xmalloc (sizeof (long) + 1);
1733 (*data_ret
) [sizeof (long)] = 0;
1734 (*(unsigned long **) data_ret
) [0] = cons_to_long (obj
);
1735 if (NILP (type
)) type
= QINTEGER
;
1737 else if (VECTORP (obj
))
1739 /* Lisp_Vectors may represent a set of ATOMs;
1740 a set of 16 or 32 bit INTEGERs;
1741 or a set of ATOM_PAIRs (represented as [[A1 A2] [A3 A4] ...]
1745 if (SYMBOLP (XVECTOR (obj
)->contents
[0]))
1746 /* This vector is an ATOM set */
1748 if (NILP (type
)) type
= QATOM
;
1749 *size_ret
= XVECTOR (obj
)->size
;
1751 *data_ret
= (unsigned char *) xmalloc ((*size_ret
) * sizeof (Atom
));
1752 for (i
= 0; i
< *size_ret
; i
++)
1753 if (SYMBOLP (XVECTOR (obj
)->contents
[i
]))
1754 (*(Atom
**) data_ret
) [i
]
1755 = symbol_to_x_atom (dpyinfo
, display
, XVECTOR (obj
)->contents
[i
]);
1757 Fsignal (Qerror
, /* Qselection_error */
1759 ("all elements of selection vector must have same type"),
1760 Fcons (obj
, Qnil
)));
1762 #if 0 /* #### MULTIPLE doesn't work yet */
1763 else if (VECTORP (XVECTOR (obj
)->contents
[0]))
1764 /* This vector is an ATOM_PAIR set */
1766 if (NILP (type
)) type
= QATOM_PAIR
;
1767 *size_ret
= XVECTOR (obj
)->size
;
1769 *data_ret
= (unsigned char *)
1770 xmalloc ((*size_ret
) * sizeof (Atom
) * 2);
1771 for (i
= 0; i
< *size_ret
; i
++)
1772 if (VECTORP (XVECTOR (obj
)->contents
[i
]))
1774 Lisp_Object pair
= XVECTOR (obj
)->contents
[i
];
1775 if (XVECTOR (pair
)->size
!= 2)
1778 ("elements of the vector must be vectors of exactly two elements"),
1779 Fcons (pair
, Qnil
)));
1781 (*(Atom
**) data_ret
) [i
* 2]
1782 = symbol_to_x_atom (dpyinfo
, display
,
1783 XVECTOR (pair
)->contents
[0]);
1784 (*(Atom
**) data_ret
) [(i
* 2) + 1]
1785 = symbol_to_x_atom (dpyinfo
, display
,
1786 XVECTOR (pair
)->contents
[1]);
1791 ("all elements of the vector must be of the same type"),
1792 Fcons (obj
, Qnil
)));
1797 /* This vector is an INTEGER set, or something like it */
1799 *size_ret
= XVECTOR (obj
)->size
;
1800 if (NILP (type
)) type
= QINTEGER
;
1802 for (i
= 0; i
< *size_ret
; i
++)
1803 if (CONSP (XVECTOR (obj
)->contents
[i
]))
1805 else if (!INTEGERP (XVECTOR (obj
)->contents
[i
]))
1806 Fsignal (Qerror
, /* Qselection_error */
1808 ("elements of selection vector must be integers or conses of integers"),
1809 Fcons (obj
, Qnil
)));
1811 *data_ret
= (unsigned char *) xmalloc (*size_ret
* (*format_ret
/8));
1812 for (i
= 0; i
< *size_ret
; i
++)
1813 if (*format_ret
== 32)
1814 (*((unsigned long **) data_ret
)) [i
]
1815 = cons_to_long (XVECTOR (obj
)->contents
[i
]);
1817 (*((unsigned short **) data_ret
)) [i
]
1818 = (unsigned short) cons_to_long (XVECTOR (obj
)->contents
[i
]);
1822 Fsignal (Qerror
, /* Qselection_error */
1823 Fcons (build_string ("unrecognised selection data"),
1824 Fcons (obj
, Qnil
)));
1826 *type_ret
= symbol_to_x_atom (dpyinfo
, display
, type
);
1830 clean_local_selection_data (obj
)
1834 && INTEGERP (XCONS (obj
)->car
)
1835 && CONSP (XCONS (obj
)->cdr
)
1836 && INTEGERP (XCONS (XCONS (obj
)->cdr
)->car
)
1837 && NILP (XCONS (XCONS (obj
)->cdr
)->cdr
))
1838 obj
= Fcons (XCONS (obj
)->car
, XCONS (obj
)->cdr
);
1841 && INTEGERP (XCONS (obj
)->car
)
1842 && INTEGERP (XCONS (obj
)->cdr
))
1844 if (XINT (XCONS (obj
)->car
) == 0)
1845 return XCONS (obj
)->cdr
;
1846 if (XINT (XCONS (obj
)->car
) == -1)
1847 return make_number (- XINT (XCONS (obj
)->cdr
));
1852 int size
= XVECTOR (obj
)->size
;
1855 return clean_local_selection_data (XVECTOR (obj
)->contents
[0]);
1856 copy
= Fmake_vector (make_number (size
), Qnil
);
1857 for (i
= 0; i
< size
; i
++)
1858 XVECTOR (copy
)->contents
[i
]
1859 = clean_local_selection_data (XVECTOR (obj
)->contents
[i
]);
1865 /* Called from XTread_socket to handle SelectionNotify events.
1866 If it's the selection we are waiting for, stop waiting
1867 by setting the car of reading_selection_reply to non-nil.
1868 We store t there if the reply is successful, lambda if not. */
1871 x_handle_selection_notify (event
)
1872 XSelectionEvent
*event
;
1874 if (event
->requestor
!= reading_selection_window
)
1876 if (event
->selection
!= reading_which_selection
)
1879 XCONS (reading_selection_reply
)->car
1880 = (event
->property
!= 0 ? Qt
: Qlambda
);
1884 DEFUN ("x-own-selection-internal", Fx_own_selection_internal
,
1885 Sx_own_selection_internal
, 2, 2, 0,
1886 "Assert an X selection of the given TYPE with the given VALUE.\n\
1887 TYPE is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'.\n\
1888 \(Those are literal upper-case symbol names, since that's what X expects.)\n\
1889 VALUE is typically a string, or a cons of two markers, but may be\n\
1890 anything that the functions on `selection-converter-alist' know about.")
1891 (selection_name
, selection_value
)
1892 Lisp_Object selection_name
, selection_value
;
1895 CHECK_SYMBOL (selection_name
, 0);
1896 if (NILP (selection_value
)) error ("selection-value may not be nil");
1897 x_own_selection (selection_name
, selection_value
);
1898 return selection_value
;
1902 /* Request the selection value from the owner. If we are the owner,
1903 simply return our selection value. If we are not the owner, this
1904 will block until all of the data has arrived. */
1906 DEFUN ("x-get-selection-internal", Fx_get_selection_internal
,
1907 Sx_get_selection_internal
, 2, 2, 0,
1908 "Return text selected from some X window.\n\
1909 SELECTION is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'.\n\
1910 \(Those are literal upper-case symbol names, since that's what X expects.)\n\
1911 TYPE is the type of data desired, typically `STRING'.")
1912 (selection_symbol
, target_type
)
1913 Lisp_Object selection_symbol
, target_type
;
1915 Lisp_Object val
= Qnil
;
1916 struct gcpro gcpro1
, gcpro2
;
1917 GCPRO2 (target_type
, val
); /* we store newly consed data into these */
1919 CHECK_SYMBOL (selection_symbol
, 0);
1921 #if 0 /* #### MULTIPLE doesn't work yet */
1922 if (CONSP (target_type
)
1923 && XCONS (target_type
)->car
== QMULTIPLE
)
1925 CHECK_VECTOR (XCONS (target_type
)->cdr
, 0);
1926 /* So we don't destructively modify this... */
1927 target_type
= copy_multiple_data (target_type
);
1931 CHECK_SYMBOL (target_type
, 0);
1933 val
= x_get_local_selection (selection_symbol
, target_type
);
1937 val
= x_get_foreign_selection (selection_symbol
, target_type
);
1942 && SYMBOLP (XCONS (val
)->car
))
1944 val
= XCONS (val
)->cdr
;
1945 if (CONSP (val
) && NILP (XCONS (val
)->cdr
))
1946 val
= XCONS (val
)->car
;
1948 val
= clean_local_selection_data (val
);
1954 DEFUN ("x-disown-selection-internal", Fx_disown_selection_internal
,
1955 Sx_disown_selection_internal
, 1, 2, 0,
1956 "If we own the selection SELECTION, disown it.\n\
1957 Disowning it means there is no such selection.")
1959 Lisp_Object selection
;
1963 Atom selection_atom
;
1964 struct selection_input_event event
;
1966 struct x_display_info
*dpyinfo
;
1969 display
= FRAME_X_DISPLAY (selected_frame
);
1970 dpyinfo
= FRAME_X_DISPLAY_INFO (selected_frame
);
1971 CHECK_SYMBOL (selection
, 0);
1973 timestamp
= last_event_timestamp
;
1975 timestamp
= cons_to_long (time
);
1977 if (NILP (assq_no_quit (selection
, Vselection_alist
)))
1978 return Qnil
; /* Don't disown the selection when we're not the owner. */
1980 selection_atom
= symbol_to_x_atom (dpyinfo
, display
, selection
);
1983 XSetSelectionOwner (display
, selection_atom
, None
, timestamp
);
1986 /* It doesn't seem to be guaranteed that a SelectionClear event will be
1987 generated for a window which owns the selection when that window sets
1988 the selection owner to None. The NCD server does, the MIT Sun4 server
1989 doesn't. So we synthesize one; this means we might get two, but
1990 that's ok, because the second one won't have any effect. */
1991 SELECTION_EVENT_DISPLAY (&event
) = display
;
1992 SELECTION_EVENT_SELECTION (&event
) = selection_atom
;
1993 SELECTION_EVENT_TIME (&event
) = timestamp
;
1994 x_handle_selection_clear ((struct input_event
*) &event
);
1999 /* Get rid of all the selections in buffer BUFFER.
2000 This is used when we kill a buffer. */
2003 x_disown_buffer_selections (buffer
)
2007 struct buffer
*buf
= XBUFFER (buffer
);
2009 for (tail
= Vselection_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
2011 Lisp_Object elt
, value
;
2012 elt
= XCONS (tail
)->car
;
2013 value
= XCONS (elt
)->cdr
;
2014 if (CONSP (value
) && MARKERP (XCONS (value
)->car
)
2015 && XMARKER (XCONS (value
)->car
)->buffer
== buf
)
2016 Fx_disown_selection_internal (XCONS (elt
)->car
, Qnil
);
2020 DEFUN ("x-selection-owner-p", Fx_selection_owner_p
, Sx_selection_owner_p
,
2022 "Whether the current Emacs process owns the given X Selection.\n\
2023 The arg should be the name of the selection in question, typically one of\n\
2024 the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'.\n\
2025 \(Those are literal upper-case symbol names, since that's what X expects.)\n\
2026 For convenience, the symbol nil is the same as `PRIMARY',\n\
2027 and t is the same as `SECONDARY'.)")
2029 Lisp_Object selection
;
2032 CHECK_SYMBOL (selection
, 0);
2033 if (EQ (selection
, Qnil
)) selection
= QPRIMARY
;
2034 if (EQ (selection
, Qt
)) selection
= QSECONDARY
;
2036 if (NILP (Fassq (selection
, Vselection_alist
)))
2041 DEFUN ("x-selection-exists-p", Fx_selection_exists_p
, Sx_selection_exists_p
,
2043 "Whether there is an owner for the given X Selection.\n\
2044 The arg should be the name of the selection in question, typically one of\n\
2045 the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'.\n\
2046 \(Those are literal upper-case symbol names, since that's what X expects.)\n\
2047 For convenience, the symbol nil is the same as `PRIMARY',\n\
2048 and t is the same as `SECONDARY'.)")
2050 Lisp_Object selection
;
2056 /* It should be safe to call this before we have an X frame. */
2057 if (! FRAME_X_P (selected_frame
))
2060 dpy
= FRAME_X_DISPLAY (selected_frame
);
2061 CHECK_SYMBOL (selection
, 0);
2062 if (!NILP (Fx_selection_owner_p (selection
)))
2064 if (EQ (selection
, Qnil
)) selection
= QPRIMARY
;
2065 if (EQ (selection
, Qt
)) selection
= QSECONDARY
;
2066 atom
= symbol_to_x_atom (FRAME_X_DISPLAY_INFO (selected_frame
),
2071 owner
= XGetSelectionOwner (dpy
, atom
);
2073 return (owner
? Qt
: Qnil
);
2077 #ifdef CUT_BUFFER_SUPPORT
2079 /* Ensure that all 8 cut buffers exist. ICCCM says we gotta... */
2081 initialize_cut_buffers (display
, window
)
2085 unsigned char *data
= (unsigned char *) "";
2087 #define FROB(atom) XChangeProperty (display, window, atom, XA_STRING, 8, \
2088 PropModeAppend, data, 0)
2089 FROB (XA_CUT_BUFFER0
);
2090 FROB (XA_CUT_BUFFER1
);
2091 FROB (XA_CUT_BUFFER2
);
2092 FROB (XA_CUT_BUFFER3
);
2093 FROB (XA_CUT_BUFFER4
);
2094 FROB (XA_CUT_BUFFER5
);
2095 FROB (XA_CUT_BUFFER6
);
2096 FROB (XA_CUT_BUFFER7
);
2102 #define CHECK_CUT_BUFFER(symbol,n) \
2103 { CHECK_SYMBOL ((symbol), (n)); \
2104 if (!EQ((symbol), QCUT_BUFFER0) && !EQ((symbol), QCUT_BUFFER1) \
2105 && !EQ((symbol), QCUT_BUFFER2) && !EQ((symbol), QCUT_BUFFER3) \
2106 && !EQ((symbol), QCUT_BUFFER4) && !EQ((symbol), QCUT_BUFFER5) \
2107 && !EQ((symbol), QCUT_BUFFER6) && !EQ((symbol), QCUT_BUFFER7)) \
2109 Fcons (build_string ("doesn't name a cut buffer"), \
2110 Fcons ((symbol), Qnil))); \
2113 DEFUN ("x-get-cut-buffer-internal", Fx_get_cut_buffer_internal
,
2114 Sx_get_cut_buffer_internal
, 1, 1, 0,
2115 "Returns the value of the named cut buffer (typically CUT_BUFFER0).")
2121 unsigned char *data
;
2128 struct x_display_info
*dpyinfo
;
2131 display
= FRAME_X_DISPLAY (selected_frame
);
2132 dpyinfo
= FRAME_X_DISPLAY_INFO (selected_frame
);
2133 window
= RootWindow (display
, 0); /* Cut buffers are on screen 0 */
2134 CHECK_CUT_BUFFER (buffer
, 0);
2135 buffer_atom
= symbol_to_x_atom (dpyinfo
, display
, buffer
);
2137 x_get_window_property (display
, window
, buffer_atom
, &data
, &bytes
,
2138 &type
, &format
, &size
, 0);
2139 if (!data
|| !format
)
2142 if (format
!= 8 || type
!= XA_STRING
)
2144 Fcons (build_string ("cut buffer doesn't contain 8-bit data"),
2145 Fcons (x_atom_to_symbol (dpyinfo
, display
, type
),
2146 Fcons (make_number (format
), Qnil
))));
2148 ret
= (bytes
? make_string ((char *) data
, bytes
) : Qnil
);
2149 /* Use xfree, not XFree, because x_get_window_property
2150 calls xmalloc itself. */
2156 DEFUN ("x-store-cut-buffer-internal", Fx_store_cut_buffer_internal
,
2157 Sx_store_cut_buffer_internal
, 2, 2, 0,
2158 "Sets the value of the named cut buffer (typically CUT_BUFFER0).")
2160 Lisp_Object buffer
, string
;
2164 unsigned char *data
;
2166 int bytes_remaining
;
2171 display
= FRAME_X_DISPLAY (selected_frame
);
2172 window
= RootWindow (display
, 0); /* Cut buffers are on screen 0 */
2174 max_bytes
= SELECTION_QUANTUM (display
);
2175 if (max_bytes
> MAX_SELECTION_QUANTUM
)
2176 max_bytes
= MAX_SELECTION_QUANTUM
;
2178 CHECK_CUT_BUFFER (buffer
, 0);
2179 CHECK_STRING (string
, 0);
2180 buffer_atom
= symbol_to_x_atom (FRAME_X_DISPLAY_INFO (selected_frame
),
2182 data
= (unsigned char *) XSTRING (string
)->data
;
2183 bytes
= STRING_BYTES (XSTRING (string
));
2184 bytes_remaining
= bytes
;
2186 if (! FRAME_X_DISPLAY_INFO (selected_frame
)->cut_buffers_initialized
)
2188 initialize_cut_buffers (display
, window
);
2189 FRAME_X_DISPLAY_INFO (selected_frame
)->cut_buffers_initialized
= 1;
2194 /* Don't mess up with an empty value. */
2195 if (!bytes_remaining
)
2196 XChangeProperty (display
, window
, buffer_atom
, XA_STRING
, 8,
2197 PropModeReplace
, data
, 0);
2199 while (bytes_remaining
)
2201 int chunk
= (bytes_remaining
< max_bytes
2202 ? bytes_remaining
: max_bytes
);
2203 XChangeProperty (display
, window
, buffer_atom
, XA_STRING
, 8,
2204 (bytes_remaining
== bytes
2209 bytes_remaining
-= chunk
;
2216 DEFUN ("x-rotate-cut-buffers-internal", Fx_rotate_cut_buffers_internal
,
2217 Sx_rotate_cut_buffers_internal
, 1, 1, 0,
2218 "Rotate the values of the cut buffers by the given number of step.\n\
2219 Positive means shift the values forward, negative means backward.")
2228 display
= FRAME_X_DISPLAY (selected_frame
);
2229 window
= RootWindow (display
, 0); /* Cut buffers are on screen 0 */
2230 CHECK_NUMBER (n
, 0);
2233 if (! FRAME_X_DISPLAY_INFO (selected_frame
)->cut_buffers_initialized
)
2235 initialize_cut_buffers (display
, window
);
2236 FRAME_X_DISPLAY_INFO (selected_frame
)->cut_buffers_initialized
= 1;
2239 props
[0] = XA_CUT_BUFFER0
;
2240 props
[1] = XA_CUT_BUFFER1
;
2241 props
[2] = XA_CUT_BUFFER2
;
2242 props
[3] = XA_CUT_BUFFER3
;
2243 props
[4] = XA_CUT_BUFFER4
;
2244 props
[5] = XA_CUT_BUFFER5
;
2245 props
[6] = XA_CUT_BUFFER6
;
2246 props
[7] = XA_CUT_BUFFER7
;
2248 XRotateWindowProperties (display
, window
, props
, 8, XINT (n
));
2258 defsubr (&Sx_get_selection_internal
);
2259 defsubr (&Sx_own_selection_internal
);
2260 defsubr (&Sx_disown_selection_internal
);
2261 defsubr (&Sx_selection_owner_p
);
2262 defsubr (&Sx_selection_exists_p
);
2264 #ifdef CUT_BUFFER_SUPPORT
2265 defsubr (&Sx_get_cut_buffer_internal
);
2266 defsubr (&Sx_store_cut_buffer_internal
);
2267 defsubr (&Sx_rotate_cut_buffers_internal
);
2270 reading_selection_reply
= Fcons (Qnil
, Qnil
);
2271 staticpro (&reading_selection_reply
);
2272 reading_selection_window
= 0;
2273 reading_which_selection
= 0;
2275 property_change_wait_list
= 0;
2276 prop_location_identifier
= 0;
2277 property_change_reply
= Fcons (Qnil
, Qnil
);
2278 staticpro (&property_change_reply
);
2280 Vselection_alist
= Qnil
;
2281 staticpro (&Vselection_alist
);
2283 DEFVAR_LISP ("selection-converter-alist", &Vselection_converter_alist
,
2284 "An alist associating X Windows selection-types with functions.\n\
2285 These functions are called to convert the selection, with three args:\n\
2286 the name of the selection (typically `PRIMARY', `SECONDARY', or `CLIPBOARD');\n\
2287 a desired type to which the selection should be converted;\n\
2288 and the local selection value (whatever was given to `x-own-selection').\n\
2290 The function should return the value to send to the X server\n\
2291 \(typically a string). A return value of nil\n\
2292 means that the conversion could not be done.\n\
2293 A return value which is the symbol `NULL'\n\
2294 means that a side-effect was executed,\n\
2295 and there is no meaningful selection value.");
2296 Vselection_converter_alist
= Qnil
;
2298 DEFVAR_LISP ("x-lost-selection-hooks", &Vx_lost_selection_hooks
,
2299 "A list of functions to be called when Emacs loses an X selection.\n\
2300 \(This happens when some other X client makes its own selection\n\
2301 or when a Lisp program explicitly clears the selection.)\n\
2302 The functions are called with one argument, the selection type\n\
2303 \(a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD').");
2304 Vx_lost_selection_hooks
= Qnil
;
2306 DEFVAR_LISP ("x-sent-selection-hooks", &Vx_sent_selection_hooks
,
2307 "A list of functions to be called when Emacs answers a selection request.\n\
2308 The functions are called with four arguments:\n\
2309 - the selection name (typically `PRIMARY', `SECONDARY', or `CLIPBOARD');\n\
2310 - the selection-type which Emacs was asked to convert the\n\
2311 selection into before sending (for example, `STRING' or `LENGTH');\n\
2312 - a flag indicating success or failure for responding to the request.\n\
2313 We might have failed (and declined the request) for any number of reasons,\n\
2314 including being asked for a selection that we no longer own, or being asked\n\
2315 to convert into a type that we don't know about or that is inappropriate.\n\
2316 This hook doesn't let you change the behavior of Emacs's selection replies,\n\
2317 it merely informs you that they have happened.");
2318 Vx_sent_selection_hooks
= Qnil
;
2320 DEFVAR_LISP ("selection-coding-system", &Vselection_coding_system
,
2321 "Coding system for communicating with other X clients.\n\
2322 When sending or receiving text via cut_buffer, selection, and clipboard,\n\
2323 the text is encoded or decoded by this coding system.\n\
2324 The default value is `compound-text'.");
2325 Vselection_coding_system
= intern ("compound-text");
2327 DEFVAR_LISP ("next-selection-coding-system", &Vnext_selection_coding_system
,
2328 "Coding system for the next communication with other X clients.\n\
2329 Usually, `selection-coding-system' is used for communicating with\n\
2330 other X clients. But, if this variable is set, it is used for the\n\
2331 next communication only. After the communication, this variable is\n\
2333 Vnext_selection_coding_system
= Qnil
;
2335 DEFVAR_INT ("x-selection-timeout", &x_selection_timeout
,
2336 "Number of milliseconds to wait for a selection reply.\n\
2337 If the selection owner doesn't reply in this time, we give up.\n\
2338 A value of 0 means wait as long as necessary. This is initialized from the\n\
2339 \"*selectionTimeout\" resource.");
2340 x_selection_timeout
= 0;
2342 QPRIMARY
= intern ("PRIMARY"); staticpro (&QPRIMARY
);
2343 QSECONDARY
= intern ("SECONDARY"); staticpro (&QSECONDARY
);
2344 QSTRING
= intern ("STRING"); staticpro (&QSTRING
);
2345 QINTEGER
= intern ("INTEGER"); staticpro (&QINTEGER
);
2346 QCLIPBOARD
= intern ("CLIPBOARD"); staticpro (&QCLIPBOARD
);
2347 QTIMESTAMP
= intern ("TIMESTAMP"); staticpro (&QTIMESTAMP
);
2348 QTEXT
= intern ("TEXT"); staticpro (&QTEXT
);
2349 QCOMPOUND_TEXT
= intern ("COMPOUND_TEXT"); staticpro (&QCOMPOUND_TEXT
);
2350 QTIMESTAMP
= intern ("TIMESTAMP"); staticpro (&QTIMESTAMP
);
2351 QDELETE
= intern ("DELETE"); staticpro (&QDELETE
);
2352 QMULTIPLE
= intern ("MULTIPLE"); staticpro (&QMULTIPLE
);
2353 QINCR
= intern ("INCR"); staticpro (&QINCR
);
2354 QEMACS_TMP
= intern ("_EMACS_TMP_"); staticpro (&QEMACS_TMP
);
2355 QTARGETS
= intern ("TARGETS"); staticpro (&QTARGETS
);
2356 QATOM
= intern ("ATOM"); staticpro (&QATOM
);
2357 QATOM_PAIR
= intern ("ATOM_PAIR"); staticpro (&QATOM_PAIR
);
2358 QNULL
= intern ("NULL"); staticpro (&QNULL
);
2360 #ifdef CUT_BUFFER_SUPPORT
2361 QCUT_BUFFER0
= intern ("CUT_BUFFER0"); staticpro (&QCUT_BUFFER0
);
2362 QCUT_BUFFER1
= intern ("CUT_BUFFER1"); staticpro (&QCUT_BUFFER1
);
2363 QCUT_BUFFER2
= intern ("CUT_BUFFER2"); staticpro (&QCUT_BUFFER2
);
2364 QCUT_BUFFER3
= intern ("CUT_BUFFER3"); staticpro (&QCUT_BUFFER3
);
2365 QCUT_BUFFER4
= intern ("CUT_BUFFER4"); staticpro (&QCUT_BUFFER4
);
2366 QCUT_BUFFER5
= intern ("CUT_BUFFER5"); staticpro (&QCUT_BUFFER5
);
2367 QCUT_BUFFER6
= intern ("CUT_BUFFER6"); staticpro (&QCUT_BUFFER6
);
2368 QCUT_BUFFER7
= intern ("CUT_BUFFER7"); staticpro (&QCUT_BUFFER7
);