From eafd58eda3babf5dbab7f9b6a8328f21b3cb1fa2 Mon Sep 17 00:00:00 2001 From: Eugene O'Connor Date: Tue, 16 Mar 2004 15:38:50 +0000 Subject: Updates to SAG for GNOME 2.6 Desktop. --- gnome2-system-admin-guide/C/ChangeLog | 4 + gnome2-system-admin-guide/C/appendixa.xml | 21 +- gnome2-system-admin-guide/C/appendixb.xml | 32 ++ gnome2-system-admin-guide/C/fontconfig.xml | 101 ++++++ gnome2-system-admin-guide/C/gconf.xml | 381 +++++++++------------ gnome2-system-admin-guide/C/glossary.xml | 32 +- gnome2-system-admin-guide/C/help.xml | 2 +- gnome2-system-admin-guide/C/l10n-readme.txt | 54 ++- gnome2-system-admin-guide/C/lockdown.xml | 202 +++++++++++ gnome2-system-admin-guide/C/menustructure.xml | 97 +++--- gnome2-system-admin-guide/C/mimetypes.xml | 73 ++-- gnome2-system-admin-guide/C/performance.xml | 258 +++----------- gnome2-system-admin-guide/C/screensavers.xml | 71 +--- gnome2-system-admin-guide/C/sessions.xml | 9 +- .../C/system-admin-guide-C.omf | 10 +- gnome2-system-admin-guide/C/system-admin-guide.xml | 31 +- gnome2-system-admin-guide/C/themes.xml | 128 +++---- 17 files changed, 793 insertions(+), 713 deletions(-) create mode 100644 gnome2-system-admin-guide/C/appendixb.xml create mode 100644 gnome2-system-admin-guide/C/fontconfig.xml create mode 100644 gnome2-system-admin-guide/C/lockdown.xml diff --git a/gnome2-system-admin-guide/C/ChangeLog b/gnome2-system-admin-guide/C/ChangeLog index ab193a4..38d4752 100644 --- a/gnome2-system-admin-guide/C/ChangeLog +++ b/gnome2-system-admin-guide/C/ChangeLog @@ -1,3 +1,7 @@ +2004-03-16 Eugene O'Connor + + * Updated System Administration Guide for GNOME 2.6. + 2003-09-08 Eugene O'Connor * Updated System Administration Guide for GNOME 2.4. diff --git a/gnome2-system-admin-guide/C/appendixa.xml b/gnome2-system-admin-guide/C/appendixa.xml index 585f00f..a2ea254 100644 --- a/gnome2-system-admin-guide/C/appendixa.xml +++ b/gnome2-system-admin-guide/C/appendixa.xml @@ -1,3 +1,4 @@ + Hidden Directories @@ -21,10 +22,10 @@ Desktop adds to the home directories of users. - + Directory - + Description @@ -96,10 +97,9 @@ the user. The Nautilus file manager -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: +contains a preference that enables users to use the file manager to manage +the desktop. If this option is selected, this directory contains the objects +that are on the desktop of the user. This directory contains the following: Objects on the desktop, for example, the Home @@ -174,9 +174,7 @@ user. For example, this directory can contain the following: Metadata for the directories with which the user works. - - Nautilus themes that the user adds. - + Nautilus emblems that the user adds. @@ -194,8 +192,9 @@ adds. - Contains controls themes, window frame themes, and -icons themes that the user adds. The user can add themes from the Theme preference tool. + Contains controls theme options, window frame theme +options, and icons theme options that the user adds. The user can add themes +from the Theme preference tool. diff --git a/gnome2-system-admin-guide/C/appendixb.xml b/gnome2-system-admin-guide/C/appendixb.xml new file mode 100644 index 0000000..4b759b9 --- /dev/null +++ b/gnome2-system-admin-guide/C/appendixb.xml @@ -0,0 +1,32 @@ + + + Security Note on Configuring SMB Printers + + This appendix provides a security note related to the configuration +of printers on Windows network shares. + + + Samba + SMB + + + Windows network shares + SMB + + + SMB + configuring printers + + Windows network shares are also referred to as Samba or SMB +shares. When you configure a printer on an SMB share, you must enter a username +and password for the print queue. + The username and password for the print queue is stored as unencrypted +text in the file /etc/cups/printers.conf. +This file has read-only permissions for users with root privileges, so any +user with root privileges can read the username and password for the print +queue. + To reduce the impact of possible security violations, ensure that the +username and password required to access the print queue is used only for +the print queue. This ensures that any possible security violation is restricted +to unauthorized use of the print queue. + diff --git a/gnome2-system-admin-guide/C/fontconfig.xml b/gnome2-system-admin-guide/C/fontconfig.xml new file mode 100644 index 0000000..0bd3f58 --- /dev/null +++ b/gnome2-system-admin-guide/C/fontconfig.xml @@ -0,0 +1,101 @@ + + Configuring Fonts + + This chapter describes how to configure fonts in the GNOME +Desktop. + + + Introduction to Configuring Fonts + + configuring fonts + fonts + + + fontconfig + fonts + + + fonts + introduction + + GNOME Desktop uses the fontconfig font configuration and +customization library. The fontconfig library can use all +kinds of fonts, including PostScript Type 1 fonts and TrueType fonts. + The fontconfig library provides a list of all the +fonts available on a GNOME Desktop system. To compile this list, fontconfig searches the directories listed in the /etc/fonts/fonts.conf file. To view all the fonts available on a system, access the fonts:/// location in the file manager on the system. + For more information about the fontconfig library, +see the following URL: + + http://freedesktop.org/software/fontconfig + + + + Font Substitution + + fonts + substitution + + The fontconfig library performs font substitution +when either entire fonts, or individual characters, are not present. If the +system needs to display a font that is not available, fontconfig attempts to display another, similar font. For example, if a web +page requests to display the Verdana font, and that font is not installed +on the system, fontconfig displays a similar font, such +as Helvetica. The list of similar fonts is defined in the /etc/fonts/fonts.conf file. + If the system needs to display a character that is not present in the +selected font, fontconfig attempts to display the character +in another, similar font. For example, you might select Bitstream Vera Sans +as the font for the Text Editor application. The Bitstream Vera font family +does not include Cyrillic characters. If you open a document which contains +a Cyrillic character, Text Editor uses a similar font that includes Cyrillic +characters to display the character. + The fontconfig library also defines aliases for fonts, +for example, serif, sans-serif, and monospace. When you select one of the aliases for a font, the system +uses the first font that is defined for that alias in the /etc/fonts/fonts.conf. + + + To Add a Font for All Users + + fonts + adding for all users + + To add a font for all users, perform the following steps: + + + Copy the font file to one of the directories in the /etc/fonts/fonts.conf file. Typically, fonts are stored in the /usr/share/fonts/ directory. + + + The fontconfig library updates the list +of fonts automatically. If the list of fonts is not updated, run the following +command: + + # + fc-cache directory-name + + + + + + To Add a Font for an Individual User + + fonts + adding for individual users + + To add a font for an individual users, perform +the following steps: + + + Copy the font file to the $HOME/.fonts +directory of the user. If you drag the font file to the fonts:/// location in the file manager, the font file is copied to the $HOME/.fonts directory. + + + The fontconfig library updates the list +of fonts automatically. If the list of fonts is not updated, run the following +command: + + # + fc-cache directory-name + + + + + diff --git a/gnome2-system-admin-guide/C/gconf.xml b/gnome2-system-admin-guide/C/gconf.xml index c6786f6..32eecdc 100644 --- a/gnome2-system-admin-guide/C/gconf.xml +++ b/gnome2-system-admin-guide/C/gconf.xml @@ -1,20 +1,18 @@ Using GConf - The information in this chapter describes how to use GConf to manage user preferences. - - Configuration Editor - + The information in this chapter describes how to use GConf to manage user preferences. This chapter also describes +how to use Configuration Editor. - Introducing GConf + Introducion to GConf GConf introduction GConf simplifies the administration of preferences -for users in the desktop environment. GConf enables -system administrators to do the following: +for GNOME Desktop users. GConf enables system administrators +to do the following: Set mandatory values for particular preferences for all users. @@ -47,9 +45,6 @@ preference, all applications that use the preference are immediately updated.

