Providing Kali specific desktop files
-------------------------------------

You can add as many desktop files as you want in the desktop-files
sub-directory. Each desktop file must have an entry "X-Kali-Package=foo"
where foo is the name of the binary package that is associated to this
desktop file. Note that you can associate multiple binary packages to
the same desktop file if needed, just put a space-separated list of
packages in the X-Kali-Package field.

Those desktop files will be installed in /usr/share/applications
by update-kali-menu as soon as the corresponding package is installed. And
they will be removed after the corresponding package has been removed.

If you want to override an existing desktop file instead of adding a new
one, make sure to reuse the same filename. When kali-menu detects the
conflict, it will transparently use dpkg-divert to move away the official
desktop file and put the Kali one in place.

It's possible to remove/hide an existing desktop file, by overriding it and
adding "NoDisplay=true" to the overridden desktop file.

-- Raphaël Hertzog <buxy@kali.org>

Installer desktop files
-----------------------

Those are special desktop files, they are used for applications that are not
installed, but nevertheless we want to show it in the menu. A click will not
start the program (as it's not installed) but instead propose to install it.

Those desktop files are identified by their filenames, which must end with
"-installer.desktop". They are installed if the corresponding package is NOT
installed, and removed after the corresponding package is installed.

As said above, the "corresponding package(s)" are listed in the entry
X-Kali-Package.  Listing more than one package is probably not a great idea.
If you need to do so, you'll have to read the code to understand what's the
behavior, and see if that's what you want.

Sysadmin-override of Kali specific desktop files
------------------------------------------------

System administrators can disable a Kali specific desktop file by creating a
symlink in the directory /etc/kali-menu/applications. This symlink must be
named after the desktop file in /usr/share/kali-menu/applications that must
be disabled, and point to /dev/null.

Run update-kali-menu after creating or removing symlinks for the change to
take effect.
