diff options
Diffstat (limited to '')
-rw-r--r-- | upstream/opensuse-tumbleweed/man1/xsetroot.1 | 123 |
1 files changed, 123 insertions, 0 deletions
diff --git a/upstream/opensuse-tumbleweed/man1/xsetroot.1 b/upstream/opensuse-tumbleweed/man1/xsetroot.1 new file mode 100644 index 00000000..016a03c8 --- /dev/null +++ b/upstream/opensuse-tumbleweed/man1/xsetroot.1 @@ -0,0 +1,123 @@ +.\" Copyright 1988, 1998 The Open Group +.\" +.\" 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. +.\" +.\" The above copyright notice and this permission notice shall be included +.\" in all copies or substantial portions of the Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR +.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +.\" OTHER DEALINGS IN THE SOFTWARE. +.\" +.\" Except as contained in this notice, the name of The Open Group shall +.\" not be used in advertising or otherwise to promote the sale, use or +.\" other dealings in this Software without prior written authorization +.\" from The Open Group. +.\" +.TH XSETROOT 1 "xsetroot 1.1.3" "X Version 11" +.SH NAME +xsetroot \- root window parameter setting utility for X +.SH SYNOPSIS +.B xsetroot +[-help] +[-version] +[-def] +[-display \fIdisplay\fP] +[-cursor \fIcursorfile maskfile\fP] +[-cursor_name \fIcursorfontname\fP] +[-xcf \fIcursorfile\fP \fIcursorsize\fP] +[-bitmap \fIfilename\fP +| -mod \fIx y\fP +| -gray +| -grey +| -solid \fIcolor\fP] +[-bg \fIcolor\fP] +[-fg \fIcolor\fP] +[-rv] +[-name \fIstring\fP] +[-d \fIdisplay\fP] +.SH DESCRIPTION +The +.I xsetroot +program +allows you to tailor the appearance of the background ("root") +window on a workstation display running X. Normally, you experiment with +.I xsetroot +until you find a personalized look that you like, then put the +.I xsetroot +command that produces it into your X startup file. +If no options are specified, or if +.I -def +is specified, the window is reset to its default state. The +.I -def +option 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 background color/tiling changing options +(-solid, -gray, -grey, -bitmap, and -mod) may be specified at a time. +.SH OPTIONS +.PP +The various options are as follows: +.IP "\fB-help\fP" +Print a usage message and exit. +.IP "\fB-version\fP" +Print a version message and exit. +.IP "\fB-def, -default\fP" +Reset unspecified attributes to the default values. (Restores the background +to the familiar gray mesh and the cursor to the hollow x shape.) +.IP "\fB-cursor\fP \fIcursorfile\fP \fImaskfile\fP" +This lets you change the pointer cursor to whatever +you want when the pointer cursor is outside of any window. +Cursor and mask files are bitmaps (little pictures), and can be made with the +.I bitmap(1) +program. You probably want the mask file to be all black until you +get used to the way masks work. +.IP "\fB-cursor_name\fP \fIcursorfontname\fP" +This lets you change the pointer cursor to one of the standard +cursors from the cursor font. Refer to appendix B of the X protocol for +the names (except that the XC_ prefix is elided for this option). +.IP "\fB-xcf\fP \fIcursorfile\fP \fIcursorsize\fP" +This lets you change the pointer cursor to one loaded from an Xcursor file +as defined by libXcursor, at the specified size. +.IP "\fB-bitmap\fP \fIfilename\fP" +Use the bitmap specified in the file to set the window pattern. You can +make your own bitmap files (little pictures) using the +.I bitmap(1) +program. The entire background will be made up of repeated "tiles" of +the bitmap. +.IP "\fB-mod\fP \fIx\fP \fIy\fP" +This is used if you want a plaid-like grid pattern on your screen. +x and y are integers ranging from 1 to 16. Try the different combinations. +Zero and negative numbers are taken as 1. +.IP "\fB-gray, -grey\fP" +Make the entire background gray (Easier on the eyes). +.IP "\fB-bg, -background\fP \fIcolor\fP" +Use ``color'' as the background color. +.IP "\fB-fg, -foreground\fP \fIcolor\fP" +Use ``color'' as the foreground color. Foreground and background colors +are meaningful only in combination with -cursor, -bitmap, or -mod. +.IP "\fB-rv, -reverse\fP" +This exchanges the foreground and background colors. Normally the foreground +color is black and the background color is white. +.IP "\fB-solid\fP \fIcolor\fP" +This sets the background of the root window to the specified color. This +option is only useful on color servers. +.IP "\fB-name\fP \fIstring\fP" +Set the name of the root window to ``string''. There is no default value. +Usually a name is assigned to a window so that the +window manager can use a text representation when the window is iconified. +This option is unused since you can't iconify the background. +.IP "\fB-d, -display\fP \fIdisplay\fP" +Specifies the server to connect to; see \fIX(7)\fP. +.SH "SEE ALSO" +X(7), xset(1), xrdb(1), Xcursor(3) +.SH AUTHOR +Mark Lillibridge, MIT Project Athena |