update-desktop-database(1) [debian man page]

UPDATE-DESKTOP-DATABASE(1)				      General Commands Manual					UPDATE-DESKTOP-DATABASE(1)

NAME

       update-desktop-database - Build cache database of MIME types handled by desktop files

SYNOPSIS

       update-desktop-database [-q|--quiet] [-v|--verbose] [DIRECTORY...]

DESCRIPTION

       The update-desktop-database program is a tool to build a cache database of the MIME types handled by desktop files.

       The  cache database contains the list of MIME types that can be handled by desktop files, as well as, for each MIME type, a list of desktop
       files that can handle this MIME type. This cache database ease the work of applications that need to find an application that  can  open  a
       document  of  a specific MIME type: those applications will not have to parse all the desktop files existing on the system, and can instead
       parse this cache database.

       If no DIRECTORY is specified as argument, the desktop files that will be processed are the ones installed in $XDG_DATA_DIRS/applications.

       If both the --quiet and --verbose options are used, then --verbose will be ignored.

OPTIONS

       The following options are supported:

       -q, --quiet
	      Do not display any information about processing and updating progress.

       -v, --verbose
	      Display more information about processing and updating progress.

NOTES

       If an invalid MIME type is met, it will be ignored and the creation of the cache database will continue.

       The format of the cache database is a simple desktop entry format, with a MIME Cache group, containing one key per MIME type. The key  name
       is the MIME type, and the key value is the list of desktop file that can handle this MIME type.

       The  order  of the desktop files found for a MIME type is not significant.  Therefore, an external mechanism must be used to determine what
       is the preferred desktop file for a MIME type.

EXAMPLE

       Here is a simple example of a cache database:

	       [MIME Cache]
	       application/x-shellscript=gedit.desktop;
	       text/plain=gedit.desktop;gvim.desktop;
	       video/webm=totem.desktop;

       This cache database is created with three desktop files, each containing a MimeType key:

	       gedit.desktop: MimeType=text/plain;application/x-shellscript;
	       gvim.desktop: MimeType=text/plain;
	       totem.desktop: MimeType=video/webm;

FILES

       $XDG_DATA_DIRS/applications/mimeinfo.cache

	      This file is the cache database created by update-desktop-database.

BUGS

       If you find bugs in the update-desktop-database program, please report these on https://bugs.freedesktop.org.

								  FREEDESKTOP.ORG					UPDATE-DESKTOP-DATABASE(1)

gnome-desktop-item-edit(1)					   User Commands					gnome-desktop-item-edit(1)

NAME

       gnome-desktop-item-edit - GNOME Desktop file editor

SYNOPSIS

       gnome-desktop-item-edit [--create-new] filename

DESCRIPTION

       gnome-desktop-item-edit	is  the GNOME Desktop file editor, which you can use to create or edit the .desktop (known as desktop) file. GNOME
       uses a standard desktop file specification as proposed by freedesktop.org.  A desktop file consists of a number of  name-value  pairs  that
       define  how  a  desktop	should organize a particular application. As this is defined as an open standard, integration of applications into
       GNOME Desktop is relatively straightforward.

       A basic entry in the desktop file must start with a tag called [Desktop Entry]. It can then have a number of name-value pairs as defined by
       the standard.  The minimum entries are as follows:

       Name		       the name of the application

       Comment		       a textual description of the application which is displayed as a tooltip message by gnome-panel. When set appropri-
			       ately, the comment can be localized within the same file.

       Exec		       the name of the actual executable

       Icon		       the file name of the icon image

       Type		       the desktop file type

       Categories	       a multi-string field which is used by gnome-panel to group applications into the appropriate categories.

       These desktop files provide the information to gnome-panel, which     places the application in the appropriate locations on the panel.	In
       a similar manner, the GNOME file manager (Nautilus) uses information from the desktop files to display the 'applications:///' view.

OPTIONS

       The following options are supported:

       --create-new    Creates a new .desktop file.

OPERANDS

       The following operands are supported:

       filename        The name of the desktop file to be edited or viewed.

EXAMPLES

       Example 1: Editing an existing .desktop file

       example% gnome-desktop-item-edit fullpath/filename

       This command invokes the launcher dialog and loads the contents of the specified desktop file into the relevant fields.

EXIT STATUS

       The following exit values are returned:

       0	Application exited successfully

       >0	Application exited with failure

FILES

       The following files are used by this application:

       /usr/bin/gnome-desktop-iExecutable for GNOME Desktop file editor

       /usr/share/applications/Desktopofile

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWgnome-panel		   |
       +-----------------------------+-----------------------------+
       |Interface stability	     |External			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       gnome-panel(1), nautilus(1)

       Latest version of the GNOME Desktop User Guide for your platform.

NOTES

       Written by Ghee Teo, Sun Microsystems  Inc., 2003.

SunOS 5.10							    2 Oct 2003						gnome-desktop-item-edit(1)