This glossary defines some of the terms used in this specification.

Desktop entry #

A desktop entry is a file with a name ending in the ".desktop" extension which conforms to the desktop entry specification (http://www.freedesktop.org/standards/desktop-entry-spec). It describes a menu item, including a name, an icon, and what to do when the item is selected. Desktop entries are also known as ".desktop files."

Desktop-File Id #

The id to identify a desktop entry with. For example, if /usr/share/applications is specified as an <AppDir>, and /opt/fop as a <LegacyDir> with a prefix of foo- then /usr/share/applications/foo/bar.desktop, /usr/share/applications/foo-bar.desktop and /opt/fop/Settings/bar.desktop all have the same desktop-file id foo-bar.desktop

Directory entry #

A directory entry is a file with a name ending in the ".directory" extension which conforms to the desktop entry specification (http://www.freedesktop.org/standards/desktop-entry-spec). It describes gives a localized name and an icon for a submenu. Directory entries are also known as ".directory files."

Menu path #

A "menu path" is the path to a particular menu. Menu paths are always "relative" so never start with a slash character. The path to a menu is simply the <Name> of each parent of the menu, followed by the <Name> of the menu itself. For example, "Foo/Bar/Baz" is a valid menu path.

Relative path #

The canonical path to a directory entry, relative to the <DirectoryDir> containing the entry. For example, if /usr/share/desktop-directories is specified as an <DirectoryDir>, the relative path to /usr/share/desktop-directories/foo/bar.directory is foo/bar.directory.