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.