Author: manuel
Date: 2005-05-19 11:28:20 -0600 (Thu, 19 May 2005)
New Revision: 4368

Modified:
   trunk/BOOK/x/installing/x-setup.xml
Log:
Tagged x-setup.xml

Modified: trunk/BOOK/x/installing/x-setup.xml
===================================================================
--- trunk/BOOK/x/installing/x-setup.xml 2005-05-19 16:45:40 UTC (rev 4367)
+++ trunk/BOOK/x/installing/x-setup.xml 2005-05-19 17:28:20 UTC (rev 4368)
@@ -6,357 +6,396 @@
 ]>
 
 <sect1 id="x-setup">
-<sect1info>
-<othername>$LastChangedBy$</othername>
-<date>$Date$</date>
-</sect1info>
-<?dbhtml filename="xfree86-setup.html"?>
-<title>X Window System Components</title>
+  <?dbhtml filename="xfree86-setup.html"?>
 
-<sect2 id='dri'>
-<title>Checking Direct Rendering Infrastructure (<acronym>DRI</acronym>) 
-Installation</title>
+  <sect1info>
+  <othername>$LastChangedBy$</othername>
+  <date>$Date$</date>
+  </sect1info>
 
-<indexterm zone="x-setup dri">
-  <primary sortas="g-DRI">DRI</primary>
-</indexterm>
+  <title>X Window System Components</title>
 
-<para><acronym>DRI</acronym> is a framework for allowing software to access 
-graphics hardware in a safe and efficient manner. It is installed in
-<application>X</application> by default if you have a supported video card. 
-To check if <acronym>DRI</acronym> is installed properly, check the log file 
-<filename>/var/log/XFree86.0.log</filename> or
-<filename>/var/log/Xorg.0.log</filename> for statements like:</para>
+  <sect2 id='dri'>
+    <title>Checking Direct Rendering Infrastructure (DRI) Installation</title>
 
-<screen>(II) R128(0): Direct rendering enabled</screen>
+    <indexterm zone="x-setup dri">
+      <primary sortas="g-DRI">DRI</primary>
+    </indexterm>
 
-<para>From an <command>xterm</command>, run <command>glxinfo</command> and 
-look for the phrase:</para> 
+    <para>DRI is a framework for allowing software to access graphics hardware
+    in a safe and efficient manner. It is installed in
+    <application>X</application> by default if you have a supported video card.
+    To check if DRI is installed properly, check the log file
+    <filename>/var/log/XFree86.0.log</filename> or
+    <filename>/var/log/Xorg.0.log</filename> for statements like:</para>
 
+<screen><literal>(II) R128(0): Direct rendering enabled</literal></screen>
+
+    <para>From an <command>xterm</command>, run <command>glxinfo</command>
+    and look for the phrase:</para>
+
 <screen><computeroutput>direct rendering: Yes</computeroutput></screen>
 
-<para>You can also run the test program <command>glxgears</command>.
-This program brings up a window with three gears turning.  The
-<command>xterm</command> will display how many frames were drawn every
-five seconds, so this is a reasonable benchmark.  The window is scalable, and
-the frames drawn per second is highly dependent on the size of
-the window.</para>
+    <para>You can also run the test program <command>glxgears</command>.
+    This program brings up a window with three gears turning.  The
+    <command>xterm</command> will display how many frames were drawn every
+    five seconds, so this is a reasonable benchmark.  The window is scalable,
+    and the frames drawn per second is highly dependent on the size of
+    the window.</para>
 
-<indexterm zone="x-setup dri">
-  <primary sortas="b-glxgears">glxgears</primary>
-</indexterm>
+    <indexterm zone="x-setup dri">
+      <primary sortas="b-glxgears">glxgears</primary>
+    </indexterm>
 
-<indexterm zone="x-setup dri">
-  <primary sortas="b-glxinfo">glxinfo</primary>
-</indexterm>
+    <indexterm zone="x-setup dri">
+      <primary sortas="b-glxinfo">glxinfo</primary>
+    </indexterm>
 
