speedie/spmenu
2
0
Fork 1
Code Issues 1 Pull requests Packages Projects Releases 15 Wiki Activity

various docs changes to represent last few commits

Browse source
This commit is contained in:
speedie 2023-04-25 18:11:49 +02:00
parent 0457a53478
commit f94f1ce9ab
9 changed files with 256 additions and 86 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
Makefile
View file

@ -98,6 +98,7 @@ man:
docs: man
command -v weasyprint || exit 1
scripts/make/generate-code-docs.sh docs/code-docs.md code.html || exit 1
pandoc --standalone README.md -o README.html
weasyprint code.html code.pdf || exit 1
weasyprint README.html README.pdf || exit 1
weasyprint spmenu.html spmenu.pdf || exit 1

184
README.html
View file

@ -1,3 +1,170 @@
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
<head>
<meta charset="utf-8" />
<meta name="generator" content="pandoc" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
<title>README</title>
<style>
html {
color: #1a1a1a;
background-color: #fdfdfd;
}
body {
margin: 0 auto;
max-width: 36em;
padding-left: 50px;
padding-right: 50px;
padding-top: 50px;
padding-bottom: 50px;
hyphens: auto;
overflow-wrap: break-word;
text-rendering: optimizeLegibility;
font-kerning: normal;
}
@media (max-width: 600px) {
body {
font-size: 0.9em;
padding: 12px;
}
h1 {
font-size: 1.8em;
}
}
@media print {
html {
background-color: white;
}
body {
background-color: transparent;
color: black;
font-size: 12pt;
}
p, h2, h3 {
orphans: 3;
widows: 3;
}
h2, h3, h4 {
page-break-after: avoid;
}
}
p {
margin: 1em 0;
}
a {
color: #1a1a1a;
}
a:visited {
color: #1a1a1a;
}
img {
max-width: 100%;
}
h1, h2, h3, h4, h5, h6 {
margin-top: 1.4em;
}
h5, h6 {
font-size: 1em;
font-style: italic;
}
h6 {
font-weight: normal;
}
ol, ul {
padding-left: 1.7em;
margin-top: 1em;
}
li > ol, li > ul {
margin-top: 0;
}
blockquote {
margin: 1em 0 1em 1.7em;
padding-left: 1em;
border-left: 2px solid #e6e6e6;
color: #606060;
}
code {
font-family: Menlo, Monaco, Consolas, 'Lucida Console', monospace;
font-size: 85%;
margin: 0;
hyphens: manual;
}
pre {
margin: 1em 0;
overflow: auto;
}
pre code {
padding: 0;
overflow: visible;
overflow-wrap: normal;
}
.sourceCode {
background-color: transparent;
overflow: visible;
}
hr {
background-color: #1a1a1a;
border: none;
height: 1px;
margin: 1em 0;
}
table {
margin: 1em 0;
border-collapse: collapse;
width: 100%;
overflow-x: auto;
display: block;
font-variant-numeric: lining-nums tabular-nums;
}
table caption {
margin-bottom: 0.75em;
}
tbody {
margin-top: 0.5em;
border-top: 1px solid #1a1a1a;
border-bottom: 1px solid #1a1a1a;
}
th {
border-top: 1px solid #1a1a1a;
padding: 0.25em 0.5em 0.25em 0.5em;
}
td {
padding: 0.125em 0.5em 0.25em 0.5em;
}
header {
margin-bottom: 4em;
text-align: center;
}
#TOC li {
list-style: none;
}
#TOC ul {
padding-left: 1.3em;
}
#TOC > ul {
padding-left: 0;
}
#TOC a:not(:hover) {
text-decoration: none;
}
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
div.columns{display: flex; gap: min(4vw, 1.5em);}
div.column{flex: auto; overflow-x: auto;}
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
ul.task-list{list-style: none;}
ul.task-list li input[type="checkbox"] {
width: 0.8em;
margin: 0 0.8em 0.2em -1.6em;
vertical-align: middle;
}
.display.math{display: block; text-align: center; margin: 0.5rem auto;}
</style>
<!--[if lt IE 9]>
<script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
<![endif]-->
</head>
<body>
<h1 id="spmenu">spmenu</h1>
<figure>
<img src="docs/preview.png" alt="image" />
@ -8,8 +175,9 @@
href="https://tools.suckless.org/dmenu">dmenu</a> which takes standard
input, parses it, and lets the user choose an option and sends the
selected option to standard output.</p>
<p>In addition to this, it also serves as a run launcher through the included
shell script `spmenu_run`, which handles both $PATH listing and .desktop entries.</p>
<p>In addition to this, it also serves as a run launcher through the
included shell script <code>spmenu_run</code>, which handles both $PATH
listing and .desktop entries.</p>
<p>It is designed to integrate well with my <a
href="https://dwm.suckless.org">dwm</a> fork, <a
href="https://git.speedie.site/speedwm">speedwm</a>.</p>
@ -18,7 +186,7 @@ href="https://git.speedie.site/speedwm">speedwm</a>.</p>
course if you want, this is free software so you can use it in your own
build.</p>
<ul>
<li>Proper configuration file support</li>
<li>Proper configuration file, including keybinds.</li>
<li>dwm-like key/mouse bind array (See keybinds.h and mouse.h)</li>
<li>Vim-like modes, including indicator.</li>
<li>The ability to move around items with keybinds.</li>
@ -145,8 +313,8 @@ includes <code>x11-misc/spmenu</code> as well as other useful
packages.</p>
<h2 id="installation-arch-gnulinux">Installation (Arch GNU/Linux)</h2>
<p>If you are on Arch GNU/Linux, you can add <a
href="https://git.speedie.site/speedie-repository">my repository</a> which
includes <code>spmenu</code> as well as other useful packages.</p>
href="https://git.speedie.site/speedie-repository">my repository</a>
which includes <code>spmenu</code> as well as other useful packages.</p>
<p>There’s also a PKGBUILD. To use it, simply
<code>make install_arch</code> in the directory the PKGBUILD is
located.</p>
@ -157,8 +325,6 @@ free to add it to this list.</p>
issues!</p>
<h3 id="general">General</h3>
<ul>
<li>Config file: Add configuration file using (probably) libconfig,
allowing keybinds to be configured without recompiling spmenu.</li>
<li>Image support: Stop using OpenSSL for caching images, mostly because
MD5() is deprecated as of OpenSSL 3.0, but this would also make it very
easy to have LibreSSL compatibility.</li>
@ -189,7 +355,7 @@ state.</li>
markup. Silencing this would be a good idea.</li>
<li>Image support: Images take a long time to load sometimes,
particularly when items are selected using the cursor so what we really
need is a way to skip over images after a set time limit</li>
need is a way to skip over images after a set time limit.</li>
</ul>
<h2 id="scripts">Scripts</h2>
<p>This build of spmenu should work with all spmenu/dmenu scripts. <a
@ -213,3 +379,5 @@ src="https://codeberg.org/speedie/spmenu-screenshots/raw/branch/master/spmenu-gr
alt="image" /> <img
src="https://codeberg.org/speedie/spmenu-screenshots/raw/branch/master/colorscheme3.png"
alt="image" /></p>
</body>
</html>

