.\" Automatically generated by Pandoc 3.1.6
.\"
.\" 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 "JGMENU-APPS" "1" "14 January, 2024" "" ""
.hy
.SH NAME
.PP
jgmenu-apps - generate jgmenu flavoured CSV menu data
.SH SYNOPSIS
.PP
\f[V]jgmenu_run apps\f[R] [--help]\ [--no-append]\ [--no-prepend]
.PD 0
.P
.PD
[--append-file <\f[I]file\f[R]>] [--prepend-file <\f[I]file\f[R]>]
.SH DESCRIPTION
.PP
\f[V]jgmenu_run apps\f[R] generates jgmenu flavoured CSV menu data for
system applications using built-in schema data or a specified schema
file to map categories to directories, rather than system .directory
files.
.PP
A schema is searched for in the following locations and order:
.IP \[bu] 2
\f[V]$XDG_CONFIG_HOME/jgmenu/schema\f[R]
.PD 0
.P
.PD
.IP \[bu] 2
\f[V]$HOME/.config/jgmenu/schema\f[R]
.PD 0
.P
.PD
.IP \[bu] 2
\f[V]$XDG_CONFIG_DIRS/jgmenu/schema\f[R]
.PD 0
.P
.PD
.IP \[bu] 2
\f[V]/etc/xdg/jgmenu/schema\f[R]
.PP
The root menu is appended and/or prepended by the contents of the files
\f[V]$HOME/.config/jgmenu/{append,prepend}.csv\f[R] if they exist.
.PP
Applications which do not belong in any of the categories in the schema
file, are placed in `Other' (which is the one with no Categories= field)
.PP
Example schema file:
.IP
.nf
\f[C]
Name=Accessories
Name[sv]=Tillbehör
Icon=applications-accessories
Categories=Accessibility;Core;Utility;

Name=Development
Name[sv]=Utveckling
Icon=applications-development
Categories=Development;

Name=Education
Name[sv]=Utbildning
Icon=applications-science
Categories=Education;

Name=Games
Name[sv]=Spel
Icon=applications-games
Categories=Game;

Name=Graphics
Name[sv]=Grafik
Icon=applications-graphics
Categories=Graphics;

Name=Multimedia
Name[sv]=Multimedia
Icon=applications-multimedia
Categories=Audio;Video;AudioVideo;

Name=Internet
Name[sv]=Internet
Icon=applications-internet
Categories=Network;

Name=Office
Name[sv]=Kontorsprogram
Icon=applications-office
Categories=Office;

Name=Other
Name[sv]=Övrigt
Icon=applications-other

Name=Settings
Name[sv]=Inställningar
Icon=preferences-desktop
Categories=Settings;Screensaver;

Name=System
Name[sv]=System
Icon=applications-system
Categories=Emulator;System;
\f[R]
.fi
.SH OPTIONS
.TP
\f[V]--help\f[R]
Show help message and exit
.TP
\f[V]--no-prepend\f[R]
Do not output \[ti]/.config/jgmenu/prepend.csv before root menu
.TP
\f[V]--no-append\f[R]
Do not output \[ti]/.config/jgmenu/append.csv after root menu
.TP
\f[V]--append-file <file>\f[R]
Specify menu file to append to the root menu.
Use $HOME/.config/jgmenu/append.csv by default.
.TP
\f[V]--prepend-file <file>\f[R]
Specify menu file to prepend to the root menu.
Use $HOME/.config/jgmenu/prepend.csv by default.
.SH ENVIRONMENT VARIABLES
.TP
\f[V]JGMENU_SINGLE_WINDOW\f[R]
If set, \f[V]\[ha]checkout()\f[R] items will be replaced by
\f[V]\[ha]root()\f[R]
.TP
\f[V]JGMENU_NO_DIRS\f[R]
If set, applications will be listed without a directory structure
.TP
\f[V]JGMENU_NO_PEND\f[R]
Do not read append.csv or prepend.csv
.TP
\f[V]JGMENU_NAME_FORMAT\f[R]
See \f[V]csv_name_format\f[R] in jgmenu(1)
.TP
\f[V]JGMENU_NO_DUPLICATES\f[R]
See \f[V]csv_no_duplicates\f[R] in jgmenu(1)
.TP
\f[V]JGMENU_I18N\f[R]
See \f[V]csv_i18n\f[R] in jgmenu(1) and jgmenu-i18n(1)
.SH AUTHORS
Johan Malm.