-<para>For troubleshooting problems, check the <acronym>DRI</acronym> Users 
-Guide at 
-<ulink url="http://dri.sourceforge.net/doc/DRIuserguide.html"/>.</para>
+    <para>For troubleshooting problems, check the DRI Users Guide at
+    <ulink url="http://dri.sourceforge.net/doc/DRIuserguide.html"/>.</para>
 
-</sect2>
+  </sect2>
 
 <!-- ================================================== -->
 
-<sect2 id='fonts'>
-<title>Adding <application>TrueType</application> fonts to
-<application>X</application></title>
+  <sect2 id='fonts'>
+    <title>Adding TrueType Fonts to X</title>
 
-<para><application>TrueType</application> font support is built into
-<application>X</application>.  The following items need to 
-be completed to make the fonts available. Each item is described in 
-detail after the list.</para>
+    <para><application>TrueType</application> font support is built into
+    <application>X</application>. The following items need to be
+    completed to make the fonts available. Each item is described in
+    detail after the list.</para>
 
-<indexterm zone="x-setup fonts">
-  <primary sortas="g-truetype">TrueType</primary>
-</indexterm>
+    <indexterm zone="x-setup fonts">
+      <primary sortas="g-truetype">TrueType</primary>
+    </indexterm>
 
-<itemizedlist>
-<listitem><para>Establish a directory for the fonts and move any 
-<application>TrueType</application> fonts you want into that directory. 
-Ensure that any fonts you install are world readable. Incorrect
-permissions on fonts have been known to cause problems with some 
-<application>X</application> applications.</para></listitem>
+    <itemizedlist>
+      <listitem>
+        <para>Establish a directory for the fonts and move any
+        <application>TrueType</application> fonts you want into that
+        directory. Ensure that any fonts you install are world readable.
+        Incorrect permissions on fonts have been known to cause problems
+        with some <application>X</application> applications.</para>
+      </listitem>
+      <listitem>
+        <para>Download the fonts.</para>
+      </listitem>
+      <listitem>
+        <para>Create the <filename>fonts.scale</filename> and
+        <filename>fonts.dir</filename> files in the
+        <application>TrueType</application> font directory.</para>
+      </listitem>
+      <listitem>
+        <para>Ensure the <application>TrueType</application> module is
+        loaded in the <filename>XF86Config</filename> or
+        <filename>xorg.conf</filename>.</para>
+      </listitem>
+      <listitem>
+        <para>Ensure the <option>FontPath</option> in
+        <filename>XF86Config</filename> or <filename>xorg.conf</filename>
+        contains the <application>TrueType</application> font
+        directory.</para>
+      </listitem>
+      <listitem>
+        <para>Update the font cache files</para>
+      </listitem>
+    </itemizedlist>
 
-<listitem><para>Download the fonts.</para></listitem>
+    <indexterm zone="x-setup fonts">
+      <primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary>
+    </indexterm>
 
-<listitem><para>Create the <filename>fonts.scale</filename> and 
-<filename>fonts.dir</filename> files in the 
-<application>TrueType</application> font 
-directory.</para></listitem>
+    <indexterm zone="x-setup fonts">
+      <primary sortas="e-etc-X11-XF86Config">/etc/X11/XF86Config</primary>
+    </indexterm>
 
-<listitem><para>Ensure the <application>TrueType</application> module is 
-loaded in the <filename>XF86Config</filename> or 
-<filename>xorg.conf</filename>.</para></listitem>
+    <sect3>
+      <title>Establish a TrueType Font Directory</title>
 
-<listitem><para>Ensure the <parameter>FontPath</parameter> in 
-<filename>XF86Config</filename> or <filename>xorg.conf</filename> contains the
-<application>TrueType</application> font directory.</para></listitem>
+      <para>The build of <application>X</application> as given above
+      automatically creates a <application>TrueType</application> font
+      directory: <filename
+      class="directory">/usr/X11R6/lib/X11/fonts/TTF</filename>. This
+      directory already has some <application>TrueType</application>
+      fonts and is set up correctly. If this directory is satisfactory,
+      copy any other <application>TrueType</application> fonts you want
+      into that directory. If not, create a new directory, preferably
+      in the <filename
+      class="directory">/usr/X11R6/lib/X11/fonts/</filename> directory
+      and put your <application>TrueType</application> fonts there.</para>
 
