aboutsummaryrefslogtreecommitdiff
path: root/system/crikey/README.source
diff options
context:
space:
mode:
authorBryan Harris <bryanlharris@gmail.com>2010-05-13 01:00:44 +0200
committerRobby Workman <rworkman@slackbuilds.org>2010-05-13 01:00:44 +0200
commite4fbc400eabcb6954f369c4292e4ee5e77209c02 (patch)
tree7739aa2bce7a367f696a42282b551dc061050053 /system/crikey/README.source
parentcf8a43d527c17d7ff0a04bc6e6554c420c82751c (diff)
system/crikey: Added to 13.0 repository
Diffstat (limited to 'system/crikey/README.source')
-rw-r--r--system/crikey/README.source67
1 files changed, 67 insertions, 0 deletions
diff --git a/system/crikey/README.source b/system/crikey/README.source
new file mode 100644
index 0000000000000..5748191778857
--- /dev/null
+++ b/system/crikey/README.source
@@ -0,0 +1,67 @@
+http://www.shallowsky.com/software/crikey/
+
+Usage (command-line flags)
+==========================
+Usage: crikey [-itxr] [-sS sleeptime] string...
+Send key events, as if args was typed in whatever X window currently has focus.
+Flags:
+ -s seconds: sleep time before sending
+ -S milliseconds: sleep time before sending
+ Many window managers need a delay for focus shifting
+ or to allow a modifier button to be released.
+ -i: Interactive (read input from stdin)
+ -t: Use XTest to send events (default)
+ -x: Use XSendEvent to send events
+ -r: Send events to root window (only with XSendEvent)
+ -l: Show long (more detailed) help
+ -d: Show debug messages
+
+If there are multiple arguments, single spaces will be inserted between them.
+
+
+
+Crikey input options
+====================
+Sample usage:
+
+crikey -s 1 'My long string\nExtending over two lines.'
+
+Using quotes around the string is normally recommended, to avoid problems with
+your shell treating any characters specially, especially backslashes.
+
+
+Special characters and syntaxes
+===============================
+Control characters use ^: ^A sends a Control-A
+Numeric ASCII codes (decimal only): \27 sends ESC
+
+Special codes:
+\t tab, \b backspace, \n newline, \r return, \d delete, \e escape, \\ backslash
+
+Modifier keys:
+\S shift, \C control, \A alt, \M or \W for the "Windows" key. These must be
+capitalized, and they only apply to the next single character, so \Aabc will
+send alt-A followed by b and c with no modifier keys.
+
+Special symbols with \( \): \(Return\) ... these are defined in
+/usr/include/X11/keysymdef.h, but only those defined on your keyboard will
+likely work.
+
+
+A Note on Xterm
+===============
+Crikey will work out of the box for most terminal emulators, but xterm blocks
+events generated with XSendEvent by default. To use crikey with xterm, you have
+two options:
+
+ * Use crikey -t, to use the X Test extension instead of XSendEvent (this is now the default).
+ * Add to your .Xdefaults file: XTerm*allowSendEvents: true
+
+Setting up Crikey in your Window Manager
+
+The most common way to use Crikey is to bind specific crikey commands to keys
+in your window manager (for instance, Shift-F12 might send a particular string).
+
+The procedure for making key bindings is different in every window manager,
+so I've moved the instructions for all the various window managers to a separate
+page: Making Crikey! work on various window managers.