source: archive/x-config.xml@ e3167158

10.0 10.1 11.0 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since e3167158 was e3167158, checked in by Bruce Dubbs <bdubbs@…>, 9 years ago

Cleanup VI. X + Window Managers

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10192 af4574ff-66df-0310-9fd7-8a98e5e911e0

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