desktop-file-utils-0.13

Introduction to desktop-file-utils

The desktop-file-utils package contains command line utilities for working with desktop entries. These utilities are used by GNOME-2 and other applications to manipulate the MIME-types application databases and help adhere to the Desktop Entry Specification.

Package Information

desktop-file-utils Dependencies

Required

GLib-2.12.12

Optional

Emacs-22.1

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/desktop-file-utils

Installation of desktop-file-utils

Install desktop-file-utils by running the following commands:

./configure --prefix=/usr &&
make

This package does not come with a test suite.

Now, as the root user:

make install

Configuring desktop-file-utils

Configuration Information

The XDG Base Directory specification defines the standard locations for applications to place data and configuration files. These files can be used, for instance, to define the menu structure and menu items in a desktop environment.

The default location for configuration files to be installed is /etc/xdg, and the default locations for data files are /usr/local/share and /usr/share. These locations can be extended with the environment variables XDG_CONFIG_DIRS and XDG_DATA_DIRS, respectively. The GNOME, KDE and XFCE environments respect respect these settings. Update the XDG_DATA_DIRS (if necessary) and XDG_CONFIG_DIRS environment variables so that the additional MIME-types application databases and desktop menu files are properly maintained and discovered by adding the following to the system-wide or personal profile:

For GNOME:

XDG_DATA_DIRS=$GNOME_PREFIX/share:/usr/local/share:/usr/share
XDG_CONFIG_DIRS=/etc/gnome/2.18.3/xdg:/etc/xdg
export XDG_DATA_DIRS XDG_CONFIG_DIRS

For KDE:

XDG_DATA_DIRS=$KDE_PREFIX/share:/usr/local/share:/usr/share
XDG_CONFIG_DIRS=/etc/kde/xdg:/etc/xdg
export XDG_DATA_DIRS XDG_CONFIG_DIRS

For XFCE, the default locations should be appropriate if the instructions in the BLFS book were followed.

When a package installs a .desktop file to a location in one of the base data directories, the database that maps MIME-types to available applications can be updated. For instance, the cache file at /usr/share/applications/mimeinfo.cache can be rebuilt by executing the following command as the root user:

update-desktop-database /usr/share/applications

Contents

Installed Programs: desktop-file-install, desktop-file-validate, and update-desktop-database
Installed Libraries: None
Installed Directories: None

Short Descriptions

desktop-file-install

is used to install a new, or modify an existing desktop file entry. It is also used to rebuild or modify the MIME-types application database.

desktop-file-validate

is used to verify the integrity of a desktop file.

update-desktop-database

is used to update the MIME-types application database.

Last updated on 2007-07-18 16:12:44 -0500