|
|
1.1 root 1: .TH XSET 1 "1 August 1987" "X Version 11"
2: .SH NAME
3: xset - X window system user setup program
4: .SH SYNOPSIS
5: .B xset
6: option [ option ] [ \fIhost\fP:\fIdisplay\fP ]
7: .SH DESCRIPTION
8: This program is used to set various user preference options of the display.
9: the \fBb\fP option controls bell volume, pitch and duration,
10: The \fBc\fP option controls key click,
11: the \fBfp\fP option sets the font path,
12: the \fBled\fP option controls the keyboard LEDs,
13: the \fBm\fP option controls the mouse parameters,
14: the \fBp\fP option controls pixel color values,
15: the \fBr\fP option controls the auto repeat,
16: the \fBs\fP option lets you set the screen saver parameters,
17: and the \fBq\fP option gives you information on the current settings.
18: Most of these can be preceded with a \fB-\fP to disable the feature,
19: or followed by \fBon\fP or \fBoff\fP if you prefer. They can also be
20: given with no further specifications, to reset the system defaults.
21: For example: ``xset c on'' turns on keyclick;
22: ``xset -r'' would turn off autorepeat;
23: ``xset b'' sets the bell volume, pitch and duration to the defaults.
24: .PP
25: The bell option accepts up to three numerical parameters. If none are
26: given, the system defaults will be used. If only one is given, the
27: bell volume will be set to that value, as a percentage of its maximum.
28: Likewise, the second parameter specifies the bell pitch, in hertz, and
29: the third one specifies the duration in milliseconds. Note that not
30: all hardware can vary the bell characteristics. The X server will set
31: the characteristics of the bell as closely as it can to the user's
32: specifications.
33: .PP
34: The keyclick option also takes an optional value from 0 to 100 to
35: indicate volume, as a percentage of maximum. The X server will set
36: the volume to the nearest value that the hardware can support.
37: .PP
38: The font path option should be followed by a comma-separated list of
39: (operating system dependent) directories. To restore the default
40: font path, use \fBfp default\fP.
41: .PP
42: The LED controls are for turning on or off one or all of the LEDs.
43: A common LED which can be controlled is the ``Caps Lock'' LED. ``xset
44: led 3'' would turn led #3 on. ``xset -led 3'' would turn it off.
45: The particular LED values may refer to different LEDs on different
46: hardware. Omitting the LED number in these commands would turn all of
47: the LEDs on or off, respectively.
48: .PP
49: The parameters for the mouse are ``acceleration'' and ``threshold''.
50: The mouse, or whatever pointer the machine is connected to, will go
51: ``acceleration'' times as fast when it travels more than ``threshold''
52: pixels in a short time. This way, the mouse can be used for precise
53: alignment when it is moved slowly, yet it can be set to travel across
54: the screen in a flick of the wrist when desired. One or both
55: parameters for the ``m'' option can be omitted, but if only one is
56: given, it will be interpreted as the acceleration.
57: .PP
58: The parameters for a pixel are the color map entry number in decimal,
59: and a color specification. The root window colors can be changed by
60: altering entries 0 and 1. The map entry must not be a read-only color,
61: or an error will result.
62: .PP
63: The parameters for the screen saver function determines how long the
64: server must be inactive for screen saving to go on, and the period
65: to change the background pattern to avoid burn in.
66: The arguments are specified in seconds. ``xset s blank'' sets the
67: preference to blank the video (if the hardware can do so) rather than
68: display a background pattern. ``xset s noblank'' sets the
69: preference to display a pattern rather than blank the video.
70: .PP
71: These settings will be reset to default values when you log out.
72: .PP
73: Note that not all X implementations are guaranteed to honor all of these
74: options.
75: .SH AUTHOR
76: Copyright (c) 1985, 1986, 1987 by Massachusetts Institute of Technology.
77: .br
78: See \fIX(1)\fP for a full copyright notice.
79: .br
80: Bob Scheifler, MIT Laboratory for Computer Science
81: David Krikorian, MIT Project Athena (X11 version)
82: .SH "SEE ALSO"
83: X(8C)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.