From eb921aa2931859f55b11f3cc42a7fadd147a58d9 Mon Sep 17 00:00:00 2001
From: anastasisg <anastasis@learnworlds.com>
Date: Wed, 12 Feb 2025 00:44:47 +0200
Subject: keysym to ignore layout

---
 man/xlnch.1 | 104 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 man/xlnch.1

(limited to 'man/xlnch.1')

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
+[&]<key>:[<description>]:<command>
+.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
-- 
cgit v1.2.3