10139N/A<!
DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
10139N/A<!--ArborText, Inc., 1988-1999, v.4002-->
10139N/A<!
ENTITY cmd "gnome-desktop-item-edit">
10139N/A<!
ENTITY suncopy "Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved.">
10139N/A<
refentry id="gnome-desktop-item-edit-1">
10139N/A<
refmeta><
refentrytitle>gnome-desktop-item-edit</
refentrytitle><
manvolnum>1</
manvolnum>
10139N/A<
refmiscinfo class="date">2 Oct 2003</
refmiscinfo>
10139N/A<
refmiscinfo class="sectdesc">&man1;</
refmiscinfo>
10139N/A<
refmiscinfo class="software">&release;</
refmiscinfo>
10139N/A<
refmiscinfo class="arch">generic</
refmiscinfo>
10139N/A<
refmiscinfo class="copyright">&suncopy;</
refmiscinfo>
10139N/A<
indexterm><
primary>gnome-desktop-item-edit</
primary></
indexterm><
indexterm>
10139N/A<
primary>GNOME Desktop file editor</
primary></
indexterm><
refnamediv id="gnome-desktop-item-edit-1-name">
10139N/A<
refname>gnome-desktop-item-edit</
refname><
refpurpose>GNOME Desktop file editor</
refpurpose>
10139N/A<
refsynopsisdiv id="gnome-desktop-item-edit-1-synp"><
title>&synp-tt;</
title>
10139N/A<
cmdsynopsis><
command>&cmd;</
command><
arg choice="opt"><
option>-create-new
10139N/A</
option></
arg><
arg choice="plain"><
option role="nodash">filename</
option></
arg>
10139N/A<
refsect1 id="gnome-desktop-item-edit-1-desc"><
title>&desc-tt;</
title>
10139N/A<
para><
command>&cmd;</
command> is the GNOME Desktop file editor, which you
10139N/Acan use to create or edit the <
filename>.desktop</
filename> (known as desktop)
10139N/AA desktop file consists of a number of name-value pairs that define how a
10139N/Adesktop should organize a particular application. As this is defined as an
10139N/Aopen standard, integration of applications into GNOME Desktop is relatively
10139N/A<
para>A basic entry in the desktop file must start with a tag called [Desktop
10139N/AEntry]. It can then have a number of name-value pairs as defined by the standard.
10139N/AThe minimum entries are as follows:<
variablelist><
varlistentry><
term>Name
10139N/A</
term><
listitem><
para>the name of the application</
para>
10139N/A<
varlistentry><
term>Comment</
term><
listitem><
para>a textual description of
10139N/Athe application which is displayed as a tooltip message by <
filename>gnome-panel
10139N/A</
filename>. When set appropriately, the comment can be localized within the
10139N/A</
variablelist><
variablelist><
varlistentry><
term>Exec</
term><
listitem><
para>
10139N/Athe name of the actual executable </
para>
10139N/A</
variablelist><
variablelist><
varlistentry><
term>Icon</
term><
listitem><
para>
10139N/Athe file name of the icon image </
para>
10139N/A</
variablelist><
variablelist><
varlistentry><
term>Type</
term><
listitem><
para>
10139N/A</
variablelist><
variablelist><
varlistentry><
term>Categories</
term><
listitem>
10139N/A<
para>a multi-string field which is used by <
filename>gnome-panel</
filename>
10139N/Ato group applications into the appropriate categories.</
para>
10139N/A<
para>These desktop files provide the information to <
filename>gnome-panel
10139N/A</
filename>, which places the application in the appropriate locations on
10139N/Athe panel. In a similar manner, the GNOME file manager (Nautilus) uses information
10139N/Afrom the desktop files to display the 'applications:///' view.</
para>
10139N/A<
refsect1 id="gnome-desktop-item-edit-1-opts"><
title>&opts-tt;</
title>
10139N/A<
para>The following options are supported:</
para>
10139N/A<
variablelist termlength="medium"><
varlistentry><
term><
option>-create-new
10139N/A</
option></
term><
listitem><
para>Creates a new <
filename>.desktop</
filename>
10139N/A<
refsect1 id="gnome-desktop-item-edit-1-oper"><
title>&oper-tt;</
title>
10139N/A<
para>The following operands are supported:</
para>
10139N/A<
variablelist termlength="medium"><
varlistentry><
term><
option role="nodash"><
replaceable>
10139N/Afilename</
replaceable></
option></
term><
listitem><
para>The name of the desktop
10139N/Afile to be edited or viewed.</
para>
10139N/A<
refsect1 id="gnome-desktop-item-edit-1-exam"><
title>&exam-tt;</
title>
10139N/A<
example role="example"><
title>Editing an existing .desktop file</
title>
10139N/A<
para><
screen>example% <
userinput>&cmd; <
replaceable>fullpath</
replaceable>/<
replaceable>
10139N/Afilename</
replaceable></
userinput></
screen></
para>
11904N/A<
para>This command invokes the launcher dialog and loads the contents
10139N/Aof the specified desktop file into the relevant fields.</
para>
10139N/A<
refsect1 id="gnome-desktop-item-edit-1-exit"><
title>&exit-tt;</
title>
10139N/A<
para>The following exit values are returned:</
para>
10139N/A<
variablelist termlength="xtranarrow"><
varlistentry><
term><
returnvalue>0</
returnvalue></
term>
10139N/A<
listitem><
para>Application exited successfully</
para>
10139N/A<
varlistentry><
term><
returnvalue>>0</
returnvalue></
term><
listitem><
para>Application
10139N/A<
refsect1 id="gnome-desktop-item-edit-1-file"><
title>&file-tt;</
title>
10139N/A<
para>The following files are used by this application:</
para>
10139N/A<
variablelist termlength="wholeline">
10139N/A</
term><
listitem><
para>Executable for GNOME Desktop file editor</
para>
10139N/A<
listitem><
para>Location of system desktop files</
para>
10139N/A<
refsect1 id="gnome-desktop-item-edit-1-attr"><
title>&attr-tt;</
title>
10139N/A<
para>See <
olink targetdocent="REFMAN5" localinfo="attributes-5"><
citerefentry>
10139N/A<
refentrytitle>attributes</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry></
olink>
10139N/Afor descriptions of the following attributes:</
para>
10139N/A<
tgroup cols="2" colsep="1" rowsep="1"><
colspec colname="COLSPEC0" colwidth="1*">
10139N/A<
colspec colname="COLSPEC1" colwidth="1*">
10139N/A<
row><
entry align="center" valign="middle">ATTRIBUTE TYPE</
entry><
entry align="center" 10139N/Avalign="middle">ATTRIBUTE VALUE</
entry></
row>
10139N/A<
row><
entry colname="COLSPEC0"><
para>Interface stability</
para></
entry><
entry 10139N/Acolname="COLSPEC1"><
para>Volatile</
para></
entry></
row>
10139N/A<
refsect1 id="gnome-desktop-item-edit-1-also"><
title>&also-tt;</
title>
10139N/A<!--Reference to another man page--> 10139N/A<!--Reference to a Help manual--> 11904N/A<
citerefentry><
refentrytitle>gnome-panel</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
11904N/A<
citerefentry><
refentrytitle>nautilus</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
11904N/A<
citerefentry><
refentrytitle>attributes</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry>
10139N/A<
para>Latest version of the <
citetitle>GNOME Desktop User Guide</
citetitle> for your platform.</
para>
10139N/A<
refsect1 id="gnome-desktop-item-edit-1-note"><
title>¬e-tt;</
title>
11933N/A<
para>Written by Ghee Teo, Sun Microsystems Inc., 2003.</
para>