chiark / gitweb /
Bugfixes:
[chiark-utils.git] / cprogs / xduplic-copier.1
1 .TH WITH-LOCK-EX "1" "July 2003" "Debian" "Chiark-utils-bin"
2 .SH NAME
3 xduplic-copier \- type into multiple X windows at once
4 .SH SYNOPSIS
5 .B xduplic-copier
6 .SH DESCRIPTION
7 xduplic-copier lets you type into multiple X windows at once.
8
9 It has a very basic user interface for selecting which windows to type
10 into.
11 .SH OPTIONS
12 xduplic-copier ignores its command-line arguments.
13 .SH MODES
14 xduplic-copier puts up a small window with some text in it.  It has
15 two modes:
16 .TP
17 Idle: "\fBi 0\fR" (red); Typing "\fBT\fR \fIcount\fR" (green)
18 If you type keystrokes into xduplic-copier, they will be replicated to
19 all the selected windows (if there are any).  (You can also type into
20 the selected windows individually in the normal way.)
21 count is the number of selected windows.
22 The starting mode is Idle; you should left-click to start selecting.
23 .TP
24 Selecting: "\fBS\fR \fIcount\fR" (white)
25 In this mode xduplic-copier has grabbed the mouse pointer and you
26 can indicate which windows you are going to want to type into.
27 .SH MOUSE ACTIONS
28 .TP
29 Left-click in xduplic-copier
30 Switch between typing and selecting modes.
31 .TP
32 Right-click in xduplic-copier
33 Quit.
34 .TP
35 Left-click in another window while selecting
36 Select this window.  (Beeps if already selected.)
37 .TP
38 Right-click in another window while selecting
39 Deselect this window.  (Beeps if not selected.)
40 .TP
41 Right-click in root window (ie, desktop background) while selecting
42 Deselect all windows.
43 .TP
44 Q key while selecting
45 Quits.
46 .SH XTERM AND ALLOW SENDEVENTS
47 xduplic-copier does its work by generating synthetic events for the
48 selected windows, using XSendEvent.  Unfortunately the xterm authors
49 think that allowing XSendEvent is a security problem; they are wrong:
50 any untrusted person can already take over your xterms anyway.  But
51 the xterm authors have configured xterm to discard synthetic events by
52 default.
53
54 You can solve this at runtime by bringing up the ctrl-leftbutton menu in
55 each xterm, and ticking the option "Allow SendEvents".  Or you can set
56 the allowSendEvents in your xterm X resources.
57
58 Neither of these significantly reduce your security.  Indeed, xterm
59 itself allows these properties to be set via the X toolkit system's
60 remote widget property setting arrangements - so it would be possible
61 for xduplic-copier to set this property itself on any xterms it
62 encountered.  Unfortunately doing so would be a lot of tedious
63 programming.
64 .SH BUGS
65 If one of the windows you have selected is closed, and you try typing,
66 xduplic-copier will crash due to an unhandled X11 error.  If you
67 notice that you have got into this state, you cannot retain your set
68 of selected windows because there is no way to click on the
69 now-destroyed window to deselect it.  You can keep xduplic-copier from
70 crashing by right-clicking on the background in selecting mode, and
71 then reselecting all your windows, which may be marginally more
72 convenient than restarting it.
73
74 The UI is perhaps excessively sparse.
75 .SH AUTHOR AND COPYRIGHT
76 Ian Jackson <ijackson@chiark.greenend.org.uk> wrote xduplic-copier
77 some time in 2002, and updated it in 2013. The manpage is from 2013.
78
79 xduplic-copier is govered by the GNU GPL, v3 or later.