source: archive/x-config.xml@ fa91d2e

11.0 qt5new trunk
Last change on this file since fa91d2e was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 5 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 7.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="x-config">
9 <?dbhtml filename="xconfig.html"?>
10
11 <sect1info>
12 <date>$Date$</date>
13 </sect1info>
14
15 <title>Additional X Window System Configuration</title>
16
17 <para>Below you will find information on fine tuning the components
18 of the <application>X Window System</application>. The documentation
19 links are specifically for <application>XFree86</application>,
20 which has been retired in BLFS, however, the
21 information contained in those documents usually pertains to
22 <application>Xorg</application> as well. Detailed descriptions are also
23 located in the <filename>xorg.conf</filename> man page.</para>
24
25 <sect2 id='xinput'>
26 <title>Setting up X Input Devices</title>
27
28 <para condition="html" role="usernotes">User Notes:
29 <ulink url="&blfs-wiki;/XInputDevices"/></para>
30
31 <sect3 id='xkeyboard'>
32 <title>Keyboards</title>
33
34 <para>The following external links provide a good introduction
35 to setting up various keyboards.</para>
36
37 <para><ulink url="http://www.xfree86.org/current/XKB-Config.html">The
38 <application>XKB</application> Configuration Guide</ulink></para>
39
40 <para><ulink url="http://www.xfree86.org/current/XKB-Enhancing.html">How
41 to further enhance <application>XKB</application>
42 configuration</ulink></para>
43
44 </sect3>
45
46 <sect3 id='xmice'>
47 <title>Mice</title>
48
49 <para>Multi-button mice can be used to their full potential by mapping
50 the additional buttons to X button events. Wheel mice are a common example.
51 The ordinary ones contain two buttons, and a scroll wheel that doubles as
52 a third button. As far as <application>X</application> is concerned, there
53 are 5 buttons as it counts the 'scroll up' and 'scroll down' functions
54 (internally they are buttons). Here is an example 'InputDevice' section for
55 a typical PS/2 wheel mouse:</para>
56
57<screen><literal>Section "InputDevice"
58 Identifier "Mouse 0"
59 Driver "mouse"
60 Option "Device" "/dev/input/mice"
61 Option "Protocol" "IMPS/2"
62 Option "ZAxisMapping" "4 5"
63 Option "Buttons" "5"
64EndSection</literal></screen>
65
66 <para>Button assignments differ for every mouse type. On more exotic
67 mice, you may find that the rocker wheel buttons are 6 and 7. Simply
68 add those values to the <option>ZAxisMapping</option> option, and set
69 the <option>Buttons</option> option appropriately to enable side to
70 side scrolling. Additional information on button assignment can be
71 found in the following <application>XFree86</application>
72 document:</para>
73
74 <para><ulink url="http://www.xfree86.org/current/mouse.html">Mouse
75 Support in <application>XFree86</application></ulink></para>
76
77 </sect3>
78
79 </sect2>
80
81 <sect2 id='xdisplay'>
82 <title>Fine Tuning Display Settings</title>
83
84 <para condition="html" role="usernotes">User Notes:
85 <ulink url="&blfs-wiki;/xdisplay"/></para>
86
87 <sect3>
88 <title>The 'Monitor' Section</title>
89
90 <para>One or more monitor sections specify the characteristics of your
91 monitor(s). Usually, the setup program can probe your monitor and setup
92 a monitor properly, however, this does not always work. The most common
93 entries that need to be updated are <option>HorizSync</option> and
94 <option>VertRefresh</option>. If the configuration program does not set
95 these properly, you will notice a resolution much lower than desired.
96 The default <option>HorizSync</option> setting is 28-33kHz which is very
97 conservative. The default <option>VertRefresh</option> is 43-72Hz.
98 Consult your monitor documentation or search online for the proper
99 settings for your monitor.</para>
100
101 <para>It is also possible to control many detailed timing characteristics
102 of a monitor with a <option>Modeline</option> setting. Most users will
103 not need to do this, but details are in the man page referenced above.
104 </para>
105
106 <warning><para>Incorrect monitor settings can destroy your monitor or
107 even set it on fire! For most newer monitors, the result of overly
108 aggressive settings is a blank screen, but older monitors do not all have
109 built in safeguards.</para></warning>
110
111 <para>Other items that may be of interest in this section is the
112 <option>DPMS</option> and associated <option>StandbyTime</option>,
113 <option>SuspendTime</option>, and <option>OffTime</option> options.
114 These parameters control the energy saving features of your monitor. They
115 may also be controlled at runtime with the <command>xset</command> command
116 or via a graphical interface such as <application>KDE</application>'s
117 Control Center.</para>
118
119 <para>A typical monitor section will normally look like:</para>
120
121<screen><literal>Section "Monitor"
122 DisplaySize 400 300 # mm
123 Identifier "Monitor0"
124 VendorName "VSC"
125 ModelName "G810-2"
126 HorizSync 30.0 - 92.0
127 VertRefresh 50.0 - 180.0
128 Option "DPMS"
129 Option "StandbyTime" "10"
130 Option "SuspendTime" "20"
131 Option "OffTime" "30"
132EndSection</literal></screen>
133
134 </sect3>
135
136 <sect3>
137 <title>The 'Device' Section</title>
138
139 <para>This section basically controls your video card. The key entry is
140 the <option>Driver</option> setting. This can be a driver from the
141 <application>X</application> distribution you are using, from the kernel
142 source, or a proprietary driver for devices such as a Nvidia graphics
143 adaptor. The driver often is a kernel module or built into the kernel
144 itself, but there are also separate non-kernel components usually found
145 in the <filename
146 class='directory'>/usr/X11R6/lib/modules/drivers/</filename> directory.
147 These were either built with the <application>X</application> server or
148 installed via external (i.e., proprietary) programs.</para>
149
150 <para>There are many options for device drivers and most are specific to
151 the driver being used. Documentation for many drivers can be found at
152 the <ulink url="http://www.xfree86.org/current/manindex4.html">XFree86
153 Driver Manual Pages</ulink>.</para>
154
155 <para>A typical Device section will look like:</para>
156
157<screen><literal>Section "Device"
158 Identifier "Videocard0"
159 Driver "radeon"
160 VendorName "Videocard vendor"
161 BoardName "ATI Radeon 7500"
162EndSection</literal></screen>
163
164 </sect3>
165
166 </sect2>
167
168 <sect2 id='xlayouts'>
169 <title>Display Layouts</title>
170
171 <para condition="html" role="usernotes">User Notes:
172 <ulink url="&blfs-wiki;/xlayouts"/></para>
173
174 <para>Within the <application>X Window System</application> configuration
175 file there may be multiple layout sections like:</para>
176
177<screen><literal>Section "ServerLayout"
178 Identifier "X.org Configured"
179 Screen 0 "Screen0" 0 0
180 InputDevice "Mouse0" "CorePointer"
181 InputDevice "Keyboard0" "CoreKeyboard"
182EndSection</literal></screen>
183
184 <para>The default layout is the first, but if you have special needs,
185 you can create others with different configurations. The
186 <option>Identifier</option> line in each section is the key. Different
187 layouts can be created using different Screen and InputDevice sections.</para>
188
189 <para>After the configuration file is updated, an alternate configuration
190 can be specified on the <command>startx</command> line. For instance,
191 to start <application>X</application> with an alternate layout with an
192 Identifier of "layout2", use the following command line:</para>
193
194<screen><command>startx -- -layout layout2</command></screen>
195
196
197 </sect2>
198
199</sect1>
Note: See TracBrowser for help on using the repository browser.