<chapter id="gui-1"> 
  <title>Writing for GUIs</title> 
  <para> This chapter provides guidelines about how to document graphical user
	 interfaces (GUIs) in the GNOME Desktop. </para> 
  <sect1> 
	 <title>GUI Basics</title> 
	 <para> A <firstterm>graphical user interface</firstterm> (<acronym>GUI</acronym>) provides the user with an intuitive way of
		interacting with a computer and computer applications. The main purpose of a
		GUI is to make the activities involved in doing a task simple and quick. GUIs
		include elements that users use to work with applications, and elements that
		display information to the users. </para> 
	 <para> GNOME documentation must cater for the following GNOME GUIs: 
		<itemizedlist> 
		  <listitem> 
			 <para> GNOME Desktop GUI </para> 
		  </listitem> 
		  <listitem> 
			 <para> Application GUIs </para> 
		  </listitem> 
		  <listitem> 
			 <para> Applet GUIs </para> 
		  </listitem> 
		</itemizedlist> </para> 
	 <para> The GNOME Desktop GUI includes the following elements: </para> 
	 <itemizedlist> 
		<listitem> 
		  <para> Buttons </para> 
		</listitem> 
		<listitem> 
		  <para> Desktop</para> 
		</listitem> 
		<listitem> 
		  <para> Dialogs</para> 
		</listitem> 
		<listitem> 
		  <para> Menus</para> 
		</listitem> 
		<listitem> 
		  <para> Panels</para> 
		</listitem> 
		<listitem> 
		  <para> Windows</para> 
		</listitem> 
	 </itemizedlist> 
  </sect1> 
  <sect1 id="gui-2"> 
	 <title>Writing About GNOME Desktop GUIs</title> 
	 <para> When you write about GNOME Desktop GUIs, observe the following guidelines:
		</para> 
	 <itemizedlist> 
		<listitem> 
		  <para> Provide only the essential details or information that the user
			 needs to know to accomplish a task. </para> 
		</listitem> 
		<listitem> 
		  <para> Refer to windows and dialogs by the title of the window or
			 dialog. Refer to menus by the title of the menu, or by the name specified for
			 the menu in <xref linkend="menu-terminology"/>. </para> 
		  <para> Avoid repeated use of the same name when the meaning is clear.
			 For example: you instruct the reader to choose 
			 <menuchoice> 
				<guimenu>File</guimenu> 
				<guimenuitem>Print</guimenuitem> 
			 </menuchoice>, with the expected result that the 
			 <guilabel>Print</guilabel> window is displayed. In this case, you do
			 not need to repeat "in the 
			 <guilabel>Print</guilabel> window", if there is no ambiguity about
			 which window you want the user to work in. </para> 
		</listitem> 
		<listitem> 
		  <para> Write the names of dialog elements and menu commands as they
			 appear in the GUI. If the name includes a colon or an ellipsis, do not include
			 that punctuation when you refer to the item in your documentation. </para> 
		</listitem> 
		<listitem> 
		  <para> Mention certain technical GUI distinctions only when necessary.
			 For example, mention that a menu is a popup menu only if that information is
			 relevant to the task that the documentation describes. </para> 
		</listitem> 
	 </itemizedlist> 
	 <para> When writing about the GUI, reserve certain verbs for specific
		activities. For a list of the verbs to use when writing about the GUI, see
		<xref linkend="gnome-glossary-user-actions"/>. </para> 
	 <para> When you write about the mouse, note the following: </para> 
	 <itemizedlist> 
		<listitem> 
		  <para> Refer to the buttons on the mouse as <emphasis>mouse
			 buttons</emphasis> to avoid confusion with buttons in dialogs. </para> 
		</listitem> 
		<listitem> 
		  <para> Refer to the indicator that shows where the mouse action occurs
			 as the <emphasis>pointer</emphasis> or <emphasis>mouse pointer</emphasis>.
			 Write about the pointer to keep the user focused on the screen. For example,
			 describe moving the pointer, not moving the mouse.</para> 
		</listitem> 
		<listitem> 
		  <para> The plural for <emphasis>mouse</emphasis> is <emphasis>mouse
			 devices</emphasis>. </para> 
		</listitem> 
	 </itemizedlist> 
  </sect1> 
  <sect1 id="desktop-terminology"> 
	 <title>GNOME Desktop Terminology</title> 
	 <para>The following terms are of prime interest when you write about the GNOME Desktop: </para> 
