.\" Automatically generated by Pandoc 2.2.1
.\"
.TH "JGMENU\-PMENU" "1" "29 September, 2019" "" ""
.hy
.SH NAME
.PP
jgmenu\-pmenu \- generate jgmenu flavoured CSV menu data
.SH SYNOPSIS
.PP
\f[C]jgmenu_run\ pmenu\f[] [\-h | \[en]help] [\[en]append\-file
<\f[I]FILE\f[]>]
.PD 0
.P
.PD
\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ [\[en]prepend\-file <\f[I]FILE\f[]>]
[\[en]locale <\f[I]LOCALE\f[]>]
.SH DESCRIPTION
.PP
Generates jgmenu flavoured CSV menu data based on .desktop and
\&.directory files found on the system, but ignores any .menu files.
Instead of the structure specified in the .menu file, it simply maps
each \[lq].desktop\[rq] application onto one of the \[lq].directory\[rq]
categories.
If a matching \[lq].directory\[rq] category does not exist, it tries to
cross\-reference \[lq]additional categories\[rq] to \[lq]related
categories\[rq] in accordance with the XDG menu\-spec.
This is a generic approach which avoids Desktop Environment specific
rules defined in the .menu file.
It ensures that all .desktop files are included in the menu.
.PP
The root menu is appended/prepended by the contents of the following
files if they exist:
.IP \[bu] 2
\f[C]~/.config/jgmenu/append.csv\f[]
.IP \[bu] 2
\f[C]~/.config/jgmenu/prepend.csv\f[]
.SH OPTIONS
.TP
.B \f[C]\-h\f[], \f[C]\-\-help\f[]
Show this help message and exit
.RS
.RE
.TP
.B \f[C]\-\-append\-file\ FILE\f[]
Path to menu file to append to the root menu
.RS
.RE
.TP
.B \f[C]\-\-prepend\-file\ FILE\f[]
Path to menu file to prepend to the root menu
.RS
.RE
.TP
.B \f[C]\-\-locale\ LOCALE\f[]
Use a custom locale (e.g.
\f[C]en_US.UTF\-8\f[]).
Available locales can be shown by running \f[C]locale\ \-a\f[].
.RS
.RE
.SH ENVIRONMENT VARIABLES
.TP
.B \f[C]JGMENU_SINGLE_WINDOW\f[]
If set, \f[C]^checkout()\f[] items will be replaced by \f[C]^root()\f[]
.RS
.RE
.TP
.B \f[C]JGMENU_NO_DIRS\f[]
If set, applications will be listed without a directory structure
.RS
.RE
.SH AUTHORS
Johan Malm.