.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH EXMENEN 1 "13 January 2008"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
exmenen, exmendis \- enable or disable extra menus for GNOME, KDE and other XDG menu-spec compliant desktops
.SH SYNOPSIS
.B exmenen
(--system | --local) [ module ]
.PP
.B exmendis
(--system | --local) [ module ]
.SH DESCRIPTION
This manual page documents briefly the
.B exmenen
and
.B exmendis
commands.
.PP
.B exmenen
is a script that enables the specified extra applications menu on either a system, or per-user basis.
It does this by creating symlinks within
.BR /etc/xdg/menus/applications-merged/
(system wide), or
.BR ${XDG_CONFIG_HOME}/menus/applications-merged/
(per-user). If the XDG_CONFIG_HOME environment variable is unset, its default is taken to be 
${HOME}/.config .

Likewise,
.B exmendis
disables an extra applications menu by removing those symlinks.  It is not an error to
enable a menu which is already enabled, or to disable one which is already disabled.
.SH EXAMPLES
.RS
.B "exmendis --system electronics"
.br
.B "exmenen --system electronics"
.RE
.PP
Disables the system wide extra
.B electronics
menu, enables it for the current user.
.SH FILES
.TP
.B /usr/share/extra-xdg-menus
Directory with .menu files defining the available extra modules.
.TP
.B /etc/xdg/menus/applications-merged
Directory with links to the files in
.B extra-xdg-menus
for system-wide enabled extra menus.
.TP
.B ${XDG_CONFIG_HOME}/menus/applications-merged
Directory with links to the files in
.B extra-xdg-menus
for per-user enabled extra menus. If XDG_CONFIG_HOME is unset, the directory used will be
.B ${HOME}/.config/menus/applications-merged

.SH AUTHOR
This manual page was written by Peter Clifton <pcjc2@cam.ac.uk> for the Debian
GNU/Linux distribution, as it is a Debian-specific script with the package.

exmenen, exmendis and this manpage were derived from scripts and documentation
written by Daniel Stone for the apache2 Debian package.