diff options
| author | Eugene O'Connor <eoconnor@src.gnome.org> | 2003-09-09 00:18:02 +0000 |
|---|---|---|
| committer | Eugene O'Connor <eoconnor@src.gnome.org> | 2003-09-09 00:18:02 +0000 |
| commit | 09595bfea08228958cb272a49664fc8a0b9b3d60 (patch) | |
| tree | c1ccd174423b5d2c60e6f37f5d7b2e508873a019 | |
| parent | e6cabc791360f08b169e8856d4c3f30f927a8bf3 (diff) | |
| download | gnome-user-docs-09595bfea08228958cb272a49664fc8a0b9b3d60.tar.gz gnome-user-docs-09595bfea08228958cb272a49664fc8a0b9b3d60.tar.xz gnome-user-docs-09595bfea08228958cb272a49664fc8a0b9b3d60.zip | |
Updates for GNOME 2.4 Desktop Syatem Administration Guide.
| -rw-r--r-- | gnome2-system-admin-guide/C/appendixa.xml | 32 | ||||
| -rw-r--r-- | gnome2-system-admin-guide/C/gconf.xml | 739 | ||||
| -rw-r--r-- | gnome2-system-admin-guide/C/gdm.xml | 550 | ||||
| -rw-r--r-- | gnome2-system-admin-guide/C/glossary.xml | 52 | ||||
| -rw-r--r-- | gnome2-system-admin-guide/C/help.xml | 102 | ||||
| -rw-r--r-- | gnome2-system-admin-guide/C/menustructure.xml | 35 | ||||
| -rw-r--r-- | gnome2-system-admin-guide/C/mimetypes.xml | 292 | ||||
| -rw-r--r-- | gnome2-system-admin-guide/C/performance.xml | 509 | ||||
| -rw-r--r-- | gnome2-system-admin-guide/C/screensavers.xml | 35 | ||||
| -rw-r--r-- | gnome2-system-admin-guide/C/sessions.xml | 37 | ||||
| -rw-r--r-- | gnome2-system-admin-guide/C/system-admin-guide.xml | 16 | ||||
| -rw-r--r-- | gnome2-system-admin-guide/C/themes.xml | 396 |
12 files changed, 1956 insertions, 839 deletions
diff --git a/gnome2-system-admin-guide/C/appendixa.xml b/gnome2-system-admin-guide/C/appendixa.xml index 2ac858c..585f00f 100644 --- a/gnome2-system-admin-guide/C/appendixa.xml +++ b/gnome2-system-admin-guide/C/appendixa.xml @@ -1,10 +1,8 @@ -<?xml version="1.0" encoding="utf-8"?> - <appendix id="appendixa-0"> <title>Hidden Directories</title> <highlights> <para>This appendix describes the hidden directories that the -GNOME desktop adds to the home directories of users. </para> +GNOME Desktop adds to the home directories of users. </para> </highlights> <indexterm> <primary>hidden directories</primary> @@ -15,7 +13,7 @@ GNOME desktop adds to the home directories of users. </para> </indexterm> <para>A hidden directory is a directory that has a name that begins with a period (.). <xref linkend="appendixa-TBL-2"/> describes the hidden directories that the GNOME -desktop adds to the home directories of users. </para> +Desktop adds to the home directories of users. </para> <table frame="topbot" id="appendixa-TBL-2"> <title>Hidden Directories in User Home Directories</title> <tgroup cols="2" colsep="0" rowsep="0"> @@ -98,24 +96,23 @@ the user. </para> </entry> <entry valign="top"> <para>The <application>Nautilus</application> file manager -contains a preference that enables users to use <application>Nautilus</application> -to manage the desktop background. If the user selects this option, this directory -contains the objects that are on the <application>Nautilus</application> desktop -background of the user. This directory contains the following:</para> +contains a preference that enables users to use the file manager to +manage the desktop. If the user selects this option, this directory contains +the objects that are on the desktop of the user. This directory contains the +following:</para> <itemizedlist> <listitem> - <para>Objects on the desktop background, for example, the <guilabel>Home</guilabel> object, the <guilabel>Trash</guilabel> object, and other launchers. -The objects appear in the directory as desktop entry files. For example, the <filename>starthere.desktop</filename> file contains a link to the <guilabel>Start Here</guilabel> location. </para> + <para>Objects on the desktop, for example, the <guilabel>Home</guilabel> +object, the <guilabel>Trash</guilabel> object, and other launchers. The objects +appear in the directory as desktop entry files. For example, the <filename>starthere.desktop</filename> file contains a link to the <guilabel>Start Here</guilabel> location. </para> </listitem> <listitem> <para>Removable media volumes that are mounted.</para> </listitem> </itemizedlist> <para>The file manager also contains a preference that enables -users to use the home directory as the desktop background directory, instead -of <filename>.gnome-desktop</filename>. If a user selects this -option, the contents of the home directory are displayed as desktop background -objects.</para> +users to use the home directory as the desktop directory, instead of <filename>.gnome-desktop</filename>. If a user selects this option, the contents of +the home directory are displayed as desktop objects.</para> </entry> </row> <row> @@ -185,7 +182,7 @@ user. For example, this directory can contain the following: </para> adds.</para> </listitem> <listitem> - <para><application>Nautilus</application> desktop background images.</para> + <para><application>Nautilus</application> desktop images.</para> </listitem> </itemizedlist> </entry> @@ -197,9 +194,8 @@ adds.</para> </para> </entry> <entry valign="top"> - <para>Contains desktop themes and window frame themes -that the user adds. The user can add themes from the <application>Themes</application> -preference tool.</para> + <para>Contains controls themes, window frame themes, and +icons themes that the user adds. The user can add themes from the <application>Theme</application> preference tool.</para> </entry> </row> <row> diff --git a/gnome2-system-admin-guide/C/gconf.xml b/gnome2-system-admin-guide/C/gconf.xml index 6226414..c6786f6 100644 --- a/gnome2-system-admin-guide/C/gconf.xml +++ b/gnome2-system-admin-guide/C/gconf.xml @@ -1,8 +1,10 @@ -<?xml version="1.0" encoding="utf-8"?> <chapter id="gconf-0"> <title>Using GConf</title> <highlights> <para>The information in this chapter describes how to use <application>GConf</application> to manage user preferences.</para> + <para> + <application>Configuration Editor</application> + </para> </highlights> <sect1 id="gconf-1"> <title>Introducing GConf</title> @@ -11,8 +13,8 @@ <secondary>introduction</secondary> </indexterm> <para><application>GConf</application> simplifies the administration of preferences -for users in the GNOME desktop environment. <application>GConf</application> -enables system administrators to do the following:</para> +for users in the desktop environment. <application>GConf</application> enables +system administrators to do the following:</para> <itemizedlist> <listitem> <para>Set mandatory values for particular preferences for all users. @@ -45,6 +47,9 @@ preference, all applications that use the preference are immediately updated.</p <para>A command line tool, <command>gconftool-2</command>.</para> </listitem> </itemizedlist> + <para> + <application>Configuration Editor</application> + </para> </sect1> <sect1 id="gconf-24"> <title>GConf Repository</title> @@ -58,8 +63,8 @@ is an element in the repository that corresponds to an application preference. For example, the <literal>/apps/gnome-session/options/show_splash_screen</literal> preference key corresponds to the <guilabel>Show splash screen on login</guilabel> option in the <application>Sessions</application> preference tool. The GNOME -user interface does not contain all of the preference keys in the <application>GConf</application> repository. For example, the <application>Sessions</application> -preference tool does not contain an option that corresponds to the <literal>/apps/gnome-session/options/splash_screen_text</literal> key.</para> +Desktop user interface does not contain all of the preference keys in the <application>GConf</application> repository. For example, the <application>Sessions</application> +preference tool does not contain an option that corresponds to the <literal>/apps/gnome-session/options/allow_tcp_connections</literal> key.</para> <para>The repository is structured like a simple hierarchical file system. The repository contains the following:</para> <itemizedlist> @@ -88,7 +93,7 @@ repository depends on the backend module that is used to read the repository. The following is an example of the <literal>/desktop/gnome/interface/font_name</literal> preference key when an Extensible Markup Language (XML) backend module is used to read the repository:</para> <literallayout><entry name="font_name" mtime="1038323555" muser="user123" type="string"> -<stringvalue>avantgarde 10</stringvalue></entry></literallayout> +<stringvalue>Sans 10</stringvalue></entry></literallayout> <note> <para>When this guide refers to a preference key, the path to the key is added to the name of the key. For example, the <literal>font_name</literal> @@ -104,7 +109,7 @@ is referred to as <literal>/desktop/gnome/interface/font_name</literal>.</para> <para>The <application>GConf</application> repository contains a series of storage locations that are called <firstterm>configuration sources</firstterm>. The configuration sources are listed in the <firstterm>GConf path file</firstterm>. The location of the <application>GConf</application> -path file is <filename>/etc/gconf/<replaceable>version_number</replaceable>/path</filename>. Each user has a path file. Each line in the path file specifies +path file is <filename>/etc/gconf/<replaceable>version-number</replaceable>/path</filename>. Each user has a path file. Each line in the path file specifies the following information:</para> <itemizedlist> <listitem> @@ -370,13 +375,14 @@ a <filename>.schemas</filename> extension.</para> <para>The schema definition files are included in the <filename>/etc/gconf/schemas</filename> directory. You can use the schema definition files to create a new configuration source.</para> <para>Some schema definition files correspond closely to a part of the GNOME -user interface. For example, <filename>system_http_proxy.schemas</filename> +Desktop user interface. For example, <filename>system_http_proxy.schemas</filename> corresponds to the <application>Network Proxy</application> preference tool. Other schema definition files contain preference keys that are not present -in the GNOME user interface. For example, the <literal>/apps/gnome-session/options/splash_screen_text</literal> key is not present in the user interface. </para> - <para>Some parts of the GNOME user interface contain preferences that represent -preference keys from more than one schema definition file. For example, the <application>Keyboard Shortcuts</application> preference tool contains preferences that -represent keys from the <filename>panel-global-config.schemas</filename> and <filename>metacity.schemas</filename> files.</para> +in the GNOME Desktop user interface. For example, the <literal>/apps/gnome-session/options/splash_screen_text</literal> key is not present in the user interface. </para> + <para>Some parts of the GNOME Desktop user interface contain preferences that +represent preference keys from more than one schema definition file. For example, +the <application>Keyboard Shortcuts</application> preference tool contains +preferences that represent keys from the <filename>panel-global-config.schemas</filename> and <filename>metacity.schemas</filename> files.</para> </sect2> </sect1> <sect1 id="gconf-25"> @@ -427,7 +433,10 @@ values. All applications use this cache, so applications only need to access the configuration sources once.</para> <para>To terminate the <application>GConf</application> daemon, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --shutdown</userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --shutdown</userinput> + </para> </sect1> <sect1 id="gconf-6"> <title>GConf Command Line Tool</title> @@ -455,8 +464,11 @@ an application.</para> </itemizedlist> <para>For example, use the following command to display the values of all keys in the <filename>/desktop/gnome</filename> directory and subdirectories.</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --recursive-list -/desktop/gnome</userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --recursive-list +/desktop/gnome</userinput> + </para> <para><xref linkend="gconf-TBL-7"/> lists some of the options that you can use with the <command>gconftool-2</command> command.</para> <table frame="topbot" id="gconf-TBL-7"> @@ -500,7 +512,7 @@ in a directory that you specify.</para> <row> <entry colname="colspec0" valign="top"> <para> - <literal>--config-source=<replaceable>configuration_source</replaceable></literal> + <literal>--config-source=<replaceable>configuration-source</replaceable></literal> </para> </entry> <entry colname="colspec1" valign="top"> @@ -523,6 +535,22 @@ Ensure that the <application>GConf</application> daemon, <command>gconfd-2</comm </entry> </row> <row> + <entry colname="colspec0"> + <para> + <literal>--dump</literal> + </para> + </entry> + <entry colname="colspec1"> + <para>Generates a list that contains all preference +keys in a <application>GConf</application> repository directory that you specify. +The list contains XML descriptions of all the keys. The list is contained +in a <literal><gconfentryfile></literal> element. </para> + <para>For example, +you can redirect the output from this option to generate a file that lists +all keys that are related to your panel configuration. You can use the <literal>--load</literal> option with this file.</para> + </entry> + </row> + <row> <entry valign="top"> <para> <literal>--get</literal> @@ -545,6 +573,19 @@ key that you specify.</para> </entry> </row> <row> + <entry colname="colspec0"> + <para> + <literal>--load=<replaceable>filename</replaceable></literal> + </para> + </entry> + <entry colname="colspec1"> + <para>Use +this option to sets the values of preference keys in the current directory +in a configuration source to the values in the file that you specify. The +file that you specify must contain XML descriptions of the keys, in a <literal><gconfentryfile></literal> element.</para> + </entry> + </row> + <row> <entry colname="colspec0" valign="top"> <para> <literal>--long-desc=<replaceable>description</replaceable></literal> @@ -583,7 +624,7 @@ an owner for a schema key. </para> </para> </entry> <entry valign="top"> - <para>Displays the value of all preference keys in all + <para>Displays the values of all preference keys in all subdirectories in a directory that you specify.</para> </entry> </row> @@ -612,8 +653,11 @@ with the <literal>--set</literal> option to specify the data type of the value that you want to set. For example, the following command sets the value of the <literal>/apps/gnome-terminal/profiles/Default/background_color</literal> key in the user configuration source:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --set "/apps/gnome-terminal/profiles/Default/background_color" ---type string "#000000"</userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --set "/apps/gnome-terminal/profiles/Default/background_color" +--type string "#000000"</userinput> + </para> <para>You can also use the <literal>--direct</literal> option and the <literal>--config-source</literal> option with the <literal>--set</literal> option to write a value to another configuration source.</para> @@ -654,8 +698,11 @@ option to specify the attribute that you want to update:</para> </itemizedlist> <para>For example, the following command sets the short description in the schema key for the <literal>/apps/gnome-terminal/profiles/Default/background_color</literal> key:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --set-schema "/schemas/apps/gnome-terminal/profiles/Default/background_color" ---short-desc "Default background color of terminal"</userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --set-schema "/schemas/apps/gnome-terminal/profiles/Default/background_color" +--short-desc "Default background color of terminal"</userinput> + </para> </entry> </row> <row> @@ -682,7 +729,7 @@ option to specify a short description for a schema key. </para> <row> <entry colname="colspec0" valign="top"> <para> - <literal>--type=<replaceable>data_type</replaceable></literal> + <literal>--type=<replaceable>data-type</replaceable></literal> </para> </entry> <entry colname="colspec1" valign="top"> @@ -767,20 +814,29 @@ values or default preference values for users, you must ensure that the <applica are logged out before you change preference values for users.</para> <para>To set a mandatory value or a default value for a preference key, use the <command>gconftool-2</command> command, as follows:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source <replaceable>configuration_source</replaceable> --type <replaceable>data_type</replaceable> ---set <replaceable>preference_key</replaceable> <replaceable>value</replaceable></userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source <replaceable>configuration-source</replaceable> --type <replaceable>data-type</replaceable> +--set <replaceable>preference-key</replaceable><replaceable>value</replaceable></userinput> + </para> <para>For example, to set <literal>wwwproxy.xyz.com</literal> as the mandatory HTTP proxy host, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /system/http_proxy/host -wwwproxy.xyz.com</userinput></para> +wwwproxy.xyz.com</userinput> + </para> <para>The user cannot override this preference value.</para> <para>You can also use the <command>gconftool-2</command> command to set default values. For example, to set the default number of workspaces to five, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults --type int --set /apps/metacity/general/num_workspaces -5</userinput></para> +5</userinput> + </para> <para>The user can override this preference value.</para> <caution> <para>Before you change mandatory preference values or default preference @@ -806,11 +862,17 @@ GConf</secondary> the values of the preference keys in the <filename>/system/http_proxy/</filename> location. For example, to set a mandatory value for the HTTP proxy host, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /system/http_proxy/host <replaceable>proxy_name</replaceable></userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /system/http_proxy/host <replaceable>proxy-name</replaceable></userinput> + </para> <para>To set a default value for the HTTP proxy host, run the following command: </para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /system/http_proxy/host <replaceable>proxy_name</replaceable></userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /system/http_proxy/host <replaceable>proxy-name</replaceable></userinput> + </para> <para>You can also set other HTTP proxy-related preferences. For information on the other HTTP proxy preferences, see the <filename>system_http_proxy.schemas</filename> schema definition file.</para> </sect2> @@ -829,12 +891,18 @@ value as follows: </para> <secondary>setting with GConf</secondary> </indexterm> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.mandatory ---type bool --set /apps/gnome-print-manager/show_all_jobs false</userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.mandatory +--type bool --set /apps/gnome-print-manager/show_all_jobs false</userinput> + </para> <para>To set a default value for this preference, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults --type bool --set /apps/gnome-print-manager/show_all_jobs -false</userinput></para> +false</userinput> + </para> <para>You can also set other print manager preferences. For information on the other print manager preferences, see the <filename>gnome-print-manager.schemas</filename> schema definition file.</para> </sect2> @@ -850,11 +918,17 @@ the other print manager preferences, see the <filename>gnome-print-manager.schem </indexterm> <para>To set a mandatory number of workspaces, use the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.mandatory --type int --set /apps/metacity/general/num_workspaces <replaceable>integer</replaceable></userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.mandatory --type int --set /apps/metacity/general/num_workspaces <replaceable>integer</replaceable></userinput> + </para> <para>To set a default number of workspaces, use the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.defaults --type int --set /apps/metacity/general/num_workspaces <replaceable>integer</replaceable></userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.defaults --type int --set /apps/metacity/general/num_workspaces <replaceable>integer</replaceable></userinput> + </para> <para>You can also set other window manager preferences. For information on the other window manager preferences, see the <filename>metacity.schemas</filename> schema definition file.</para> @@ -873,13 +947,19 @@ schema definition file.</para> keys in the <filename>/desktop/gnome/accessibility/keyboard</filename> location. For example, if you want to set a mandatory value so that keyboard accessibility features are enabled, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.mandatory --type bool --set /desktop/gnome/accessibility/keyboard/enable -true</userinput></para> +true</userinput> + </para> <para>To set a default value for this preference, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults --type bool --set desktop/gnome/accessibility/keyboard/enable -false</userinput></para> +false</userinput> + </para> <para>You can also set other keyboard accessibility preferences. For information on the other keyboard accessibility preferences, see the <filename>desktop_gnome_accessibility_keyboard.schemas</filename> schema definition file.</para> </sect2> @@ -894,89 +974,21 @@ on the other keyboard accessibility preferences, see the <filename>desktop_gnome <secondary>setting shortcut preferences with GConf</secondary> </indexterm> <para>To set -keyboard shortcut preferences, you modify the values of preference keys in -two locations. The following table shows the locations to modify, and the -part of the user interface to which the locations correspond:</para> - <informaltable frame="topbot"> - <tgroup cols="2" colsep="0" rowsep="0"> - <colspec colwidth="50*"/> - <colspec colwidth="50*"/> - <thead> - <row rowsep="1"> - <entry valign="top"> - <para>GConf Location</para> - </entry> - <entry valign="top"> - <para>User Interface Component</para> - </entry> - </row> - </thead> - <tbody> - <row> - <entry valign="top"> - <para> - <filename>/apps/panel/global</filename> - </para> - </entry> - <entry valign="top"> - <para><application>Keyboard Shortcuts</application> preference -tool, <guilabel>Desktop</guilabel> section</para> - </entry> - </row> - <row> - <entry valign="top"> - <para> - <filename>/apps/metacity/general</filename> - </para> - </entry> - <entry valign="top"> - <para><application>Keyboard Shortcuts</application> preference -tool, <guilabel>Window Management</guilabel> section</para> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - <para>For example, you might want users to use only the <keycombo><keycap>Alt</keycap><keycap>F3</keycap></keycombo> - keyboard shortcut to open the <guilabel>Run Program</guilabel> dialog. To set this mandatory value, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /apps/panel/global/run_key -'<Alt>F3'</userinput></para> - <para>You might want users to use <keycombo><keycap>Alt</keycap><keycap>F11</keycap></keycombo> -to maximize windows, by default. To set this default value, run the following -command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /apps/metacity/window_keybindings/maximize -'<Alt>F11'</userinput></para> +keyboard shortcut preferences, you modify the values of preference keys in <filename>/apps/metacity/global_keybindings</filename> location. For example, you might +want users to use only the <keycombo><keycap>Alt</keycap><keycap>F3</keycap></keycombo> keyboard +shortcut to open the <guilabel>Run Program</guilabel> dialog. To set this +mandatory value, run the following command:</para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /apps/metacity/global_keybindings +'<Alt>F3'</userinput> + </para> <para>You can also set other keyboard shortcut preferences. For information -on the other keyboard shortcut preferences, see the <filename>panel-global-config.schemas</filename> and <filename>metacity.schemas</filename> schema definition files.</para> - </sect2> - <sect2 id="gconf-13"> - <title>To Set Global Panel Preferences</title> - <indexterm> - <primary>GConf</primary> - <secondary>global panel preferences, setting</secondary> - </indexterm> - <indexterm> - <primary>panels</primary> - <secondary>setting -global preferences with GConf</secondary> - </indexterm> - <para>To set global preferences -for panels, you modify the values of the preference keys in the <filename>/apps/panel/global</filename> location. For example, if you do not want users -to ever use panel animation, set a mandatory value as follows:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.mandatory --type bool --set /apps/panel/global/enable_animations -false</userinput></para> - <para>To set a default value for this preference, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.defaults --type bool --set /apps/panel/global/enable_animations -false</userinput></para> - <para>You can also set other global panel preferences. For information on -the other global panel preferences, see the <filename>panel-global-config.schemas</filename> schema definition file.</para> +on the other keyboard shortcut preferences, see the <filename>metacity.schemas</filename> schema definition file.</para> </sect2> <sect2 id="gconf-14"> - <title>To Set Preferences for Individual Panels and Panel Objects</title> + <title>Setting Panel and Panel Object Preferences</title> <indexterm> <primary>GConf</primary> <secondary>panel object preferences, setting</secondary> @@ -990,9 +1002,9 @@ preferences, setting individual </secondary> <primary>panels</primary> <secondary>preferences, individual, setting with GConf</secondary> </indexterm> - <para>The <filename>panel-per-panel-config.schemas</filename> -schema definition file specifies the following details of the panels on the -desktop:</para> + <para>The <filename>panel-default-setup.entries</filename> schema +definition file specifies the following details of the panels in the desktop +environment:</para> <itemizedlist> <listitem> <para>Number of panels.</para> @@ -1009,12 +1021,12 @@ desktop:</para> </itemizedlist> <para>The configuration of individual panels and of panel objects is a complex task. To configure individual panels and panel objects, you must first understand -the structure of the <filename>panel-per-panel-config.schemas</filename> schema -definition file. For more information on the <filename>panel-per-panel-config.schemas</filename> schema definition file, see the next section.</para> +the structure of the <filename>panel-default-setup.entries</filename> schema +definition file. For more information on the <filename>panel-default-setup.entries</filename> schema definition file, see the next section.</para> <para>To set preferences for individual panels and panel objects, you must set the values of many preferences in a configuration source. The easiest -way to set the values of many preferences is to use a script. For a sample -script that sets preferences for a panel and objects on the panel, see <xref linkend="gconf-3"/>.</para> +way to set the values of panel preferences is to use the <literal>gconftool-2</literal> command with the <literal>--dump</literal> and <literal>--load</literal> options. For more information on how to set preferences for panels +and objects on panels, see <xref linkend="gconf-3"/>.</para> <sect3 id="gconf-23"> <title>Schema Definition File for Individual Panels and Panel Objects</title> <indexterm> @@ -1027,207 +1039,160 @@ script that sets preferences for a panel and objects on the panel, see <xref lin <secondary>schema definition files</secondary> <tertiary>panel and panel object</tertiary> </indexterm> - <para>The schema definition file <filename>panel-per-panel-config.schemas</filename> contains sections that specify panels -and panel contents for small, medium, and large screens. The section for small -screens and the section for large screens are not functional at the time of -publication of this guide. To learn about preference keys for panels or panel -objects, read the section for medium screens only. </para> - <para>The medium section of the file <filename>panel-per-panel-config.schemas</filename> is structured as follows:</para> + <para>The schema definition file <filename>panel-default-setup.entries</filename> contains sections that specify panels +and panel contents. The <filename>panel-default-setup.entries</filename> file +is structured as follows:</para> <orderedlist> <listitem> <para>Preference keys that specify the general structure of panels, -applets, and other panel objects on the desktop. The following keys specify -the number of panels, applets, and other panel objects that appear on the -desktop:</para> +applets, and other panel objects in the desktop environment. The following +keys specify the number of panels, applets, and other panel objects that appear +in the desktop environment:</para> <itemizedlist> <listitem> <para> - <literal>/apps/panel/default_profiles/medium/general/panel_id_list</literal> + <literal>/apps/panel/default_setup/general/toplevel_id_list</literal> </para> </listitem> <listitem> <para> - <literal>/apps/panel/default_profiles/medium/general/applet_id_list</literal> + <literal>/apps/panel/default_setup/general/applet_id_list</literal> </para> </listitem> <listitem> <para> - <literal>/apps/panel/default_profiles/medium/general/object_id_list</literal> + <literal>/apps/panel/default_setup/general/object_id_list</literal> </para> </listitem> </itemizedlist> <para>The keys also assign identifiers to each panel, applet, and panel object. -For example, the following excerpt from <filename>panel-per-panel-config.schemas</filename> specifies that two panels appear on the desktop:</para> - <literallayout><key>/schemas/apps/panel/default_profiles/medium/ -general/panel_id_list</key> -. -. -. -<default>[00000001,00000002]</default></literallayout> - <para>In <filename>panel-per-panel-config.schemas</filename>, the identifier -00000001 identifies the bottom edge panel, and the identifier 00000002 identifies -the Menu Panel.</para> +For example, the following sample from <filename>panel-default-setup.entries</filename> specifies that one panel appears in the desktop environment:</para> + <literallayout><entry> + <key>toplevel_id_list</key> + <schema_key>/schemas/apps/panel/general/toplevel_id_list</schema_key> + <value> + <list type="string"> + <value> + <string>bottom_panel</string> + </value> + </list> + </value> + </entry></literallayout> + <para>In <filename>panel-default-setup.entries</filename>, the identifier <literal>bottom_panel</literal> identifies the bottom edge panel.</para> </listitem> <listitem> <para>Preference keys that specify the properties of the panels. The panel property keys are structured as follows:</para> - <literallayout>/apps/panel/default_profiles/medium/panels/<replaceable>panel_number</replaceable>/<replaceable>panel_property_key</replaceable></literallayout> - <para>For example, the key <literal>/apps/panel/default_profiles/medium/panels/00000001/screen_edge</literal> specifies the edge of the display on which the bottom edge panel -resides. </para> - <para>The keys that specify the properties of the bottom edge panel are listed -first. The keys that specify the properties of the Menu Panel are listed at -the end of the medium section in <filename>panel-per-panel-config.schemas</filename>. </para> + <literallayout>/apps/panel/default_setup/toplevels/<replaceable>panel-name</replaceable>/<replaceable>panel-property-key</replaceable></literallayout> + <para>For example, the key <literal>/apps/panel/default_setup/toplevels/bottom_panel/size</literal> specifies the size of the bottom panel. </para> </listitem> <listitem> <para>Preference keys that list the panel objects, the panel object properties, and the panels in which the objects reside. For example, the following -excerpt from <filename>panel-per-panel-config.schemas</filename> specifies -object 00000001:</para> - <literallayout><key>/schemas/apps/panel/default_profiles/medium/ -objects/00000001/object_type</key> -. -. -. -<default>launcher-object</default> -. -. +sample from <filename>panel-default-setup.entries</filename> specifies a <guimenu>Main Menu</guimenu> object at the left side of the bottom panel:</para> + <literallayout><entrylist base="/apps/panel/default_setup/objects/main_menu"> + <entry> + <key>object_type</key> + <schema_key>/schemas/apps/panel/objects/object_type</schema_key> + <value> + <string>menu-object</string> + </value> + </entry> + <entry> + <key>toplevel_id</key> + <schema_key>/schemas/apps/panel/objects/toplevel_id</schema_key> + <value> + <string>bottom_panel</string> + </value> + </entry> + <entry> + <key>position</key> + <schema_key>/schemas/apps/panel/objects/position</schema_key> + <value> + <int>0</int> + </value> + </entry> . -<key>/schemas/apps/panel/default_profiles/medium/ -objects/00000001/launcher_location</key> . . -. -<default>applications:///nautilus.desktop</default> -. -. -. -<key>/schemas/apps/panel/default_profiles/medium/ -objects/00000001/panel_id</key> -. -. -. -<default>00000002</default></literallayout> - <para>The object is a launcher that starts <application>Nautilus</application> -file manager. The launcher resides in the Menu Panel.</para> + </entrylist></literallayout> </listitem> <listitem> <para>Preference keys that list the applets, the applet preferences, -and the panels in which the applets reside. For example, the following excerpt -from <filename>panel-per-panel-config.schemas</filename> specifies applet -00000001:</para> - <literallayout><key>/schemas/apps/panel/default_profiles/medium/ -applets/00000001/object_type</key> -. -. -. -<default>bonobo-applet</default> -. -. -. -<key>/schemas/apps/panel/default_profiles/medium/ -applets/00000001/panel_id</key> -. -. -. -<default>00000001</default> -. +and the panels in which the applets reside. For example, the following sample +from <filename>panel-default-setup.entries</filename> specifies the <application>Window List</application> applet, in the bottom panel:</para> + <literallayout><entrylist base="/apps/panel/default_setup/applets/window_list"> + <entry> + <key>object_type</key> + <schema_key>/schemas/apps/panel/objects/object_type</schema_key> + <value> + <string>bonobo-applet</string> + </value> + </entry> + <entry> + <key>toplevel_id</key> + <schema_key>/schemas/apps/panel/objects/toplevel_id</schema_key> + <value> + <string>bottom_panel</string> + </value> + </entry> + <entry> + <key>position</key> + <schema_key>/schemas/apps/panel/objects/position</schema_key> + <value> + <int>2</int> + </value> + </entry> . . -<key>/schemas/apps/panel/default_profiles/medium/ -applets/00000001/bonobo_iid</key> . -. -. -<default>OAFIID:GNOME_TasklistApplet</default></literallayout> - <para>The applet is the <application>Window List</application> applet. The -applet resides in the bottom edge panel.</para> + <entry> + <key>bonobo_iid</key> + <schema_key>/schemas/apps/panel/objects/bonobo_iid_type</schema_key> + <value> + <string>OAFIID:GNOME_WindowListApplet</string> + </value> + </entry> + </entrylist></literallayout> </listitem> </orderedlist> </sect3> <sect3 id="gconf-3"> - <title>Sample Script for Setting Individual Panel Preferences</title> - <para>This section contains a sample script that sets the preferences for -a panel that has the following major characteristics:</para> - <itemizedlist> + <title>To Set Preferences for Individual Panels and Panel Objects</title> + <para>To set the preferences for a panel and the objects on a panel perform +the following steps:</para> + <orderedlist> + <listitem> + <para>Log in to a GNOME session, and configure the panels as required.</para> + </listitem> <listitem> - <para>The panel is an edge panel, and resides at the bottom edge -of the screen.</para> + <para>Use the <literal>--dump</literal> option with the <literal>gconftool-2</literal> command line tool to generate a file that contains an +XML description of your panel configuration. The <literal>--dump</literal> +option generates a list that contains all preference keys in a <application>GConf</application> repository directory that you specify. </para> + <para>For example, the following command creates an XML description of the +default panel configuration in a file called <filename>my-panel-setup.entries</filename>:</para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --dump /apps/panel/profiles/default +> my-panel-setup.entries</userinput> + </para> </listitem> <listitem> - <para>The panel contains a file manager launcher and a <application>Terminal</application> launcher.</para> + <para>Open the <filename>my-panel-setup.entries</filename> file +in a text editor, and modify the file as required.</para> </listitem> <listitem> - <para>The panel contains a <application>Window List</application> -applet.</para> + <para>Use the <literal>--load</literal> option with the <literal>gconftool-2</literal> command line tool to set the values of the default configuration +source to the values in the <filename>my-panel-setup.entries</filename> file. +For example, the following command sets the values of the keys in the default +configuration source to the values of the corresponding keys in <filename>my-panel-setup.entries</filename>:</para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.defaults --load my-panel-setup.entries</userinput> + </para> </listitem> - </itemizedlist> - <para>The sample script also sets other minor preferences. All of the preferences -have default values, not mandatory values.</para> - <para>The sample script follows:</para> - <literallayout># Usage is: set_key <type> <key> <value> <extra options if any> - -function set_key() -{ - TYPE="$1" - shift - KEY="$1" - shift - VALUE="$1" - shift - OTHER_ARGS="$*" - gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults ---owner=panel $OTHER_ARGS --type "$TYPE" --set "$KEY" "$VALUE" -} - -# Define the number of panels, the number of launchers, and the number of applets -set_key list /apps/panel/default_profiles/medium/general -/panel_id_list [00000001] --list-type string -set_key list /apps/panel/default_profiles/medium/general -/object_id_list [00000001,00000002] --list-type string -set_key list /apps/panel/default_profiles/medium/general -/applet_id_list [00000001] --list-type string - -# Define the characteristics of the panel -set_key string /apps/panel/default_profiles/medium/panels -/00000001/panel_type edge-panel -set_key string /apps/panel/default_profiles/medium/panels -/00000001/panel_size panel-size-x-small -set_key string /apps/panel/default_profiles/medium/panels -/00000001/screen_edge panel-edge-bottom -set_key bool /apps/panel/default_profiles/medium/panels -/00000001/hide_buttons_enabled false -set_key string /apps/panel/default_profiles/medium/panels -/00000001/panel_background_type no-background - -# Define the first launcher -set_key string /apps/panel/default_profiles/medium/objects -/00000001/object_type launcher-object -set_key string /apps/panel/default_profiles/medium/objects -/00000001/launcher_location 'applications:///nautilus.desktop' -set_key string /apps/panel/default_profiles/medium/objects -/00000001/panel_id 00000001 -set_key int /apps/panel/default_profiles/medium/objects -/00000001/position 20 - -# Define the second launcher -set_key string /apps/panel/default_profiles/medium/objects -/00000002/object_type launcher-object -set_key string /apps/panel/default_profiles/medium/objects -/00000002/launcher_location 'applications:///System/gnome-terminal.desktop' -set_key string /apps/panel/default_profiles/medium/objects -/00000002/panel_id 00000001 -set_key int /apps/panel/default_profiles/medium/objects -/00000002/position 25 - -# Define the applet -set_key string /apps/panel/default_profiles/medium/applets -/00000001/object_type bonobo-applet -set_key string /apps/panel/default_profiles/medium/applets -/00000001/bonobo_iid OAFIID:GNOME_TasklistApplet -set_key string /apps/panel/default_profiles/medium/applets -/00000001/panel_id 00000001 -set_key int /apps/panel/default_profiles/medium/applets -/00000001/position 25</literallayout> + </orderedlist> </sect3> </sect2> </sect1> @@ -1284,19 +1249,25 @@ interface to which the keys correspond:</para> </informaltable> <para>For example, to set <literal>Sans 12</literal> as the mandatory application font, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /desktop/gnome/interface/font_name “Sans -12”</userinput></para> +12”</userinput> + </para> <indexterm> - <primary>desktop background</primary> - <secondary>font preferences, -setting with GConf</secondary> + <primary>desktop</primary> + <secondary>font preferences, setting +with GConf</secondary> </indexterm> - <para>To set <literal>palatino 12</literal> as the default desktop background object font, run the following -command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source + <para>To set <literal>palatino 12</literal> +as the default desktop object font, run the following command:</para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /apps/nautilus/preferences/desktop_font “palatino -12”</userinput></para> +12”</userinput> + </para> </sect2> <sect2 id="gconf-20"> <title>To Set Desktop Background Preferences</title> @@ -1311,11 +1282,17 @@ xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /apps/nautilus/p <para>To set desktop background preferences, you modify the values of the preference keys in the <filename>/desktop/gnome/background</filename> location. For example, to set a mandatory image for the desktop background, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /desktop/gnome/background/picture_filename <replaceable>filename.png</replaceable></userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /desktop/gnome/background/picture_filename <replaceable>filename.png</replaceable></userinput> + </para> <para>To set a default value for this preference, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /desktop/gnome/background/picture_filename <replaceable>filename.png</replaceable></userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /desktop/gnome/background/picture_filename <replaceable>filename.png</replaceable></userinput> + </para> <para>You can also set other desktop background preferences. For information on the other desktop background preferences, see the <filename>desktop_gnome_background.schemas</filename> schema definition file.</para> </sect2> @@ -1333,13 +1310,19 @@ with GConf</secondary> <para>To set splash image preferences, you modify the value of the preference keys in the <filename>/apps/gnome-session/options/</filename> location. For example, if you do not want users ever to see a splash image, set a mandatory value as follows:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.mandatory --type bool --set /apps/gnome-session/options/show_splash_screen -false</userinput></para> +false</userinput> + </para> <para>To set a default value for this preference, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults --type bool --set /apps/gnome-session/options/show_splash_screen -false</userinput></para> +false</userinput> + </para> <para>You can also set other splash image preferences. For information on the other splash image preferences, see the <filename>gnome-session.schemas</filename> schema definition file.</para> </sect2> @@ -1357,11 +1340,155 @@ values</secondary> </indexterm> <para>To restore the default preference values for a user, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --direct --config-source <replaceable>user_configuration_source</replaceable> --recursive-unset</userinput></para> - <para>Replace <replaceable>user_configuration_source</replaceable> with the + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --direct --config-source <replaceable>user-configuration-source</replaceable> --recursive-unset</userinput> + </para> + <para>Replace <replaceable>user-configuration-source</replaceable> with the configuration source in the <filename>.gconf</filename> directory in the home directory of the user. </para> <para>This command resets the values of all preference keys, in all subdirectories, from the user setting to the setting in the default configuration source.</para> </sect1> + <sect1 id="gconf-4"> + <title>Using Configuration Editor</title> + <indexterm> + <primary>GConf</primary> + <see>Configuration Editor</see> + </indexterm> + <indexterm> + <primary>Configuration Editor</primary> + <secondary>overview</secondary> + </indexterm> + <para><application>Configuration Editor</application> enables +you to do the following:</para> + <itemizedlist> + <listitem> + <para>Modify the values of the keys in the <application>GConf</application> +repository.</para> + </listitem> + <listitem> + <para>View documentation on the keys in the <application>GConf</application> +repository.</para> + </listitem> + </itemizedlist> + <para>To open <application>Configuration Editor</application>, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>System Tools</guisubmenu><guimenuitem>Configuration Editor</guimenuitem></menuchoice>. <xref linkend="gconf-FIG-31"/> +shows the <application>Configuration Editor</application> window.</para> + <figure id="gconf-FIG-31"> + <title>Configuration Editor Window</title> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/gconf_editor_anno_window.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Configuration Editor window. Callouts: Tree pane, Modification pane, Documentation pane.</phrase> + </textobject> + </mediaobject> + </screenshot> + </figure> + <para>The <application>Configuration Editor</application> window contains +the following panes:</para> + <variablelist> + <varlistentry> + <term>Tree pane</term> + <listitem> + <para>Enables you to navigate +the directories and subdirectories in the <application>GConf</application> +repository. Use this pane to display the keys that you want to modify in the +modification pane. The tree pane is on the left side of the window.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>Modification pane</term> + <listitem> + <para>Displays the keys +in the selected <application>GConf</application> repository directory. Use +this pane to select keys that you want to modify, and to modify the values +of keys. The modification pane is in the upper part of the right side of the +window.</para> + <para>The icons beside the keys in the modification pane indicate what type +of value you can enter for the key. For example, the check mark icon beside +the <literal>/system/http_proxy/use_http_proxy</literal> key indicates that +you can enter a boolean value for the key. </para> + <para>The icons also indicate if you cannot edit the value of a key. For example, +a key icon beside a schema key indicates that you cannot modify the value +of the key. </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Documentation pane</term> + <listitem> + <para>Displays documentation +for the currently selected key. Use this pane to read more information on +the <application>GConf</application> preference keys.</para> + </listitem> + </varlistentry> + </variablelist> + <indexterm> + <primary>GConf</primary> + <secondary>GConf editor, +using</secondary> + </indexterm> + <para>You can copy the names of keys so that +you can paste the name of the key into another application. You can also add +bookmarks to keys.</para> + <para>The following sections describe how to use the <application>Configuration +Editor</application>.</para> + <sect2 id="gconf-32"> + <title>To Modify the Value of a Key</title> + <indexterm> + <primary>Configuration Editor</primary> + <secondary>modifying key +values</secondary> + </indexterm> + <para>To modify the value of a key, perform +the following steps:</para> + <orderedlist> + <listitem> + <para>Use the tree pane to display the key that you want to modify +in the modification pane. </para> + </listitem> + <listitem> + <para>Select the key to modify.</para> + </listitem> + <listitem> + <para>To change the value of an integer key or a string key, click +in the <guilabel>Value</guilabel> column of the key. Type the new value for +the key.</para> + <para>To change the value of a boolean key, click in the <guilabel>Value</guilabel> +column of the key.</para> + </listitem> + </orderedlist> + </sect2> + <sect2 id="gconf-33"> + <title>To Copy a Key Name</title> + <indexterm> + <primary>Configuration Editor</primary> + <secondary>copying key names</secondary> + </indexterm> + <para>To copy a key name, select the key whose name +you want to copy in the modification pane. Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy key name</guimenuitem></menuchoice>. If required, +you can paste the name of the key into another application.</para> + </sect2> + <sect2 id="gconf-5"> + <title>Using Bookmarks With Keys</title> + <indexterm> + <primary>Configuration Editor</primary> + <secondary>bookmarks</secondary> + </indexterm> + <para>To access a key in your bookmarks, choose the key from the <guimenu>Bookmarks</guimenu> menu. You can add keys to your <guimenu>Bookmarks</guimenu> +menu. </para> + <sect3 id="gconf-29"> + <title>To Add a Bookmark</title> + <para>To add a bookmark, select the key that you want to bookmark in the modification +pane. Choose <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Add bookmark</guimenuitem></menuchoice>.</para> + </sect3> + <sect3 id="gconf-30"> + <title>To Delete a Bookmark</title> + <para>To delete a bookmark, choose <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Edit bookmarks</guimenuitem></menuchoice>. An <guilabel>Edit bookmarks</guilabel> dialog is displayed. Select the bookmark in the +dialog, then click <guilabel>Delete</guilabel>. </para> + </sect3> + </sect2> + </sect1> </chapter> diff --git a/gnome2-system-admin-guide/C/gdm.xml b/gnome2-system-admin-guide/C/gdm.xml new file mode 100644 index 0000000..f34d4b1 --- /dev/null +++ b/gnome2-system-admin-guide/C/gdm.xml @@ -0,0 +1,550 @@ +<chapter id="gdm-0"> + <title>Configuring GDM</title> + <highlights> + <para>This chapter describes how to configure <application>GDM</application> in the GNOME Desktop.</para> + </highlights> + <sect1 id="gdm-1"> + <title>Introduction to GDM</title> + <indexterm> + <primary>GDM</primary> + <secondary>introduction</secondary> + </indexterm> + <para>To start a GNOME Desktop session, users must log in to authenticate +their identity. The login screen provides gateway to the desktop environment +for the user. The <application>GNOME Display Manager</application> (<application>GDM</application>) application controls the login screen. </para> + <para><application>GDM</application> also enables you to log in to another +session without closing the current session.</para> + </sect1> + <sect1 id="gdm-2"> + <title>Configuring GDM</title> + <indexterm> + <primary>GDM</primary> + <secondary>configuring</secondary> + </indexterm> + <para>To configure <application>GDM</application>, use the <application>GDM +Configurator</application> application. To open <application>GDM Configurator</application>, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>System Tools</guisubmenu><guimenuitem>GDM Configurator</guimenuitem></menuchoice>.</para> + <para>You can configure <application>GDM</application> in the following functional +areas:</para> + <itemizedlist> + <listitem> + <para> + <guilabel>General</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Standard greeter</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Graphical greeter</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Security</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>XDMCP</guilabel> + </para> + </listitem> + </itemizedlist> + <sect2 id="gdm-3"> + <title>General Settings</title> + <para>Use the <guilabel>General</guilabel> tabbed section to set general GDM +preferences.</para> + <para><xref linkend="gdm-TBL-8"/> lists the general GDM settings that you can +configure.</para> + <table frame="topbot" id="gdm-TBL-8"> + <title>General GDM Settings</title> + <tgroup cols="2" colsep="0" rowsep="0"> + <colspec colwidth="50*"/> + <colspec colwidth="50*"/> + <thead> + <row rowsep="1"> + <entry> + <para>Element</para> + </entry> + <entry> + <para>Description</para> + </entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para> + <guilabel>Local</guilabel> + </para> + </entry> + <entry> + <para>Information +to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Remote</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Always use 24 hour clock format</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Login a user automatically on first bootup</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Automatic login username</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Login a user automatically after a specified number +of seconds</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided +in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Timed login username</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Seconds before login</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + </tbody> + </tgroup> + </table> + </sect2> + <sect2 id="gdm-4"> + <title>Standard Greeter Settings</title> + <para>Use the <guilabel>Standard greeter</guilabel> tabbed section to set +preferences for the standard greeter.</para> + <para><xref linkend="gdm-TBL-9"/> lists the standard greeter settings that +you can configure.</para> + <table frame="topbot" id="gdm-TBL-9"> + <title>Standard Greeter Settings</title> + <tgroup cols="2" colsep="0" rowsep="0"> + <colspec colname="colspec2" colwidth="50*"/> + <colspec colname="colspec3" colwidth="50*"/> + <thead> + <row rowsep="1"> + <entry> + <para>Element</para> + </entry> + <entry> + <para>Description</para> + </entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para> + <guilabel>Logo</guilabel> + </para> + </entry> + <entry> + <para>Information +to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Welcome string</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Show choosable user images (face browser)</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>No background</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry colname="colspec2"> + <para> + <guilabel>Image</guilabel> + </para> + </entry> + <entry colname="colspec3"> + <para/> + </entry> + </row> + <row> + <entry colname="colspec2"> + <para> + <guilabel>Color</guilabel> + </para> + </entry> + <entry colname="colspec3"> + <para/> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Scale background image to fit</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Only color on remote displays</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Background color</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + </tbody> + </tgroup> + </table> + </sect2> + <sect2 id="gdm-5"> + <title>Graphical Greeter Settings</title> + <para>Use the <guilabel>Graphical greeter</guilabel> tabbed section to set +preferences for the graphical greeter.</para> + <para><xref linkend="gdm-TBL-10"/> lists the graphical greeter settings that +you can configure.</para> + <table frame="topbot" id="gdm-TBL-10"> + <title>Graphical Greeter Settings</title> + <tgroup cols="2" colsep="0" rowsep="0"> + <colspec colwidth="50*"/> + <colspec colwidth="50*"/> + <thead> + <row rowsep="1"> + <entry> + <para>Element</para> + </entry> + <entry> + <para>Description</para> + </entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para>Greeter list</para> + </entry> + <entry> + <para>Information to be +provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guibutton>Install new theme</guibutton> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + </tbody> + </tgroup> + </table> + </sect2> + <sect2 id="gdm-6"> + <title>Security Settings</title> + <para>Use the <guilabel>Security</guilabel> tabbed section to set security +preferences for GDM.</para> + <para><xref linkend="gdm-TBL-11"/> lists the security settings that you can +configure.</para> + <table frame="topbot" id="gdm-TBL-11"> + <title>Security Settings</title> + <tgroup cols="2" colsep="0" rowsep="0"> + <colspec colwidth="50*"/> + <colspec colwidth="50*"/> + <thead> + <row rowsep="1"> + <entry> + <para>Element</para> + </entry> + <entry> + <para>Description</para> + </entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para> + <guilabel>Allow root to login with GDM</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Allow root to login remotely with GDM</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Allow remote timed logins</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Show system menu</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Allow configuration from the login screen</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Retry delay (seconds)</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + </tbody> + </tgroup> + </table> + </sect2> + <sect2 id="gdm-7"> + <title>XDMCP Settings</title> + <para>Use the <guilabel>XDMCP</guilabel> tabbed section to set preferences +for XDMCP.</para> + <para><xref linkend="gdm-TBL-12"/> lists the XDMCP settings that you can configure.</para> + <table frame="topbot" id="gdm-TBL-12"> + <title>XDMCP Settings</title> + <tgroup cols="2" colsep="0" rowsep="0"> + <colspec colname="colspec0" colwidth="50*"/> + <colspec colname="colspec1" colwidth="50*"/> + <thead> + <row rowsep="1"> + <entry> + <para>Element</para> + </entry> + <entry> + <para>Description</para> + </entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para> + <guilabel>Enable XDMCP</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Honour indirect requests</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Listen on UDP port</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Maximum pending requests</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Max pending indirect requests</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Maximum remote sessions</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Maximum wait time</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry> + <para> + <guilabel>Maximum indirect wait time</guilabel> + </para> + </entry> + <entry> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry colname="colspec0"> + <para> + <guilabel>Displays per host</guilabel> + </para> + </entry> + <entry colname="colspec1"> + <para>Information to be provided in a future release.</para> + </entry> + </row> + <row> + <entry colname="colspec0"> + <para> + <guilabel>Ping interval (minutes)</guilabel> + </para> + </entry> + <entry colname="colspec1"> + <para>Information to be provided in a future release.</para> + </entry> + </row> + </tbody> + </tgroup> + </table> + </sect2> + </sect1> + <sect1 id="gdm-13"> + <title>Logging in to a New Session</title> + <indexterm> + <primary>GDM</primary> + <secondary>logging in to new session</secondary> + </indexterm> + <indexterm> + <primary>New login application</primary> + </indexterm> + <para>To log in to a new session, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>System Tools</guisubmenu><guimenuitem>New login</guimenuitem></menuchoice>. A login screen is displayed. Enter your username +and password to log in.</para> + </sect1> +</chapter> diff --git a/gnome2-system-admin-guide/C/glossary.xml b/gnome2-system-admin-guide/C/glossary.xml index 6c9ddf9..65dd29a 100644 --- a/gnome2-system-admin-guide/C/glossary.xml +++ b/gnome2-system-admin-guide/C/glossary.xml @@ -1,4 +1,3 @@ -<?xml version="1.0" encoding="utf-8"?> <glossary id="glossary-1"> <title>Glossary</title> <glossentry id="glossary-13"> @@ -9,12 +8,16 @@ <glossterm><filename>.directory</filename> file</glossterm> <glosssee otherterm="glossary-12"/> </glossentry> + <glossentry id="glossary-32"> + <glossterm><filename>.omf</filename> file</glossterm> + <glosssee otherterm="glossary-31"/> + </glossentry> <glossentry id="glossary-18"> <glossterm>application registry</glossterm> <glossdef> <para>The application registry is a location that contains text files which register applications. The location of the application registry -for the GNOME desktop is <filename>/usr/share/gnome/application-registry</filename>.</para> +for the GNOME Desktop is <filename>/usr/share/gnome/application-registry</filename>.</para> </glossdef> </glossentry> <glossentry id="glossary-11"> @@ -22,8 +25,7 @@ for the GNOME desktop is <filename>/usr/share/gnome/application-registry</filena <glossdef> <para>A data file that provides information about an item in a menu. The desktop entry file specifies the details for the item such as a name, -a command to run, an icon, and so on. Desktop entry files have -a <filename>.desktop</filename> file extension.</para> +a command to run, an icon, and so on. Desktop entry files have a <filename>.desktop</filename> file extension.</para> </glossdef> </glossentry> <glossentry id="glossary-12"> @@ -134,27 +136,24 @@ icon to represent files of that MIME type. MIME keys files have a <filename>.key <glossdef> <para>A MIME type identifies the format of a file. The MIME type enables applications to read the file. For example, an email application can -use the MIME type to detect what type of file is in a file attached to an -email. </para> +use the <literal>image/png</literal> MIME type to detect that a Portable Networks +Graphic (PNG) file is attached to an email. </para> </glossdef> </glossentry> <glossentry id="glossary-22"> <glossterm>MIME type registry</glossterm> <glossdef> <para>The MIME type registry is a location that contains text files -which register MIME types for the GNOME desktop. The location of the MIME -type registry for the GNOME desktop is <filename>/usr/gnome/share/mime-info</filename>.</para> +which register MIME types for the desktop environment. The location of the +MIME type registry for the GNOME Desktop is <filename>/usr/gnome/share/mime-info</filename>.</para> </glossdef> </glossentry> - <glossentry id="glossary-24"> - <glossterm>Netscape color palette</glossterm> + <glossentry id="glossary-31"> + <glossterm>OMF file</glossterm> <glossdef> - <para>The <application>Netscape</application> color palette is a -general-purpose palette of 216 colors. The <application>Netscape</application> -color palette is designed to optimize the use of color on systems that support -8-bit color. The <application>Netscape</application> color palette is also -called the <emphasis>websafe color palette</emphasis> and the <emphasis>Netscape -color cube</emphasis>.</para> + <para>Open Source Metadata Framework file. This is a file that is +associated with the XML file for a manual. The OMF file contains information +about the manual that is used by the help browser. OMF files have a <filename>.omf</filename> extension.</para> </glossdef> </glossentry> <glossentry id="glossary-25"> @@ -165,12 +164,21 @@ file content sniffer. The pattern mask identifies bits in the pattern to ignore when searching for a pattern in a file. </para> </glossdef> </glossentry> + <glossentry id="glossary-30"> + <glossterm>pregenerate</glossterm> + <glossdef> + <para>To convert source XML files for online help to HTML before +the online help is used. You can pregenerate help to improve the performance +of the help browser. Use the <command>yelp-pregenerate</command> command to +pregenerate help.</para> + </glossdef> + </glossentry> <glossentry id="glossary-28"> <glossterm>screensaver</glossterm> <glossdef> <para>A screensaver is an application that replaces the image on a screen when the screen is not in use. The screensaver application for the -GNOME desktop is <application>XScreenSaver</application>. </para> +GNOME Desktop is <application>XScreenSaver</application>. </para> </glossdef> </glossentry> <glossentry id="glossary-29"> @@ -205,4 +213,14 @@ several directories.</para> files specify the structure of your menus.</para> </glossdef> </glossentry> + <glossentry id="glossary-24"> + <glossterm>websafe color palette</glossterm> + <glossdef> + <para>The websafe color palette is a general-purpose palette of +216 colors. The websafe color palette is designed to optimize the use of color +on systems that support 8-bit color. The websafe color palette is also called +the <emphasis>Netscape color palette</emphasis> and the <emphasis>Netscape +color cube</emphasis>.</para> + </glossdef> + </glossentry> </glossary> diff --git a/gnome2-system-admin-guide/C/help.xml b/gnome2-system-admin-guide/C/help.xml new file mode 100644 index 0000000..af0224b --- /dev/null +++ b/gnome2-system-admin-guide/C/help.xml @@ -0,0 +1,102 @@ +<chapter id="help-0"> + <title>Help System</title> + <highlights> + <para>This chapter describes the Help system in the GNOME Desktop.</para> + </highlights> + <sect1 id="help-1"> + <title>Introduction</title> + <indexterm> + <primary>online Help</primary> + <see>Help</see> + </indexterm> + <indexterm> + <primary>Help</primary> + <secondary>introduction</secondary> + </indexterm> + <para>The GNOME Desktop displays Help in the <application>Yelp</application> Help +browser. The source documents for the Help are XML files. The XML files are +written to the DocBook XML Version 4.1.2 document type definition (DTD). The +DocBook XML files are converted to HTML, and the HTML is displayed in the +Help browser. For more information on DocBook XML, see the following URL:</para> + <literallayout> + <ulink url="http://www.oasis-open.org/docbook/xml/">http://www.oasis-open.org/docbook/xml</ulink> + </literallayout> + <para>The Help system uses <firstterm>Open Source Metadata Framework</firstterm> +(OMF) files, and a cataloging system. The next sections describe OMF files +and the cataloging system.</para> + </sect1> + <sect1 id="help-3"> + <title>OMF Files</title> + <indexterm> + <primary>.omf files</primary> + <see>OMF files</see> + </indexterm> + <indexterm> + <primary>Help</primary> + <secondary>OMF files</secondary> + </indexterm> + <indexterm> + <primary>OMF files</primary> + </indexterm> + <para>The XML file for each manual +has an associated OMF file. The OMF file contains information about the manual +that is used by the Help browser. OMF files have a <filename>.omf</filename> +extension.</para> + <para>When you install an application, the installation process installs an +OMF file to a directory of OMF files. If a Help document has an associated +OMF file in an OMF file directory, the Help document is displayed in the Help +browser.</para> + <para>OMF files contain information about Help documents such as the following:</para> + <itemizedlist> + <listitem> + <para>The location of the XML file for the Help document</para> + </listitem> + <listitem> + <para>The title of the Help document</para> + </listitem> + <listitem> + <para>A subject category to which the Help document belongs</para> + </listitem> + </itemizedlist> + </sect1> + <sect1 id="help-2"> + <title>ScrollKeeper Cataloging System</title> + <indexterm> + <primary>Help</primary> + <secondary>ScrollKeeper cataloging system</secondary> + </indexterm> + <indexterm> + <primary>ScrollKeeper cataloging system</primary> + </indexterm> + <para><application>ScrollKeeper</application> is a cataloging +system for documentation. The Help browser uses <application>ScrollKeeper</application> to catalog the manuals on the system. <application>ScrollKeeper</application> manages the information in the OMF files for the Help browser. </para> + <para><application>ScrollKeeper</application> uses the information in the +OMF files to enable the Help browser to find Help documents on a system. When +you install an application, the installation process installs an OMF file +to a directory of OMF files. </para> + <para><application>ScrollKeeper</application> builds a table of contents for +each Help document that has an associated OMF file. <application>ScrollKeeper</application> builds the table of contents from the XML file specified in +the OMF file. The table of contents for the Help document is displayed in +the left pane of the Help browser window, and enables users to navigate the +Help document in the left pane. The title of the document in the OMF file +is also displayed in the left pane of the Help browser window. </para> + <para><application>ScrollKeeper</application> contains a hierarchy of subject +categories to which a Help document can belong. The Help documents are organized +into this hierarchy of subject categories in the left pane of the Help browser +window. The subject category of the document in the OMF file determines the +location of the document in the hierarchy. The hierarchy of subject categories +is defined in the following file:</para> + <para> + <filename>/usr/share/scrollkeeper/Templates/C/scrollkeeper_cl.xml</filename> + </para> + <para>The subject category of a document must correspond to a subject category +in the following file:</para> + <para> + <filename>/usr/share/scrollkeeper/Templates/C/scrollkeeper_cl.xml</filename> + </para> + <note> + <para>If the Help document XML file is moved to a new location, then +you might need to update the location in the OMF file.</para> + </note> + </sect1> +</chapter> diff --git a/gnome2-system-admin-guide/C/menustructure.xml b/gnome2-system-admin-guide/C/menustructure.xml index f576c73..d090e0f 100644 --- a/gnome2-system-admin-guide/C/menustructure.xml +++ b/gnome2-system-admin-guide/C/menustructure.xml @@ -1,9 +1,8 @@ -<?xml version="1.0" encoding="utf-8"?> <chapter id="menustructure-0"> <title>Customizing Menus</title> <highlights> - <para>The information in this chapter describes how GNOME implements -menus and how you can customize menus.</para> + <para>The information in this chapter describes how the GNOME +Desktop implements menus and how you can customize menus.</para> </highlights> <sect1 id="menustructure-1"> <title>Introduction to Menus</title> @@ -11,8 +10,8 @@ menus and how you can customize menus.</para> <primary>menus</primary> <secondary>introduction</secondary> </indexterm> - <para>The way in which GNOME implements menus in the desktop enables you to -do the following:</para> + <para>The way in which the GNOME Desktop implements menus enables you to do +the following:</para> <itemizedlist> <listitem> <para>Customize the menu hierarchy easily. The menu hierarchy is @@ -28,7 +27,7 @@ about the menu hierarchy to applications when you install the applications.</par <para>Configure menus so that users cannot modify the menus.</para> </listitem> </itemizedlist> - <para>Menus in the GNOME desktop use the following components:</para> + <para>Menus in the GNOME Desktop use the following components:</para> <itemizedlist> <listitem> <para>File abstraction layer</para> @@ -104,7 +103,7 @@ for all users</para> </table> </sect1> <sect1 id="menustructure-13"> - <title>Vfolders</title> + <title>Vfolders and Menus</title> <indexterm> <primary>menus</primary> <secondary>vfolders</secondary> @@ -117,7 +116,7 @@ a <firstterm>vfolder</firstterm> is a virtual representation of items that reside in a physical location or physical locations on your system. For example, a vfolder might represent the contents of several directories. A vfolder is an abstraction from one or more physical locations. In terms of menus in the -GNOME desktop, a vfolder is a representation in a menu of items that might +GNOME Desktop, a vfolder is a representation in a menu of items that might be physically located in several directories. </para> <indexterm> <primary>menus</primary> @@ -380,7 +379,7 @@ links to a file, folder, or FTP site.</para> </entry> <entry colname="colspec1" valign="top"> <para>Specifies -the help file to display when you choose <guimenuitem>Help on <replaceable>application_name</replaceable></guimenuitem> from the menu item popup menu.</para> +the help file to display when you choose <guimenuitem>Help on <replaceable>application-name</replaceable></guimenuitem> from the menu item popup menu.</para> </entry> </row> <row> @@ -409,11 +408,10 @@ URL: </para> <ulink url="http://www.freedesktop.org/standards/desktop-entry-spec/desktop-entry-spec.html">http://www.freedesktop.org/standards/desktop-entry-spec/desktop-entry-spec.html</ulink> </literallayout> <note> - <para>Panel launchers and desktop background objects also use desktop -entry files. The desktop entry files for launchers and desktop background -objects provide the same information as for items in a menu. For example, -the desktop entry files provide the command to run when a user chooses the -launcher or object.</para> + <para>Panel launchers and desktop objects also use desktop entry files. +The desktop entry files for launchers and desktop objects provide the same +information as for items in a menu. For example, the desktop entry files provide +the command to run when a user chooses the launcher or object.</para> </note> </sect1> <sect1 id="menustructure-14"> @@ -507,7 +505,7 @@ or the filename extension. </para> <primary>menus</primary> <secondary>editing</secondary> </indexterm> - <para>You use the following desktop components to edit menus:</para> + <para>You use the following desktop environment components to edit menus:</para> <itemizedlist> <listitem> <para><application>Nautilus</application> file manager</para> @@ -544,10 +542,11 @@ menus.</para> </indexterm> <indexterm> <primary>file manager</primary> - <secondary>adding menus with</secondary> + <secondary>adding menus +with</secondary> </indexterm> - <para>To add a menu for all users, -perform the following steps:</para> + <para>To add a menu for all users, perform the +following steps:</para> <orderedlist> <listitem> <para>In a file manager window, access the location where you want diff --git a/gnome2-system-admin-guide/C/mimetypes.xml b/gnome2-system-admin-guide/C/mimetypes.xml index ac3ff2f..759a681 100644 --- a/gnome2-system-admin-guide/C/mimetypes.xml +++ b/gnome2-system-admin-guide/C/mimetypes.xml @@ -1,12 +1,11 @@ -<?xml version="1.0" encoding="utf-8"?> <chapter id="mimetypes-0"> <title>MIME Types</title> <highlights> <para>This chapter describes how applications detect MIME types, -how to register MIME types, and how to add applications to the GNOME desktop.</para> +how to register MIME types, and how to add applications to the desktop environment.</para> </highlights> <sect1 id="mimetypes-1"> - <title>Introduction</title> + <title>Introduction to MIME Types</title> <indexterm> <primary>MIME types</primary> <secondary>introduction</secondary> @@ -17,9 +16,9 @@ to read the file. Applications such as Internet browsers and email applications use the MIME type to handle files of different types. For example, an email application can use the MIME type to detect what type of file is in a file attached to an email.</para> - <para>In the GNOME desktop, the <application>Nautilus</application> file manager -uses MIME types to identify the type of a file. The file manager needs to -know the MIME type of a file to perform the following tasks:</para> + <para>The <application>Nautilus</application> file manager uses MIME types +to identify the type of a file. The file manager needs to know the MIME type +of a file to perform the following tasks:</para> <itemizedlist> <listitem> <para>Open the file in an appropriate application.</para> @@ -51,7 +50,8 @@ the procedure that you must follow to add a new application.</para> <indexterm> <primary>detecting MIME types</primary> </indexterm> - <para>Applications can detect the MIME type of a file as follows:</para> + <para>Applications +can detect the MIME type of a file as follows:</para> <orderedlist> <listitem> <para>The application uses <firstterm>file content sniffers</firstterm> @@ -162,141 +162,141 @@ this entry.</para> </tbody> </tgroup> </table> - <sect3 id="mimetypes-12"> - <title>Pattern Masks</title> - <indexterm> - <primary>MIME types</primary> - <secondary>pattern mask</secondary> - </indexterm> - <indexterm> - <primary>pattern mask</primary> - </indexterm> - <para>A + </sect2> + <sect2 id="mimetypes-12"> + <title>Pattern Masks</title> + <indexterm> + <primary>MIME types</primary> + <secondary>pattern mask</secondary> + </indexterm> + <indexterm> + <primary>pattern mask</primary> + </indexterm> + <para>A pattern mask identifies bits in the pattern to ignore when searching for a pattern in a file. The following is an example of a file content sniffer with a pattern mask:</para> - <literallayout>0 string BMxxxx\000\000 &0xffff00000000ffff image/bmp</literallayout> - <para>The pattern and mask in the example are as follows:</para> - <informaltable frame="none"> - <tgroup cols="9" colsep="0" rowsep="0"> - <colspec colwidth="16.54*"/> - <colspec colwidth="10.21*"/> - <colspec colwidth="10.41*"/> - <colspec colwidth="10.21*"/> - <colspec colwidth="10.41*"/> - <colspec colwidth="10.21*"/> - <colspec colwidth="10.41*"/> - <colspec colwidth="10.21*"/> - <colspec colwidth="10.41*"/> - <tbody> - <row> - <entry valign="top"> - <para>Pattern</para> - </entry> - <entry valign="top"> - <para> - <literal>B</literal> - </para> - </entry> - <entry valign="top"> - <para> - <literal>M</literal> - </para> - </entry> - <entry valign="top"> - <para> - <literal>x</literal> - </para> - </entry> - <entry valign="top"> - <para> - <literal>x</literal> - </para> - </entry> - <entry valign="top"> - <para> - <literal>x</literal> - </para> - </entry> - <entry valign="top"> - <para> - <literal>x</literal> - </para> - </entry> - <entry valign="top"> - <para> - <literal>\000</literal> - </para> - </entry> - <entry valign="top"> - <para> - <literal>\000</literal> - </para> - </entry> - </row> - <row> - <entry valign="top"> - <para>Mask</para> - </entry> - <entry valign="top"> - <para> - <literal>ff</literal> - </para> - </entry> - <entry valign="top"> - <para> - <literal>ff</literal> - </para> - </entry> - <entry valign="top"> - <para> - <literal>00</literal> - </para> - </entry> - <entry valign="top"> - <para> - <literal>00</literal> - </para> - </entry> - <entry valign="top"> - <para> - <literal>00</literal> - </para> - </entry> - <entry valign="top"> - <para> - <literal>00</literal> - </para> - </entry> - <entry valign="top"> - <para> - <literal>ff</literal> - </para> - </entry> - <entry valign="top"> - <para> - <literal>ff</literal> - </para> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - <para>The pattern and mask specify a file with the following characteristics:</para> - <orderedlist> - <listitem> - <para>The file begins with <literal>BM</literal>.</para> - </listitem> - <listitem> - <para><literal>BM</literal> is followed by four bytes with any values.</para> - </listitem> - <listitem> - <para>The four bytes are followed by <literal>\000\000</literal>.</para> - </listitem> - </orderedlist> - <para>The file content sniffer specifies that the MIME type of files that + <literallayout>0 string BMxxxx\000\000 &0xffff00000000ffff image/bmp</literallayout> + <para>The pattern and mask in the example are as follows:</para> + <informaltable frame="none"> + <tgroup cols="9" colsep="0" rowsep="0"> + <colspec colwidth="16.54*"/> + <colspec colwidth="10.21*"/> + <colspec colwidth="10.41*"/> + <colspec colwidth="10.21*"/> + <colspec colwidth="10.41*"/> + <colspec colwidth="10.21*"/> + <colspec colwidth="10.41*"/> + <colspec colwidth="10.21*"/> + <colspec colwidth="10.41*"/> + <tbody> + <row> + <entry valign="top"> + <para>Pattern</para> + </entry> + <entry valign="top"> + <para> + <literal>B</literal> + </para> + </entry> + <entry valign="top"> + <para> + <literal>M</literal> + </para> + </entry> + <entry valign="top"> + <para> + <literal>x</literal> + </para> + </entry> + <entry valign="top"> + <para> + <literal>x</literal> + </para> + </entry> + <entry valign="top"> + <para> + <literal>x</literal> + </para> + </entry> + <entry valign="top"> + <para> + <literal>x</literal> + </para> + </entry> + <entry valign="top"> + <para> + <literal>\000</literal> + </para> + </entry> + <entry valign="top"> + <para> + <literal>\000</literal> + </para> + </entry> + </row> + <row> + <entry valign="top"> + <para>Mask</para> + </entry> + <entry valign="top"> + <para> + <literal>ff</literal> + </para> + </entry> + <entry valign="top"> + <para> + <literal>ff</literal> + </para> + </entry> + <entry valign="top"> + <para> + <literal>00</literal> + </para> + </entry> + <entry valign="top"> + <para> + <literal>00</literal> + </para> + </entry> + <entry valign="top"> + <para> + <literal>00</literal> + </para> + </entry> + <entry valign="top"> + <para> + <literal>00</literal> + </para> + </entry> + <entry valign="top"> + <para> + <literal>ff</literal> + </para> + </entry> + <entry valign="top"> + <para> + <literal>ff</literal> + </para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <para>The pattern and mask specify a file with the following characteristics:</para> + <orderedlist> + <listitem> + <para>The file begins with <literal>BM</literal>.</para> + </listitem> + <listitem> + <para><literal>BM</literal> is followed by four bytes with any values.</para> + </listitem> + <listitem> + <para>The four bytes are followed by <literal>\000\000</literal>.</para> + </listitem> + </orderedlist> + <para>The file content sniffer specifies that the MIME type of files that match the pattern and mask is <literal>image/bmp</literal>.</para> - </sect3> </sect2> <sect2 id="mimetypes-4"> <title>MIME Type Registry</title> @@ -368,9 +368,9 @@ is the MIME type of the file.</para> <para>In MIME information files, the filename pattern to search for is written as a regular expression.</para> <para>The format of MIME type entries in MIME information files is as follows:</para> - <literallayout><replaceable>MIME_type</replaceable> - ext[,priority]: <replaceable>list_of_extensions</replaceable> - regex[,priority]: <replaceable>list_of_regular_expressions</replaceable></literallayout> + <literallayout><replaceable>MIME-type</replaceable> + ext[,priority]: <replaceable>list-of-extensions</replaceable> + regex[,priority]: <replaceable>list-of-regular-expressions</replaceable></literallayout> <para>You can specify a priority value for the filename extension and the regular expression. You can use the priority value to differentiate composite filenames. For example, you can assign a priority of <literal>1</literal> @@ -670,7 +670,7 @@ use.</para> </table> </sect1> <sect1 id="mimetypes-9"> - <title>Adding an Application to the GNOME Desktop</title> + <title>Adding an Application to the Desktop Environment</title> <indexterm> <primary>MIME types</primary> <secondary>adding applications</secondary> @@ -679,15 +679,15 @@ use.</para> <primary>applications</primary> <secondary>adding</secondary> </indexterm> - <para>To add an application to the GNOME desktop, perform the -following steps:</para> + <para>To add an application to the desktop environment, perform +the following steps:</para> <orderedlist> <listitem> <para>Add a menu item for the application. For more information on how to add an item to a menu, see <xref linkend="menustructure-0"/>.</para> </listitem> <listitem> - <para>Add an icon for the application to <filename>/usr/gnome/share/icons/<replaceable>theme_name</replaceable>/<replaceable>icon_size</replaceable>/apps</filename>. + <para>Add an icon for the application to <filename>/usr/gnome/share/icons/<replaceable>theme-name</replaceable>/<replaceable>icon-size</replaceable>/apps</filename>. For more information on icons and themes, see <citetitle>Installing Themes</citetitle>. </para> </listitem> <listitem> @@ -706,7 +706,7 @@ registry. For more information on MIME keys files, see <xref linkend="mimetypes- </listitem> <listitem> <para>If the application uses a new MIME type, add an icon for the -MIME type to <filename>/usr/gnome/share/icons/<replaceable>theme_name</replaceable>/<replaceable>icon_size</replaceable>/mimetypes</filename>. For more information on icons +MIME type to <filename>/usr/gnome/share/icons/<replaceable>theme-name</replaceable>/<replaceable>icon-size</replaceable>/mimetypes</filename>. For more information on icons and themes, see <citetitle>Installing Themes</citetitle>. </para> </listitem> <listitem> diff --git a/gnome2-system-admin-guide/C/performance.xml b/gnome2-system-admin-guide/C/performance.xml index 4d98630..0c26d10 100644 --- a/gnome2-system-admin-guide/C/performance.xml +++ b/gnome2-system-admin-guide/C/performance.xml @@ -1,19 +1,18 @@ -<?xml version="1.0" encoding="utf-8"?> <chapter id="performance-0"> <title>Improving Performance</title> <highlights> <para>This chapter describes how to improve the performance of -the GNOME desktop. </para> +the GNOME Desktop.</para> </highlights> <sect1 id="performance-1"> - <title>Introduction</title> + <title>Introduction to Improving Performance</title> <indexterm> <primary>performance, improving</primary> <secondary>introduction</secondary> </indexterm> <para>This chapter lists several preferences whose -settings you can change to improve the performance of the GNOME desktop. You -can use the <command>gconftool-2</command> command to set values for preferences +settings you can change to improve the performance of the desktop environment. +You can use the <command>gconftool-2</command> command to set values for preferences for users. The example commands in this chapter show how to set values in the user configuration source. </para> <para>You can also use the <literal>--direct</literal> and <literal>--config-source</literal> options to set mandatory values or default values for preferences. @@ -37,18 +36,24 @@ usage</secondary> <secondary>reducing</secondary> </indexterm> <para>This section describes preferences that -you can set to reduce CPU usage by the GNOME desktop. </para> +you can set to reduce CPU usage by the desktop environment. </para> <sect2 id="performance-3"> - <title>To Use Themes Which Require Less CPU Resources</title> + <title>To Use Theme Options Which Require Less CPU Resources</title> + <indexterm> + <primary>themes</primary> + <secondary>window frame options</secondary> + <tertiary>and CPU usage</tertiary> + </indexterm> <indexterm> <primary>themes</primary> <secondary>and CPU usage</secondary> </indexterm> - <para>Some window frame themes load image files to draw the window frame. -Other themes use simpler techniques to draw the window frame.</para> - <para>The default theme is Crux. Crux loads image files, and can be slow on -systems with limited CPU resources. To reduce CPU usage, use one of the following -window frame themes: </para> + <para>Some window frame theme +options load image files to draw the window frame. Other options use simpler +techniques to draw the window frame.</para> + <para>The default window frame option is Crux. Crux loads image files, and +can be slow on systems with limited CPU resources. To reduce CPU usage, use +one of the following window frame options: </para> <itemizedlist> <listitem> <para>Atlanta</para> @@ -57,7 +62,8 @@ window frame themes: </para> <para>Esco</para> </listitem> </itemizedlist> - <para>The following window frame themes also use less CPU resources than Crux:</para> + <para>The following window frame options also use less CPU resources than +Crux:</para> <itemizedlist> <listitem> <para>AgingGorilla</para> @@ -70,30 +76,39 @@ window frame themes: </para> </listitem> </itemizedlist> <note> - <para>Metabox does not work well with inverse desktop themes such as -HighContrastInverse. Use Atlanta with inverse desktop themes.</para> + <para>Metabox does not work well with inverse controls options such +as HighContrastInverse. Use Atlanta with inverse controls options.</para> </note> - <indexterm> - <primary>themes</primary> - <secondary>changing</secondary> - </indexterm> - <para>To change the window frame theme, run the following command: </para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type string ---set /apps/metacity/general/theme <replaceable>theme_name</replaceable></userinput></para> + <para><indexterm><primary>themes</primary><secondary>window frame options</secondary><tertiary>changing</tertiary></indexterm>To change the window +frame theme option, run the following command: </para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type string +--set /apps/metacity/general/theme <replaceable>option-name</replaceable></userinput> + </para> <para>For example, to use Atlanta, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type string ---set /apps/metacity/general/theme Atlanta</userinput></para> - <para>Alternatively, users can choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>Themes</guimenuitem></menuchoice>, then select the appropriate theme.</para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type string +--set /apps/metacity/general/theme Atlanta</userinput> + </para> + <para>Alternatively, users can choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>Theme</guimenuitem></menuchoice>, then select the appropriate option.</para> <tip> <para>You can use the <application>Metacity Theme Viewer</application> -to measure the performance of a window frame theme, and to preview the theme. +to measure the performance of a window frame option, and to preview the option. To start <application>Metacity Theme Viewer</application>, use the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>metacity-theme-viewer <replaceable>theme_name</replaceable></userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>metacity-theme-viewer <replaceable>option-name</replaceable></userinput> + </para> <para>For example, to measure the performance of Atlanta and preview Atlanta, run the following command: </para> - <para><computeroutput>#</computeroutput> <userinput>metacity-theme-viewer -Atlanta</userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>metacity-theme-viewer +Atlanta</userinput> + </para> </tip> </sect2> <sect2 id="performance-2"> @@ -106,51 +121,35 @@ Atlanta</userinput></para> <primary>menu icons</primary> <secondary>and CPU usage</secondary> </indexterm> - <para>Some items in menus display an icon beside the item. To -turn off this feature, run the following command: </para> <indexterm> <primary>menu icons</primary> <secondary>turning off</secondary> </indexterm> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 ---type bool --set /desktop/gnome/interface/menus_have_icons false</userinput></para> + <para>Some items in menus display an icon beside the +item. To turn off this feature, run the following command: </para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type bool +--set /desktop/gnome/interface/menus_have_icons false</userinput> + </para> <para>Alternatively, users can choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>Menus & Toolbars</guimenuitem></menuchoice>, then deselect the <guilabel>Show icons in menus</guilabel> option.</para> </sect2> - <sect2 id="performance-5"> - <title>To Reduce CPU Usage by Turning On Wireframe Mode</title> - <indexterm> - <primary>wireframe mode</primary> - <secondary>and CPU usage</secondary> - </indexterm> - <para>The Metacity window manager has a wireframe mode for when -you move and resize windows. When wireframe mode is turned on, only the outline -of windows is displayed when you move and resize windows. The contents of -the window do not need to be updated during the move or resize. The contents -of the window are displayed when the move or resize is complete.</para> - <indexterm> - <primary>wireframe mode</primary> - <secondary>turning on</secondary> - </indexterm> - <para>To turn on wireframe mode, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type bool ---set /apps/metacity/general/wireframe_move_resize true</userinput></para> - </sect2> <sect2 id="performance-6"> <title>To Reduce CPU Usage by Turning Off the Splash Screen</title> <indexterm> <primary>splash screen</primary> <secondary>and CPU usage</secondary> </indexterm> - <para>By default, when users log in to the GNOME desktop, a splash -screen is displayed. Icons are displayed on the splash screen while the user -logs in. You can turn off the splash screen to reduce CPU usage during login. </para> - <indexterm> - <primary>splash screen</primary> - <secondary>turning off</secondary> - </indexterm> - <para>To turn off the splash screen, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type bool ---set /apps/gnome-session/options/show_splash_screen false</userinput></para> + <para>By default, when users log in to the desktop environment, +a splash screen is displayed. Icons are displayed on the splash screen while +the user logs in. You can turn off the splash screen to reduce CPU usage during +login. </para> + <para><indexterm><primary>splash screen</primary><secondary>turning off</secondary></indexterm>To turn off the splash screen, run the following command:</para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type bool +--set /apps/gnome-session/options/show_splash_screen false</userinput> + </para> <para>Alternatively, users can choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Advanced</guisubmenu><guimenuitem>Sessions</guimenuitem></menuchoice>, then deselect the <guilabel>Show splash screen on login</guilabel> option.</para> </sect2> @@ -162,9 +161,12 @@ then deselect the <guilabel>Show splash screen on login</guilabel> option.</para </indexterm> <para>When users show or hide panels, the panels can show or hide in an animated style. To turn off panel animation, run the following command: </para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type bool ---set /apps/panel/global/enable_animations false</userinput></para> - <para>Alternatively, users can choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Advanced</guisubmenu><guimenuitem>Themes</guimenuitem></menuchoice>, + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type bool +--set /apps/panel/global/enable_animations false</userinput> + </para> + <para>Alternatively, users can choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Advanced</guisubmenu><guimenuitem>Panel</guimenuitem></menuchoice>, then deselect the <guilabel>Animation</guilabel> option.</para> </sect2> <sect2 id="performance-7"> @@ -238,7 +240,7 @@ to never, the CPU usage and the network traffic are reduced.</para> </tgroup> </informaltable> <para>The following table describes the performance preferences for the file -manager. For the fastest performance, set the value of the preferences to <literal>never</literal>.</para> +manager. For the fastest performance, set the value of the preferences to <literal>never</literal>.</para> <informaltable frame="topbot"> <tgroup cols="2" colsep="0" rowsep="0"> <colspec colwidth="43.34*"/> @@ -264,10 +266,13 @@ manager. For the fastest performance, set the value of the preferences to <lite <para>Specifies when to preview the content of text files in the icon that represents the file. To never preview the content of text files, run the following command: </para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type string --set /apps/nautilus/preferences/show_icon_text -never</userinput></para> - <para>Alternatively, users can perform the following -steps:</para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type string --set /apps/nautilus/preferences/</userinput> + <userinput>show_icon_text never</userinput> + </para> + <para>Alternatively, users can perform +the following steps:</para> <orderedlist> <listitem> <para>Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> from a file manager window, then choose <guilabel>Performance</guilabel>.</para> @@ -288,10 +293,12 @@ preference.</para> <entry valign="top"> <para>Specifies when to show the number of items in folders. To never show the number of items in folders, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type string --set /apps/nautilus/preferences/show_directory_item_counts -never </userinput></para> - <para>Alternatively, users can perform the following -steps:</para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type string --set /apps/nautilus/preferences/</userinput> + <userinput>show_directory_item_counts never</userinput> + </para> + <para>Alternatively, users can perform the following steps:</para> <orderedlist> <listitem> <para>Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> from a file manager window, then choose <guilabel>Performance</guilabel>.</para> @@ -312,10 +319,12 @@ Folders</guilabel> preference.</para> <entry valign="top"> <para>Specifies when to show thumbnails of image files. To never show thumbnails, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type string --set /apps/nautilus/preferences/show_image_thumbnails -never </userinput></para> - <para>Alternatively, users can perform the following -steps:</para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type string --set /apps/nautilus/preferences/</userinput> + <userinput>show_image_thumbnails never</userinput> + </para> + <para>Alternatively, users can perform the following steps:</para> <orderedlist> <listitem> <para>Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> from a file manager window, then choose <guilabel>Performance</guilabel>.</para> @@ -336,8 +345,11 @@ Files</guilabel> preference.</para> <entry valign="top"> <para>Specifies when to preview the content of sound files. To never preview the content of sound files, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type string --set /apps/nautilus/preferences/preview_sound -never </userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type string --set /apps/nautilus/preferences/preview_sound +never </userinput> + </para> <para>Alternatively, users can perform the following steps:</para> <orderedlist> @@ -365,55 +377,56 @@ preference.</para> you to turn off the side pane and the toolbar. To improve file manager performance, turn off the side pane and the toolbar.</para> <para>To turn off the side pane, run the following command: </para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type bool ---set /apps/nautilus/preferences/start_with_sidebar false</userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type bool +--set /apps/nautilus/preferences/start_with_sidebar false</userinput> + </para> <para>Alternatively, users can choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> from a file manager window, then choose <guilabel>Windows</guilabel>, and then deselect the <guilabel>Display side pane</guilabel> option. The next time that users open a file manager window, the window does not display a side pane. </para> - <indexterm> - <primary>file manager</primary> - <secondary>toolbar, turning off</secondary> - </indexterm> - <para>To turn off the toolbar, run the following command: </para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type bool ---set /apps/nautilus/preferences/start_with_toolbar false</userinput></para> + <para><indexterm><primary>file manager</primary><secondary>toolbar, turning +off</secondary></indexterm>To turn off the toolbar, run the following command: </para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type bool +--set /apps/nautilus/preferences/start_with_toolbar false</userinput> + </para> <para>Alternatively, users can choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> from a file manager window, then choose <guilabel>Windows</guilabel>, and then deselect the <guilabel>Display toolbar</guilabel> option. The next time that users open a file manager window, the window does not display a toolbar. </para> <para>You can also turn off the location bar. Users can use the <keycombo><keycap>Ctrl</keycap><keycap>L</keycap></keycombo> keyboard shortcut to display a location bar when required. </para> - <indexterm> - <primary>file manager</primary> - <secondary>location bar, turning -off</secondary> - </indexterm> - <para>To turn off the location bar, run the following + <para><indexterm><primary>file manager</primary><secondary>location bar, turning +off</secondary></indexterm>To turn off the location bar, run the following command:</para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type bool ---set /apps/nautilus/preferences/start_with_location_bar false</userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type bool +--set /apps/nautilus/preferences/start_with_location_bar false</userinput> + </para> <para>Alternatively, users can choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> from a file manager window, then choose <guilabel>Windows</guilabel>, and then deselect the <guilabel>Display location bar</guilabel> option. The next time that users open a file manager window, the window does not display a location bar.</para> </sect3> <sect3 id="performance-11"> - <title>To Turn Off the Desktop Background</title> + <title>To Turn Off the Desktop</title> <indexterm> <primary>file manager</primary> - <secondary>desktop background, turning -off</secondary> + <secondary>desktop, turning off</secondary> </indexterm> <indexterm> - <primary>desktop background</primary> - <secondary>turning off</secondary> + <primary>desktop</primary> + <secondary>turning +off</secondary> </indexterm> - <para>The file manager contains -a preference that enables users to use <application>Nautilus</application> -to manage the desktop background. Users can disable the desktop background -to improve performance. However, if users disable the desktop background, -users cannot do the following:</para> + <para>The file manager contains a preference that +enables users to use <application>Nautilus</application> to manage the desktop. +Users can disable the desktop to improve performance. However, if users disable +the desktop, users cannot do the following:</para> <itemizedlist> <listitem> - <para>Use the <guimenu>Desktop Background</guimenu> menu.</para> + <para>Use the <guimenu>Desktop</guimenu> menu.</para> </listitem> <listitem> <para>Use the file manager to change the pattern or color of the @@ -423,9 +436,12 @@ desktop background. </para> <para>Use the <guilabel>Home</guilabel> object and the <guilabel>Trash</guilabel> object. The <guilabel>Home</guilabel> object and the <guilabel>Trash</guilabel> object are not displayed on the desktop. </para> </listitem> </itemizedlist> - <para>To disable the desktop background, run the following command: </para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type bool ---set /apps/nautilus/preferences/show_desktop false</userinput></para> + <para>To disable the desktop, run the following command: </para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type bool +--set /apps/nautilus/preferences/show_desktop false</userinput> + </para> <para>Alternatively, users can choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> from a file manager window. Users can then choose <guilabel>Desktop & Trash</guilabel>, and then deselect the <guilabel>Use Nautilus to draw the desktop</guilabel> option. </para> @@ -433,29 +449,37 @@ the <guilabel>Use Nautilus to draw the desktop</guilabel> option. </para> </sect2> </sect1> <sect1 id="performance-12"> - <title>Reducing X11 Network Traffic</title> + <title>Reducing X Window System Network Traffic</title> <indexterm> <primary>reducing</primary> - <secondary>X11 network traffic</secondary> + <secondary>X Window System network traffic</secondary> </indexterm> <indexterm> - <primary>X11 network traffic, reducing</primary> + <primary>X Window System network traffic, +reducing</primary> </indexterm> <indexterm> <primary>network traffic, reducing</primary> </indexterm> - <para>This section describes preferences that you can set to reduce X11 network -traffic on the GNOME desktop. </para> + <para>This section describes preferences that you can +set to reduce X Window System network traffic on the desktop environment. </para> <sect2 id="performance-14"> - <title>To Use Themes Which Create Less Network Traffic</title> + <title>To Use Theme Options Which Create Less Network Traffic</title> + <indexterm> + <primary>themes</primary> + <secondary>window frame options</secondary> + <tertiary>and network traffic</tertiary> + </indexterm> <indexterm> <primary>themes</primary> <secondary>and network traffic</secondary> </indexterm> - <para>Remote display protocols do not transfer every pixel in -a block of pixels if all pixels in the block are the same color.</para> - <para>To reduce X11 network traffic, use a window frame theme that uses solid -colors. That is, use one of the following window frame themes:</para> + <para>Remote +display protocols do not transfer every pixel in a block of pixels if all +pixels in the block are the same color.</para> + <para>To reduce X Window System network traffic, use a window frame theme +option that uses solid colors. That is, use one of the following window frame +options:</para> <itemizedlist> <listitem> <para>Atlanta</para> @@ -464,7 +488,7 @@ colors. That is, use one of the following window frame themes:</para> <para>Esco</para> </listitem> </itemizedlist> - <para>For information on how to change the theme, see <xref linkend="performance-3"/>.</para> + <para>For information on how to change theme options, see <xref linkend="performance-3"/>.</para> </sect2> <sect2 id="performance-15"> <title>To Reduce Network Traffic by Turning Off Display of Icons in Menus</title> @@ -473,21 +497,11 @@ colors. That is, use one of the following window frame themes:</para> <secondary>and network traffic</secondary> </indexterm> <para>Some items in menus display an icon beside the item. If -the icon is located on another file system, this feature can increase X11 -network traffic. This feature can also increase X11 network traffic if the -panels are displayed on a remote host. </para> +the icon is located on another file system, this feature can increase X Window +System network traffic. This feature can also increase X Window System network +traffic if the panels are displayed on a remote host. </para> <para>For information on how to turn off this feature, see <xref linkend="performance-2"/>.</para> </sect2> - <sect2 id="performance-13"> - <title>To Reduce Network Traffic by Turning On Wireframe Mode</title> - <indexterm> - <primary>wireframe mode</primary> - <secondary>and network traffic</secondary> - </indexterm> - <para>If the application that displays the window -is running on a remote host, wireframe mode reduces X11 network traffic.</para> - <para>For more information on wireframe mode, see <xref linkend="performance-5"/>.</para> - </sect2> </sect1> <sect1 id="performance-17"> <title>Reducing Color Usage and Improving Display Quality</title> @@ -505,48 +519,54 @@ is running on a remote host, wireframe mode reduces X11 network traffic.</para> <para>Many modern computer systems support 24-bit color, that is, 16,777,216 colors. However, many users still use systems that support 8-bit color, that is, 256 colors. </para> - <para>The GNOME desktop uses the <firstterm>Netscape color palette</firstterm>. + <para>The desktop environment uses the <firstterm>websafe color palette</firstterm>. This palette is a general-purpose palette of 216 colors, which is designed to optimize the use of color on systems that support 8-bit color. However, -some visual components of the GNOME desktop are designed for systems that -support 24-bit color.</para> +some visual components of the desktop environment are designed for systems +that support 24-bit color.</para> <para>The following display problems might occur on systems that support 8-bit color:</para> <itemizedlist> <listitem> <para>Windows, icons, and background images might appear grainy. - Many themes, background images, and icons use colors that are not in the <application>Netscape</application> color palette. The colors that are not in the palette -are replaced with the nearest equivalent or a dithered approximation. This -use of replacement colors causes the grainy appearance.</para> + Many themes, background images, and icons use colors that are not in the +websafe color palette. The colors that are not in the palette are replaced +with the nearest equivalent or a dithered approximation. This use of replacement +colors causes the grainy appearance.</para> </listitem> <listitem> - <para>Applications that do not use the <application>Netscape</application> -color palette have less colors available. Color errors might occur. Some colors -might not appear in the user interface of the application. Some applications -might crash if the application cannot allocate colors.</para> + <para>Applications that do not use the websafe color palette have +less colors available. Color errors might occur. Some colors might not appear +in the user interface of the application. Some applications might crash if +the application cannot allocate colors.</para> </listitem> <listitem> <para>Color flashing might occur when users switch between applications -that use the <application>Netscape</application> color palette, and applications -that do not use this palette. The applications that do not use the <application>Netscape</application> color palette might use a custom colormap. When the -custom colormap is used, other visual components might lose colors, then become -unviewable.</para> +that use the websafe color palette, and applications that do not use this +palette. The applications that do not use the websafe color palette might +use a custom colormap. When the custom colormap is used, other visual components +might lose colors, then become unviewable.</para> </listitem> </itemizedlist> <para>The following sections describe how to optimize the appearance of the -GNOME desktop for systems that support 8-bit color. </para> +desktop environment for systems that support 8-bit color. </para> <sect2 id="performance-20"> - <title>To Use Themes That Use the Netscape Color Palette</title> + <title>To Use Theme Options That Use the Websafe Color Palette</title> + <indexterm> + <primary>themes</primary> + <secondary>window frame options</secondary> + <tertiary>and color usage</tertiary> + </indexterm> <indexterm> <primary>themes</primary> <secondary>and color usage</secondary> </indexterm> - <para>Some window frame themes use colors that are in the Netscape -color palette. Bright and Esco use colors from the Netscape color palette. -Bright and Esco do not have the grainy appearance of other themes on 8-bit -color displays. Use Bright or Esco for the best color display on 8-bit visual -modes. </para> - <para>For information on how to change the theme, see <xref linkend="performance-3"/>.</para> + <para>Some window +frame theme options use colors that are in the websafe color palette. Bright +and Esco use colors from the websafe color palette. Bright and Esco do not +have the grainy appearance of other window frame options on 8-bit color displays. +Use Bright or Esco for the best color display on 8-bit visual modes. </para> + <para>For information on how to change theme options, see <xref linkend="performance-3"/>.</para> </sect2> <sect2 id="performance-21"> <title>To Reduce Color Usage by Turning Off Display of Icons in Menus</title> @@ -555,8 +575,8 @@ modes. </para> <secondary>and color usage</secondary> </indexterm> <para>Some items in menus display an icon beside the item. If -the icon contains colors that are not in the <application>Netscape</application> -color palette, this feature can increase the number of colors used.</para> +the icon contains colors that are not in the websafe color palette, this feature +can increase the number of colors used.</para> <para>For information on how to turn off this feature, see <xref linkend="performance-2"/>.</para> </sect2> <sect2 id="performance-18"> @@ -566,7 +586,7 @@ color palette, this feature can increase the number of colors used.</para> <secondary>and color usage</secondary> </indexterm> <para>You can turn off the splash screen to make more colors available -for the GNOME desktop and applications.</para> +for the desktop environment and for applications.</para> <para>For information on how to turn off the splash screen, see <xref linkend="performance-6"/>.</para> </sect2> <sect2 id="performance-19"> @@ -576,16 +596,171 @@ for the GNOME desktop and applications.</para> <secondary>using solid color</secondary> </indexterm> <para>Use a solid color for the desktop background. -Use of a solid color reduces the number of colors used by the GNOME desktop. </para> +Use of a solid color reduces the number of colors used by the desktop environment. </para> <para>To set a solid color for the desktop background, run the following commands: </para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type string ---set /desktop/gnome/background/picture_options none</userinput></para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type string ---set /desktop/gnome/background/color_shading_type solid</userinput></para> - <para><computeroutput>#</computeroutput> <userinput>gconftool-2 --type string ---set /desktop/gnome/background/primary_color \#<replaceable>hexadecimal_color</replaceable></userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type string +--set /desktop/gnome/background/picture_options none</userinput> + </para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type string +--set /desktop/gnome/background/color_shading_type solid</userinput> + </para> + <para> + <computeroutput>#</computeroutput> + <userinput>gconftool-2 --type string +--set /desktop/gnome/background/primary_color \#<replaceable>hexadecimal-color</replaceable></userinput> + </para> <para>Alternatively, users can choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>Background</guimenuitem></menuchoice>, then choose a solid color for the desktop background.</para> </sect2> </sect1> + <sect1 id="performance-23"> + <title>Improving Performance of Help</title> + <indexterm> + <primary>improving</primary> + <secondary>Help performance</secondary> + </indexterm> + <indexterm> + <primary>Help</primary> + <secondary>improving performance</secondary> + </indexterm> + <indexterm> + <primary>performance, improving</primary> + <secondary>Help</secondary> + </indexterm> + <para>The source documents for the +Help are XML files. The XML files are converted to HTML, and the <application>Yelp</application> Help browser displays the HTML. The HTML can be <firstterm>pregenerated</firstterm>, that is, the XML can be converted to HTML before +the Help is used.</para> + <para>Alternatively, the conversion can be performed automatically when a +user calls a Help file. If the conversion is performed when the user calls +the Help file, the conversion has a significant impact on the speed with which +Help documents are displayed.</para> + <para>To avoid performance problems with the Help, pregenerate the HTML so +that the Help browser does not need to do the conversion. Use the <command>yelp-pregenerate</command> command to pregenerate a Help document. The syntax +of the <command>yelp-pregenerate</command> command is as follows: </para> + <cmdsynopsis> + <command>yelp-pregenerate</command> + <group> + <arg choice="plain"> + <option>a</option> + </arg> + <arg choice="opt"> + <option>f</option> + <replaceable>filename</replaceable> + </arg> + </group> + <arg choice="opt"> + <option role="nodash"> + <replaceable>locale</replaceable> + </option> + </arg> + </cmdsynopsis> + <para>The following table describes the options and arguments +for the <command>yelp-pregenerate</command> command:</para> + <informaltable frame="topbot"> + <tgroup cols="2" colsep="0" rowsep="0"> + <colspec colwidth="33.33*"/> + <colspec colwidth="66.67*"/> + <thead> + <row rowsep="1"> + <entry> + <para>Option or Argument</para> + </entry> + <entry> + <para>Description</para> + </entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para> + <literal>-a</literal> + </para> + </entry> + <entry> + <para>Pregenerates +all XML files that are registered in the <application>ScrollKeeper</application> +database. This option is the default option.</para> + </entry> + </row> + <row> + <entry> + <para> + <literal>-f</literal> + </para> + </entry> + <entry> + <para>Pregenerates +only the XML files that you specify in the command.</para> + </entry> + </row> + <row> + <entry> + <para> + <literal>filename</literal> + </para> + </entry> + <entry> + <para>The name of the XML file or XML files that you want to pregenerate.</para> + </entry> + </row> + <row> + <entry> + <para> + <literal>locale</literal> + </para> + </entry> + <entry> + <para>The +locale for which you want to pregenerate the XML files. The default locale +is C, or English.</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <para>For example, to pregenerate the English version of all XML files in +the file system, run the following command:</para> + <para> + <computeroutput>#</computeroutput> + <userinput>yelp-pregenerate -a</userinput> + </para> + <para>You do not need to specify the locale in this example, as the default +locale is <literal>C</literal>. To pregenerate the Spanish version of the <application>gedit</application> manual, run the following command: </para> + <para> + <computeroutput>#</computeroutput> + <userinput>yelp-pregenerate -f gedit.xml +es</userinput> + </para> + <para>When a user opens a Help file, the Help browser does the following: </para> + <orderedlist> + <listitem> + <para>The Help browser searches for the appropriate HTML file. If +the Help browser finds the HTML file, the Help browser compares the modification +dates of the HTML file and the corresponding XML file. If the HTML file is +more recent than the XML file, the HTML file is displayed.</para> + </listitem> + <listitem> + <para>If the HTML file is older than the XML file, the XML file +is converted to HTML.</para> + </listitem> + <listitem> + <para>If the Help browser does not find a HTML file for a Help document, +the XML file is converted to HTML.</para> + </listitem> + </orderedlist> + <para>In other words, the Help browser displays pregenerated HTML if the pregenerated +HTML file is present. If the pregenerated HTML file is not present, the Help +browser converts the XML file to HTML.</para> + <note> + <para>You might want to pregenerate the Help for any new applications +that you want to add to your desktop environment. If there are severe space +restrictions in your environment, you might choose not to pregenerate the +Help.</para> + </note> + </sect1> </chapter> diff --git a/gnome2-system-admin-guide/C/screensavers.xml b/gnome2-system-admin-guide/C/screensavers.xml index 53ed1f0..30311ef 100644 --- a/gnome2-system-admin-guide/C/screensavers.xml +++ b/gnome2-system-admin-guide/C/screensavers.xml @@ -1,4 +1,3 @@ -<?xml version="1.0" encoding="utf-8"?> <chapter id="screensavers-0"> <title>Setting Screensavers</title> <highlights> @@ -7,7 +6,7 @@ This chapter also provides information on how to modify the displays that are available for the screensaver.</para> </highlights> <sect1 id="screensavers-1"> - <title>Introduction</title> + <title>Introduction to Screensavers</title> <indexterm> <primary>screensavers</primary> <secondary>introduction</secondary> @@ -18,15 +17,9 @@ are available for the screensaver.</para> </indexterm> <para>A <firstterm>screensaver</firstterm> is an application that replaces the image on a screen when the screen is not in use. The screensaver -application for the GNOME desktop is <application>XScreenSaver</application>. +application for the GNOME Desktop is <application>XScreenSaver</application>. The following sections describe how to set preferences for the <application>XScreenSaver</application> application, and how to modify the displays that are available for the screensaver.</para> - <note> - <para>The <application>XScreenSaver</application> application does not -allow you to lock your screen if you are logged in as <literal>root</literal>. -If you want to be able to lock your screen, log in as a normal user. To obtain -system administrator privileges, open a terminal window, then use the <command>su</command> command to log in as <literal>root</literal>.</para> - </note> </sect1> <sect1 id="screensavers-2"> <title>Setting Screensaver Preferences</title> @@ -64,7 +57,7 @@ locations, depending on the platform, as follows:</para> </row> <row> <entry valign="top"> - <para>Solaris Operating Environment</para> + <para>Solaris Operating System</para> </entry> <entry valign="top"> <para> @@ -75,10 +68,9 @@ locations, depending on the platform, as follows:</para> </tbody> </tgroup> </informaltable> - <para>To modify screensaver application preferences, users can right-click -on the <guibutton>Lock</guibutton> button, then choose <guimenuitem>Properties</guimenuitem>. The user can then modify preferences in the <guilabel>XScreenSaver</guilabel> dialog. When a user modifies the screensaver preferences, the -preferences are stored in the home directory of the user, in the <filename>$HOME/.xscreensaver</filename> file. For information on screensaver preferences, -see <citetitle>GNOME 2.2 Desktop User Guide</citetitle>.</para> + <para>To modify screensaver application preferences, users can use the <application>Screensaver</application> preference tool. To start the <application>Screensaver</application> preference tool, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>Screensaver</guimenuitem></menuchoice> from the Menu Panel. When a user modifies +the screensaver preferences, the preferences are stored in the home directory +of the user, in the <filename>$HOME/.xscreensaver</filename> file. For information on screensaver preferences, see <citetitle>GNOME 2.2 Desktop User Guide</citetitle>.</para> <para>Users can also run the command <command>/usr/X11R6/bin/xscreensaver-demo</command> to open the <guilabel>XScreenSaver</guilabel> dialog.</para> <para>To set default screensaver preferences for all users, modify the <filename>XScreenSaver</filename> file. You can also use the <guilabel>XScreenSaver</guilabel> dialog to create a <filename>$HOME/.xscreensaver</filename> file, then copy the file to the location of the <filename>XScreenSaver</filename> @@ -91,7 +83,10 @@ want to change this default display behavior.</para> </note> <para>To activate changes to the screensaver preferences, use the following command to reload screensaver preferences:</para> - <para><computeroutput>#</computeroutput> <userinput>xscreensaver-command -restart</userinput></para> + <para> + <computeroutput>#</computeroutput> + <userinput>xscreensaver-command -restart</userinput> + </para> <note> <para>The <application>xset</application> application does not work with <application>XScreenSaver</application> at the time of publication of @@ -114,11 +109,11 @@ file. </para> to the <filename>/usr/X11R6/lib/xscreensaver/hacks</filename> directory. Add the command for the screensaver display to the <filename>XScreenSaver</filename> file or the <filename>$HOME/.xscreensaver</filename> file. Include any arguments that are required to run the screensaver display on the whole -desktop, rather than in a window. For example, you might want to include the <literal>-root</literal> option to display the screensaver display on the desktop.</para> - <para>To disable a screensaver display, add -a minus sign (-) at the start of the command for the screensaver display in -the preferences file. The following excerpt from a <filename>$HOME/.xscreensaver</filename> file shows a disabled <literal>Qix (solid)</literal> screensaver -display:</para> +screen, rather than in a window. For example, you might want to include the <literal>-root</literal> option to display the screensaver display on the whole screen.</para> + <para>To disable a screensaver display, add a minus sign (-) at +the start of the command for the screensaver display in the preferences file. +The following excerpt from a <filename>$HOME/.xscreensaver</filename> file +shows a disabled <literal>Qix (solid)</literal> screensaver display:</para> <literallayout>- "Qix (solid)" qix -root -solid -segments 100</literallayout> </sect1> </chapter> diff --git a/gnome2-system-admin-guide/C/sessions.xml b/gnome2-system-admin-guide/C/sessions.xml index 01b19eb..d7db396 100644 --- a/gnome2-system-admin-guide/C/sessions.xml +++ b/gnome2-system-admin-guide/C/sessions.xml @@ -1,4 +1,3 @@ -<?xml version="1.0" encoding="utf-8"?> <chapter id="sessions-0"> <title>Session Management</title> <highlights> @@ -7,17 +6,17 @@ how to set session defaults. The chapter also contains information on sessions and login scripts.</para> </highlights> <sect1 id="sessions-1"> - <title>Introduction</title> + <title>Introduction to Sessions</title> <indexterm> <primary>sessions</primary> <secondary>introduction</secondary> </indexterm> - <para>A GNOME desktop session occurs between the time that a user -logs in to the GNOME desktop and the time that the user logs out. The session -manager starts after the <application>Login Manager</application> authenticates -the user. The session manager enables the user to manage the session. For -example, a user can save the state of a session and return to that session -the next time that the user logs in. </para> + <para>A session occurs between the time that a user logs in to +the desktop environment and the time that the user logs out. The session manager +starts after the <application>Login Manager</application> authenticates the +user. The session manager enables the user to manage the session. For example, +a user can save the state of a session and return to that session the next +time that the user logs in. </para> <para>At a minimum, the following applications run in a session:</para> <itemizedlist> <listitem> @@ -28,7 +27,7 @@ the next time that the user logs in. </para> </listitem> <listitem> <para>The <application>gnome-panel</application> application, which -runs the panels on the GNOME desktop.</para> +runs the panels in the desktop environment.</para> </listitem> <listitem> <para>The <application>Metacity</application> window manager.</para> @@ -91,24 +90,4 @@ the default settings in <filename>/usr/share/gnome/default.session</filename> are used. </para> <para>To save the current session as the default session, users can run the <command>gnome-session-save</command> command. </para> </sect1> - <sect1 id="sessions-2"> - <title>Login Scripts</title> - <indexterm> - <primary>sessions</primary> - <secondary>login scripts</secondary> - </indexterm> - <para>The GNOME desktop does not support system-wide login scripts -or logout scripts. The session manager only allows users to configure user -sessions. Users can configure non-session-managed startup applications with -the <application>Sessions</application> preference tool.</para> - <tip> - <para>You can work around the lack of support for system-wide login scripts. -To create a system-wide login script, create the script in the <filename>/usr/dt/config/Xsession.d</filename> directory. Name the script as follows:</para> - <para> - <filename><replaceable>number_greater_than_1000</replaceable>.<replaceable>name</replaceable></filename> - </para> - <para>For example, name the script <filename>1050.login</filename>. For more -information on the <filename>/usr/dt/config/Xsession.d</filename> file, see <citetitle>The XSession File</citetitle> in the <citerefentry><refentrytitle>dtlogin</refentrytitle><manvolnum>1</manvolnum></citerefentry> man page.</para> - </tip> - </sect1> </chapter> diff --git a/gnome2-system-admin-guide/C/system-admin-guide.xml b/gnome2-system-admin-guide/C/system-admin-guide.xml index 790eaab..3953ab9 100644 --- a/gnome2-system-admin-guide/C/system-admin-guide.xml +++ b/gnome2-system-admin-guide/C/system-admin-guide.xml @@ -1,14 +1,15 @@ <?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ - <!ENTITY gnomeversion "2.2">
- <!ENTITY manrevision "2.1">
- <!ENTITY date "January 2003">
+ <!ENTITY gnomeversion "2.4">
+ <!ENTITY manrevision "2.2">
+ <!ENTITY date "September 2003">
<!ENTITY LEGAL SYSTEM "legal.xml">
<!ENTITY gconf SYSTEM "gconf.xml">
<!ENTITY menustructure SYSTEM "menustructure.xml"> <!ENTITY themes SYSTEM "themes.xml"> <!ENTITY mimetypes SYSTEM "mimetypes.xml"> + <!ENTITY gdm SYSTEM "gdm.xml"> <!ENTITY screensavers SYSTEM "screensavers.xml"> <!ENTITY sessions SYSTEM "sessions.xml"> <!ENTITY performance SYSTEM "performance.xml"> @@ -51,6 +52,14 @@ <para role="author">Sun Microsystems</para> <para role="publisher">GNOME Documentation Project</para> </revdescription> + </revision> + <revision>
+ <revnumber>GNOME 2.2 Desktop System Administration Guide V2.1</revnumber>
+ <date>January 2003</date>
+ <revdescription>
+ <para role="author">Sun Microsystems</para> + <para role="publisher">GNOME Documentation Project</para> + </revdescription> </revision>
<revision>
<revnumber>GNOME 2.0 Desktop System Administration Guide V2.0</revnumber>
@@ -74,6 +83,7 @@ &menustructure; &themes; &mimetypes; +&gdm; &screensavers; &sessions; &performance; diff --git a/gnome2-system-admin-guide/C/themes.xml b/gnome2-system-admin-guide/C/themes.xml index 1384d8d..02620aa 100644 --- a/gnome2-system-admin-guide/C/themes.xml +++ b/gnome2-system-admin-guide/C/themes.xml @@ -1,138 +1,300 @@ -<?xml version="1.0" encoding="utf-8"?> <chapter id="themes-0"> <title>Installing Themes</title> <highlights> - <para>This chapter describes the types of theme that are available -in the GNOME desktop, how to install themes, and how to create a custom theme.</para> + <para>This chapter describes themes, the theme settings that are +available in the GNOME Desktop, how to install options for theme settings, +and how to create a custom option.</para> </highlights> <sect1 id="themes-1"> - <title>Introduction</title> + <title>Introduction to Themes</title> <indexterm> <primary>themes</primary> <secondary>introduction</secondary> </indexterm> <para>A theme is a group of coordinated settings that specifies the visual -appearance of a part of the GNOME desktop. Users can choose themes to change -the appearance of the desktop. </para> - <para>The following types of theme affect different parts of the GNOME desktop:</para> +appearance of a part of the desktop environment. Users can choose themes to +change the appearance of the desktop.</para> + <para>A theme contains settings that affect different parts of the GNOME desktop, +as follows:</para> <variablelist> <varlistentry> - <term>Desktop themes</term> + <term>Controls</term> + <listitem> + <para><indexterm><primary>themes</primary><secondary>controls options</secondary><tertiary>introduction</tertiary></indexterm><indexterm><primary>GTK+ themes</primary><see>themes, controls options</see></indexterm>The controls setting for a theme determines the visual +appearance of windows, panels, and applets. The controls setting also determines +the visual appearance of the GNOME-compliant interface items that appear on +windows, panels, and applets, such as menus, icons, and buttons. Some of the +controls setting options that are available are designed for special accessibility +needs. Users can choose an option for the controls setting from the <guilabel>Controls</guilabel> tabbed section in the <application>Theme</application> +preference tool.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>Window frame</term> <listitem> <indexterm> - <primary>desktop -themes</primary> - <see>themes</see> + <primary>themes</primary> + <secondary>window frame options</secondary> + <tertiary>introduction</tertiary> </indexterm> - <para>Desktop themes determine -the visual appearance of windows, panels, and applets. Desktop themes also -determine the visual appearance of the GNOME-compliant interface items that -appear on windows, panels, and applets, such as menus, icons, and buttons. -Some of the desktop themes that are available in GNOME are designed for special -accessibility needs. Users can choose a desktop theme from the <guilabel>Widget Theme</guilabel> tabbed section in the <application>Theme</application> -preference tool.</para> + <indexterm> + <primary>Metacity themes</primary> + <see>themes, window frame options</see> + </indexterm> + <para>The window frame setting +for a theme determines the appearance of the frames around windows only. Users +can choose an option for the window frame setting from the <guilabel>Window +Border</guilabel> tabbed section in the <application>Theme</application> preference +tool.</para> </listitem> </varlistentry> <varlistentry> - <term>Window frame themes</term> + <term>Icon</term> <listitem> <indexterm> - <primary>window frame themes</primary> - <see>themes</see> + <primary>themes</primary> + <secondary>icons options</secondary> + <tertiary>introduction</tertiary> + </indexterm> + <indexterm> + <primary>icon themes</primary> + <see>themes, icons options</see> </indexterm> - <para>Window frame -themes determine the appearance of the frames around windows only. Users can -choose a window frame theme from the <guilabel>Window Frames</guilabel> tabbed -section in the <application>Theme</application> preference tool.</para> + <para>The icon setting for a theme determines the appearance of +the icons on panels and the desktop background. Users can choose an option +for the icon setting from the <guilabel>Icons</guilabel> tabbed section in +the <application>Theme</application> preference tool.</para> </listitem> </varlistentry> </variablelist> </sect1> - <sect1 id="themes-3"> - <title>To Install a Desktop Theme</title> - <indexterm> - <primary>themes</primary> - <secondary>desktop theme, installing</secondary> - </indexterm> - <para>Desktop themes reside in the <filename>/usr/share/themes</filename> directory. The typical structure of a desktop theme in the file -system is as follows:</para> - <informaltable frame="none"> + <sect1 id="themes-17"> + <title>Theme Index File</title> + <para>Each theme has an index file which defines the characteristics of the +theme. The name of the index file is <filename>/usr/share/theme/<replaceable>theme-name</replaceable>/index.theme</filename>. </para> + <para>The following is a sample theme index file:</para> + <literallayout>[Desktop Entry] +Type=X-GNOME-Metatheme +Name=High Contrast Large +Name[es]=Alto contraste grande +Comment=Large black-on-white text and icons +Comment[es]=Textos e iconos grandes en negro sobre blanco +Encoding=UTF-8 + +[X-GNOME-Metatheme] +GtkTheme=HighContrastLargePrint +IconTheme=HighContrast +MetacityTheme=Atlanta +ApplicationFont=sans 18 +</literallayout> + <para>The following table describes the keys in theme index files:</para> + <table frame="topbot" id="themes-TBL-18"> + <title>Keys in Theme Index Files</title> <tgroup cols="2" colsep="0" rowsep="0"> - <colspec colwidth="19.19*"/> - <colspec colwidth="80.81*"/> + <colspec colname="colspec0" colwidth="45.25*"/> + <colspec colname="colspec1" colwidth="54.75*"/> + <thead> + <row rowsep="1"> + <entry> + <para>Index File Key</para> + </entry> + <entry> + <para>Description</para> + </entry> + </row> + </thead> <tbody> <row> - <entry valign="top"> - <para>Theme file</para> - </entry> - <entry valign="top"> + <entry colname="colspec0"> <para> - <filename>/usr/share/themes/<replaceable>theme_name</replaceable>/gtk-2.0/gtkrc</filename> + <literal>Type</literal> </para> </entry> + <entry colname="colspec1"> + <para>Specifies that this theme determines the appearance +of several theme options, such as controls, window frames, and icons.</para> + </entry> </row> <row> - <entry valign="top"> - <para>Image files</para> + <entry colname="colspec0"> + <para> + <literal>Name</literal> + </para> </entry> - <entry valign="top"> + <entry colname="colspec1"> + <para>The name of the theme. This is the name of +the theme that is displayed in the <application>Theme</application> preference +tool.</para> + </entry> + </row> + <row> + <entry colname="colspec0"> <para> - <filename>/usr/share/themes/<replaceable>theme_name</replaceable>/pixmaps/*.*</filename> + <literal>Comment</literal> </para> </entry> + <entry colname="colspec1"> + <para>A brief description of the theme. This is +the text that is displayed under the name of the theme in the <application>Theme</application> preference tool.</para> + </entry> </row> - </tbody> - </tgroup> - </informaltable> - <para>Typically, a new desktop theme is supplied as a <filename>.tar.gz</filename> -file. To install the new desktop theme, unzip the <filename>.tar.gz</filename> -file, then untar the <filename>.tar</filename> file into the <filename>/usr/share/themes</filename> directory.</para> - <para>If a user adds a desktop theme, the theme is stored in the <filename>$HOME/.themes</filename> directory.</para> - <para>Users can install their own desktop themes. If a user installs a desktop -theme, the theme is stored in the <filename>$HOME/.themes</filename> directory.</para> - </sect1> - <sect1 id="themes-5"> - <title>To Install a Window Frame Theme</title> - <indexterm> - <primary>themes</primary> - <secondary>window frame theme, installing</secondary> - </indexterm> - <para>Window frame themes reside in the <filename>/usr/share/themes/<replaceable>theme_name</replaceable>/metacity-1</filename> -directory. The typical structure of a window frame theme in the file system -is as follows:</para> - <informaltable frame="none"> - <tgroup cols="2" colsep="0" rowsep="0"> - <colspec colwidth="19.19*"/> - <colspec colwidth="80.81*"/> - <tbody> <row> - <entry valign="top"> - <para>Theme file</para> + <entry> + <para> + <literal>GtkTheme</literal> + </para> + </entry> + <entry> + <para>Corresponds to the controls setting in the <application>Theme</application> +preference tool. Specifies which controls setting option to apply to windows, +panels, and applets.</para> </entry> - <entry valign="top"> + </row> + <row> + <entry> <para> - <filename>/usr/share/themes/<replaceable>theme_name</replaceable>/metacity-1/metacity-theme-1.xml</filename> + <literal>IconTheme</literal> </para> </entry> + <entry> + <para>Corresponds to the icons setting in the <application>Theme</application> preference +tool. Specifies which icons setting option to apply to panels and the desktop +background.</para> + </entry> </row> <row> - <entry valign="top"> - <para>Image files</para> + <entry> + <para> + <literal>MetacityTheme</literal> + </para> </entry> - <entry valign="top"> + <entry> + <para>Corresponds to the window frame setting in the <application>Theme</application> +preference tool. Specifies which window frame setting option to apply to windows.</para> + </entry> + </row> + <row> + <entry colname="colspec0"> <para> - <filename>/usr/share/themes/<replaceable>theme_name</replaceable>/metacity-1/*.*</filename> + <literal>ApplicationFont</literal> </para> </entry> + <entry colname="colspec1"> + <para>Corresponds to the application font setting +in the <application>Font</application> preference tool.</para> + </entry> </row> </tbody> </tgroup> - </informaltable> - <para>Typically, a new window frame theme is supplied as a <filename>.tar.gz</filename> file. To install the new window frame theme, unzip the <filename>.tar.gz</filename> file, then untar the <filename>.tar</filename> file into -the <filename>/usr/share/themes</filename> directory.</para> - <para>Users can install their own window frame themes. If a user installs -a window frame theme, the theme is stored in the <filename>$HOME/.themes</filename> -directory.</para> + </table> + </sect1> + <sect1 id="themes-3"> + <title>To Install a New Controls Option</title> + <indexterm> + <primary>themes</primary> + <secondary>controls options</secondary> + <tertiary>installing</tertiary> + </indexterm> + <para>You can add a new option +for the controls setting in the <application>Theme</application> preference +tool. Controls options reside in the <filename>/usr/share/themes</filename> +directory. The typical structure of a controls option in the file system is +as follows:</para> + <variablelist> + <varlistentry> + <term>Option file</term> + <listitem> + <para> + <filename>/usr/share/themes/<replaceable>option-name</replaceable>/gtk-2.0/gtkrc</filename> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Image files</term> + <listitem> + <para> + <filename>/usr/share/themes/<replaceable>option-name</replaceable>/pixmaps/*.*</filename> + </para> + </listitem> + </varlistentry> + </variablelist> + <para>Typically, a new option for the controls setting is supplied +as a <filename>.tar.gz</filename> file. To install the new controls option, +unzip the <filename>.tar.gz</filename> file, then untar the <filename>.tar</filename> file into the <filename>/usr/share/themes</filename> directory.</para> + <para>Users can install their own options for the controls setting. If a user +installs an option for the controls setting, the option is stored in the <filename>$HOME/.themes</filename> directory.</para> + </sect1> + <sect1 id="themes-5"> + <title>To Install a New Window Frame Option</title> + <indexterm> + <primary>themes</primary> + <secondary>window frame options</secondary> + <tertiary>installing</tertiary> + </indexterm> + <para>You can add a new option +for the window frame setting in the <application>Theme</application> preference +tool. Window frame options reside in the <filename>/usr/share/themes/<replaceable>option-name</replaceable>/metacity-1</filename> directory. The typical structure +of a window frame option in the file system is as follows:</para> + <variablelist> + <varlistentry> + <term>Option file</term> + <listitem> + <para> + <filename>/usr/share/themes/<replaceable>option-name</replaceable>/metacity-1/metacity-theme-1.xml</filename> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Image files</term> + <listitem> + <para> + <filename>/usr/share/themes/<replaceable>option-name</replaceable>/metacity-1/*.*</filename> + </para> + </listitem> + </varlistentry> + </variablelist> + <para>Typically, a new option for the window frame setting +is supplied as a <filename>.tar.gz</filename> file. To install the new window +frame option, unzip the <filename>.tar.gz</filename> file, then untar the <filename>.tar</filename> file into the <filename>/usr/share/themes</filename> directory.</para> + <para>Users can install their own options for the window frame setting. If +a user installs an option for the window frame setting, the option is stored +in the <filename>$HOME/.themes</filename> directory.</para> + </sect1> + <sect1 id="themes-16"> + <title>To Install a New Icons Option</title> + <indexterm> + <primary>themes</primary> + <secondary>icons options</secondary> + <tertiary>installing</tertiary> + </indexterm> + <para>You can add a new option for the icons +setting in the <application>Theme</application> preference tool. Icons options +reside in the <filename>/usr/share/icons/<replaceable>option-name</replaceable></filename> +directory. The typical structure of an icons option in the file system is +as follows:</para> + <variablelist> + <varlistentry> + <term>Option file</term> + <listitem> + <para> + <filename>/usr/share/icons/<replaceable>option-name</replaceable></filename> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Image files</term> + <listitem> + <para> + <filename>/usr/share/icons/<replaceable>option-name</replaceable>/icons/*.*</filename> + </para> + </listitem> + </varlistentry> + </variablelist> + <para>Typically, a new option for the icons setting +is supplied as a <filename>.tar.gz</filename> file. To install the new icons +option, unzip the <filename>.tar.gz</filename> file, then untar the <filename>.tar</filename> file into the <filename>/usr/share/icons</filename> directory.</para> + <para>Users can install their own options for the icons setting. If a user +installs an option for the icons setting, the option is stored in the <filename>$HOME/.icons/<replaceable>option-name</replaceable></filename> directory.</para> </sect1> <sect1 id="themes-11"> <title>Installing Icons for Themes</title> @@ -140,16 +302,28 @@ directory.</para> <primary>themes</primary> <secondary>installing icons</secondary> </indexterm> - <para>The GNOME desktop provides several themes that are designed -for users with special visual needs. For example, some of the themes are designed -for users with low vision. The themes contain several versions of each icon -so that the icon can be displayed in each theme.</para> + <para>The desktop environment provides several themes that are +designed for users with special visual needs. For example, some of the themes +are designed for users with low vision. Several versions of icons might be +required so that the icon can be displayed properly in each theme.</para> <para>You might need to install a new icon for an application. When you install a new icon, you must create several versions of the icon, so that the icon -displays correctly in the themes. You can create the icons in several formats, -for example Portable Network Graphic (PNG) format. The suggested size of icons -for the GNOME desktop is 48 pixels by 48 pixels. At this size, most themes -can rescale the icons.</para> +displays correctly in the themes. You must create several versions of the +following types of icon:</para> + <itemizedlist> + <listitem> + <para>Icons that are used within applications in the desktop environment.</para> + </listitem> + <listitem> + <para>Icons that are used internally by GTK+ applications, or GTK+ +stock icons.</para> + </listitem> + </itemizedlist> + <para>When you install a new icon, you must create several versions of the +icon, so that the icon displays correctly in the themes. You can create the +icons in several formats, for example Portable Network Graphic (PNG) format. +The suggested size of icons for the desktop environment is 48 pixels by 48 +pixels. At this size, most themes can rescale the icons.</para> <para>When you install a new icon, create the following 48 × 48 pixel versions of the icon:</para> <itemizedlist> @@ -174,32 +348,24 @@ to add icons to the HighContrast theme, add the icons to the <filename>/usr/shar For example, to add icons to the HighContrast theme, add references to the icons to the <filename>/usr/share/themes/HighContrast/gtk-2.0/gtkrc</filename> file. </para> - <para>The instructions above apply only to the following types of icon:</para> - <itemizedlist> - <listitem> - <para>Icons that are used within applications in the GNOME desktop.</para> - </listitem> - <listitem> - <para>Icons that are used internally by GTK+ applications, or GTK+ -stock icons.</para> - </listitem> - </itemizedlist> <para>For more information on how to create icons for application launchers and for panels, see <ulink url="http://www.freedesktop.org/standards/icon-theme-spec.html">http://www.freedesktop.org/standards/icon-theme-spec.html</ulink>.</para> </sect1> <sect1 id="themes-15"> - <title>To Create a Custom Desktop Theme</title> + <title>To Create a Custom Controls Option</title> <indexterm> <primary>themes</primary> - <secondary>creating custom desktop</secondary> + <secondary>controls options</secondary> + <tertiary>creating custom</tertiary> </indexterm> - <para>If the desktop themes that the GNOME desktop provides are -not suitable for the needs of your users, you can create a custom desktop -theme. To create a custom desktop theme, perform the following steps:</para> + <para>If the options for the +controls setting are not suitable for the needs of your users, you can create +a custom controls option. To create a custom controls option, perform the +following steps:</para> <orderedlist> <listitem> - <para>Create a directory structure for the theme in the <filename>/usr/share/themes</filename> directory. Use the same directory structure that -other themes use. For example, to create a theme that is called SmallPrint, + <para>Create a directory structure for the option in the <filename>/usr/share/themes</filename> directory. Use the same directory structure that +other options use. For example, to create an option that is called SmallPrint, create the following directories:</para> <itemizedlist> <listitem> @@ -215,22 +381,22 @@ create the following directories:</para> </itemizedlist> </listitem> <listitem> - <para>Locate the <filename>gtkrc</filename> theme file that is closest -to meeting the needs of your users. Copy the file to the <filename>gtk-2.0</filename> directory of your new theme.</para> + <para>Locate the <filename>gtkrc</filename> file that is closest +to meeting the needs of your users. Copy the file to the <filename>gtk-2.0</filename> directory of your new option.</para> </listitem> <listitem> <para>Open the <filename>gtkrc</filename> file in a text editor, and modify the attributes of the interface elements as required. </para> </listitem> <listitem> - <para>If the new theme includes images, install the images for the -new theme in the <filename>pixmaps</filename> directory of your new theme. -If the new theme uses images from another theme, you do not need to create -copies of the images for the new theme. Instead, ensure that the reference + <para>If the new option includes images, install the images for +the new option in the <filename>pixmaps</filename> directory of your new option. +If the new option uses images from another option, you do not need to create +copies of the images for the new option. Instead, ensure that the reference to the images in the <literal>pixmap_path</literal> entry in the <filename>gtkrc</filename> file is correct.</para> </listitem> </orderedlist> - <para>Users can now choose the new theme.</para> + <para>Users can now choose the new option for the controls setting.</para> <para>For more information on <filename>gtkrc</filename> files, see <ulink url="http://developer.gnome.org/doc/API/2.0/gtk/index.html">http://developer.gnome.org/doc/API/2.0/gtk/index.html</ulink>.</para> </sect1> </chapter> |