From cda495a4511dc70d13c6828bbc681a750f7a14fd Mon Sep 17 00:00:00 2001 From: Brent Smith Date: Sat, 11 Mar 2006 02:23:37 +0000 Subject: Committed patch from William Jon McCann with small changes. Fixes #332091 2006-03-10 Brent Smith * screensavers.xml: Committed patch from William Jon McCann with small changes. Fixes #332091 --- ChangeLog | 5 ++ gnome2-system-admin-guide/C/ChangeLog | 6 ++ gnome2-system-admin-guide/C/screensavers.xml | 99 ++++++++++++++-------------- 3 files changed, 61 insertions(+), 49 deletions(-) diff --git a/ChangeLog b/ChangeLog index f68b4f7..a490f88 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2006-03-08 William Jon McCann + + * gnome2-system-admin-guide/C/screensavers.xml: + First pass at updating. + 2006-03-08 William Jon McCann * gnome2-user-guide/C/gospanel.xml: Updated panel diff --git a/gnome2-system-admin-guide/C/ChangeLog b/gnome2-system-admin-guide/C/ChangeLog index 7d6bd39..092aa91 100644 --- a/gnome2-system-admin-guide/C/ChangeLog +++ b/gnome2-system-admin-guide/C/ChangeLog @@ -1,3 +1,9 @@ +2006-03-10 Brent Smith + + * screensavers.xml: + Committed patch from William Jon McCann with small changes. Fixes + #332091 + 2006-03-10 Brent Smith * mimetypes.xml: diff --git a/gnome2-system-admin-guide/C/screensavers.xml b/gnome2-system-admin-guide/C/screensavers.xml index 98e3494..48ba8ac 100644 --- a/gnome2-system-admin-guide/C/screensavers.xml +++ b/gnome2-system-admin-guide/C/screensavers.xml @@ -12,13 +12,13 @@ are available for the screensaver. introduction - XScreenSaver + gnome-screensaver screensavers 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 XScreenSaver. -The following sections describe how to set preferences for the XScreenSaver application, and how to modify the displays that +application for the GNOME Desktop is gnome-screensaver. +The following sections describe how to set preferences for the gnome-screensaver application, and how to change the themes that are available for the screensaver. @@ -27,58 +27,59 @@ are available for the screensaver. screensavers setting preferences - Default screensaver preferences are stored in a file that -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.6 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. - To restore the default settings for a user, delete the $HOME/.xscreensaver file from the home directory of the user. If no $HOME/.xscreensaver file is present, the default preferences in the XScreenSaver file are used. - - The default display behavior of XScreenSaver -is to display a blank screen. The blank screen might confuse users. You might -want to change this default display behavior. - - To activate changes to the screensaver preferences, use the following -command to reload screensaver preferences: - - # - xscreensaver-command -restart - - - The xset application does not work -with XScreenSaver at the time of publication of -this guide. To modify screensaver preferences, modify the XScreenSaver file or the $HOME/.xscreensaver file. - + All screensaver preferences and settings are stored in GConf. + To modify screensaver application preferences, users can use the Screensaver preference tool. For information on screensaver preferences, see GNOME Desktop User's Guide. + Users can also run the command /usr/bin/gnome-screensaver-preferences to open +the Screensaver Preferences dialog. + To set default screensaver settings and policy for all users, modify the screensaver settings in the Default GConf Configuration Source. + To set mandatory screensaver settings and policy for all users, modify the screensaver settings in the Mandatory GConf Configuration Source. - Modifying Screensaver Displays + Modifying Screensaver Themes screensavers - modifying screensaver -displays + modifying screensaver themes The screensaver application allows users -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 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 +to choose one or more screensaver themes. A screensaver +theme is an application that displays images on the screen of the user when +the screen is not in use. The available screensaver themes are listed in the Screensaver preference tool. + To add a new screensaver theme, copy the executable file for the screensaver theme engine to somewhere in your PATH or into the +screensaver theme engine executable directory. The screensaver theme engine executable directory for your system can be determined using the following command: +pkg-config --variable=privlibexecdir gnome-screensaver + +Next, add a .desktop file for the theme into the screensaver themes directory. The screensaver themes directory for your system +can be determined using the following command: +pkg-config --variable=themesdir gnome-screensaver + +In the Exec field of the .desktop file include any arguments that are required to run the screensaver +theme on the whole screen, rather than in a window. For example, some legacy screensaver theme engines may require you +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 + The Screensaver infrastructure implements themes according to the XDG menu + specification. By supporting this specification, GNOME allows you + to: + + + + Customize the themes easily. You can edit a small number + of files to customize the available themes. You do not need to modify + your applications or move files. + + + + Install themes easily. You do not need to provide + information about the system when you install + the themes. + + + + Configure the system so that users cannot modify the themes. + + + + For more information, see . + -- cgit