jmsellens@watdragon.waterloo.edu ("John M. Sellens") (03/06/87)
I couldn't find a man page for xsetroot(1) on my X V10R4 tape.
So I put this one together.
John Sellens -- Logic Programming and Artificial Intelligence Group
{decvax|utzoo|ihnp4|allegra|clyde}!watmath!watdragon!jmsellens
jmsellens@dragon.waterloo.{edu,CDN} jsellens@watmta.BITNET
jmsellens%dragon@waterloo.csnet
.TH XSETROOT 1 "15 November 1985" "X Version 10"
.SH NAME
xsetroot \- X window system root window parameter setting utility
.SH SYNOPSIS
.B xsetroot
.RI [ -help ]
.RI [ -def ]
.RI [ "-fg <colour>" ]
.RI [ "-bg <colour>" ]
.RI [ -invert ]
.RI [ "-name <string>" ]
.RI [ "-cursor <cursor file> <mask file>" ]
.RI [ "-solid <colour>" ]
.RI [ -gray ]
.RI [ -grey ]
.RI [ "-bitmap <file>" ]
.RI [ "-mod <x> <y>" ]
.RI [ host : display ]
.SH DESCRIPTION
.I Xsetroot
allows you to set the characteristics of the ``root'' or background
window on an X server. If no options are specified, or if
.I -def
is specified, the window is reset to its default state.
.I -def
can be specified along with other options and only the non-specified
characteristics will be reset to the default state.
.PP
Only one of the colour changing options (
.IR -solid ,
.IR -gray ,
.IR -grey ,
.IR -bitmap
and
.IR -mod )
may be specified at a time.
.PP
The various options are as follows:
.IP -help
Print a usage message and exit.
.IP -def
Reset unspecified attributes to the default values.
.IP "-fg <colour>"
Use ``<colour>'' as the foreground colour when setting attributes.
.IP "-bg <colour>"
Use ``<colour>'' as the background colour when setting attributes.
.IP -invert
Swap the values of the foreground and background colours when
setting attributes.
.IP "-name <string>"
Set the name of the root window to ``<string>''. The default value is
``X Root Window''.
.IP "-cursor <cursor file> <mask file>"
Use the cursor and mask in the specified files as the root window cursor.
.IP "-solid <colour>"
Set the window colour to ``<colour>''.
.IP -gray
Set the window colour to grey.
.IP -grey
Set the window colour to gray.
.IP "-bitmap <file>"
Use the bitmap specified in the file to set the window pattern.
.IP "-mod <x> <y>"
Use <x> and <y> to set a ``modula'' pattern (whatever that is) for
the window.
.SH AUTHOR
Copyright (c) 1985, 1986 by Massachusetts Institute of Technology.
.br
See \fIX(1)\fP for a full copyright notice.
.br
Tony Della Fera, DEC
.SH "SEE ALSO"
xset(1), X(8C)