-<listitem><para>Update the font cache files</para></listitem>
-</itemizedlist>
+    </sect3>
 
-<indexterm zone="x-setup fonts">
-  <primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary>
-</indexterm>
+    <sect3>
+      <title>Download the Fonts</title>
 
-<indexterm zone="x-setup fonts">
-  <primary sortas="e-etc-X11-XF86Config">/etc/X11/XF86Config</primary>
-</indexterm>
+      <para>There are two known high quality free font resources:
+      <ulink url="ftp://ftp.gnu.org/savannah/files/freefont/"/> and
+      <ulink url="http://corefonts.sourceforge.net/"/>. Copy the fonts
+      (files with the <filename>.ttf</filename> suffix) to the directory
+      you've just created.</para>
 
-<sect3><title>Establish a <application>TrueType</application> font 
-directory</title>
+    </sect3>
 
-<para>The build of <application>X</application> as given above automatically 
-creates a <application>TrueType</application> font directory: 
-<filename class="directory">/usr/X11R6/lib/X11/fonts/TTF</filename>. This 
-directory already has some <application>TrueType</application> fonts and is 
-set up correctly. If this directory is satisfactory, copy any other 
-<application>TrueType</application> fonts you want into that directory. If 
-not, create a new directory, preferably in the 
-<filename class="directory">/usr/X11R6/lib/X11/fonts/</filename> directory and 
-put your <application>TrueType</application> fonts there.</para>
-</sect3>
+    <sect3 id="fonts-scale-dir">
+      <title>Create 'fonts.scale' and 'fonts.dir'</title>
 
-<sect3><title>Download the fonts</title>
+      <indexterm zone="x-setup fonts-scale-dir">
+        <primary sortas="g-fonts.scale">fonts.scale</primary>
+      </indexterm>
 
-<para>There are two known high quality free font resources:
-<ulink url="ftp://ftp.gnu.org/savannah/files/freefont/"/> and 
-<ulink url="http://corefonts.sourceforge.net/"/>. Copy the fonts (files with 
-the <filename>.ttf</filename> suffix) to the directory you've just
-created.</para>
-    
-</sect3>
+      <indexterm zone="x-setup fonts-scale-dir">
+        <primary sortas="g-fonts.dir">fonts.dir</primary>
+      </indexterm>
 
-<sect3 id="fonts-scale-dir"><title>Create <filename>fonts.scale</filename> and 
-<filename>fonts.dir</filename></title>
-<indexterm zone="x-setup fonts-scale-dir">
-  <primary sortas="g-fonts.scale">fonts.scale</primary>
-</indexterm>
-<indexterm zone="x-setup fonts-scale-dir">
-  <primary sortas="g-fonts.dir">fonts.dir</primary>
-</indexterm>
+      <para>Now change to the directory where you have your
+      <application>TrueType</application> fonts and run:</para>
 
-<para>Now change to the directory where you have your
-<application>TrueType</application> fonts and run:
-<screen><userinput><command>mkfontscale &amp;&amp;
-mkfontdir</command></userinput></screen></para>
-<indexterm zone="x-setup fonts-scale-dir">
-  <primary sortas="b-mkfontscale">mkfontscale</primary>
-</indexterm>
-<indexterm zone="x-setup fonts-scale-dir">
-  <primary sortas="b-mkfontdir">mkfontdir</primary>
-</indexterm>
-</sect3>
+<screen role="root"><userinput>mkfontscale &amp;&amp;
+mkfontdir</userinput></screen>
 
-<sect3><title>Ensure <application>TrueType</application> is loaded in 
-<filename>XF86Config</filename> or <filename>xorg.conf</filename></title> 
-<para>The "Module" section should look like:
-<screen>Section "Module"
-        ...
-        Load  "freetype"
-        ...
-EndSection</screen></para>
-</sect3>
+      <indexterm zone="x-setup fonts-scale-dir">
+        <primary sortas="b-mkfontscale">mkfontscale</primary>
+      </indexterm>
 
