Return to xsetroot.man CVS log

Up to [Research Unix] / researchv9 / X11 / src / X.V11R1 / clients / xsetroot

Annotation of researchv9/X11/src/X.V11R1/clients/xsetroot/xsetroot.man, revision 1.1.1.1

1.1       root        1: .TH XSETROOT 1 "12 June 1987" "X Version 11"
                      2: .SH NAME
                      3: xsetroot \- X window system root window parameter setting utility
                      4: .SH SYNOPSIS
                      5: .B xsetroot
                      6: [ -help ]
                      7: [ -def ]
                      8: [-cursor
                      9: .I cursorfile mask\ file
                     10: ]
                     11: [-bitmap
                     12: .I filename
                     13: ]
                     14: [-mod
                     15: .I x y
                     16: ]
                     17: [ -gray ]
                     18: [ -grey ]
                     19: [-fg
                     20: .I color
                     21: ]
                     22: [-bg
                     23: .I color
                     24: ]
                     25: [ -rv ]
                     26: [-solid
                     27: .I color
                     28: ]
                     29: [-name
                     30: .I string
                     31: ]
                     32: [
                     33: .I host : display
                     34: ]
                     35: .SH DESCRIPTION
                     36: .I Xsetroot
                     37: allows you to tailor the appearance of the background ("root")
                     38: window on a workstation display running X.  Normally, you experiment with
                     39: .I xsetroot
                     40: until you find a personalized look that you like, then put the
                     41: .I xsetroot
                     42: command that produces it into your .login file.
                     43: If no options are specified, or if
                     44: .I -def
                     45: is specified, the window is reset to its default state.
                     46: .I -def
                     47: can be specified along with other options and only the non-specified
                     48: characteristics will be reset to the default state.
                     49: .PP
                     50: Only one of the background color/tileing changing options (
                     51: .IR -solid ,
                     52: .IR -gray ,
                     53: .IR -grey ,
                     54: .IR -bitmap
                     55: and
                     56: .IR -mod )
                     57: may be specified at a time.
                     58: 
                     59: .PP
                     60: The various options are as follows:
                     61: .IP -help
                     62: Print a usage message and exit.
                     63: .IP -def
                     64: Reset unspecified attributes to the default values.  (Restores the background
                     65: to the familiar gray mesh and the cursor to the hollow x shape.)
                     66: .IP "-cursor cursorfile maskfile"
                     67: This lets you change the mouse cursor to whatever
                     68: you want when the mouse cursor is outside of any window.
                     69: Cursor and mask files are bitmaps (little pictures) made with the
                     70: .I bitmap(1)
                     71: program.  You probably want the mask file to be all black until you
                     72: get used to the way masks work.
                     73: .IP "-bitmap filename"
                     74: Use the bitmap specified in the file to set the window pattern.  You can
                     75: make your own bitmap files (little pictures) using the
                     76: .I bitmap(1)
                     77: program.  The entire background will be made up of repeated "tiles" of
                     78: the bitmap.
                     79: .IP "-mod x y"
                     80: This is used if you want a plaid-like grid pattern on your screen.
                     81: x and y are integers ranging from 1 to 16.  Try the different combinations.
                     82: Zero and negative numbers are taken as 1.
                     83: .IP -gray
                     84: Make the entire background gray.  (Easier on the eyes.)
                     85: .IP -grey
                     86: Make the entire background grey.
                     87: .IP "-fg color"
                     88: Use ``color'' as the foreground color when setting attributes.
                     89: .IP "-bg color"
                     90: Use ``color'' as the background color when setting attributes.
                     91: .IP -rv
                     92: This exchanges the foreground and background colors.  Normally the foreground
                     93: color is black and the background color is white.
                     94: This option can go with any of the above.
                     95: .IP "-solid color"
                     96: Set the window color to ``color''.
                     97: .IP "-name string"
                     98: Set the name of the root window to ``string''.  There is no default value.
                     99: Usually a name is assigned to a window so that the
                    100: window manager can use a text representation when the window is iconified.
                    101: This option is unused since you can't iconify the background.
                    102: .IP "host:display"
                    103: Defaults to the DISPLAY environment variable, which is usually set
                    104: to be one's own workstation host, display 0.  
                    105: .SH "SEE ALSO"
                    106: xset(1), X(1)
                    107: .SH AUTHOR
                    108: Mark Lillibridge, MIT Project Athena
                    109: .br
                    110: Copyright (c) 1987 by Massachusetts Institute of Technology.
                    111: .br
                    112: See \fIX(1)\fP for a full copyright notice.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.