A command line tool, gconftool-2. - - Configuration Editor - GConf Repository @@ -63,8 +58,8 @@ is an element in the repository that corresponds to an application preference. For example, the /apps/gnome-session/options/show_splash_screen preference key corresponds to the Show splash screen on login option in the Sessions preference tool. The GNOME -Desktop user interface does not contain all of the preference keys in the GConf repository. For example, the Sessions -preference tool does not contain an option that corresponds to the /apps/gnome-session/options/allow_tcp_connections key. +Desktop user interface does not contain all of the preference keys in the GConf repository. For example, the Panel +preference tool does not contain an option that corresponds to the /apps/panel/global/tooltips_enabled key. The repository is structured like a simple hierarchical file system. The repository contains the following: @@ -109,8 +104,8 @@ is referred to as /desktop/gnome/interface/font_name. The GConf repository contains a series of storage locations that are called configuration sources. The configuration sources are listed in the GConf path file. The location of the GConf -path file is /etc/gconf/version-number/path. Each user has a path file. Each line in the path file specifies -the following information: +path file is /etc/gconf/gconf-version-number/path. Each user has a path file. The path file specifies the following +information for each configuration source: The backend module to use to read the repository. @@ -122,10 +117,11 @@ the following information: The location of the repository. - By default, the contents of the GConf path -file are as follows: + The GConf path file also contains include instructions. By default, the contents of the GConf path file are as follows: xml:readonly:/etc/gconf/gconf.xml.mandatory +include /etc/gconf/2/local-mandatory.path include "$(HOME)/.gconf.path" +include /etc/gconf/2/local-defaults.path xml:readwrite:$(HOME)/.gconf xml:readonly:/etc/gconf/gconf.xml.defaults When GConf searches for a preference value, GConf reads the configuration sources in the order specified @@ -137,10 +133,10 @@ in the path file: - + Configuration Source - + Description @@ -164,6 +160,9 @@ mandatory. This configuration source is stored in the .gconf directory in the home directory of the user. When the user sets a preference, the new preference information is added to this location. + You can use +the Configuration Editor to modify the user configuration +source. @@ -193,10 +192,59 @@ order of priority: Default preferences - The include instruction in the GConf path file enables users to use another configuration source. -To use another configuration source, the user must specify the location of -the configuration source. The user specifies the location of the configuration + The include instructions in the GConf path file enable system administrators to specify other configuration +sources. + + + + + + + + Included Configuration Source + + + Description + + + + + + + + /etc/gconf/2/local-mandatory.path + + + + Use this configuration +source to store mandatory preference values for a particular system. + + + + + + $(HOME)/.gconf.path + + + + The user specifies the location of the configuration source in the home directory, in a file that is called .gconf.path. + + + + + + /etc/gconf/2/local-defaults.path + + + + Use this configuration +source to store default preference values for a particular system. + + + + + GConf Schemas @@ -234,10 +282,10 @@ and the relationship of these items to preference keys: - + Item - + Description @@ -294,10 +342,10 @@ and a schema object: - + Item - + Example @@ -376,13 +424,14 @@ a .schemas extension. new configuration source. Some schema definition files correspond closely to a part of the GNOME Desktop user interface. For example, system_http_proxy.schemas -corresponds to the Network Proxy preference tool. -Other schema definition files contain preference keys that are not present -in the GNOME Desktop user interface. For example, the /apps/gnome-session/options/splash_screen_text key is not present in the user interface. +corresponds to the Network Proxy preference tool. Other schema definition files contain +preference keys that are not present in the GNOME Desktop user interface. +For example, the /apps/panel/global/tooltips_enabled key +is not present in the user interface. Some parts of the GNOME Desktop user interface contain preferences that represent preference keys from more than one schema definition file. For example, -the Keyboard Shortcuts preference tool contains -preferences that represent keys from the panel-global-config.schemas and metacity.schemas files. +the Keyboard Shortcuts preference tool contains preferences that represent +keys from the panel-global-config.schemas and metacity.schemas files. @@ -478,10 +527,10 @@ use with the gconftool-2 command. - + Option - + Function @@ -535,7 +584,7 @@ Ensure that the GConf daemon, gconfd-2 - + --dump @@ -573,14 +622,13 @@ key that you specify. - + --load=filename - Use -this option to sets the values of preference keys in the current directory + 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 <gconfentryfile> element. @@ -905,6 +953,7 @@ false You can also set other print manager preferences. For information on the other print manager preferences, see the gnome-print-manager.schemas schema definition file. + To Set the Number of Workspaces @@ -957,7 +1006,7 @@ true # gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.defaults --type bool --set desktop/gnome/accessibility/keyboard/enable +xml:readwrite:/etc/gconf/gconf.xml.defaults --type bool --set /desktop/gnome/accessibility/keyboard/enable false You can also set other keyboard accessibility preferences. For information @@ -976,7 +1025,7 @@ on the other keyboard accessibility preferences, see the desktop_gnome To set keyboard shortcut preferences, you modify the values of preference keys in /apps/metacity/global_keybindings location. For example, you might want users to use only the AltF3 keyboard -shortcut to open the Run Program dialog. To set this +shortcut to open the Run Application dialog. To set this mandatory value, run the following command: # @@ -1002,9 +1051,8 @@ preferences, setting individual panels preferences, individual, setting with GConf - The panel-default-setup.entries schema -definition file specifies the following details of the panels in the desktop -environment: + The panel-default-setup.entries file +specifies the following details of the panels in the GNOME Desktop: Number of panels. @@ -1021,14 +1069,15 @@ environment: 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 panel-default-setup.entries schema -definition file. For more information on the panel-default-setup.entries schema definition file, see the next section. +the structure of the panel-default-setup.entries file. +For more information on the panel-default-setup.entries +file, see the next section. 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 panel preferences is to use the gconftool-2 command with the --dump and --load options. For more information on how to set preferences for panels and objects on panels, see . - Schema Definition File for Individual Panels and Panel Objects + Specifying Individual Panels and Panel Objects GConf schema definition files @@ -1039,15 +1088,15 @@ and objects on panels, see . schema definition files panel and panel object - The schema definition file panel-default-setup.entries contains sections that specify panels -and panel contents. The panel-default-setup.entries file -is structured as follows: + The file panel-default-setup.entries contains sections that specify panels and panel contents. The panel-default-setup.entries file specifies values for schema keys. +The panel-default-setup.entries file resides in the /etc/gconf/schemas directory. + The panel-default-setup.entries file is structured +as follows: - Preference keys that specify the general structure of panels, -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: + Keys that specify the general structure of panels, applets, +and other panel objects in the GNOME Desktop. The following keys specify the +number of panels, panel objects, and applets that appear in the GNOME Desktop: @@ -1056,17 +1105,17 @@ in the desktop environment: - /apps/panel/default_setup/general/applet_id_list + /apps/panel/default_setup/general/object_id_list - /apps/panel/default_setup/general/object_id_list + /apps/panel/default_setup/general/applet_id_list - The keys also assign identifiers to each panel, applet, and panel object. -For example, the following sample from panel-default-setup.entries specifies that one panel appears in the desktop environment: + The keys also assign identifiers to each panel, panel object, and applet. +For example, the following sample from panel-default-setup.entries specifies that one panel appears in the GNOME Desktop: <entry> <key>toplevel_id_list</key> <schema_key>/schemas/apps/panel/general/toplevel_id_list</schema_key> @@ -1078,18 +1127,18 @@ For example, the following sample from panel-default-setup.entries - In panel-default-setup.entries, the identifier bottom_panel identifies the bottom edge panel. + In the panel-default-setup.entries file, the identifier bottom_panel identifies the bottom edge panel. - Preference keys that specify the properties of the panels. -The panel property keys are structured as follows: + Keys that specify the properties of the panels. The panel +property keys are structured as follows: /apps/panel/default_setup/toplevels/panel-name/panel-property-key For example, the key /apps/panel/default_setup/toplevels/bottom_panel/size specifies the size of the bottom panel. - Preference keys that list the panel objects, the panel object -properties, and the panels in which the objects reside. For example, the following -sample from panel-default-setup.entries specifies a Main Menu object at the left side of the bottom panel: + Keys that specify the panel objects, the panel object properties, +and the panels in which the objects reside. For example, the following sample +from panel-default-setup.entries specifies a Main Menu object at the left side of the bottom panel: <entrylist base="/apps/panel/default_setup/objects/main_menu"> <entry> <key>object_type</key> @@ -1118,8 +1167,8 @@ sample from panel-default-setup.entries specifies a - Preference keys that list the applets, the applet preferences, -and the panels in which the applets reside. For example, the following sample + Keys that specify the applets, the applet preferences, and +the panels in which the applets reside. For example, the following sample from panel-default-setup.entries specifies the Window List applet, in the bottom panel: <entrylist base="/apps/panel/default_setup/applets/window_list"> <entry> @@ -1154,6 +1203,13 @@ from panel-default-setup.entries specifies the + The OAFIID is a unique identifier for an applet. To find the OAFIID +for a particular applet, see the .server file for the +applet in the /usr/lib/bonobo/servers directory. For +example, the following excerpt from GNOME_Wncklet_Factory.server shows the OAFIID for the Window List +applet: + <oaf_server iid="OAFIID:GNOME_WindowListApplet" +type="factory" location="OAFIID:GNOME_Wncklet_Factory"> @@ -1180,6 +1236,24 @@ default panel configuration in a file called my-panel-setup.entries Open the my-panel-setup.entries file in a text editor, and modify the file as required. + For example, you might want to change the location of the desktop entry +files. The following is an excerpt from a file generated with the --dump option: + <entry> + <key>objects/object_16/launcher_location</key> + <schema_key>/schemas/apps/panel/objects/launcher_location</schema_key> + <value> + <string>hadjaha-00adce02f7.desktop</string> + </value> + </entry> + In the sample above, you might want to change the reference to hadjaha-00adce02f7.desktop to another desktop entry file that is +available globally. + When you generate a panel configuration with the --dump +option, the positions of the panel objects are absolute positions. You might +want to change the positions of panel objects from absolute positions to relative +positions. The object at the extreme left of a panel has a position value of 0. The next object has a position value of 1, and so on. If you want object +positions to be relative to the right side of the panel, set the value of +the right_stick key to true. + Use the --load option with the gconftool-2 command line tool to set the values of the default configuration @@ -1219,11 +1293,12 @@ interface to which the keys correspond: - + GConf Location - - User Interface Component + + User +Interface Component @@ -1233,7 +1308,7 @@ interface to which the keys correspond: /desktop/gnome/interface/font_name - Font preference tool, Application font section + Font preference tool, Application font option @@ -1241,7 +1316,7 @@ interface to which the keys correspond: /apps/nautilus/preferences/desktop_font - Font preference tool, Desktop font section + Font preference tool, Desktop font option @@ -1255,13 +1330,9 @@ font, run the following command: xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /desktop/gnome/interface/font_name “Sans 12” - - desktop - font preferences, setting -with GConf - - To set palatino 12 -as the default desktop object font, run the following command: + desktopfont preferences, setting +with GConfTo set palatino 12 as +the default desktop object font, run the following command: # gconftool-2 --direct --config-source @@ -1270,18 +1341,19 @@ xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /apps/nautilus/p - To Set Desktop Background Preferences + To Set Background Preferences GConf - desktop background, setting + background, setting - desktop background - preferences, setting with GConf + background + preferences, +setting with GConf - To set desktop -background preferences, you modify the values of the preference keys in the /desktop/gnome/background location. For example, to set a mandatory -image for the desktop background, run the following command: + To set preferences for the +desktop background, you modify the values of the preference keys in the /desktop/gnome/background location. For example, to set a mandatory +image for the background, run the following command: # gconftool-2 --direct --config-source @@ -1293,8 +1365,8 @@ xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /desktop/gnome/ gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /desktop/gnome/background/picture_filename filename.png - You can also set other desktop background preferences. For information -on the other desktop background preferences, see the desktop_gnome_background.schemas schema definition file. + You can also set other background preferences. For information on the +other background preferences, see the desktop_gnome_background.schemas schema definition file. To Set Splash Image Preferences @@ -1350,145 +1422,4 @@ directory of the user. This command resets the values of all preference keys, in all subdirectories, from the user setting to the setting in the default configuration source. - - Using Configuration Editor - - GConf - Configuration Editor - - - Configuration Editor - overview - - Configuration Editor enables -you to do the following: - - - Modify the values of the keys in the GConf -repository. - - - View documentation on the keys in the GConf -repository. - - - To open Configuration Editor, choose ApplicationsSystem ToolsConfiguration Editor. -shows the Configuration Editor window. -
- Configuration Editor Window - - - - - - - Configuration Editor window. Callouts: Tree pane, Modification pane, Documentation pane. - - - -
- The Configuration Editor window contains -the following panes: - - - Tree pane - - Enables you to navigate -the directories and subdirectories in the GConf -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. - - - - Modification pane - - Displays the keys -in the selected GConf 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. - 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 /system/http_proxy/use_http_proxy key indicates that -you can enter a boolean value for the key. - 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. - - - - Documentation pane - - Displays documentation -for the currently selected key. Use this pane to read more information on -the GConf preference keys. - - - - - GConf - GConf editor, -using - - 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. - The following sections describe how to use the Configuration -Editor. - - To Modify the Value of a Key - - Configuration Editor - modifying key -values - - To modify the value of a key, perform -the following steps: - - - Use the tree pane to display the key that you want to modify -in the modification pane. - - - Select the key to modify. - - - To change the value of an integer key or a string key, click -in the Value column of the key. Type the new value for -the key. - To change the value of a boolean key, click in the Value -column of the key. - - - - - To Copy a Key Name - - Configuration Editor - copying key names - - To copy a key name, select the key whose name -you want to copy in the modification pane. Choose EditCopy key name. If required, -you can paste the name of the key into another application. - - - Using Bookmarks With Keys - - Configuration Editor - bookmarks - - To access a key in your bookmarks, choose the key from the Bookmarks menu. You can add keys to your Bookmarks -menu. - - To Add a Bookmark - To add a bookmark, select the key that you want to bookmark in the modification -pane. Choose BookmarksAdd bookmark. - - - To Delete a Bookmark - To delete a bookmark, choose BookmarksEdit bookmarks. An Edit bookmarks dialog is displayed. Select the bookmark in the -dialog, then click Delete. - - - diff --git a/gnome2-system-admin-guide/C/glossary.xml b/gnome2-system-admin-guide/C/glossary.xml index 65dd29a..434cbf5 100644 --- a/gnome2-system-admin-guide/C/glossary.xml +++ b/gnome2-system-admin-guide/C/glossary.xml @@ -80,7 +80,7 @@ order in which to search the sources. lists the keys in a particular application, and defines the characteristics of the keys. GConf schemas are generated from schema definition files. Schema definition files have a .schemas -extension. +file extension. @@ -119,8 +119,8 @@ the object. MIME information file A MIME information file is a text file that associates MIME -types with filename extensions and filename patterns. MIME information files -have a .mime file extension. +types with file extensions and filename patterns. MIME information files have +a .mime file extension. @@ -145,7 +145,7 @@ Graphic (PNG) file is attached to an email. The MIME type registry is a location that contains text files which register MIME types for the desktop environment. The location of the -MIME type registry for the GNOME Desktop is /usr/gnome/share/mime-info. +MIME type registry for the GNOME Desktop is /usr/share/mime-info. @@ -153,7 +153,13 @@ MIME type registry for the GNOME Desktop is /usr/gnome/share/mime-info 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 .omf extension. +about the manual that is used by the Help browser. OMF files have a .omf file extension. + + + + PAM + + Pluggable Authentication Modules. @@ -167,10 +173,10 @@ when searching for a pattern in a file. pregenerate - 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 yelp-pregenerate command to -pregenerate help. + 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 yelp-pregenerate command to +pregenerate Help. @@ -188,11 +194,17 @@ GNOME Desktop is XScreenSaver. on the screen of the user when the screen is not in use. + + UDP + + User Datagram Protocol. + + Uniform Resource Identifier A Uniform Resource Identifier (URI) is a string that identifies -a particular location in a file system or on the Web. For example, the address +a particular location in a file system or on the web. For example, the address of a web page is a URI. diff --git a/gnome2-system-admin-guide/C/help.xml b/gnome2-system-admin-guide/C/help.xml index af0224b..13f98de 100644 --- a/gnome2-system-admin-guide/C/help.xml +++ b/gnome2-system-admin-guide/C/help.xml @@ -4,7 +4,7 @@ This chapter describes the Help system in the GNOME Desktop. - Introduction + Introduction to the Help System online Help Help diff --git a/gnome2-system-admin-guide/C/l10n-readme.txt b/gnome2-system-admin-guide/C/l10n-readme.txt index a3b1d62..dacb2e0 100644 --- a/gnome2-system-admin-guide/C/l10n-readme.txt +++ b/gnome2-system-admin-guide/C/l10n-readme.txt @@ -1,6 +1,26 @@ ___________________________________________________________ -GNOME 2.4 Desktop System Administration Guide - L10n readme +GNOME 2.6 Desktop System Administration Guide - L10n readme Written by: Eugene O'Connor (eugene.oconnor@sun.com) +Manual revision: 2.3 +Date: 16 March 2004 + +Changes between Version 2.2 and 2.3 +=================================== + +gconf: Deleted Configuration Editor information. + +New chapters: +fontconfig +lockdown +appendixb + +Deleted chapter: +gdm + +Deleted screenshot: +gconf_editor_anno_window + +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Manual revision: 2.2 Date: 08 September 2003 @@ -52,33 +72,9 @@ First version. ________________________________________________________________________ -GNOME 2.0 Desktop System Administration Guide - Screenshot Instructions +GNOME 2.6 Desktop System Administration Guide - Screenshot Instructions Written by: Eugene O'Connor (eugene.oconnor@sun.com) -Manual revision: 2.1 -Date: 14 January 2003 - -====================================================== -General Screenshot Instructions ------------------------------------------------------- +Manual revision: 2.3 +Date: 16 March 2004 -When you take screenshots for the GNOME 2.4 Desktop System Administration Guide, please note the following: - -* For information on how to take screenshots, see the GDP Handbook. -* For information on how to add callouts, see the GDP Handbook. -* For information on the style of screenshots to be used in GNOME, see http://developer.gnome.org/documents/style-guide/ch10.html. Please note that, unless otherwise specified, all of the screenshots should be taken with the default settings. -* Screenshot are taken at a screen resolution of 800*600. -* When you take a screenshot of a window or dialog, the window or dialog should have focus, unless otherwise specified. - -====================================================== -gconf Screenshot Instructions ------------------------------------------------------- - -gconf_editor_anno_window -1. Start Configuration Editor. -2. Display the key /system/http_proxy/use_http_proxy in the GConf editor window. -3. Adjust the width of the panes to make the window as small as possible. -4. Ensure that the window has focus. If it does not, click on the window to give it focus. -5. Take a screenshot of the window. -6. In your image editor, paste the screenshot into the appropriate location in file gconf_editor_anno_window.xcf. -7. In your image editor, add the translations to the XCF file. -8. In your image editor, save the file in the appropriate formats. +There are no screenshots in this book. diff --git a/gnome2-system-admin-guide/C/lockdown.xml b/gnome2-system-admin-guide/C/lockdown.xml new file mode 100644 index 0000000..044d070 --- /dev/null +++ b/gnome2-system-admin-guide/C/lockdown.xml @@ -0,0 +1,202 @@ + + Disabling GNOME Desktop Features + + This chapter describes how to disable particular features +of the GNOME Desktop. + + + Introduction to Disabling GNOME Desktop Features + + disabling features + introduction + + + lockdown + disabling features + + The GNOME Desktop includes features that you can use +to restrict access to certain functions in the GNOME Desktop. The disable +features are useful in various situations where you want to restrict the actions +that users can perform on a computer. For example, you might want to prevent +command line operations on a computer that is for public use at a trade show. +The disable features are also known as lockdown features. + You set GConf keys to disable features. For +information about how to set GConf keys, see . You can also use the Configuration Editor application to set GConf keys in +a user configuration source. For more information about the Configuration Editor application, see the GConf Editor +Manual. + + + To Disable Lock Screen and Log Out + + disabling features + lock screen + + + disabling features + log +out + + To disable the lock screen and log out functions, set the /apps/panel/global/disable_lock_screen key and the /apps/panel/global/disable_log_out key to true. + When you disable +the lock screen and log out functions, the following items are removed from +the panels: + + + Lock Screen and Log +Out user menu items from the Main Menu. + + + Lock and Log Out +menu items from the Add to PanelActions menu. To open this menu, right-click on +a vacant space on a panel, then choose Add to PanelActions. + + + Lock Screen and Log +Out user menu items from the Actions menu in the Menu Bar applet. + + + Also, any Lock Screen buttons and Log Out buttons on panels are disabled. + + + To Disable Command Line Operations + + disabling features + command line + + To disable operations from a command line, set the /desktop/gnome/lockdown/disable_command_line key to true. + When you disable command line operations, the following +changes occur in the user interface: + + + The Run Application menu item is +removed from the following menus: + + + + Main Menu + + + + Actions submenu in the Add to +Panel menu + + + Actions menu in the Menu Bar applet + + + + + Any Run buttons on panels are disabled. + + + To disable command line operations, you must also remove menu items +that start terminal applications. For example, you might want to remove menu +items that contain the following commands from the menus: + + + GNOME Terminal command, that is /usr/bin/gnome-terminal + + + + /usr/bin/xterm + + + + + /usr/bin/setterm + + + + The items are removed from the following menus: + + + + Main Menu + + + + + + Add to Panel + Launcher from menu + + + + + To disable command line operations, you must also disable the Command Line applet. To disable the Command Line applet, add the applet to the /apps/panel/global/disabled_applets key. When you disable the Command Line +applet, the Command Line applet is removed from +the Main Menu and the Add to PanelUtility menu. + + + To Disable Panel Configuration + + disabling features + panel configuration + + To disable panel configuration, set the /apps/panel/global/locked_down key to true. + When you disable +panel configuration, the following changes occur in the user interface: + + + The following items are removed from the panel popup menu, +and from the drawer popup menu: + + + + Add to Panel + + + + + Delete This Panel + + + + + Properties + + + + + New Panel + + + + + + The launcher popup menu is disabled. + + + The following items are removed from the applet popup menu: + + + + Remove From Panel + + + + + Lock + + + + + Move + + + + + + The Main Menu popup menu is disabled. + + + The launcher drag feature is disabled, so that users cannot +drag launchers to, or from, panels. + + + The panel drag feature is disabled, so that users cannot drag +panels to new locations. + + + + diff --git a/gnome2-system-admin-guide/C/menustructure.xml b/gnome2-system-admin-guide/C/menustructure.xml index d090e0f..ede832b 100644 --- a/gnome2-system-admin-guide/C/menustructure.xml +++ b/gnome2-system-admin-guide/C/menustructure.xml @@ -67,10 +67,10 @@ to the menus. - + Menu - + URI Locations @@ -89,8 +89,7 @@ users - Desktop Preferences menu -for all users + Desktop Preferences menu for all users @@ -118,18 +117,11 @@ 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 be physically located in several directories. - - menus - vfolder information files - - - vfolder information files - - A vfolder information file is an XML file that -describes a vfolder. Vfolder information files specify the structure of your -menus. Vfolder information files specify the names of your menus, and the -order in which applications appear in your menus. Vfolder information files -have a .vfolder-info file extension. + menusvfolder information filesvfolder information filesA vfolder information file is an XML file +that describes a vfolder. Vfolder information files specify the structure +of your menus. Vfolder information files specify the names of your menus, +and the order in which applications appear in your menus. Vfolder information +files have a .vfolder-info file extension. The following is an excerpt from a vfolder information file: <?xml version="1.0"?> <VFolderInfo> @@ -164,10 +156,10 @@ in vfolder information files. - + Element - + Description @@ -256,13 +248,13 @@ hierarchy. Desktop entry files have a .desktop file extensi [Desktop Entry] Encoding=UTF-8 Name=Calculator -Comment=Perform simple calculations -Exec=gnome-calculator -Icon=gnome-calc3.png +Comment=Perform calculations +Exec=gcalctool +Icon=gcalctool.png Terminal=false Type=Application -X-GNOME-DocPath=gnome-calculator/gnome-calculator.xml -Categories=GNOME;Application;Utility; +Categories=GNOME;Application;Utility; +X-GNOME-DocPath=gcalctool/gcalctool.xml describes the most important keys in desktop entry files. @@ -272,10 +264,10 @@ in desktop entry files. - + Desktop Entry Key - + Description @@ -333,7 +325,7 @@ from the menu. Specifies the filename of an icon that represents the item. Does not specify the path to the filename, -or the filename extension. +or the file extension. @@ -374,38 +366,39 @@ links to a file, folder, or FTP site. - X-GNOME-DocPath + Categories - Specifies -the help file to display when you choose Help on application-name from the menu item popup menu. + Specifies the keywords that describe +the item. The keywords are separated with semicolons (;). To see a list of +the standard category keywords, see the desktop menu specification at the +following URL: + + http://www.freedesktop.org + + The vfolder information +files map the keywords to menus. - Categories + X-GNOME-DocPath - Specifies the keywords that describe -the item. The keywords are separated with semicolons (;). To see a list of -the standard category keywords, see the following URL: - - http://www.freedesktop.org/standards/VFolderDesktops.txt - - The vfolder information files map the keywords -to menus. + Specifies +the help file to display when you choose Help on application-name from the menu item popup menu. - For more information on the keys in desktop entry files, see the following -URL: + For more information on the keys in desktop entry files, see the desktop +entry specification at the following URL: - http://www.freedesktop.org/standards/desktop-entry-spec/desktop-entry-spec.html + http://www.freedesktop.org Panel launchers and desktop objects also use desktop entry files. @@ -442,10 +435,10 @@ in directory entry files. - + Directory Entry Key - + Description @@ -482,7 +475,7 @@ of the menu. The comment is displayed as a tooltip when you point to the menu. < Specifies the filename of an icon that represents the menu. Does not specify the path to the filename, -or the filename extension. +or the file extension. @@ -505,7 +498,7 @@ or the filename extension. menus editing - You use the following desktop environment components to edit menus: + You use the following GNOME Desktop components to edit menus: Nautilus file manager @@ -564,10 +557,6 @@ is automatically updated with the details of the new menu. The name of the folder is displayed as the name of the menu. - - You might need to reload the display of the file manager window -before you can type the name for the folder. - The next time that users log in, the menu is in the assigned location. @@ -580,11 +569,11 @@ before you can type the name for the folder. Create a directory entry file for the item that you want to -add. Create the directory entry file in the /usr/gnome/share/gnome/vfolders directory. For more information on directory entry files, see . +add. Create the directory entry file in the /usr/share/gnome/vfolders directory. For more information on directory entry files, see . Locate the vfolder information file for the location where -you want to add the menu. For example, to add a menu to the Applications menu, locate the file /usr/gnome/etc/gnome-vfs-2.0/vfolders/applications-all-users.vfolder-info. +you want to add the menu. For example, to add a menu to the Applications menu, locate the file /etc/gnome-vfs-2.0/vfolders/applications-all-users.vfolder-info. In the vfolder information file, add a <Folder> element for the new menu. For more information on vfolder information @@ -698,7 +687,7 @@ following conditions are true: A vfolder information file that corresponds to the menu is -present in the /etc/gnome-vfs-2.0/vfolder directory. +present in the /etc/gnome-vfs-2.0/vfolders directory. The vfolder information file has the same name as the URI @@ -714,12 +703,12 @@ following steps: Create a vfolder information file for the menu that you want -to configure in the /etc/gnome-vfs-2.0/vfolder directory. +to configure in the /etc/gnome-vfs-2.0/vfolders directory. Give the vfolder information file the name of the URI location that corresponds to the menu that you want to configure. For example, to configure -the Applications menu, create a vfolder information called applications.vfolder-info in the /etc/gnome-vfs-2.0/vfolder directory. +the Applications menu, create a vfolder information called applications.vfolder-info in the /etc/gnome-vfs-2.0/vfolders directory. Set the permissions on the vfolder information file to read diff --git a/gnome2-system-admin-guide/C/mimetypes.xml b/gnome2-system-admin-guide/C/mimetypes.xml index 759a681..e9a07f4 100644 --- a/gnome2-system-admin-guide/C/mimetypes.xml +++ b/gnome2-system-admin-guide/C/mimetypes.xml @@ -2,7 +2,7 @@ MIME Types This chapter describes how applications detect MIME types, -how to register MIME types, and how to add applications to the desktop environment. +how to register MIME types, and how to add applications to the GNOME Desktop. Introduction to MIME Types @@ -64,7 +64,7 @@ type of the file. If file content sniffers do not identify the MIME type, then the application can check the filename. The application checks the filename against the MIME type registry. The MIME type registry -associates particular filename extensions and filename patterns, with particular +associates particular file extensions and filename patterns, with particular MIME types. If a match for the filename is found, the MIME type associated with the extension or pattern is the MIME type of the file. @@ -80,7 +80,7 @@ and the MIME type registry. file content sniffers - File content sniffers are specified in the file /usr/gnome/etc/gnome-vfs-mime-magic. The following is an example of a file content sniffer: + File content sniffers are specified in the file /etc/gnome-vfs-mime-magic. The following is an example of a file content sniffer: 0 string \x89PNG image/png The syntax for file content sniffers is as follows: offset_start[:offset_end] pattern_type pattern [&pattern_mask] type @@ -93,10 +93,10 @@ sniffer. - + Field - + Description @@ -304,18 +304,18 @@ match the pattern and mask is image/bmp. MIME types MIME type registry - The MIME type registry is located in /usr/gnome/share/mime-info. The MIME type registry contains the following files: + The MIME type registry is located in /usr/share/mime-info. The MIME type registry contains the following files: - + File - - Filename Extension + + File Extension @@ -355,7 +355,7 @@ files. associate MIME types with one or both of the following: - Filename extensions + File extensions Filename patterns @@ -371,11 +371,10 @@ as a regular expression. MIME-type ext[,priority]: list-of-extensions regex[,priority]: list-of-regular-expressions - 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 1 -to the .gz extension, and assign a higher priority of 2 to the .tar.gz extension. In this case, the -file abc.tar.gz takes the MIME type for .tar.gz. + You can specify a priority value for the file extension and the regular +expression. You can use the priority value to differentiate composite filenames. +For example, you can assign a priority of 1 to the .gz extension, and assign a higher priority of 2 +to the .tar.gz extension. In this case, the file abc.tar.gz takes the MIME type for .tar.gz. You must indent the ext field and the regex field with a tab character (\t). @@ -398,8 +397,10 @@ text/x-readme The file manager reads the MIME information files alphabetically. The alphabetical order determines the order in which MIME types are assigned -to filename extensions or regular expressions. For example, if the same file -extension is assigned to different MIME types in the files abc.mime and def.mime, the MIME type in abc.mime is used. +to file extensions or regular expressions. For example, if the same file extension +is assigned to different MIME types in the files abc.mime +and def.mime, the MIME type in abc.mime +is used. @@ -432,24 +433,24 @@ MIME keys files. Typically, the description key and the - + Key - + Description - + can_be_executable - - Specifies whether files of this MIME type -can be executed. + + Specifies +whether files of this MIME type can be executed. @@ -471,7 +472,7 @@ displayed in the file manager and other applications. Specifies the filename of an icon to represent the -MIME type. Does not specify the path to the filename, or the filename extension. +MIME type. Does not specify the path to the filename, or the file extension. This icon can be displayed in the file manager and other applications. @@ -490,8 +491,8 @@ for this MIME type for most applications. - short_list_application_ids - _for_novice_user_level + short_list_application_ids +_for_novice_user_level @@ -542,7 +543,7 @@ the following information: An application registration file can contain one or more application registrations. Application registration files have a .applications extension. - The location of the application registry is /usr/share/gnome/application-registry. This directory contains a default application registration file + The location of the application registry is /usr/share/application-registry. This directory contains a default application registration file that is called gnome-vfs.applications. To register an application, add a registration file for the application to the application registry. @@ -566,10 +567,10 @@ files. - + Key - + Description @@ -670,7 +671,7 @@ use. - Adding an Application to the Desktop Environment + Adding an Application to the GNOME Desktop MIME types adding applications @@ -679,16 +680,16 @@ use. applications adding - To add an application to the desktop environment, perform -the following steps: + To add an application to the GNOME Desktop, perform the +following steps: Add a menu item for the application. For more information on how to add an item to a menu, see . - Add an icon for the application to /usr/gnome/share/icons/theme-name/icon-size/apps. -For more information on icons and themes, see Installing Themes. + Add an icon for the application to /usr/share/icons/theme-name/icon-size/apps. +For more information on icons and themes, see . If the application uses a new MIME type, add a file content @@ -706,8 +707,8 @@ registry. For more information on MIME keys files, see . To associate the application with a MIME type, add an application diff --git a/gnome2-system-admin-guide/C/performance.xml b/gnome2-system-admin-guide/C/performance.xml index 0c26d10..21cd41f 100644 --- a/gnome2-system-admin-guide/C/performance.xml +++ b/gnome2-system-admin-guide/C/performance.xml @@ -11,14 +11,14 @@ the GNOME Desktop. introduction This chapter lists several preferences whose -settings you can change to improve the performance of the desktop environment. -You can use the gconftool-2 command to set values for preferences +settings you can change to improve the performance of the GNOME Desktop. You +can use the gconftool-2 command to set values for preferences for users. The example commands in this chapter show how to set values in -the user configuration source. +the user configuration source. You can also use the --direct and --config-source options to set mandatory values or default values for preferences. You can also use the gconftool-2 command in a script to set the values of many preferences. For more information on the gconftool-2 command and the options that are available with the -command, see Using GConf. +command, see . Reducing CPU Usage @@ -36,7 +36,7 @@ usage reducing This section describes preferences that -you can set to reduce CPU usage by the desktop environment. +you can set to reduce CPU usage by the GNOME Desktop. To Use Theme Options Which Require Less CPU Resources @@ -51,9 +51,9 @@ you can set to reduce CPU usage by the desktop environment. Some window frame theme options load image files to draw the window frame. Other options use simpler techniques to draw the window frame. - 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: + The Crux window frame option 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: Atlanta @@ -92,7 +92,8 @@ frame theme option, run the following command: gconftool-2 --type string --set /apps/metacity/general/theme Atlanta - Alternatively, users can choose ApplicationsDesktop PreferencesTheme, then select the appropriate option. + Alternatively, users can use the Theme preference +tool to select the appropriate option. You can use the Metacity Theme Viewer to measure the performance of a window frame option, and to preview the option. @@ -132,7 +133,8 @@ item. To turn off this feature, run the following command: gconftool-2 --type bool --set /desktop/gnome/interface/menus_have_icons false - Alternatively, users can choose ApplicationsDesktop PreferencesMenus & Toolbars, then deselect the Show icons in menus option. + Alternatively, users can use the Menus & Toolbars +preference tool to deselect the Show icons in menus option. To Reduce CPU Usage by Turning Off the Splash Screen @@ -150,8 +152,9 @@ login. gconftool-2 --type bool --set /apps/gnome-session/options/show_splash_screen false - Alternatively, users can choose ApplicationsDesktop PreferencesAdvancedSessions, -then deselect the Show splash screen on login option. + Alternatively, users can use the Sessions +preference tool to deselect the Show splash screen on login +option. To Reduce CPU Usage by Turning Off Panel Animation @@ -166,8 +169,8 @@ in an animated style. To turn off panel animation, run the following command: gconftool-2 --type bool --set /apps/panel/global/enable_animations false - Alternatively, users can choose ApplicationsDesktop PreferencesAdvancedPanel, -then deselect the Animation option. + Alternatively, users can use the Panel preference +tool to deselect the Drawer and panel animation option. Improving File Manager Performance @@ -193,24 +196,24 @@ values are described in the following table: - + Value - + Description - + always - - Performs -the action for both local files, and files on other file systems. + + Performs the action for both local files, and files on +other file systems. @@ -247,10 +250,10 @@ manager. For the fastest performance, set the value of the preferences to - + Preference - + Description @@ -275,10 +278,10 @@ files, run the following command: the following steps: - Choose EditPreferences from a file manager window, then choose Performance. + Choose EditPreferences from a file manager window, then choose Preview. - Select an option for the Show Text in Icons + Select an option for the Show text in icons preference. @@ -301,11 +304,11 @@ To never show the number of items in folders, run the following command: Alternatively, users can perform the following steps: - Choose EditPreferences from a file manager window, then choose Performance. + Choose EditPreferences from a file manager window, then choose Preview. - Select an option for the Show Number of Items in -Folders preference. + Select an option for the Count number of items +preference. @@ -327,11 +330,11 @@ To never show thumbnails, run the following command: Alternatively, users can perform the following steps: - Choose EditPreferences from a file manager window, then choose Performance. + Choose EditPreferences from a file manager window, then choose Preview. - Select an option for the Show Thumbnails for Image -Files preference. + Select an option for the Show thumbnails +preference. @@ -354,10 +357,10 @@ never steps: - Choose EditPreferences from a file manager window, then choose Performance. + Choose EditPreferences from a file manager window, then choose Preview. - Select an option for the Preview Sound Files + Select an option for the Preview sound files preference. @@ -382,9 +385,6 @@ turn off the side pane and the toolbar. gconftool-2 --type bool --set /apps/nautilus/preferences/start_with_sidebar false - Alternatively, users can choose EditPreferences from a file manager window, -then choose Windows, and then deselect the Display side pane option. The next time that users open a file -manager window, the window does not display a side pane. file managertoolbar, turning offTo turn off the toolbar, run the following command: @@ -392,9 +392,6 @@ offTo turn off the toolbar, run the following command: < gconftool-2 --type bool --set /apps/nautilus/preferences/start_with_toolbar false - Alternatively, users can choose EditPreferences from a file manager window, -then choose Windows, and then deselect the Display toolbar option. The next time that users open a file manager -window, the window does not display a toolbar. You can also turn off the location bar. Users can use the CtrlL keyboard shortcut to display a location bar when required. file managerlocation bar, turning @@ -405,9 +402,6 @@ command: gconftool-2 --type bool --set /apps/nautilus/preferences/start_with_location_bar false - Alternatively, users can choose EditPreferences from a file manager window, -then choose Windows, and then deselect the Display location bar option. The next time that users open a file -manager window, the window does not display a location bar. To Turn Off the Desktop @@ -422,8 +416,8 @@ off The file manager contains a preference that enables users to use Nautilus to manage the desktop. -Users can disable the desktop to improve performance. However, if users disable -the desktop, users cannot do the following: +You can disable the desktop to improve performance. However, if you disable +the desktop, you cannot do the following: Use the Desktop menu. @@ -433,7 +427,8 @@ the desktop, users cannot do the following: desktop background. - Use the Home object and the Trash object. The Home object and the Trash object are not displayed on the desktop. + Use the desktop objects, such as Trash. +The desktop objects are not displayed on the desktop. To disable the desktop, run the following command: @@ -442,9 +437,6 @@ desktop background. gconftool-2 --type bool --set /apps/nautilus/preferences/show_desktop false - Alternatively, users can choose EditPreferences from a file manager window. -Users can then choose Desktop & Trash, and then deselect -the Use Nautilus to draw the desktop option. @@ -462,7 +454,7 @@ reducing network traffic, reducing This section describes preferences that you can -set to reduce X Window System network traffic on the desktop environment. +set to reduce X Window System network traffic on the GNOME Desktop. To Use Theme Options Which Create Less Network Traffic @@ -519,11 +511,11 @@ traffic if the panels are displayed on a remote host. 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. - The desktop environment uses the websafe color palette. + The GNOME Desktop uses the websafe color palette. 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 desktop environment are designed for systems -that support 24-bit color. +some visual components of the GNOME Desktop are designed for systems that +support 24-bit color. The following display problems might occur on systems that support 8-bit color: @@ -549,7 +541,7 @@ might lose colors, then become unviewable. The following sections describe how to optimize the appearance of the -desktop environment for systems that support 8-bit color. +GNOME Desktop for systems that support 8-bit color. To Use Theme Options That Use the Websafe Color Palette @@ -586,18 +578,18 @@ can increase the number of colors used. and color usage You can turn off the splash screen to make more colors available -for the desktop environment and for applications. +for the GNOME Desktop and for applications. For information on how to turn off the splash screen, see . - To Reduce Color Usage by Using a Solid Color for the Desktop Background + To Reduce Color Usage by Using a Solid Color for the Background - desktop background + background using solid color - Use a solid color for the desktop background. -Use of a solid color reduces the number of colors used by the desktop environment. - To set a solid color for the desktop background, run the following commands: + Use a solid color for the desktop background. Use of a solid +color reduces the number of colors used by the GNOME Desktop. + To set a solid color for the background, run the following commands: # gconftool-2 --type string @@ -613,154 +605,8 @@ Use of a solid color reduces the number of colors used by the desktop environmen gconftool-2 --type string --set /desktop/gnome/background/primary_color \#hexadecimal-color - Alternatively, users can choose ApplicationsDesktop PreferencesBackground, then choose a solid color for the desktop -background. + Alternatively, users can use the Background +preference tool to choose a solid color for the background. - - Improving Performance of Help - - improving - Help performance - - - Help - improving performance - - - performance, improving - Help - - The source documents for the -Help are XML files. The XML files are converted to HTML, and the Yelp Help browser displays the HTML. The HTML can be pregenerated, that is, the XML can be converted to HTML before -the Help is used. - 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. - To avoid performance problems with the Help, pregenerate the HTML so -that the Help browser does not need to do the conversion. Use the yelp-pregenerate command to pregenerate a Help document. The syntax -of the yelp-pregenerate command is as follows: - - yelp-pregenerate - - - - - - - filename - - - - - - - The following table describes the options and arguments -for the yelp-pregenerate command: - - - - - - - - Option or Argument - - - Description - - - - - - - - -a - - - - Pregenerates -all XML files that are registered in the ScrollKeeper -database. This option is the default option. - - - - - - -f - - - - Pregenerates -only the XML files that you specify in the command. - - - - - - filename - - - - The name of the XML file or XML files that you want to pregenerate. - - - - - - locale - - - - The -locale for which you want to pregenerate the XML files. The default locale -is C, or English. - - - - - - For example, to pregenerate the English version of all XML files in -the file system, run the following command: - - # - yelp-pregenerate -a - - You do not need to specify the locale in this example, as the default -locale is C. To pregenerate the Spanish version of the gedit manual, run the following command: - - # - yelp-pregenerate -f gedit.xml -es - - When a user opens a Help file, the Help browser does the following: - - - 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. - - - If the HTML file is older than the XML file, the XML file -is converted to HTML. - - - If the Help browser does not find a HTML file for a Help document, -the XML file is converted to HTML. - - - 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. - - 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. - - diff --git a/gnome2-system-admin-guide/C/screensavers.xml b/gnome2-system-admin-guide/C/screensavers.xml index 30311ef..c6780cd 100644 --- a/gnome2-system-admin-guide/C/screensavers.xml +++ b/gnome2-system-admin-guide/C/screensavers.xml @@ -28,50 +28,13 @@ are available for the screensaver. setting preferences Default screensaver preferences are stored in a file that -is called XScreenSaver. This file is stored in different -locations, depending on the platform, as follows: - - - - - - - - Platform - - - File Location - - - - - - - RedHat Linux - - - - /usr/X11R6/lib/X11/app-defaults/XScreenSaver - - - - - - Solaris Operating System - - - - /usr/openwin/lib/app-defaults/XScreenSaver - - - - - - - To modify screensaver application preferences, users can use the Screensaver preference tool. To start the Screensaver preference tool, choose ApplicationsDesktop PreferencesScreensaver from the Menu Panel. When a user modifies -the screensaver preferences, the preferences are stored in the home directory -of the user, in the $HOME/.xscreensaver file. For information on screensaver preferences, see GNOME 2.2 Desktop User Guide. - Users can also run the command /usr/X11R6/bin/xscreensaver-demo to open the XScreenSaver dialog. +is called XScreenSaver. This file is stored in /usr/X11R6/lib/X11/app-defaults/XScreenSaver. + To modify screensaver application preferences, users can use the Screensaver preference tool. When a user modifies the screensaver +preferences, the preferences are stored in the home directory of the user, +in the $HOME/.xscreensaver file. For information on screensaver preferences, see GNOME 2.2 Desktop User Guide. + Users can +also run the command /usr/bin/xscreensaver-demo to open +the XScreenSaver dialog. To set default screensaver preferences for all users, modify the XScreenSaver file. You can also use the XScreenSaver dialog to create a $HOME/.xscreensaver file, then copy the file to the location of the XScreenSaver file. @@ -105,15 +68,17 @@ to choose one or more screensaver displays. A screensaver display is an application that displays images on the screen of the user when the screen is not in use. The screensaver displays are listed in the XScreenSaver file and in the $HOME/.xscreensaver file. - To add a new screensaver display, copy the executable file for the display -to the /usr/X11R6/lib/xscreensaver/hacks directory. Add -the command for the screensaver display to the XScreenSaver file or the $HOME/.xscreensaver file. Include -any arguments that are required to run the screensaver display on the whole -screen, rather than in a window. For example, you might want to include the -root option to display the screensaver display on the whole screen. - 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 $HOME/.xscreensaver file -shows a disabled Qix (solid) screensaver display: + To add a new +screensaver display, copy the executable file for the display to the directory +where the displays are located. Add the command for the screensaver display +to the XScreenSaver file or the $HOME/.xscreensaver file. Include any arguments that are required to run the screensaver +display on the whole screen, rather than in a window. For example, you might +want to include the -root option to display the screensaver +display on the whole screen. + 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 $HOME/.xscreensaver file shows a disabled Qix (solid) screensaver +display: - "Qix (solid)" qix -root -solid -segments 100 diff --git a/gnome2-system-admin-guide/C/sessions.xml b/gnome2-system-admin-guide/C/sessions.xml index d7db396..2661f4b 100644 --- a/gnome2-system-admin-guide/C/sessions.xml +++ b/gnome2-system-admin-guide/C/sessions.xml @@ -12,7 +12,7 @@ and login scripts. introduction 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 +the GNOME Desktop and the time that the user logs out. The session manager starts after the Login Manager 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 @@ -27,7 +27,7 @@ time that the user logs in. The gnome-panel application, which -runs the panels in the desktop environment. +runs the panels in the GNOME Desktop. The Metacity window manager. @@ -48,10 +48,10 @@ session information: - + File - + Description @@ -82,6 +82,7 @@ the details are stored in this file. + To set default session details for all users, modify the default session file. To restore the default session settings for a user, delete the session diff --git a/gnome2-system-admin-guide/C/system-admin-guide-C.omf b/gnome2-system-admin-guide/C/system-admin-guide-C.omf index 16435dc..9a7314f 100755 --- a/gnome2-system-admin-guide/C/system-admin-guide-C.omf +++ b/gnome2-system-admin-guide/C/system-admin-guide-C.omf @@ -9,20 +9,20 @@ System Administration Guide - 2003-09-08 + 2004-03-16 - + - System Administration Guide for GNOME 2.4. + System Administration Guide for GNOME 2.6. administrator's guide diff --git a/gnome2-system-admin-guide/C/system-admin-guide.xml b/gnome2-system-admin-guide/C/system-admin-guide.xml index 46d5920..80f3a1a 100644 --- a/gnome2-system-admin-guide/C/system-admin-guide.xml +++ b/gnome2-system-admin-guide/C/system-admin-guide.xml @@ -1,29 +1,36 @@ - - + + + + + + ]> GNOME &gnomeversion; Desktop System Administration Guide - 2003 + 2004 Sun Microsystems + + 2003 + Sun Microsystems + For more information on how to create icons for application launchers -and for panels, see http://www.freedesktop.org/standards/icon-theme-spec.html. +and for panels, see http://www.freedesktop.org/Standards/icon-theme-spec. To Create a Custom Controls Option @@ -370,12 +354,12 @@ create the following directories: - /usr/share/themes/SmallPrint/gtk-2.0 + /usr/share/themes/SmallPrint - /usr/share/themes/SmallPrint/pixmaps + /usr/share/themes/SmallPrint/gtk-2.0 -- cgit