More formatting of the Xorg config page. Only one text change:

"/GB" removed...

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@18705 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Pierre Labastie 2017-05-09 08:59:52 +00:00
parent 6da5593487
commit da4b5e0903

View File

@ -19,38 +19,51 @@
<primary sortas="g-configuring-xorg">Configuring Xorg</primary>
</indexterm>
<sect2 id='X11-testing' xreflabel="Testing Xorg">
<sect2 id='X11-testing' xreflabel="Testing Xorg">
<title>Testing Xorg</title>
<note><para>Before starting Xorg for the first time, is is useful to
rebuild the library cache by running <userinput>ldconfig</userinput>
as the <systemitem class="username">root</systemitem> user.</para></note>
<note>
<para>
Before starting Xorg for the first time, is is useful to
rebuild the library cache by running <userinput>ldconfig</userinput>
as the <systemitem class="username">root</systemitem> user.
</para>
</note>
<para>To test the <application>Xorg</application> installation, issue
<userinput>startx</userinput>. This command brings up a rudimentary window
manager called <emphasis>twm</emphasis> with three xterm windows and one
xclock window. The xterm window in the upper left is a login terminal and
running <emphasis>exit</emphasis> from this terminal will exit the
<application>X Window</application> session. The third xterm window may be
obscured on your system by the other two xterms.</para>
<para>
To test the <application>Xorg</application> installation, issue
<command>startx</command>. This command brings up a rudimentary window
manager called <emphasis>twm</emphasis> with three xterm windows and one
xclock window. The xterm window in the upper left is a login terminal and
running <emphasis>exit</emphasis> from this terminal will exit the
<application>X Window</application> session. The third xterm window may
be obscured on your system by the other two xterms.
</para>
<note><para>When testing <application>Xorg</application> with the
<application>twm</application> window manager, there will be several
warnings in the Xorg log file, <filename revision="sysv">
/var/log/Xorg.0.log</filename><filename revision="systemd">
$HOME/.local/share/xorg/Xorg.0.log</filename>,
about missing font files. In addition, there will be several warnings on
the text mode terminal (usually tty1) about missing fonts. These warnings
do not affect functionality, but can be removed if desired by installing
the <xref linkend="xorg7-legacy"/>.</para></note>
<note>
<para>
When testing <application>Xorg</application> with the
<application>twm</application> window manager, there will be several
warnings in the Xorg log file, <filename revision="sysv">
/var/log/Xorg.0.log</filename><filename revision="systemd">
$HOME/.local/share/xorg/Xorg.0.log</filename>, about missing font
files. In addition, there will be several warnings on the text mode
terminal (usually tty1) about missing fonts. These warnings do not
affect functionality, but can be removed if desired by installing
the <xref linkend="xorg7-legacy"/>.
</para>
</note>
<para>Generally, there is no specific configuration required for
<application>Xorg</application>, but customization is possible. For details
see <xref linkend='xconfig'/> below.</para>
<para>
Generally, there is no specific configuration required for
<application>Xorg</application>, but customization is possible. For
details, see <xref linkend='xconfig'/> below.
</para>
</sect2>
</sect2>
<sect2 role="configuration" id="checking-dri" xreflabel="Checking the DRI installation">
<sect2 role="configuration" id="checking-dri" xreflabel="Checking the DRI
installation">
<title>Checking the Direct Rendering Infrastructure (DRI)
Installation</title>
@ -163,10 +176,9 @@ OpenGL version string: 3.0 Mesa 10.4.5</computeroutput></screen>
be approximately the same as the monitor refresh rate.
</para>
</sect2>
</sect2>
<sect2 role="configuration" id="hybrid-graphics" xreflabel="Hybrid
Graphics">
<sect2 role="configuration" id="hybrid-graphics" xreflabel="Hybrid Graphics">
<title>Hybrid Graphics</title>
<para>
@ -199,24 +211,30 @@ OpenGL version string: 3.0 Mesa 10.4.5</computeroutput></screen>
<envar>DRI_PRIME=1</envar>, you will need to check your installation.
</para>
</sect2>
</sect2>
<sect2 role="configuration" id='xconfig'>
<title>Setting up Xorg Devices</title>
<para>For most hardware configurations, modern Xorg will automatically
get the server configuration correct without any user intervention. There
are, however, some cases where auto-configuration will be incorrect.
Following are some example manual configuration items that may be of use in
these instances.</para>
<para>
For most hardware configurations, modern Xorg will automatically
get the server configuration correct without any user intervention. There
are, however, some cases where auto-configuration will be incorrect.
Following are some example manual configuration items that may be of use
in these instances.
</para>
<sect3 id="xinput">
<title>Setting up X Input Devices</title>
<para>For most input devices, no additional configuration will be
necessary. This section is provided for informational purposes only.</para>
<title>Setting up X Input Devices</title>
<para>
For most input devices, no additional configuration will be
necessary. This section is provided for informational purposes only.
</para>
<para>A sample default XKB setup could look like the following (executed as
the <systemitem class="username">root</systemitem> user):</para>
<para>
A sample default XKB setup could look like the following (executed as
the <systemitem class="username">root</systemitem> user):
</para>
<screen role="root"><userinput>cat &gt; /etc/X11/xorg.conf.d/xkb-defaults.conf &lt;&lt; "EOF"
Section "InputClass"
@ -227,22 +245,24 @@ Section "InputClass"
EndSection
EOF</userinput></screen>
<para>
The <quote>XkbLayout</quote> line is an example for a French (AZERTY)
keyboard. Change it to your keyboard model. That line is not needed for
a QWERTY (US/GB) keyboard.
</para>
</sect3>
<para>
The <quote>XkbLayout</quote> line is an example for a French (AZERTY)
keyboard. Change it to your keyboard model. That line is not needed for
a QWERTY (US) keyboard.
</para>
</sect3>
<sect3 id="xdisplay">
<title>Fine Tuning Display Settings</title>
<sect3 id="xdisplay">
<title>Fine Tuning Display Settings</title>
<para>Again, with modern Xorg, little or no additional configuration is
necessary. If you should need extra options passed to your video driver,
for instance, you could use something like the following (again, executed as
the <systemitem class="username">root</systemitem> user):</para>
<para>
Again, with modern Xorg, little or no additional configuration is
necessary. If you should need extra options passed to your video driver,
for instance, you could use something like the following (again,
executed as the <systemitem class="username">root</systemitem> user):
</para>
<screen><userinput role="root">cat &gt; /etc/X11/xorg.conf.d/videocard-0.conf &lt;&lt; "EOF"
<screen role="root"><userinput>cat &gt; /etc/X11/xorg.conf.d/videocard-0.conf &lt;&lt; "EOF"
Section "Device"
Identifier "Videocard0"
Driver "radeon"
@ -252,11 +272,13 @@ Section "Device"
EndSection
EOF</userinput></screen>
<para>Another common setup is having multiple server layouts for use in
different environments. Though the server will automatically detect the
presence of another monitor, it may get the order incorrect:</para>
<para>
Another common setup is having multiple server layouts for use in
different environments. Though the server will automatically detect the
presence of another monitor, it may get the order incorrect:
</para>
<screen><userinput role="root">cat &gt; /etc/X11/xorg.conf.d/server-layout.conf &lt;&lt; "EOF"
<screen role="root"><userinput>cat &gt; /etc/X11/xorg.conf.d/server-layout.conf &lt;&lt; "EOF"
Section "ServerLayout"
Identifier "DefaultLayout"
Screen 0 "Screen0" 0 0
@ -265,6 +287,6 @@ Section "ServerLayout"
EndSection
EOF</userinput></screen>
</sect3>
</sect3>
</sect2>
</sect1>