<itemizedlist>
<listitem><para><link linkend="term-desktop">Desktop</link></para></listitem>
<listitem><para><link linkend="term-desktop-background">Desktop background</link></para></listitem>
<listitem><para><link linkend="term-desktop-environment">Desktop environment</link></para></listitem>
<listitem><para><link linkend="term-gnome-desktop">GNOME Desktop</link></para></listitem>
</itemizedlist>
	 <para> Use the terminology shown in <xref linkend="desktop-fig"/> when you
		write about GNOME Desktop components. </para> 
	 <figure id="desktop-fig"> 
		<title>GNOME Desktop Terminology</title> 
		<mediaobject> 
		  <imageobject><imagedata fileref="figures/desktop_elements.png"
			 format="PNG"/> 
		  </imageobject> 
		  <textobject> 
			 <phrase>GNOME Desktop. Callouts: Panel, Desktop objects, Desktop,
				Pointer, Panel.</phrase> 
		  </textobject> 
		</mediaobject> 
	 </figure> 
	 <para> For more detailed information on the terms in
		<xref linkend="desktop-fig"/>, see <xref linkend="wordlist"/>. </para> 
  </sect1> 
  <sect1 id="gui-3"> 
	 <title>Panel Terminology</title> 
	 <para> A panel is an area in the GNOME Desktop from which you can run
		applications and applets, and perform other tasks. Use the terminology shown in
		<xref linkend="panel-fig"/> when you write about panels. </para> 
	 <figure id="panel-fig"> 
		<title>Panel Terminology</title> 
		<mediaobject> 
		  <imageobject><imagedata fileref="figures/panel_elements.png"
			 format="PNG"/> 
		  </imageobject> 
		  <textobject> 
			 <phrase>Horizontal panel with hide buttons and panel objects.
				Callouts: Hide button, Panel objects, Launcher, Menu, Applet, Drawer, Other
				panel object.</phrase> 
		  </textobject> 
		</mediaobject> 
	 </figure> 
	 <para> For more detailed information on the terms in
		<xref linkend="panel-fig"/>, see <xref linkend="wordlist"/>. </para> 
  </sect1> 
  <sect1 id="menu-terminology"> 
	 <title>Menu Terminology</title> 
	 <para> A menu or a submenu is a list of commands.
		<xref linkend="gui-TBL-4"/> lists and illustrates some of the menus in GNOME
		GUIs. Use the terms in <xref linkend="gui-TBL-4"/> when you need to refer to a
		particular menu. </para> 
	 <para> Note that you do not need to specify the name of a menu when you
		refer to commands on the menu. For example, you can write "To add an object to
		a panel, right-click on the panel, then choose 
		<guimenuitem>Add to Panel</guimenuitem>". </para> 
	 <table frame="topbot" id="gui-TBL-4"> 
	 <title>Menu Terminology</title> 
	 <tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="50*"
		colname="col0"/><colspec colwidth="50*" colname="col1"/> 
		<thead> 
		  <row rowsep="1"> 
			 <entry valign="top"> 
				<para> Menu </para> </entry> 
			 <entry valign="top"> 
				<para> Example </para> </entry> 
		  </row> 
		</thead> 
		<tbody> 
		  <row> 
			 <entry colname="col0" valign="top"> 
				<para> Applet popup menu </para> </entry> 
			 <entry colname="col1" valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/applet_popup_menu.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample applet popup menu.</phrase> 
				  </textobject> 
				</mediaobject> </entry> 
		  </row> 
		  <row> 
			 <entry colname="col0" valign="top"> 
				<para> 
				  <guimenu>Desktop</guimenu> menu </para> </entry> 
			 <entry colname="col1" valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata
					 fileref="figures/desktop_background_menu.png" format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Desktop menu.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> 
				  <guimenu>Main Menu</guimenu> </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/gnome_menu.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Main Menu.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Menu item popup menu </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/launcher_popup_menu.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample launcher popup menu.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Panel popup menu </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/panel_popup_menu.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Panel popup menu.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Panel object popup menu </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata
					 fileref="figures/panel_object_popup_menu.png" format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Panel object popup menu.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> 
				  <guimenu>Window Menu</guimenu> </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/window_menu.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Window Menu.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		</tbody> 
	 </tgroup> 
	 </table> 
	 <para> For more detailed information on the terms in
		<xref linkend="gui-TBL-4"/>, see <xref linkend="wordlist"/>. </para> 
  </sect1> 
  <sect1 id="window-terminology"> 
	 <title>Window Terminology</title> 
	 <para> A window is a rectangular frame that displays a particular application. Typically,
		applications have one main window from which users can open secondary windows,
		called <firstterm>dialogs</firstterm>. Use the terminology shown in
		<xref linkend="window-fig-1"/> when you write about windows. </para> 
	 <figure id="window-fig-1"> 
		<title>Window Terminology</title> 
		<mediaobject> 
		  <imageobject><imagedata fileref="figures/window_elements.png"
			 format="PNG"/> 
		  </imageobject> 
		  <textobject> 
			 <phrase>Sample window, with the following callouts: Frame, Window
				name, Border, Menubar, Handle, Toolbar, Statusbar.</phrase> 
		  </textobject> 
		</mediaobject> 
	 </figure> 
	 <para> A window frame is a border around a window. You can use the window
		frame to perform various actions on the window. In particular, the titlebar
		contains various active control elements. Use the terminology shown in
		<xref linkend="window-fig-2"/> when you write about window frames and the
		elements in window frames. </para> 
	 <figure id="window-fig-2"> 
		<title>Window Frame Terminology</title> 
		<mediaobject> 
		  <imageobject><imagedata fileref="figures/window_titlebar_elements.png"
			 format="PNG"/> 
		  </imageobject> 
		  <textobject> 
			 <phrase>Sample window titlebar, with the following callouts: Window
				Menu button, Titlebar, Minimize button, Maximize button, Close Window
				button.</phrase> 
		  </textobject> 
		</mediaobject> 
	 </figure> 
	 <para> A pane is a subdivision of a window. For example, a
		<application>Nautilus</application> window can contain two panes: a side pane
		and a view pane. <xref linkend="window-fig-3"/> shows panes in an
		<application>Evolution</application> 
		<guilabel>Inbox</guilabel> window.</para> 
	 <figure id="window-fig-3"> 
		<title>Window Pane Terminology</title> 
		<mediaobject> 
		  <imageobject><imagedata fileref="figures/window_panes.png"
			 format="PNG"/> 
		  </imageobject> 
		  <textobject> 
			 <phrase>Evolution Inbox window, with the following callouts: Folder
				pane, Message pane, Preview pane.</phrase> 
		  </textobject> 
		</mediaobject> 
	 </figure> 
	 <para> For more detailed information on window terms, see
		<xref linkend="wordlist"/>. </para> 
  </sect1> 
  <sect1 id="dialog-terminology"> 
	 <title>Dialog Terminology</title> 
	 <para> A dialog is a popup window in which the user enters information or
		commands. Dialogs can contain control elements that the user can work with to
		select an option, specify a value, and so on. <xref linkend="gui-TBL-2"/> lists
		and illustrates the dialog elements in the GNOME Desktop GUI. Use the terms in
		<xref linkend="gui-TBL-2"/> when you write about dialog elements. </para> 
	 <table frame="topbot" id="gui-TBL-2"> 
	 <title>Dialog Terminology</title> 
	 <tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="50*"/><colspec
		colwidth="50*"/> 
		<thead> 
		  <row rowsep="1"> 
			 <entry valign="top"> 
				<para> Element </para> </entry> 
			 <entry valign="top"> 
				<para> Example </para> </entry> 
		  </row> 
		</thead> 
		<tbody> 
		  <row> 
			 <entry valign="top"> 
				<para> Check box </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/check_box.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample check box.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Color wheel </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata
					 fileref="figures/color_wheel1.png" format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample color wheel.</phrase> 
				  </textobject> 
				</mediaobject> 
				<mediaobject> 
				  <imageobject><imagedata
					 fileref="figures/color_wheel2.png" format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample color wheel.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Column heading </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/column_heading.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample column heading.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Drop-down combination box </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata
					 fileref="figures/dropdown_combination_box.png" format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample drop-down combination box.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Drop-down list </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/dropdown_list_box.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample drop-down list.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row>
 		  <row> 
			 <entry valign="top"> 
				<para> Drop-down section </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/dropdown_section1.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample closed drop-down section.</phrase> 
				  </textobject> 
				</mediaobject>
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/dropdown_section2.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample open drop-down section.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Field </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/field.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample field.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Group box </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/group_box.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample group box.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> List box </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/list_box.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample list box.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Radio button </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata
					 fileref="figures/radio_button.png" format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample radio button.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Scrollbar </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/scrollbar.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample scrollbar.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Slider </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/slider.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample slider.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Spin box </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/spin_box.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample spin box.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Tab </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/tabs.png" format="PNG"/>
					 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample tabs.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Tabbed section </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/tabbed_section.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample tabbed section.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Table </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/table.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample table.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Text box </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/text_box.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample text box.</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		</tbody> 
	 </tgroup> 
	 </table> 
	 <para> For more detailed information on dialog terms, see
		<xref linkend="gnome-glossary-desktop"/>. </para> 
  </sect1> 
  <sect1 id="button-terminology"> 
	 <title>Button Terminology</title> 
	 <para> <xref linkend="gui-TBL-5"/> lists and illustrates some of the button
		types that you can use in GNOME Desktop GUIs. Use the terms in
		<xref linkend="gui-TBL-5"/> when you write about buttons. </para> 
	 <table frame="topbot" id="gui-TBL-5"> 
	 <title>Button Terminology</title> 
	 <tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="50*"
		colname="col0"/><colspec colwidth="50*" colname="col1"/> 
		<thead> 
		  <row rowsep="1"> 
			 <entry valign="top"> 
				<para> Button </para> </entry> 
			 <entry valign="top"> 
				<para> Example </para> </entry> 
		  </row> 
		</thead> 
		<tbody> 
		  <row> 
			 <entry colname="col0" valign="top"> 
				<para> Arrow buttons </para> </entry> 
			 <entry colname="col1" valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/arrow_button1.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample arrow button</phrase> 
				  </textobject> 
				</mediaobject> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/arrow_button2.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample arrow button</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry colname="col0" valign="top"> 
				<para> Color selector button </para> </entry> 
			 <entry colname="col1" valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata
					 fileref="figures/color_selector_button.png" format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample color selector button</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry colname="col0" valign="top"> 
				<para> Command button</para></entry> 
			 <entry colname="col1" valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/command_button.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample command button</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Font selector button </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata
					 fileref="figures/font_selector_button.png" format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample font selector button</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Icon selector buttons </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata
					 fileref="figures/icon_selector_button1.png" format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample icon selector button</phrase> 
				  </textobject> 
				</mediaobject> 
				<mediaobject> 
				  <imageobject><imagedata
					 fileref="figures/icon_selector_button2.png" format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample icon selector button</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> 
				  <guimenu> Main Menu</guimenu> button </para></entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/footprint_icon.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Main Menu button</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Toggle buttons</para></entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/toggle_button.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample toggle buttons</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Toolbar buttons </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/toolbar_button.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample toolbar button</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Window frame buttons </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/window_frame_button.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample window frame buttons</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		  <row> 
			 <entry valign="top"> 
				<para> Window list buttons </para> </entry> 
			 <entry valign="top"> 
				<mediaobject> 
				  <imageobject><imagedata fileref="figures/window_list_button.png"
					 format="PNG"/> 
				  </imageobject> 
				  <textobject> 
					 <phrase>Sample window list buttons</phrase> 
				  </textobject> 
				</mediaobject></entry> 
		  </row> 
		</tbody> 
	 </tgroup> 
	 </table> 
	 <para> For more detailed information on GUI buttons, see
		<xref linkend="gnome-glossary-button-types"/>. </para> 
  </sect1> 
</chapter> 