-<sect3><title>Ensure the <parameter>FontPath</parameter> in
-<filename>XF86Config</filename> or <filename>xorg.conf</filename> points to the
-<application>TrueType</application> font directory</title>
-<para>The "Files" section should look like:
-<screen>Section "Files"
-        ...
-        FontPath 
"/usr/X11R6/lib/X11/fonts/<replaceable>[TrueTypeDir]</replaceable>/"
-        ...
-EndSection</screen></para>
-</sect3>
+      <indexterm zone="x-setup fonts-scale-dir">
+        <primary sortas="b-mkfontdir">mkfontdir</primary>
+      </indexterm>
 
-<sect3><title>Update the font cache files</title> 
+    </sect3>
 
-<para>Ensure you have the following directory entries in
-<filename>/etc/fonts/local.conf</filename>, inside the fontconfig
-tags. Create <filename>/etc/fonts/local.conf</filename> using the 
-following commands:</para>
+    <sect3>
+      <title>Ensure TrueType is Loaded in 'XF86Config' or 'xorg.conf'</title>
 
-<indexterm zone="x-setup fonts">
-  <primary sortas="e-etc-fonts-local.conf">/etc/fonts/local.conf</primary>
-</indexterm>
+      <para>The "Module" section should look like:</para>
 
-<screen><userinput><command>cat &gt; /etc/fonts/local.conf &lt;&lt; 
"EOF"</command>
-&lt;?xml version="1.0"?&gt;
+<screen><literal>Section "Module"
+    ...
+    Load  "freetype"
+    ...
+EndSection</literal></screen>
+
+    </sect3>
+
+    <sect3>
+      <title>Ensure the FontPath in 'XF86Config' or 'xorg.conf' Points to the
+      TrueType Font Directory</title>
+
+      <para>The "Files" section should look like:</para>
+
+<screen><literal>Section "Files"
+    ...
+    FontPath 
"/usr/X11R6/lib/X11/fonts/<replaceable>[TrueTypeDir]</replaceable>/"
+    ...
+EndSection</literal></screen>
+
+    </sect3>
+
+    <sect3>
+      <title>Update the Font Cache Files</title>
+
+      <para>Ensure you have the following directory entries in
+      <filename>/etc/fonts/local.conf</filename>, inside the fontconfig
+      tags. Create <filename>/etc/fonts/local.conf</filename> using the
+      following commands:</para>
+
+      <indexterm zone="x-setup fonts">
+        <primary 
sortas="e-etc-fonts-local.conf">/etc/fonts/local.conf</primary>
+      </indexterm>
+
+<screen role="root"><userinput>cat &gt; /etc/fonts/local.conf &lt;&lt; "EOF"
+<literal>&lt;?xml version="1.0"?&gt;
 &lt;!DOCTYPE fontconfig SYSTEM "fonts.dtd"&gt;
 &lt;!-- /etc/fonts/local.conf file for local customizations --&gt;
 
 &lt;fontconfig&gt;
 &lt;dir&gt;/usr/X11R6/lib/X11/fonts/TTF&lt;/dir&gt;
 &lt;dir&gt;/usr/X11R6/lib/X11/fonts/Type1&lt;/dir&gt;
-&lt;/fontconfig&gt;
+&lt;/fontconfig&gt;</literal>
 
-<command>EOF</command></userinput></screen>
+EOF</userinput></screen>
 
-<!-- 
+
+<!--
 <screen><userinput><command>sed -i -e '/^&lt;\/fontconfig&gt;/i\
 &lt;dir&gt;/usr/X11R6/lib/X11/fonts/TTF&lt;/dir&gt;\
 &lt;dir&gt;/usr/X11R6/lib/X11/fonts/Type1&lt;/dir&gt;' 
/etc/fonts/local.conf</command></userinput></screen>
  -->
 
-<para>The <command>fc-cache</command> program will automatically search
-the above directories and all subdirectories for needed fonts.</para>
-    
-<para>Finally, to update all the font cache files, run</para>
+      <para>The <command>fc-cache</command> program will automatically
+      search the above directories and all subdirectories for needed
+      fonts.</para>
 
-<screen><userinput><command>fc-cache</command></userinput></screen>
+      <para>Finally, to update all the font cache files, run</para>
 
-<indexterm zone="x-setup fonts">
-  <primary sortas="b-fc-cache">fc-cache</primary>
-</indexterm>
+<screen role="root"><userinput>fc-cache</userinput></screen>
 
