xrefresh(1X)                                         xrefresh(1X)



NAME
     xrefresh - refreshes all or part of an X screen

SYNOPSIS
     xrefresh [-white] [-black] [-solid color] [-root]
     [-none] [-geometry geometry] [-display display]

DESCRIPTION
     xrefresh is a simple X command that causes all or part of
     your screen to be refreshed.  The xrefresh command maps a
     window on top of the desired area of the screen and immedi-
     ately unmaps it, causing refresh events to be sent to all
     applications.  By default, a window with no background is
     used, causing all applications to refresh smoothly.  Howev-
     er, the various options can be used to indicate that a solid
     background (of any color) or the background window should be
     used instead.

   Options
     The xrefresh command accepts these options:

     -black  Refreshes with a black background.  This can be
             somewhat disorienting as everything goes black for a
             moment.

     -display display
             Allows you to specify the server and screen to re-
             fresh.  See X(1X) for details.

     -geometry geometry
             Specifies the portion of the screen to be refreshed.
             See X(1X) for details.

     -none   Specifies that all windows are to be refreshed.
             This is the default.

     -root   Refreshes the background window.

     -solid color
             Refreshes with a solid background of the specified
             color.  Green is recommended.

     -white  Refreshes with a white background.  The screen ap-
             pears to flash quickly and then is refreshed.

   X defaults
     The xrefresh command uses the Xlib routine XGetDefault(3X)
     to read defaults, so its resource names are capitalized.
     The resources Black, White, Solid, None, and Root determine
     what sort of window background to use.





November, 1990                                                  1

xrefresh(1X)                                         xrefresh(1X)



     The resource name Geometry determines the area to refresh.

   Environment variables
     The xrefresh command uses this environment variable:

     DISPLAY Specifies the default host, display number, and
             screen.

LIMITATIONS
     The xrefresh command should have just one default type for
     the background.

NOTES
     Copyright 1988, Massachusetts Institute of Technology.
     See X(1X) for a full statement of rights and permissions.

     Author: Jim Gettys, Digital Equipment Corporation and MIT
     Project Athena

SEE ALSO
     X(1X)


































2                                                  November, 1990