summaryrefslogtreecommitdiffstats
path: root/gnome2-user-guide/C/gospanel.xml
diff options
context:
space:
mode:
Diffstat (limited to 'gnome2-user-guide/C/gospanel.xml')
-rw-r--r--gnome2-user-guide/C/gospanel.xml156
1 files changed, 147 insertions, 9 deletions
diff --git a/gnome2-user-guide/C/gospanel.xml b/gnome2-user-guide/C/gospanel.xml
index f5e3841..262f8e5 100644
--- a/gnome2-user-guide/C/gospanel.xml
+++ b/gnome2-user-guide/C/gospanel.xml
@@ -76,7 +76,7 @@ these panels.</para>
<variablelist>
<varlistentry>
<term><application>Menu Bar</application> applet</term>
- <listitem><para>Contains the <guimenu>Applications</guimenu>, the <guimenu>Places</guimenu>, and the <guimenu>Desktop</guimenu> menu. For more on the menu bar, see <xref linkend="menubar"/>.</para></listitem>
+ <listitem><para>The panel menubar contains the <guimenu>Applications</guimenu>, the <guimenu>Places</guimenu>, and the <guimenu>Desktop</guimenu> menu. For more on the menu bar, see <xref linkend="menubar"/>.</para></listitem>
</varlistentry>
<varlistentry>
<term><application>Web Browser Launcher</application></term>
@@ -743,7 +743,7 @@ control the volume of the speaker on your system.</para>
<see>launchers</see>
</indexterm>
<para>A <firstterm>launcher</firstterm> is an object that performs a specific action when you open it.</para>
- <para>You can find launchers in the panels, in the Main Menubar, and on the desktop. A launcher is represented by an icon in all of these locations.</para>
+ <para>You can find launchers in the panels, in the panel menubar, and on the desktop. A launcher is represented by an icon in all of these locations.</para>
<para>You might use a launcher to do any of the following:</para>
<itemizedlist>
<listitem>
@@ -1165,10 +1165,148 @@ the GNOME website in your default browser.</para>
</tbody>
</tgroup>
</informaltable>
+
+ <para>The command can contain the following special codes which will be replaced with the value specified in the following table:</para>
+ <informaltable>
+ <tgroup cols="2" colsep="0" rowsep="0">
+ <colspec colname="colspec0" colwidth="47.36*"/>
+ <colspec colname="colspec1" colwidth="52.64*"/>
+ <thead>
+ <row rowsep="1">
+ <entry>
+ <para>Code</para>
+ </entry>
+ <entry>
+ <para>Meaning</para>
+ </entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry valign="top">
+ <para>
+ <command>%f</command>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>A single file name, even if multiple files are selected. The system reading the desktop entry should recognize that the program in question cannot handle multiple file arguments, and it should should probably spawn and execute multiple copies of a program for each selected file if the program is not able to handle additional file arguments. If files are not on the local file system (i.e. are on HTTP or FTP locations), the files will be copied to the local file system and %f will be expanded to point at the temporary file. Used for programs that do not understand the URL syntax.</para>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <command>%F</command>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>A list of files. Use for apps that can open several local files at once.</para>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <command>%u</command>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>A single URL.</para>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <command>%U</command>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>A list of URLs.</para>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <command>%d</command>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>Directory containing the file that would be passed in a %f field.</para>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <command>%D</command>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>List of directories containing the files that would be passed in to a %F field.</para>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <command>%n</command>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>A single filename (without path).</para>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <command>%N</command>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>A list of filenames (without paths).</para>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <command>%i</command>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>The Icon field of the desktop entry expanded as two parameters, first --icon and then the contents of the Icon field. Should not expand as any parameters if the Icon field is empty or missing.</para>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <command>%c</command>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>The translated Name field associated with the desktop entry.</para>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <command>%k</command>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>The location of the desktop file as either a URI (if for example gotten from the vfolder system) or a local filename or empty if no location is known.</para>
+ </entry>
+ </row>
+ <row>
+ <entry valign="top">
+ <para>
+ <command>%v</command>
+ </para>
+ </entry>
+ <entry valign="top">
+ <para>The name of the Device entry in the desktop file.</para> </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ <para>These are as defined by freedesktop.org's <ulink type="http" url="http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-0.9.4.html">Desktop Entry Specification</ulink>.</para>
</section>
</section>
-
-
</section>
<section id="gospanel-557">
<title>Buttons</title>
@@ -1770,7 +1908,7 @@ right-click on any vacant space on the panel. Choose <menuchoice><guimenu>Add to
<secondary>introduction</secondary>
</indexterm>
<para>The <guimenu>Main Menu</guimenu> provides access to
- the <guimenu>Applications</guimenu> menu and many of the items in the <guimenu>Actions</guimenu> menu. You can access almost all of the standard applications,
+ the <guimenu>Applications</guimenu> menu and many of the items in the <guimenu>Desktop</guimenu> menu. You can access almost all of the standard applications,
commands, and configuration options from the <guimenu>Main Menu</guimenu>. </para>
<para>You can add <guimenu>Main Menu</guimenu> buttons to your panels. Click
on the <guimenu>Main Menu</guimenu> button to open the <guimenu>Main Menu</guimenu>.</para>
@@ -1782,7 +1920,7 @@ right-click on any vacant space on the panel. Choose <menuchoice><guimenu>Add to
</indexterm>
<para>You can add as many <guimenu>Main Menu</guimenu> buttons
as you want to your panels. To add a <guimenu>Main Menu</guimenu> to a panel,
- right-click on any vacant space on the panel. Choose <menuchoice><guimenu>Add to Panel</guimenu><guimenuitem>Main Menu</guimenuitem></menuchoice>.</para>
+ right-click on any vacant space on the panel. Choose <guimenuitem>Add to Panel</guimenuitem> and choose <guilabel>Main Menu</guilabel> from the <link linkend="panels-addobject"><guilabel>Add to Panel</guilabel></link> dialog.</para>
</section>
</section>
<section id="goseditmainmenu-65">
@@ -1797,9 +1935,9 @@ right-click on any vacant space on the panel. Choose <menuchoice><guimenu>Add to
</textobject>
</mediaobject>
</screenshot>
- <para>The <application>Menu Bar</application> provides access to the <guimenu>Applications</guimenu> and <guimenu>Actions</guimenu> menus. You can access
+ <para>The <application>Menu Bar</application> provides access to the panel menubar, which contains the <guimenu>Applications</guimenu>, <guimenu>Places</guimenu>, and <guimenu>Desktop</guimenu> menus. You can access
almost all of the standard applications, commands, and configuration options
- from the <application>Menu Bar</application>. For more on using the Menu Bar, see <xref linkend="menubar"/>.</para>
+ from the <application>Menu Bar</application>. For more on using the panel menubar, see <xref linkend="menubar"/>.</para>
<section id="goseditmainmenu-66">
<title>To Add a Menu Bar to a Panel</title>
<indexterm>
@@ -1808,7 +1946,7 @@ right-click on any vacant space on the panel. Choose <menuchoice><guimenu>Add to
</indexterm>
<para>You can add as many <application>Menu Bar</application>
applets as you want to your panels. To add a <application>Menu Bar</application>
- to a panel, right-click on any vacant space on the panel. Choose <menuchoice><guimenu>Add to Panel</guimenu><guimenuitem>Menu Bar</guimenuitem></menuchoice>.</para>
+ to a panel, right-click on any vacant space on the panel. Choose <guimenuitem>Add to Panel</guimenuitem> and choose <guilabel>Menu Bar</guilabel> from the <link linkend="panels-addobject"><guilabel>Add to Panel</guilabel></link> dialog.</para>
</section>
</section>