From eb921aa2931859f55b11f3cc42a7fadd147a58d9 Mon Sep 17 00:00:00 2001 From: anastasisg Date: Wed, 12 Feb 2025 00:44:47 +0200 Subject: keysym to ignore layout --- man/xlnch.1 | 104 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ man/xlnch.1.scd | 84 +++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 188 insertions(+) create mode 100644 man/xlnch.1 create mode 100644 man/xlnch.1.scd (limited to 'man') diff --git a/man/xlnch.1 b/man/xlnch.1 new file mode 100644 index 0000000..4ca4b92 --- /dev/null +++ b/man/xlnch.1 @@ -0,0 +1,104 @@ +.\" Generated by scdoc 1.11.1 +.\" Complete documentation for this program is not available as a GNU info page +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.nh +.ad l +.\" Begin generated content: +.TH "xlnch" "1" "2021-05-04" +.P +.P +.SH NAME +.P +xlnch - fast launcher for X +.P +.SH SYNOPSIS +.P +\fBxlnch\fR [\fIfile\fR] +.P +.SH OPTIONS +.P +\fBxlnch\fR has the following options: +.P +\fIfile\fR +.RS 4 +xlnch configuration.\& +.P +.RE +\fB-h\fR +.RS 4 +Print help.\& +.P +.RE +.SH DESCRIPTION +.P +\fBxlnch\fR parses a list of commands along with keys for executing them.\& It then +draws the avaliable commands with their keybinding and grabs the focus so the +next keypress will run the selected command.\& The configuration can either be +read from a file or from the standard input.\& +.P +.SH CONFIGURATION +.P +Each line is a command.\& It must have a key, and can optionally have a +description.\& By default xlnch exits when you press a key bound to a command.\& +You can prefix the key with an ampersand (&) which will keep \fBxlnch\fR open and +in focus.\& Those commands will be shown in red.\& If you ommit the command +description, \fBxlnch\fR will show the command instead.\& +.P +The configuration format is this: +.P +.RS 4 +[&]:[]: +.P +.RE +\fBkey\fR +.RS 4 +A single ascii character.\& +.P +.RE +\fBdescription\fR +.RS 4 +Any ascii string.\& +.P +.RE +\fBcommand\fR +.RS 4 +A valid command (see below).\& +.P +.RE +.SH EXAMPLE CONFIGURATION +.P +f::firefox +.br +e:The best editor:emacs +.br +&t:terminals:xterm +.P +In this example pressing \fIf\fR will launch firefox and then exit, same for \fIe\fR +and emacs.\& But if you press \fIt\fR an xterm will spawn but the launcher will stay +open, so pressing \fIt\fR twice will launch two xterms consecutively.\& This makes +more sense if used to control your window manager though it's cli interface or +similar applications.\& +.P +.SH VALID COMMANDS +.P +Internally \fBxlnch\fR uses \fBwordexp\fR(3) to parse the command.\& So the same +limitations apply.\& Some advanced stuff might be possible with clever quoting +and calling \fIbash -c\fR as the command but it is recommended to make a script for +such things and just call it from \fBxlnch\fR.\& +.P +.SH TIPS +.P +Since \fBxlnch\fR can read from stdin you can have "excecutable" files with +different configurations.\& Just add \fI#!\&/bin/xlnch\fR on the first line, make the +file executable and run it.\& +.P +You can call different xlnch configurations from within xlnch to create +submenues.\& Don't use the & for such calls because the two xlnch windows will +both want to constantly grab the focus.\& Either don't provide a way to go back +to the previous menu, or simply assign \fIb\fR to the parent menu so you have a way +back.\& +.P +.SH AUTHOR +.P +Anastasis Grammenos \ No newline at end of file diff --git a/man/xlnch.1.scd b/man/xlnch.1.scd new file mode 100644 index 0000000..824e2fc --- /dev/null +++ b/man/xlnch.1.scd @@ -0,0 +1,84 @@ +xlnch(1) + +; Tabs are required for indentation ( in emacs) + +# NAME + +xlnch - fast launcher for X + +# SYNOPSIS + +*xlnch* [_file_] + +# OPTIONS + +*xlnch* has the following options: + +_file_ + xlnch configuration. + +*-h* + Print help. + +# DESCRIPTION + +*xlnch* parses a list of commands along with keys for executing them. It then +draws the avaliable commands with their keybinding and grabs the focus so the +next keypress will run the selected command. The configuration can either be +read from a file or from the standard input. + +# CONFIGURATION + +Each line is a command. It must have a key, and can optionally have a +description. By default xlnch exits when you press a key bound to a command. +You can prefix the key with an ampersand (&) which will keep *xlnch* open and +in focus. Those commands will be shown in red. If you ommit the command +description, *xlnch* will show the command instead. + +The configuration format is this: + + \[&]:[]: + +*key* + A single ascii character. + +*description* + Any ascii string. + +*command* + A valid command (see below). + +# EXAMPLE CONFIGURATION + +f::firefox++ +e:The best editor:emacs++ +&t:terminals:xterm + +In this example pressing _f_ will launch firefox and then exit, same for _e_ +and emacs. But if you press _t_ an xterm will spawn but the launcher will stay +open, so pressing _t_ twice will launch two xterms consecutively. This makes +more sense if used to control your window manager though it's cli interface or +similar applications. + +# VALID COMMANDS + +Internally *xlnch* uses *wordexp*(3) to parse the command. So the same +limitations apply. Some advanced stuff might be possible with clever quoting +and calling _bash -c_ as the command but it is recommended to make a script for +such things and just call it from *xlnch*. + +# TIPS + +Since *xlnch* can read from stdin you can have "excecutable" files with +different configurations. Just add _#!/bin/xlnch_ on the first line (or the +appropriate path), make the file executable and run it. + +You can call different xlnch configurations from within xlnch to create +submenues. Don't use the & for such calls because the two xlnch windows will +both want to constantly grab the focus. Either don't provide a way to go back +to the previous menu, or simply assign _b_ to the parent menu so you have a way +back. + +# AUTHOR + +Anastasis Grammenos \ No newline at end of file -- cgit v1.2.3