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 specifica-
     tion  as  proposed  by freedesktop.org.  A desktop file con-
     sists 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  appli-
                             cation which is displayed as a tool-
                             tip message by gnome-panel. When set
                             appropriately,  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.



SunOS 5.11           Last change: 2 Oct 2003                    1






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



     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 (Nau-
     tilus)  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  con-
     tents  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-item-edit

         Executable for GNOME Desktop file editor



     /usr/share/applications/




SunOS 5.11           Last change: 2 Oct 2003                    2






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



         Location of system desktop files



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWgnome-panel             
    
     Interface stability          Volatile                    
    


SEE ALSO
     gnome-panel(1), nautilus(1), attributes(5)

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

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






























SunOS 5.11           Last change: 2 Oct 2003                    3