-<para><application>X</application> will now be able to use
-<application>TrueType</application> fonts when it is restarted.
-You can check to see if the new fonts are available with the
-<command>xlsfonts</command>  or <command>xfontsel</command> 
-program.</para>
+      <indexterm zone="x-setup fonts">
+        <primary sortas="b-fc-cache">fc-cache</primary>
+      </indexterm>
 
-<note><para>You should rerun <command>mkfontscale</command> and  
-<command>mkfontdir</command> any time you add or delete
-<application>TrueType</application> fonts.
-You should also rerun <command>fc-cache</command> each time
-you add or remove any fonts.</para></note>
+      <para><application>X</application> will now be able to use
+      <application>TrueType</application> fonts when it is restarted.
+      You can check to see if the new fonts are available with the
+      <command>xlsfonts</command>  or <command>xfontsel</command>
+      program.</para>
 
-</sect3>
-</sect2>
+      <note>
+        <para>You should rerun <command>mkfontscale</command> and
+        <command>mkfontdir</command> any time you add or delete
+        <application>TrueType</application> fonts.
+        You should also rerun <command>fc-cache</command> each time
+        you add or remove any fonts.</para>
+      </note>
 
+    </sect3>
+
+  </sect2>
+
 <!-- ================================================== -->
-<sect2>
-<title>Setting up keyboards</title>
-<para>In this version of <application>X</application>, non-Latin
-keyboard layouts do not include Latin configurations as was previous
-practice. To set up a keyboard for Latin and non-Latin input, 
-change the XkbLayout keyboard driver option in the InputDevice section
-of the <filename>XF86Config</filename> or <filename>xorg.conf</filename> file. 
-For example:</para>
 
-<screen>   Section "InputDevice"
-     Identifier          "Keyboard0"
-     Driver              "Keyboard"
-     Option "XkbModel"   "pc105"
-     Option "XkbLayout"  "en_US,ru"
-     Option "XkbOptions" "grp:switch,grp:alt_shift_toggle,grp_led:scroll"
-   EndSection</screen>
+  <sect2>
+    <title>Setting up Keyboards</title>
 
-<para>In this example, you can use the Alt-Shift combination to switch
-between keyboard layouts and use the Scroll Lock <acronym>LED</acronym> to 
-indicate when the second layout is active.</para>
-</sect2>
+    <para>In this version of <application>X</application>, non-Latin
+    keyboard layouts do not include Latin configurations as was previous
+    practice. To set up a keyboard for Latin and non-Latin input, change
+    the XkbLayout keyboard driver option in the InputDevice section
+    of the <filename>XF86Config</filename> or <filename>xorg.conf</filename>
+    file. For example:</para>
 
+<screen><literal>Section "InputDevice"
+    Identifier          "Keyboard0"
+    Driver              "Keyboard"
+    Option "XkbModel"   "pc105"
+    Option "XkbLayout"  "en_US,ru"
+    Option "XkbOptions" "grp:switch,grp:alt_shift_toggle,grp_led:scroll"
+EndSection</literal></screen>
+
+    <para>In this example, you can use the <keycap>Alt+Shift</keycap>
+    combination to switch between keyboard layouts and use the Scroll Lock
+    LED to indicate when the second layout is active.</para>
+
+  </sect2>
+
 <!-- ================================================== -->
-<sect2>
-<title>Setting up fonts</title>
 
-<para>Users using character sets other than <acronym>ISO</acronym>-8859-1 have 
-to make a few adjustments to their font settings in order to make sure that 
-fonts with the correct encoding are used for "fixed", "variable", "10x20" and
-similar aliases:</para>
-    
-<para>For Cyrillic alphabet, it is sufficient to put the following line
-into the top of the "Files" section in <filename>XF86Config</filename>
-or <filename>xorg.conf</filename> because this directory already contains 
-the needed bitmap fonts and their aliases:</para>
+  <sect2>
+    <title>Setting up Fonts</title>
 
-<screen>FontPath     "/usr/X11R6/lib/X11/fonts/cyrillic/"</screen>
+    <para>Users using character sets other than ISO-8859-1 have to make
+    a few adjustments to their font settings in order to make sure that
+    fonts with the correct encoding are used for "fixed", "variable",
+    "10x20" and similar aliases:</para>
 