5
README.md
View file

@ -19,7 +19,7 @@ It is designed to integrate well with my [dwm](https://dwm.suckless.org) fork, [
This build of spmenu has some features written for this build.
Of course if you want, this is free software so you can use it in your own build.
- Proper configuration file support
- Proper configuration file, including keybinds.
- dwm-like key/mouse bind array (See keybinds.h and mouse.h)
- Vim-like modes, including indicator.
- The ability to move around items with keybinds.
@ -126,7 +126,6 @@ Pull requests would be greatly appreciated for any of these issues!
### General
- Config file: Add mouse/keybind configuration
- Image support: Stop using OpenSSL for caching images, mostly because MD5()
is deprecated as of OpenSSL 3.0, but this would also make it very easy to
have LibreSSL compatibility.
@ -152,7 +151,7 @@ like you will be unable to use spmenu in its current state.
Silencing this would be a good idea.
- Image support: Images take a long time to load sometimes, particularly when
items are selected using the cursor so what we really need is a way to
skip over images after a set time limit
skip over images after a set time limit.
## Scripts

BIN
README.pdf
View file

Binary file not shown.

BIN
code.pdf
View file

Binary file not shown.

61
docs/docs.md
View file

@ -2,7 +2,7 @@ spmenu
======
spmenu is a program for X11 that reads standard input and allows the user to
select items separated by a newline. It is a fork of
select items separated by a newline. It's a fork of
[suckless's dmenu](https://tools.suckless.org/dmenu) which is a good more
minimal alternative to spmenu.
@ -13,8 +13,7 @@ proper mouse/keybind configuration, and more.
It should be noted that most of these features may be disabled by the user, either
during compile time or through configuration.
Usage
=====
## Usage
On runtime, spmenu reads from standard input (stdin). spmenu items are
separated by a newline (`\n`). When (by default) Enter is pressed, the selected
@ -27,8 +26,7 @@ This can be used in shell scripts to create interactive menus.
On top of this, you can specify arguments to change the behavior of spmenu.
See a list below for a list.
Arguments
=========
## Arguments
You may use long, descriptive arguments or the shorter arguments.
@ -470,13 +468,17 @@ dmenu compatibility can be achieved using these arguments:
`-sf color`
: Set the selected foreground color
Keybinds
========
## Keybinds
See `keybinds.h` for a list.
You can set keybinds through the config file. A default config file is available
after installing spmenu. This configuration file has identical keybindings to the
default hardcoded keybinds.
Modes
=====
By default, the configuration file will ignore all hardcoded keybindings to
prevent keybind conflicts, but if you do not like this behaviour you can
simply set `ignoreglobalkeys = 1`.
## Modes
One of the features that separate spmenu from dmenu is spmenu's different
modes. As of version 0.2, there are two modes. Normal mode and Insert mode.
@ -492,15 +494,13 @@ this mode, most keybinds do nothing. When you are in insert mode, you
filter items by typing text into the field. Once you're done
with insert mode, you can press Escape to enter normal mode again.
-p option
=========
## -p option
spmenu has a -p option, which stands for prompt. It allows you to specify
text to display next to the item list. It is displayed on the left side of the
spmenu window. It should be noted that the prompt is purely visual though.
Images
======
## Images
spmenu supports drawing images. This image is placed on the left side of
the menu window. To use an image, pipe `IMG:/path/to/image` to spmenu.
@ -519,8 +519,7 @@ There are also a few image related arguments, such as:
NOTE: Vector images (such as .svg) can be displayed too.
Colored text
============
## Colored text
spmenu supports colored text through SGR sequences. This is the same colors
that you might already be using in your shell scripts. This means you can
@ -536,8 +535,7 @@ if you want this.
See 'SGR sequences' for more information.
SGR sequences
=============
## SGR sequences
A basic supported SGR sequence looks like this: `\033[X;YZm`
@ -563,8 +561,7 @@ Just as a tip, you can pipe your colored spmenu output to
`sed -e 's/\x1b\[[0-9;]*m//g'`. This will clear the SGR sequences from
the output. This is useful when you want to check what the output actually is.
Pango markup
============
## Pango markup
If spmenu was compiled with Pango enabled (default), you should be able to
utilize Pango markup in every part of spmenu. That is, the mode indicator,
@ -609,8 +606,7 @@ need to parse it manually. Doing so with `sed` is very easy. For example:
See [this page](https://docs.gtk.org/Pango/pango_markup.html) for more information.
Configuration
=============
## Configuration
Unlike dmenu, spmenu has a configuration file which can be edited by hand. It
is located in ~/.config/spmenu/spmenu.conf, but you can override this by
@ -623,8 +619,7 @@ This configuration file is loaded on startup.
You can also include other configuration files in the configuration file using
`@include "path/to/config"`.
.Xresources
=============
## .Xresources
spmenu also has .Xresources (xrdb) support built in. It reads the xrdb
(.Xresources database) on runtime. You may disable it by passing -nxrdb,
@ -638,8 +633,7 @@ as you can just `xrdb -override` any .Xresources file you want.
You can also use wildcards (such as `*`) to achieve a global colorscheme.
Programs like `pywal` do this to apply universal colorschemes.
Profiles
========
## Profiles
spmenu supports profiles. Profiles are like configuration
files (See `Configuration`) that can be switched between quickly using a keybind.
@ -669,8 +663,7 @@ the profile used before will be used in place.
There are a few color schemes for spmenu included in the repository, see
the `themes/` directory. Feel free to copy those to your profile directory.
Run launcher
============
## Run launcher
spmenu includes a shell script called spmenu_run. It lists executable programs
in $PATH and displays them to the user in a list. Not only that but it shows
@ -697,8 +690,7 @@ without the prefix. Same goes for magnet links.
You can also configure the run launcher through editing
`~/.config/spmenu/run/config` which is configured in shell syntax.
spmenu_desktop
==============
## spmenu_desktop
In addition to the aforementioned `spmenu_run`, the spmenu package also provides
`spmenu_desktop` which instead of reading $PATH only lists out .desktop entries.
@ -709,8 +701,7 @@ icon for entries that use one.
It can be configured through editing `~/.config/spmenu/desktop/config`. The
configuration file can also be moved by setting `${XDG_CONFIG_HOME}`.
spmenu commands
===============
## spmenu commands
spmenu has a few special commands. These work similar to the images. For example
to list the version, in addition to the `--version` argument you can also simply
@ -726,14 +717,12 @@ run `printf 'spmenu:version' | spmenu`. There are a few of these.
: Print a test script for spmenu which tests various features. Report any
weird issues you may have.
License
=======
## License
spmenu is licensed under the MIT license because that's the original suckless
license. See the included LICENSE file for more information.
Reporting issues
================
## Reporting issues
Please report issues on the
[Codeberg repository](https://codeberg.org/speedie/speediegq) or alternatively

48
spmenu.1
View file

@ -20,8 +20,9 @@
.PP
spmenu is a program for X11 that reads standard input and allows the
user to select items separated by a newline.
It is a fork of suckless\[cq]s dmenu (https://tools.suckless.org/dmenu)
which is a good more minimal alternative to spmenu.
It\[cq]s a fork of suckless\[cq]s
dmenu (https://tools.suckless.org/dmenu) which is a good more minimal
alternative to spmenu.
.PP
What makes spmenu different from all the dmenu forks is that spmenu has
features like color support, Vim-like modes, image support, proper
@ -29,7 +30,7 @@ mouse/keybind configuration, and more.
.PP
It should be noted that most of these features may be disabled by the
user, either during compile time or through configuration.
.SH Usage
.SS Usage
.PP
On runtime, spmenu reads from standard input (stdin).
spmenu items are separated by a newline (\f[V]\[rs]n\f[R]).
@ -45,7 +46,7 @@ This can be used in shell scripts to create interactive menus.
On top of this, you can specify arguments to change the behavior of
spmenu.
See a list below for a list.
.SH Arguments
.SS Arguments
.PP
You may use long, descriptive arguments or the shorter arguments.
.TP
@ -490,10 +491,17 @@ Set the selected background color
.TP
\f[V]-sf color\f[R]
Set the selected foreground color
.SH Keybinds
.SS Keybinds
.PP
See \f[V]keybinds.h\f[R] for a list.
.SH Modes
You can set keybinds through the config file.
A default config file is available after installing spmenu.
This configuration file has identical keybindings to the default
hardcoded keybinds.
.PP
By default, the configuration file will ignore all hardcoded keybindings
to prevent keybind conflicts, but if you do not like this behaviour you
can simply set \f[V]ignoreglobalkeys = 1\f[R].
.SS Modes
.PP
One of the features that separate spmenu from dmenu is spmenu\[cq]s
different modes.
@ -514,13 +522,13 @@ When you are in insert mode, you filter items by typing text into the
field.
Once you\[cq]re done with insert mode, you can press Escape to enter
normal mode again.
.SH -p option
.SS -p option
.PP
spmenu has a -p option, which stands for prompt.
It allows you to specify text to display next to the item list.
It is displayed on the left side of the spmenu window.
It should be noted that the prompt is purely visual though.
.SH Images
.SS Images
.PP
spmenu supports drawing images.
This image is placed on the left side of the menu window.
@ -542,7 +550,7 @@ There are also a few image related arguments, such as:
\f[V]-ic\f[R], \f[V]-itc\f[R] and \f[V]-gc\f[R].
.PP
NOTE: Vector images (such as .svg) can be displayed too.
.SH Colored text
.SS Colored text
.PP
spmenu supports colored text through SGR sequences.
This is the same colors that you might already be using in your shell
@ -561,7 +569,7 @@ For 256 color support to work, you must add to the array.
See \f[V]libs/color.h\f[R] if you want this.
.PP
See `SGR sequences' for more information.
.SH SGR sequences
.SS SGR sequences
.PP
A basic supported SGR sequence looks like this: \f[V]\[rs]033[X;YZm\f[R]
.PP
@ -590,7 +598,7 @@ Just as a tip, you can pipe your colored spmenu output to
\f[V]sed -e \[aq]s/\[rs]x1b\[rs][[0-9;]*m//g\[aq]\f[R].
This will clear the SGR sequences from the output.
This is useful when you want to check what the output actually is.
.SH Pango markup
.SS Pango markup
.PP
If spmenu was compiled with Pango enabled (default), you should be able
to utilize Pango markup in every part of spmenu.
@ -638,7 +646,7 @@ For example:
.PP
See this page (https://docs.gtk.org/Pango/pango_markup.html) for more
information.
.SH Configuration
.SS Configuration
.PP
Unlike dmenu, spmenu has a configuration file which can be edited by
hand.
@ -652,7 +660,7 @@ This configuration file is loaded on startup.
.PP
You can also include other configuration files in the configuration file
using \f[V]\[at]include \[dq]path/to/config\[dq]\f[R].
.SH .Xresources
.SS .Xresources
.PP
spmenu also has .Xresources (xrdb) support built in.
It reads the xrdb (.Xresources database) on runtime.
@ -668,7 +676,7 @@ Of course, you don\[cq]t NEED to use them, as you can just
You can also use wildcards (such as \f[V]*\f[R]) to achieve a global
colorscheme.
Programs like \f[V]pywal\f[R] do this to apply universal colorschemes.
.SH Profiles
.SS Profiles
.PP
spmenu supports profiles.
Profiles are like configuration files (See \f[V]Configuration\f[R]) that
@ -704,7 +712,7 @@ setting in the profile used before will be used in place.
There are a few color schemes for spmenu included in the repository, see
the \f[V]themes/\f[R] directory.
Feel free to copy those to your profile directory.
.SH Run launcher
.SS Run launcher
.PP
spmenu includes a shell script called spmenu_run.
It lists executable programs in $PATH and displays them to the user in a
@ -740,7 +748,7 @@ Same goes for magnet links.
You can also configure the run launcher through editing
\f[V]\[ti]/.config/spmenu/run/config\f[R] which is configured in shell
syntax.
.SH spmenu_desktop
.SS spmenu_desktop
.PP
In addition to the aforementioned \f[V]spmenu_run\f[R], the spmenu
package also provides \f[V]spmenu_desktop\f[R] which instead of reading
@ -753,7 +761,7 @@ It can be configured through editing
\f[V]\[ti]/.config/spmenu/desktop/config\f[R].
The configuration file can also be moved by setting
\f[V]${XDG_CONFIG_HOME}\f[R].
.SH spmenu commands
.SS spmenu commands
.PP
spmenu has a few special commands.
These work similar to the images.
@ -771,12 +779,12 @@ Print the spmenu license
\f[V]spmenu:test\f[R]
Print a test script for spmenu which tests various features.
Report any weird issues you may have.
.SH License
.SS License
.PP
spmenu is licensed under the MIT license because that\[cq]s the original
suckless license.
See the included LICENSE file for more information.
.SH Reporting issues
.SS Reporting issues
.PP
Please report issues on the Codeberg
repository (https://codeberg.org/speedie/speediegq) or alternatively

43
spmenu.html
View file

@ -170,7 +170,7 @@
</header>
<h1 id="spmenu">spmenu</h1>
<p>spmenu is a program for X11 that reads standard input and allows the
user to select items separated by a newline. It is a fork of <a
user to select items separated by a newline. It’s a fork of <a
href="https://tools.suckless.org/dmenu">suckless’s dmenu</a> which is a
good more minimal alternative to spmenu.</p>
<p>What makes spmenu different from all the dmenu forks is that spmenu
@ -178,7 +178,7 @@ has features like color support, Vim-like modes, image support, proper
mouse/keybind configuration, and more.</p>
<p>It should be noted that most of these features may be disabled by the
user, either during compile time or through configuration.</p>
<h1 id="usage">Usage</h1>
<h2 id="usage">Usage</h2>
<p>On runtime, spmenu reads from standard input (stdin). spmenu items
are separated by a newline (<code>\n</code>). When (by default) Enter is
pressed, the selected item will be piped to stdout.</p>
@ -188,7 +188,7 @@ spawn an spmenu window with three items, ‘Apple’, ‘Orange’ and ‘Pear
This can be used in shell scripts to create interactive menus.</p>
<p>On top of this, you can specify arguments to change the behavior of
spmenu. See a list below for a list.</p>
<h1 id="arguments">Arguments</h1>
<h2 id="arguments">Arguments</h2>
<p>You may use long, descriptive arguments or the shorter arguments.</p>
<dl>
<dt><code>-mh, --line-height height</code></dt>
@ -779,9 +779,14 @@ Set the selected background color
Set the selected foreground color
</dd>
</dl>
<h1 id="keybinds">Keybinds</h1>
<p>See <code>keybinds.h</code> for a list.</p>
<h1 id="modes">Modes</h1>
<h2 id="keybinds">Keybinds</h2>
<p>You can set keybinds through the config file. A default config file
is available after installing spmenu. This configuration file has
identical keybindings to the default hardcoded keybinds.</p>
<p>By default, the configuration file will ignore all hardcoded
keybindings to prevent keybind conflicts, but if you do not like this
behaviour you can simply set <code>ignoreglobalkeys = 1</code>.</p>
<h2 id="modes">Modes</h2>
<p>One of the features that separate spmenu from dmenu is spmenu’s
different modes. As of version 0.2, there are two modes. Normal mode and
Insert mode. These modes are of course similar to Vim.</p>
@ -794,12 +799,12 @@ in normal mode. In this mode, most keybinds do nothing. When you are in
insert mode, you filter items by typing text into the field. Once you’re
done with insert mode, you can press Escape to enter normal mode
again.</p>
<h1 id="p-option">-p option</h1>
<h2 id="p-option">-p option</h2>
<p>spmenu has a -p option, which stands for prompt. It allows you to
specify text to display next to the item list. It is displayed on the
left side of the spmenu window. It should be noted that the prompt is
purely visual though.</p>
<h1 id="images">Images</h1>
<h2 id="images">Images</h2>
<p>spmenu supports drawing images. This image is placed on the left side
of the menu window. To use an image, pipe
<code>IMG:/path/to/image</code> to spmenu. If you want you can specify
@ -815,7 +820,7 @@ item. In practice, drawing an image might look like this:</p>
<code>-ib</code>, <code>-ic</code>, <code>-itc</code> and
<code>-gc</code>.</p>
<p>NOTE: Vector images (such as .svg) can be displayed too.</p>
<h1 id="colored-text">Colored text</h1>
<h2 id="colored-text">Colored text</h2>
<p>spmenu supports colored text through SGR sequences. This is the same
colors that you might already be using in your shell scripts. This means
you can pipe practically any colored shell script straight into spmenu,
@ -827,7 +832,7 @@ except even more useful. Example:
<p>For 256 color support to work, you must add to the array. See
<code>libs/color.h</code> if you want this.</p>
<p>See ‘SGR sequences’ for more information.</p>
<h1 id="sgr-sequences">SGR sequences</h1>
<h2 id="sgr-sequences">SGR sequences</h2>
<p>A basic supported SGR sequence looks like this:
<code>\033[X;YZm</code></p>
<p>Here, X specifies if you want normal or bright colors. Y specifies if
@ -849,7 +854,7 @@ information.</p>
<code>sed -e 's/\x1b\[[0-9;]*m//g'</code>. This will clear the SGR
sequences from the output. This is useful when you want to check what
the output actually is.</p>
<h1 id="pango-markup">Pango markup</h1>
<h2 id="pango-markup">Pango markup</h2>
<p>If spmenu was compiled with Pango enabled (default), you should be
able to utilize Pango markup in every part of spmenu. That is, the mode
indicator, items, input, prompt, etc.</p>
@ -904,7 +909,7 @@ is very easy. For example:
<code>... | spmenu ... | sed 's/&lt;big&gt;//g; s/&lt;/big&gt;//g'</code></p>
<p>See <a href="https://docs.gtk.org/Pango/pango_markup.html">this
page</a> for more information.</p>
<h1 id="configuration">Configuration</h1>
<h2 id="configuration">Configuration</h2>
<p>Unlike dmenu, spmenu has a configuration file which can be edited by
hand. It is located in ~/.config/spmenu/spmenu.conf, but you can
override this by exporting <code>$XDG_CONFIG_HOME</code>.</p>
@ -914,7 +919,7 @@ override this by exporting <code>$XDG_CONFIG_HOME</code>.</p>
on startup.</p>
<p>You can also include other configuration files in the configuration
file using <code>@include "path/to/config"</code>.</p>
<h1 id="xresources">.Xresources</h1>
<h2 id="xresources">.Xresources</h2>
<p>spmenu also has .Xresources (xrdb) support built in. It reads the
xrdb (.Xresources database) on runtime. You may disable it by passing
-nxrdb, or enable it by padding -xrdb. You can also set this in the
@ -927,7 +932,7 @@ Of course, you don’t NEED to use them, as you can just
<p>You can also use wildcards (such as <code>*</code>) to achieve a
global colorscheme. Programs like <code>pywal</code> do this to apply
universal colorschemes.</p>
<h1 id="profiles">Profiles</h1>
<h2 id="profiles">Profiles</h2>
<p>spmenu supports profiles. Profiles are like configuration files (See
<code>Configuration</code>) that can be switched between quickly using a
keybind.</p>
@ -955,7 +960,7 @@ the setting in the profile used before will be used in place.</p>
<p>There are a few color schemes for spmenu included in the repository,
see the <code>themes/</code> directory. Feel free to copy those to your
profile directory.</p>
<h1 id="run-launcher">Run launcher</h1>
<h2 id="run-launcher">Run launcher</h2>
<p>spmenu includes a shell script called spmenu_run. It lists executable
programs in $PATH and displays them to the user in a list. Not only that
but it shows recently run programs first in the list.</p>
@ -980,7 +985,7 @@ $BROWSER even without the prefix. Same goes for magnet links.</p>
<p>You can also configure the run launcher through editing
<code>~/.config/spmenu/run/config</code> which is configured in shell
syntax.</p>
<h1 id="spmenu_desktop">spmenu_desktop</h1>
<h2 id="spmenu_desktop">spmenu_desktop</h2>
<p>In addition to the aforementioned <code>spmenu_run</code>, the spmenu
package also provides <code>spmenu_desktop</code> which instead of
reading $PATH only lists out .desktop entries.</p>
@ -989,7 +994,7 @@ displaying an icon for entries that use one.</p>
<p>It can be configured through editing
<code>~/.config/spmenu/desktop/config</code>. The configuration file can
also be moved by setting <code>${XDG_CONFIG_HOME}</code>.</p>
<h1 id="spmenu-commands">spmenu commands</h1>
<h2 id="spmenu-commands">spmenu commands</h2>
<p>spmenu has a few special commands. These work similar to the images.
For example to list the version, in addition to the
<code>--version</code> argument you can also simply run
@ -1010,11 +1015,11 @@ Print a test script for spmenu which tests various features. Report any
weird issues you may have.
</dd>
</dl>
<h1 id="license">License</h1>
<h2 id="license">License</h2>
<p>spmenu is licensed under the MIT license because that’s the original
suckless license. See the included LICENSE file for more
information.</p>
<h1 id="reporting-issues">Reporting issues</h1>
<h2 id="reporting-issues">Reporting issues</h2>
<p>Please report issues on the <a
href="https://codeberg.org/speedie/speediegq">Codeberg repository</a> or
alternatively email me.</p>

BIN
spmenu.pdf
View file

Binary file not shown.