Add documentation for spmenu_test
Add documentation for spmenu_test, also improve Markdown format consistency.
This commit is contained in:
parent
2cee004182
commit
b4dd4fc383
|
@ -1,7 +1,6 @@
|
|||
![preview](screenshots/spmenu-themes.gif)
|
||||
# spmenu
|
||||
|
||||
spmenu
|
||||
======
|
||||
![preview](screenshots/spmenu-themes.gif)
|
||||
|
||||
spmenu is a simple X11 and Wayland menu application which takes standard input, parses
|
||||
it, lets the user choose an option and sends the selected option to standard output.
|
||||
|
|
|
@ -1,5 +1,4 @@
|
|||
spmenu
|
||||
======
|
||||
# spmenu
|
||||
|
||||
spmenu is an X11 and Wayland menu application which takes standard input, parses
|
||||
it, lets the user choose an option and sends the selected option to standard output.
|
||||
|
@ -855,6 +854,7 @@ or the [GitHub mirror](https://github.com/speediegq/spmenu).
|
|||
## See also
|
||||
|
||||
- spmenu_run(1)
|
||||
- spmenu_test(1)
|
||||
- [spmenu wiki](https://spmenu.speedie.site)
|
||||
- [spmenu git repository](https://git.speedie.site/speedie/spmenu)
|
||||
- [spmenu GitHub mirror](https://github.com/speediegq/spmenu)
|
||||
|
|
|
@ -1,5 +1,4 @@
|
|||
spmenu_run
|
||||
==========
|
||||
# spmenu_run
|
||||
|
||||
spmenu includes a powerful Bash script called spmenu_run. It has several
|
||||
different components, but the run launcher component lists out
|
||||
|
@ -157,6 +156,7 @@ email me.
|
|||
## See also
|
||||
|
||||
- spmenu(1)
|
||||
- spmenu_test(1)
|
||||
- [spmenu wiki](https://spmenu.speedie.site)
|
||||
- [spmenu git repository](https://git.speedie.site/speedie/spmenu)
|
||||
- [spmenu GitHub mirror](https://github.com/speediegq/spmenu)
|
||||
|
|
33
docs/test-docs.md
Normal file
33
docs/test-docs.md
Normal file
|
@ -0,0 +1,33 @@
|
|||
# spmenu_test
|
||||
|
||||
spmenu_test is a simple shell script which prints formatted text and colors.
|
||||
It is mainly designed for spmenu development, but may also be nice for testing
|
||||
colorschemes and themes.
|
||||
|
||||
## Usage
|
||||
|
||||
Run `spmenu_test` to run the script. It will spawn an spmenu window with
|
||||
no transparency where many different colors and types of formatting can
|
||||
be seen.
|
||||
|
||||
spmenu_test will pass all arguments directly to spmenu, it doesn't use any
|
||||
arguments for itself. See spmenu(1) for a list of arguments you can
|
||||
pass to spmenu_test. If no arguments are passed, spmenu will be launched
|
||||
using `--no-alpha --lines 40 --columns 1 --prompt ...`.
|
||||
|
||||
## License
|
||||
|
||||
spmenu is licensed under the MIT license.
|
||||
|
||||
## Reporting issues
|
||||
|
||||
Please report issues on the [Git repository](https://git.speedie.site/speedie/spmenu)
|
||||
or the [GitHub mirror](https://github.com/speediegq/spmenu).
|
||||
|
||||
## See also
|
||||
|
||||
- spmenu(1)
|
||||
- spmenu_run(1)
|
||||
- [spmenu wiki](https://spmenu.speedie.site)
|
||||
- [spmenu git repository](https://git.speedie.site/speedie/spmenu)
|
||||
- [spmenu GitHub mirror](https://github.com/speediegq/spmenu)
|
|
@ -33,15 +33,27 @@ docs() {
|
|||
[ ! -x "$(command -v pandoc)" ] && printf "pandoc must be installed for this action.\n" && exit 1
|
||||
|
||||
version="$(grep "version : '" meson.build | awk '{ print $3 }' | sed "s/'\"//g; s/\"',//g")"
|
||||
|
||||
if [ -f "docs/docs.md" ]; then
|
||||
printf "%% spmenu(1) ${version} | fancy dynamic menu\n" > .man.md
|
||||
cat docs/docs.md >> .man.md
|
||||
pandoc --standalone --to man .man.md -o spmenu.1
|
||||
rm -f .man.md
|
||||
fi
|
||||
|
||||
if [ -f "docs/run-docs.md" ]; then
|
||||
printf "%% spmenu_run(1) ${version} | \$PATH/.desktop launcher and file manager\n" > .man.md
|
||||
cat docs/run-docs.md >> .man.md
|
||||
pandoc --standalone --to man .man.md -o spmenu_run.1
|
||||
rm -f .man.md
|
||||
fi
|
||||
|
||||
if [ -f "docs/test-docs.md" ]; then
|
||||
printf "%% spmenu_test(1) ${version} | spmenu test script\n" > .man.md
|
||||
cat docs/test-docs.md >> .man.md
|
||||
pandoc --standalone --to man .man.md -o spmenu_test.1
|
||||
rm -f .man.md
|
||||
fi
|
||||
}
|
||||
|
||||
kblist() {
|
||||
|
|
2
spmenu.1
2
spmenu.1
|
@ -1538,6 +1538,8 @@ mirror (https://github.com/speediegq/spmenu).
|
|||
.IP \[bu] 2
|
||||
spmenu_run(1)
|
||||
.IP \[bu] 2
|
||||
spmenu_test(1)
|
||||
.IP \[bu] 2
|
||||
spmenu wiki (https://spmenu.speedie.site)
|
||||
.IP \[bu] 2
|
||||
spmenu git repository (https://git.speedie.site/speedie/spmenu)
|
||||
|
|
|
@ -198,6 +198,8 @@ email me.
|
|||
.IP \[bu] 2
|
||||
spmenu(1)
|
||||
.IP \[bu] 2
|
||||
spmenu_test(1)
|
||||
.IP \[bu] 2
|
||||
spmenu wiki (https://spmenu.speedie.site)
|
||||
.IP \[bu] 2
|
||||
spmenu git repository (https://git.speedie.site/speedie/spmenu)
|
||||
|
|
54
spmenu_test.1
Normal file
54
spmenu_test.1
Normal file
|
@ -0,0 +1,54 @@
|
|||
.\" Automatically generated by Pandoc 3.1.2
|
||||
.\"
|
||||
.\" Define V font for inline verbatim, using C font in formats
|
||||
.\" that render this, and otherwise B font.
|
||||
.ie "\f[CB]x\f[]"x" \{\
|
||||
. ftr V B
|
||||
. ftr VI BI
|
||||
. ftr VB B
|
||||
. ftr VBI BI
|
||||
.\}
|
||||
.el \{\
|
||||
. ftr V CR
|
||||
. ftr VI CI
|
||||
. ftr VB CB
|
||||
. ftr VBI CBI
|
||||
.\}
|
||||
.TH "spmenu_test" "1" "" "2.2" "spmenu test script"
|
||||
.hy
|
||||
.SH spmenu_test
|
||||
.PP
|
||||
spmenu_test is a simple shell script which prints formatted text and
|
||||
colors.
|
||||
It is mainly designed for spmenu development, but may also be nice for
|
||||
testing colorschemes and themes.
|
||||
.SS Usage
|
||||
.PP
|
||||
Run \f[V]spmenu_test\f[R] to run the script.
|
||||
It will spawn an spmenu window with no transparency where many different
|
||||
colors and types of formatting can be seen.
|
||||
.PP
|
||||
spmenu_test will pass all arguments directly to spmenu, it doesn\[cq]t
|
||||
use any arguments for itself.
|
||||
See spmenu(1) for a list of arguments you can pass to spmenu_test.
|
||||
If no arguments are passed, spmenu will be launched using
|
||||
\f[V]--no-alpha --lines 40 --columns 1 --prompt ...\f[R].
|
||||
.SS License
|
||||
.PP
|
||||
spmenu is licensed under the MIT license.
|
||||
.SS Reporting issues
|
||||
.PP
|
||||
Please report issues on the Git
|
||||
repository (https://git.speedie.site/speedie/spmenu) or the GitHub
|
||||
mirror (https://github.com/speediegq/spmenu).
|
||||
.SS See also
|
||||
.IP \[bu] 2
|
||||
spmenu(1)
|
||||
.IP \[bu] 2
|
||||
spmenu_run(1)
|
||||
.IP \[bu] 2
|
||||
spmenu wiki (https://spmenu.speedie.site)
|
||||
.IP \[bu] 2
|
||||
spmenu git repository (https://git.speedie.site/speedie/spmenu)
|
||||
.IP \[bu] 2
|
||||
spmenu GitHub mirror (https://github.com/speediegq/spmenu)
|
Loading…
Reference in a new issue