1 .\" Copyright 1988, 1998 The Open Group
3 .\" Permission to use, copy, modify, distribute, and sell this software and its
4 .\" documentation for any purpose is hereby granted without fee, provided that
5 .\" the above copyright notice appear in all copies and that both that
6 .\" copyright notice and this permission notice appear in supporting
9 .\" The above copyright notice and this permission notice shall be included
10 .\" in all copies or substantial portions of the Software.
12 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
13 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
14 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
15 .\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
16 .\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
17 .\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
18 .\" OTHER DEALINGS IN THE SOFTWARE.
20 .\" Except as contained in this notice, the name of The Open Group shall
21 .\" not be used in advertising or otherwise to promote the sale, use or
22 .\" other dealings in this Software without prior written authorization
23 .\" from The Open Group.
25 .TH XREFRESH 1 __xorgversion__
27 xrefresh - refresh all or part of an X screen
34 is a simple X program that causes all or part of your screen to be repainted.
35 This is useful when system messages have messed up your screen.
37 maps a window on top of the desired area of the screen and then immediately
39 causing refresh events to be sent to all applications. By default,
40 a window with no background is used, causing all applications to repaint
42 However, the various options can be used to indicate that a solid background
43 (of any color) or the root window background should be used instead.
48 Use a white background. The screen just appears to flash quickly, and then
53 Use a black background (in effect, turning off all of the electron guns to
54 the tube). This can be somewhat disorienting as everything goes black for
58 .B \-solid \fIcolor\fP
59 Use a solid background of the specified color. Try green.
63 Use the root window background.
67 This is the default. All of the windows simply repaint.
70 .B \-geometry \fIWxH+X+Y\fP
71 Specifies the portion of the screen to be repainted; see \fIX(__miscmansuffix__)\fP.
74 .B \-display \fIdisplay\fP
75 This argument allows you to specify the server and screen to
76 refresh; see \fIX(__miscmansuffix__)\fP.
80 program uses the routine
81 .I XGetDefault(__libmansuffix__)
82 to read defaults, so its resource names are all capitalized.
85 .B Black\fP, \fBWhite\fP, \fBSolid\fP, \fBNone\fP, \fBRoot\fP
86 Determines what sort of window background to use.
90 Determines the area to refresh. Not very useful.
94 DISPLAY - To get default host and display number.
99 It should have just one default type for the background.
101 Jim Gettys, Digital Equipment Corp., MIT Project Athena