-<para>For ISO-8859-<replaceable>[X]</replaceable> based locales, use the
-following command instead:</para>
+    <para>For Cyrillic alphabet, it is sufficient to put the following line
+    into the top of the "Files" section in <filename>XF86Config</filename>
+    or <filename>xorg.conf</filename> because this directory already
+    contains the needed bitmap fonts and their aliases:</para>
 
-<screen><userinput><command>sed -i 's,iso8859-1\( 
\|$\),iso8859-<replaceable>[X]</replaceable>\1,g' \
-    
/usr/X11R6/lib/X11/fonts/{75dpi,100dpi,misc}/fonts.alias</command></userinput></screen>
+<screen><literal>FontPath   
"/usr/X11R6/lib/X11/fonts/cyrillic/"</literal></screen>
 
-</sect2>
+    <para>For ISO-8859-<replaceable>[X]</replaceable> based locales, use
+    the following command instead:</para>
 
+<screen role="root"><userinput>sed -i 's,iso8859-1\( 
\|$\),iso8859-<replaceable>[X]</replaceable>\1,g' \
+    
/usr/X11R6/lib/X11/fonts/{75dpi,100dpi,misc}/fonts.alias</userinput></screen>
+
+  </sect2>
+
 <!-- ================================================== -->
-<sect2 id='xdm'>
-<title>Setting up XDM</title>
-<para><command>xdm</command> provides a graphical logon capability and is
-normally set up in <filename>/etc/inittab</filename>.  Most of the information 
-you need to customize <command>xdm</command> is found in its man page.  To 
-execute <command>xdm</command> during bootup, change the initdefault level to 
5 
-and add the following lines to <filename>/etc/inittab</filename>:</para>
 
-<indexterm zone="x-setup xdm">
-  <primary sortas="b-xdm">xdm</primary>
-</indexterm>
+  <sect2 id='xdm'>
+    <title>Setting up XDM</title>
 
-<para><screen><userinput># Run xdm as a separate service
-x:5:respawn:/usr/X11R6/bin/xdm -nodaemon</userinput></screen></para>
+    <para><command>xdm</command> provides a graphical logon capability and
+    is normally set up in <filename>/etc/inittab</filename>. Most of the
+    information you need to customize <command>xdm</command> is found in
+    its man page. To execute <command>xdm</command> during bootup, change
+    the initdefault level to 5 and add the following lines to
+    <filename>/etc/inittab</filename>:</para>
 
-<para>If Linux-PAM is installed on your system, you should 
-create a PAM entry for xdm by duplicating the login entry
-using the following command:</para>
+    <indexterm zone="x-setup xdm">
+      <primary sortas="b-xdm">xdm</primary>
+    </indexterm>
 
-<para><screen><userinput>cp /etc/pam.d/login 
/etc/pam.d/xdm</userinput></screen></para>
-<indexterm zone="x-setup xdm">
-  <primary sortas="e-etc-pam.d/xdm">/etc/pam.d/xdm</primary>
-</indexterm>
+<screen><literal># Run xdm as a separate service
+x:5:respawn:/usr/X11R6/bin/xdm -nodaemon</literal></screen>
 
-</sect2>
+    <para>If <application>Linux-PAM</application> is installed on your
+    system, you should create a PAM entry for <command>xdm</command> by
+    duplicating the <command>login</command> entry using the following
+    command:</para>
 
+    <indexterm zone="x-setup xdm">
+      <primary sortas="e-etc-pam.d/xdm">/etc/pam.d/xdm</primary>
+    </indexterm>
+
+<screen role="root"><userinput>cp /etc/pam.d/login 
/etc/pam.d/xdm</userinput></screen>
+
+  </sect2>
+
 <!-- ================================================== -->
-<sect2 id='x-resources'>
-<title>Using <application>X</application> Resources</title>
-<para>There are many options that can be set in
-<application>X</application> and <application>X</application> clients via
-resources.  Typically resources are set in the 
-<filename>~/.Xresources</filename> file.</para>
 
-<para>The layout of the <filename>~/.Xresources</filename> file consists
-of a list of specifications in the form of</para>
+  <sect2 id='x-resources'>
+    <title>Using X Resources</title>
 
