ref: 3798304f5f499f30c6aef4a6561ad3f53d892908
parent: 8f50f11f51de6dd07f97db4a3e4b1b956af83313
author: glenda <glenda@9front.local>
date: Mon Sep 6 07:32:13 EDT 2021
dmenu: add a manpage
--- /dev/null
+++ b/dmenu.man
@@ -1,0 +1,75 @@
+.TH DMENU 1
+.
+.SH NAME
+.
+dmenu \- interactive menu for picking a selection
+.SH SYNOPSIS
+.B menu
+[
+.B -d
+]
+.B <choices
+.
+.SH DESCRIPTION
+.
+.I Dmenu
+reads lines of text from standard input and display them on screen.
+Entering text on keyboard fills the search query, filtering only
+lines that match it.
+Once selection is made, dmenu print the selected line to standard
+output and exits.
+.PP
+Along with Ctl+U, Ctl+W, Backspace, Del, LeftClic, MouseWheel,
+extra controls are provided:
+.TF "Enter / RightClic"
+.TP
+.B Ctl+P / Up
+Move selection up one line.
+.TP
+.B Ctl+N / Down
+Move selection down one line.
+.TP
+.B Enter / RightClic
+Print current selection and exit.
+.TP
+.B PgUp / PgDown
+Scroll the current matches.
+.
+.SH ENVIRONMENT VARIABLES
+.
+.TF "$font"
+.TP
+.B $font
+display font in use.
+.
+.SH EXAMPLES
+.
+Display the list of keyboard input digraphs:
+.RS
+.EE
+dmenu </lib/keyboard
+.EX
+.RE
+.PP
+Prompt an ssh host and connect to it:
+.RS
+.EX
+vt -b ssh `{sed 's/.* server=/root@/' $home/lib/sshthumbs | dmenu}+.EE
+.RE
+.PP
+Fetch passwords from secstore and copy it to snarf buffer.
+.RS
+.EX
+auth/secstore -G pass | dmenu | sed 's/.* pass=//' >/dev/snarf
+.EE
+.RE
+.
+.SH SOURCE
+.
+.B git://git.z0.is/9dmenu
+.
+.SH SEE ALSO
+.
+.IR fontsel (1),
+.IR menu (2).