X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?p=xscreensaver;a=blobdiff_plain;f=driver%2Fxscreensaver-command.man;h=0dee348fbdfdad605831f59c578a1d7139de6404;hp=d65457f73f91752b0c29746b38973ab89f4cd6bf;hb=019de959b265701cd0c3fccbb61f2b69f06bf9ee;hpb=c28aecf9fc41e3a03494bacf7279745425e2fa18 diff --git a/driver/xscreensaver-command.man b/driver/xscreensaver-command.man index d65457f7..0dee348f 100644 --- a/driver/xscreensaver-command.man +++ b/driver/xscreensaver-command.man @@ -11,29 +11,27 @@ .if n .sp 1 .if t .sp .5 .. -.TH XScreenSaver 1 "23-Oct-2002 (4.06)" "X Version 11" +.TH XScreenSaver 1 "09-Nov-2013 (5.23)" "X Version 11" .SH NAME xscreensaver-command - control a running xscreensaver process .SH SYNOPSIS .B xscreensaver-command [\-display \fIhost:display.screen\fP] \ -[\-help] \ -[\-demo] \ -[\-prefs] \ -[\-activate] \ -[\-deactivate] \ -[\-cycle] \ -[\-next] \ -[\-prev] \ -[\-select \fIn\fP] \ -[\-exit] \ -[\-restart] \ -[\-lock] \ -[\-throttle] \ -[\-unthrottle] \ -[\-version] \ -[\-time] \ -[\-watch] +[\-help | \ +\-demo | \ +\-prefs | \ +\-activate | \ +\-deactivate | \ +\-cycle | \ +\-next | \ +\-prev | \ +\-select \fIn\fP | \ +\-exit | \ +\-restart | \ +\-lock | \ +\-version | \ +\-time | \ +\-watch] .SH DESCRIPTION The \fIxscreensaver\-command\fP program controls a running \fIxscreensaver\fP process by sending it client-messages. @@ -119,10 +117,8 @@ this to activate the screensaver with a particular graphics demo. (The first element in the list is numbered 1, not 0.) .TP 8 .B \-exit -Causes the xscreensaver process to exit gracefully. This is roughly the same -as killing the process with -.BR kill (1), -but it is easier, since you don't need to first figure out the pid. +Causes the xscreensaver process to exit gracefully. +This does nothing if the display is currently locked. .B Warning: never use \fIkill -9\fP with \fIxscreensaver\fP while the screensaver is @@ -141,21 +137,6 @@ running as you. See .BR xscreensaver (1) for details. .TP 8 -.B \-throttle -Temporarily switch to ``blank screen'' mode, and don't run any display modes -at all, until the screensaver is next de-activated. This is useful if you're -using a machine remotely, and you find that some display modes are using too -much CPU. - -(If you want to do this \fIpermanently\fP, that is, you want the screen saver -to only blank the screen and not run demos at all, then set the \fIprograms\fP -resource to an empty list: See -.BR xscreensaver (1) -for details.) -.TP 8 -.B \-unthrottle -Turn `-throttle' mode off and resume normal behavior. -.TP 8 .B \-version Prints the version of xscreensaver that is currently running on the display: that is, the actual version number of the running xscreensaver background @@ -171,18 +152,9 @@ un-blanked.) .TP 8 .B \-restart Causes the screensaver process to exit and then restart with the same command -line arguments as last time. Do this after you've changed the resource -database, to cause xscreensaver to notice the changes. - -.B Warning: -if you have a \fI.xscreensaver\fP file, this might not do what you -expect. You're probably better off killing the existing -xscreensaver (with \fIxscreensaver\-command -exit\fP) and then -launching it again. - -The important point is, you need to make sure that the xscreensaver -process is running as you. If it's not, it won't be reading the -right \fI.xscreensaver\fP file. +line arguments as last time. You shouldn't really need to do this, +since xscreensaver notices when the \fI.xscreensaver\fP file has +changed and re-reads it as needed. .TP 8 .B \-watch Prints a line each time the screensaver changes state: when the screen @@ -227,9 +199,29 @@ while () { } } .EE -Note that LOCK might come either with or without a preceeding BLANK +Note that LOCK might come either with or without a preceding BLANK (depending on whether the lock-timeout is non-zero), so the above program keeps track of both of them. +.SH STOPPING GRAPHICS +If xscreensaver is running, but you want it to stop running screen hacks +(e.g., if you are logged in remotely, and you want the console to remain +locked but just be black, with no graphics processes running) you can +accomplish that by simply powering down the monitor remotely. In a +minute or so, xscreensaver will notice that the monitor is off, and +will stop running screen hacks. You can power off the monitor like so: +.EX +xset dpms force off +.EE +See the +.BR xset (1) +manual for more info. + +You can also use +.BR xscreensaver-demo (1) +to make the monitor power down after a few hours, meaning that xscreensaver +will run graphics until it has been idle for the length of time you +specified; and after that, the monitor will power off, and screen hacks +will stop being run. .SH DIAGNOSTICS If an error occurs while communicating with the \fIxscreensaver\fP daemon, or if the daemon reports an error, a diagnostic message will be printed to @@ -253,18 +245,19 @@ The latest version of and related tools can always be found at http://www.jwz.org/xscreensaver/ .SH "SEE ALSO" .BR X (1), -.BR xscreensaver (1) -.BR xscreensaver\-demo (1) +.BR xscreensaver (1), +.BR xscreensaver\-demo (1), +.BR xset (1) .SH COPYRIGHT -Copyright \(co 1992, 1993, 1997, 1998, 1999, 2000, 2001, 2002 -by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell -this software and its documentation for any purpose is hereby granted without -fee, provided that the above copyright notice appear in all copies and that -both that copyright notice and this permission notice appear in supporting -documentation. No representations are made about the suitability of this -software for any purpose. It is provided "as is" without express or implied -warranty. +Copyright \(co 1992-2013 by Jamie Zawinski. +Permission to use, copy, modify, distribute, and sell this software +and its documentation for any purpose is hereby granted without fee, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. No representations are made about the +suitability of this software for any purpose. It is provided "as is" +without express or implied warranty. .SH AUTHOR -Jamie Zawinski , 13-aug-92. +Jamie Zawinski , 13-aug-1992. Please let me know if you find any bugs or make any improvements.