-<indexterm zone="x-setup x-resources">
-  <primary sortas="e-AA.xresources">~/.Xresources</primary>
-</indexterm>
+    <para>There are many options that can be set in
+    <application>X</application> and <application>X</application>
+    clients via resources. Typically resources are set in the
+    <filename>~/.Xresources</filename> file.</para>
 
-<screen>object.subobject[.subobject...].attribute: value</screen>
+    <para>The layout of the <filename>~/.Xresources</filename> file
+    consists of a list of specifications in the form of</para>
 
-<para>Components of a resource specification are linked together 
-by either <emphasis>tight</emphasis>, represented by a dot (.),
-or <emphasis>loose</emphasis>, represented by an asterisk (*),  bindings.
-A tight binding indicates that the components on either side of the dot must
-be directly next to each other as defined in a specific implementation.  An
-asterisk is a wildcard character that means that any number of levels in
-a defined hierarchy can be between the components. 
-For example, X offers two special cursors: redglass and whiteglass.  To
-use one of these resources, you need to add the following line:</para>
+    <indexterm zone="x-setup x-resources">
+      <primary sortas="e-AA.xresources">~/.Xresources</primary>
+    </indexterm>
 
-<screen>Xcursor.theme: whiteglass</screen>
+<screen><literal>object.subobject[.subobject...].attribute: 
value</literal></screen>
 
-<para>However, you can specify the background for all clients with:</para>
+    <para>Components of a resource specification are linked together by
+    either <emphasis>tight</emphasis>, represented by a dot (.), or
+    <emphasis>loose</emphasis>, represented by an asterisk (*), bindings.
+    A tight binding indicates that the components on either side of the
+    dot must be directly next to each other as defined in a specific
+    implementation. An asterisk is a wildcard character that means that
+    any number of levels in a defined hierarchy can be between the components.
+    For example, X offers two special cursors: redglass and whiteglass. To
+    use one of these resources, you need to add the following line:</para>
 
-<screen>*background: blue</screen>
+<screen><literal>Xcursor.theme: whiteglass</literal></screen>
 
-<para>More specific resource variables will override less specific 
names.</para>
+    <para>However, you can specify the background for all clients with:</para>
 
-<para>Resource definitions can be found in the man pages for each
-respective client.</para>
+<screen><literal>*background: blue</literal></screen>
 
-<para>In order to load your resources, the <command>xrdb</command> program 
-must be called with the appropriate parameters. Typically, the first time 
-resources are loaded, you use:</para>
+    <para>More specific resource variables will override less specific
+    names.</para>
 
-<screen><userinput><command>xrdb -load 
&lt;filename&gt;</command></userinput></screen>
+    <para>Resource definitions can be found in the man pages for each
+    respective client.</para>
 
-<para>To add resources to <application>X</application>'s database in memory, 
-use:</para>
+    <para>In order to load your resources, the <command>xrdb</command>
+    program must be called with the appropriate parameters. Typically,
+    the first time resources are loaded, you use:</para>
 
-<screen><userinput><command>xrdb -merge 
&lt;filename&gt;</command></userinput></screen>
+<screen><userinput>xrdb -load &lt;filename&gt;</userinput></screen>
 
-<para>The <command>xrdb</command> instruction is usually placed in 
-<filename>~/.xinitrc</filename> or <filename>~/.xsession</filename>.
-To get more information, see the xrdb man page.</para>
+    <para>To add resources to <application>X</application>'s database
+    in memory, use:</para>
 
-<indexterm zone="x-setup x-resources">
-  <primary sortas="b-xrdb">xrdb</primary>
-</indexterm>
+<screen><userinput>xrdb -merge &lt;filename&gt;</userinput></screen>
 
-</sect2>
+    <para>The <command>xrdb</command> instruction is usually placed in
+    <filename>~/.xinitrc</filename> or <filename>~/.xsession</filename>.
+    To get more information, see the <command>xrdb</command> man page.</para>
 
+    <indexterm zone="x-setup x-resources">
+      <primary sortas="b-xrdb">xrdb</primary>
+    </indexterm>
+
+  </sect2>
+
 </sect1>
-

-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Reply via email to