Changeset 3f72a148


Ignore:
Timestamp:
05/05/2006 07:01:37 AM (16 years ago)
Author:
DJ Lucas <dj@…>
Branches:
10.0, 10.1, 11.0, 11.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 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, lazarus, nosym, perl-modules, qt5new, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/test-20220226
Children:
afb1341
Parents:
9d91468a
Message:

Completed X Window section changes/x7 split

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

Files:
13 added
9 edited

Legend:

Unmodified
Added
Removed
  • general.ent

    r9d91468a r3f72a148  
    351351<!-- Chapter 25 -->
    352352<!ENTITY xorg-version                 "6.9.0">
     353<!ENTITY xfree86-version              "4.5.0">
    353354<!ENTITY xorg7-version                "7.0.0">
    354 <!ENTITY xfree86-version              "4.5.0">
     355<!ENTITY luit-version                 "1.0.1">
     356<!ENTITY xbitmaps-version             "1.0.1">
     357<!ENTITY xorg-server-version          "1.0.2">
    355358
    356359<!-- Chapter 26 -->
  • general/genutils/xterm.xml

    r9d91468a r3f72a148  
    6262
    6363    <bridgehead renderas="sect4">Required</bridgehead>
    64     <para><xref linkend="x-window-system"/></para>
     64    <para><xref linkend="x-window-system"/> and
     65    <xref linkend="pkgconfig"/></para>
    6566
    66     <bridgehead renderas="sect4">Required</bridgehead>
    67     <para><xref linkend="pkgconfig"/></para>
     67    <bridgehead renderas="sect4">Optional</bridgehead>
     68    <para><xref linkend="luit"/></para>
    6869
    6970    <para condition="html" role="usernotes">User Notes:
  • introduction/welcome/changelog.xml

    r9d91468a r3f72a148  
    4848          <para>[bdubbs] - Updated to ntp-4.2.0a.</para>
    4949        </listitem>
     50        <listitem>
     51          <para>[dj] - Reorganized X Window System chapter.</para>
     52        </listitem>
     53        <listitem>
     54          <para>[dj] - Spilt Xorg-7 instructions into several pages.</para>
     55        </listitem>
     56        <listitem>
     57          <para>[dj] - Corrected links in Mesa and xterm instructions for
     58          new xorg7 pages.</para>
     59        </listitem>
    5060      </itemizedlist>
    5161    </listitem>
  • x/installing/installing.xml

    r9d91468a r3f72a148  
    3535  <para><application>XFree86</application> continues to be a solid,
    3636  conservative application with excellent driver support.</para>
    37 
    38 
     37  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xmono-dummy.xml"/>
    3938  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xorg.xml"/>
     39  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xfree86.xml"/>
     40  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xorg7-dummy.xml"/>
    4041  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xorg7.xml"/>
    41   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xfree86.xml"/>
     42  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x7proto.xml"/>
     43  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x7util.xml"/>
     44  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x7lib.xml"/>
     45  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xbitmaps.xml"/>
     46  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x7app.xml"/>
     47  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x7data.xml"/>
     48  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x7font.xml"/>
     49  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="luit.xml"/>
     50  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x7server.xml"/>
     51  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x7driver.xml"/>
     52  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xconfig-dummy.xml"/>
     53  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x-setup.xml"/>
    4254  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x-config.xml"/>
    43   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x-setup.xml"/>
    44 
    4555</chapter>
  • x/installing/x-setup.xml

    r9d91468a r3f72a148  
    66]>
    77
    8 <sect1 id="x-setup">
    9   <?dbhtml filename="xfree86-setup.html"?>
     8<sect1 id="x-setup" xreflabel="X Window System Components">
     9  <?dbhtml filename="x-setup.html"?>
    1010
    1111  <sect1info>
     
    1515
    1616  <title>X Window System Components</title>
     17
     18    <sect2 role="configuration" id='xconfig'>
     19    <title>Configuring The X Window System</title>
     20
     21    <para>If you've installed the X Window System in any prefix other
     22    than <filename>/usr</filename>, as the
     23    <systemitem class="username">root</systemitem> user, add
     24    <filename class="directory">
     25    <replaceable>&lt;/usr/X11R6&gt;</replaceable>/lib</filename> to
     26    the <filename>/etc/ld.so.conf</filename> file and run
     27    <command>ldconfig</command>.  Additionally, While still the
     28    <systemitem class="username">root</systemitem> user, ensure
     29    <filename class="directory">
     30    <replaceable>&lt;/usr/X11R6&gt;</replaceable>/bin</filename>
     31    and <filename class="directory">
     32    <replaceable>&lt;/usr/X11R6&gt;</replaceable>/lib/pkgconfig</filename>
     33    are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
     34    environment variables, respectively. Instructions for doing this are
     35    described in the section <xref linkend='postlfs-config-profile'/>.</para>
     36
     37    <para>As the <systemitem class="username">root</systemitem> user
     38    create a basic X Window System configuration file with the following
     39    commands:</para>
     40
     41    <para>For <application>Xorg</application>:</para>
     42<screen><userinput>cd ~ &amp;&amp;
     43Xorg -configure</userinput></screen>
     44
     45    <para>For <application>XFree86</application>:</para>
     46<screen><userinput>cd ~ &amp;&amp;
     47XFree86 -configure</userinput></screen>
     48
     49    <indexterm zone="x-setup xconfig">
     50      <primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary>
     51    </indexterm>
     52
     53    <indexterm zone="x-setup xconfig">
     54      <primary sortas="e-etc-X11-XF86Config">/etc/X11/XF86Config</primary>
     55    </indexterm>
     56
     57    <para>The screen will go black and you may hear some clicking of the
     58    monitor.  This command will create a file in your
     59    home directory, <filename>xorg.conf.new</filename> for
     60    <application>Xorg</application>, or <filename>XF86Config.new</filename>
     61    for <application>XFree86</application>.</para>
     62
     63    <para>Edit the newly created configuration file to suit your system. The
     64    details of the files are located in the xorg.conf and XF86Config man
     65    pages. Some things you may want to do are:</para>
     66
     67    <itemizedlist>
     68      <listitem>
     69        <para>Section "Files". Change the order of the font paths searched.
     70        You may want to put 100dpi fonts ahead of 75dpi fonts if your system
     71        normally comes up closer to 100 dots per inch. You may want to remove
     72        some font directories completely.</para>
     73      </listitem>
     74      <listitem>
     75        <para>Section "Module". If you are going to install NVidia
     76        drivers, remove the "dri" line.</para>
     77      </listitem>
     78      <listitem>
     79        <para>Sections "InputDevice". You may want to change the
     80        keyboard autorepeat rate by adding
     81        <option>Option "Autorepeat" "250 30"</option>.</para>
     82      </listitem>
     83      <listitem>
     84        <para>Section "Monitor". Specify the <option>VertRefresh</option>
     85        and <option>HorizSync</option> values if the system does not
     86        automatically detect the monitor and its values.</para>
     87      </listitem>
     88      <listitem>
     89        <para>Section "Device". You may want to set some of the options
     90        available for your selected video driver. A description of the driver
     91        parameters is in the man page for your driver.</para>
     92      </listitem>
     93      <listitem><para>Section "Screen". Add a DefaultDepth statement such as:
     94        <option>DefaultDepth 24</option>. In the SubSection for your
     95        default depth, add a modes line such as:
     96        <option>Modes "1600x1200" "1280x1024" "1024x768"</option>. The first
     97        mode listed will normally be the starting resolution.</para>
     98      </listitem>
     99    </itemizedlist>
     100
     101    <para>Test the system with one of the following commands:</para>
     102
     103    <para>For <application>Xorg</application>:</para>
     104<screen><userinput>X -config ~/xorg.conf.new</userinput></screen>
     105
     106    <para>For <application>XFree86</application>:</para>
     107<screen><userinput>XFree86 -xf86config ~/XF86Config.new</userinput></screen>
     108
     109    <para>You will only get a gray background with an X-shaped mouse cursor,
     110    but it confirms the system is working. Exit with
     111    <keycap>Control+Alt+Backspace</keycap>. If the system does not work, take
     112    a look at <filename>/var/log/Xorg.0.log</filename> or
     113    <filename>/var/log/XFree86.0.log</filename> to see what went
     114    wrong.</para>
     115
     116    <para>As the <systemitem class="username">root</systemitem> user, create
     117    the configuration directory and move the configuration file to the new
     118    directory:</para>
     119
     120    <para>For <application>Xorg</application>:</para>
     121<screen role="root"><userinput>install -v -m755 -D ~/xorg.conf.new /etc/X11/xorg.conf</userinput></screen>
     122
     123    <para>For <application>XFree86</application>:</para>
     124<screen role="root"><userinput>install -v -m755 -D ~/XF86Config.new /etc/X11/XF86Config</userinput></screen>
     125
     126    <para>As the <systemitem class="username">root</systemitem> user, create
     127    <filename>.xinitrc</filename>:</para>
     128
     129<screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
     130<literal># Begin .xinitrc file
     131xterm  -g 80x40+0+0   &amp;
     132xclock -g 100x100-0+0 &amp;
     133twm</literal>
     134EOF</userinput></screen>
     135
     136    <para>This provides an initial screen with a small clock that is
     137    managed by a simple window manager, Tab Window Manager. For details of
     138    <command>twm</command>, see the man page.</para>
     139
     140    <note>
     141      <para>The default configuration for <application>Xorg</application>
     142      includes <application>xterm</application>. 
     143      <application>Xorg</application>'s modular distribution no longer includes
     144      <application>xterm</application>, and
     145      as a result, the <command>startx</command> command will fail if you have
     146      not installed <xref linkend="xterm2"/> when using the modular X Window
     147      System.</para>
     148    </note>
     149
     150    <indexterm zone="x-setup xconfig">
     151      <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
     152    </indexterm>
     153
     154    <para>When needed, the X Window System creates the directory
     155    <filename class='directory'>/tmp/.ICE-unix</filename> if it does not
     156    exist. If this directory is not owned by
     157    <systemitem class="username">root</systemitem>,
     158    the X Window System delays startup by a few seconds and also
     159    appends a warning to the logfile. This also affects startup of other
     160    applications. To improve performance, it is advisable to manually create
     161    the directory before the X Window System uses it. Add the file creation
     162    to <filename>/etc/sysconfig/createfiles</filename> that is sourced by
     163    the <filename>/etc/rc.d/init.d/cleanfs</filename> startup script.</para>
     164
     165<screen role="root"><userinput>cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"
     166/tmp/.ICE-unix dir 1777 root root
     167EOF</userinput></screen>
     168
     169    <indexterm zone="x-setup xconfig">
     170      <primary
     171      sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
     172    </indexterm>
     173
     174    <para>Start <application>X</application> with:</para>
     175
     176<screen><userinput>startx</userinput></screen>
     177
     178    <para>and a basic functional <application>X Window
     179    System</application> should be displayed.</para>
     180
     181    <para>For a list of the package contents and a description of the commands,
     182    see the sections in the <xref linkend='xfree86-contents'/>.</para>
     183
     184  </sect2>
     185
    17186
    18187  <sect2 id='dri'>
  • x/installing/xfree86.xml

    r9d91468a r3f72a148  
    445445EOF</userinput></screen>
    446446
     447      <para>You should now continue on to the <xref linkend="x-setup"/> section
     448      to complete the configuration of
     449      <application>XFree86</application>.</para>
     450
    447451    </sect3>
    448452
     
    492496  </sect2>
    493497
    494   <sect2 role="configuration" id="xfree86-config">
    495     <title>Configuring XFree86</title>
    496 
    497     <para>As the <systemitem class="username">root</systemitem> user: Edit
    498     <filename>/etc/ld.so.conf</filename> and add
    499     <filename class="directory">/usr/X11R6/lib</filename>, then run:</para>
    500 
    501 <screen role="root"><userinput>ldconfig</userinput></screen>
    502 
    503     <indexterm zone="xfree86 xfree86-config">
    504       <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
    505     </indexterm>
    506 
    507     <para>Ensure <filename class="directory">/usr/X11R6/bin</filename>
    508     and <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>
    509     are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
    510     environment variables, respectively. Instructions for doing this are
    511     described in the section <xref linkend='postlfs-config-profile'/>.</para>
    512 
    513     <indexterm zone="xfree86 xfree86-config">
    514       <primary sortas="e-etc-X11-XF86Config">/etc/X11/XF86Config</primary>
    515     </indexterm>
    516 
    517     <para>Create the <filename>XF86Config</filename> file with:</para>
    518 
    519 <screen><userinput>cd ~ &amp;&amp;
    520 XFree86 -configure</userinput></screen>
    521 
    522     <para>The screen will go black and you may hear some clicking of the monitor.
    523     This command will create a file, <filename>XF86Config.new</filename> in your
    524     home directory.</para>
    525 
    526     <para>Edit <filename>XF86Config.new</filename> to suit your system.
    527     The details of the file are located in the man page <command>man
    528     XF86Config</command>. Some things you may want to do are:</para>
    529 
    530     <itemizedlist>
    531       <listitem>
    532         <para>Section "Files". Change the order of the font paths searched.
    533         You may want to put 100dpi fonts ahead of 75dpi fonts if your system
    534         normally comes up closer to 100 dots per inch.  You may want to remove
    535         some font directories completely.</para>
    536       </listitem>
    537       <listitem>
    538         <para>Section "Module". If you are going to install NVidia
    539         drivers, remove the "dri" line.</para>
    540       </listitem>
    541       <listitem>
    542         <para>Sections "InputDevice". You may want to change the
    543         keyboard autorepeat rate by adding
    544         <option>Option "Autorepeat" "250 30"</option>.</para>
    545       </listitem>
    546       <listitem>
    547         <para>Section "Monitor". Specify the <option>VertRefresh</option>
    548         and <option>HorizSync</option> values if the system does not
    549         automatically detect the monitor and its values.</para>
    550       </listitem>
    551       <listitem>
    552         <para>Section "Device". You may want to set some of the options
    553         available for your selected video driver.  A description of the
    554         driver parameters is in the man page for your driver.</para>
    555       </listitem>
    556       <listitem>
    557         <para>Section "Screen". Add a DefaultDepth statement such as:
    558         <option>DefaultDepth 24</option>. In the SubSection for your
    559         default depth, add a modes line such as:
    560         <option>Modes "1600x1200" "1280x1024" "1024x768"</option>. The
    561         first mode listed will normally be the starting resolution.</para>
    562       </listitem>
    563     </itemizedlist>
    564 
    565     <para>Test the system with:</para>
    566 
    567 <screen><userinput>XFree86 -xf86config ~/XF86Config.new</userinput></screen>
    568 
    569     <para>You will only get a gray background with an X-shaped mouse cursor,
    570     but it confirms the system is working. Exit with
    571     <keycap>Control+Alt+Backspace</keycap>. If the system does not work,
    572     examine <filename>/var/log/XFree86.0.log</filename> to see what went
    573     wrong.</para>
    574 
    575     <para>As the <systemitem class="username">root</systemitem> user:
    576     move the configuration file to its final location:</para>
    577 
    578 <screen role="root"><userinput>mv ~/XF86Config.new /etc/X11/XF86Config</userinput></screen>
    579 
    580     <para>Create <filename>.xinitrc</filename>:</para>
    581 
    582 <screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
    583 <literal># Begin .xinitrc file
    584 xterm  -g 80x40+0+0   &amp;
    585 xclock -g 100x100-0+0 &amp;
    586 twm</literal>
    587 EOF</userinput></screen>
    588 
    589     <para>This provides an initial screen with an xterm and a clock that is
    590     managed by a simple window manager, Tab Window Manager. For details of
    591     <command>twm</command>, see the man page.</para>
    592 
    593     <indexterm zone="xfree86 xfree86-config">
    594       <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
    595     </indexterm>
    596 
    597     <note>
    598       <para>When needed, <application>XFree86</application> creates the
    599       directory <filename>/tmp/.ICE-unix</filename> if it does not exist.
    600       If this directory is not owned by <systemitem
    601       class="username">root</systemitem>, <application>XFree86</application>
    602       delays startup by a few seconds and also appends a warning to the
    603       logfile. This also affects startup of other applications. To improve
    604       performance, it is advisable to manually create the directory before
    605       <application>XFree86</application> uses it. Add the file creation to
    606       <filename>/etc/sysconfig/createfiles</filename> that is sourced by
    607       the <filename>/etc/rc.d/init.d/cleanfs</filename> startup script.</para>
    608 
    609 <screen role="root"><userinput>cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"
    610 <literal>/tmp/.ICE-unix dir 1777 root root</literal>
    611 EOF</userinput></screen>
    612 
    613     </note>
    614 
    615     <indexterm zone="xfree86 xfree86-config">
    616       <primary
    617       sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
    618     </indexterm>
    619 
    620     <para>Start <application>X</application> with:</para>
    621 
    622 <screen><userinput>startx</userinput></screen>
    623 
    624     <para>to get a basic functional <application>X Window
    625     System</application>.</para>
    626 
    627     <para>At this point, you should check out <xref linkend='x-setup'/>
    628     for the necessary configuration to make <application>X</application>
    629     fully functional. Additionally, you can have a look at <xref
    630     linkend='x-config'/> for information on fine tuning your
    631     <application>X</application> configuration.</para>
    632 
    633   </sect2>
    634 
    635498  <sect2 id="xfree86-contents" role="content"
    636499  xreflabel="XFree86 Contents and Descriptions">
  • x/installing/xorg.xml

    r9d91468a r3f72a148  
    419419ln -svn /usr/X11R6/lib/X11/fonts/TTF /usr/share/fonts/X11-TTF</userinput></screen>
    420420
     421      <para>You should now continue on to the <xref linkend="x-setup"/> section
     422      to complete the configuration of
     423      <application>Xorg</application>.</para>
     424
    421425    </sect3>
    422426
     
    463467    by users only.</quote></para>
    464468
     469    <para>For a list of the package contents, see the sections in the
     470    <xref linkend='xfree86-contents'/>.</para>
     471
    465472  </sect2>
    466473
    467   <sect2 role="configuration" id='xorg-config'>
    468     <title>Configuring Xorg</title>
    469 
    470     <para>Edit <filename>/etc/ld.so.conf</filename> and add
    471     <filename class="directory">/usr/X11R6/lib</filename>. Run:</para>
    472 
    473     <indexterm zone="xorg xorg-config">
    474       <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
    475     </indexterm>
    476 
    477 <screen role="root"><userinput>ldconfig</userinput></screen>
    478 
    479     <para>Ensure <filename class="directory">/usr/X11R6/bin</filename>
    480     and <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>
    481     are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
    482     environment variables, respectively. Instructions for doing this are
    483     described in the section <xref linkend='postlfs-config-profile'/>.</para>
    484 
    485     <para>Create the <filename>xorg.conf</filename> file with:</para>
    486 
    487 <screen><userinput>cd ~ &amp;&amp;
    488 Xorg -configure</userinput></screen>
    489 
    490     <para>The screen will go black and you may hear some clicking of the monitor.
    491     This command will create a file, <filename>xorg.conf.new</filename> in your
    492     home directory.</para>
    493 
    494     <indexterm zone="xorg xorg-config">
    495       <primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary>
    496     </indexterm>
    497 
    498     <para>Edit <filename>xorg.conf.new</filename> to suit your system. The
    499     details of the file are located in the xorg.conf man page. Some things
    500     you may want to do are:</para>
    501 
    502     <itemizedlist>
    503       <listitem>
    504         <para>Section "Files". Change the order of the font paths searched.
    505         You may want to put 100dpi fonts ahead of 75dpi fonts if your system
    506         normally comes up closer to 100 dots per inch. You may want to remove
    507         some font directories completely.</para>
    508       </listitem>
    509       <listitem>
    510         <para>Section "Module". If you are going to install NVidia
    511         drivers, remove the "dri" line.</para>
    512       </listitem>
    513       <listitem>
    514         <para>Sections "InputDevice". You may want to change the
    515         keyboard autorepeat rate by adding
    516         <option>Option "Autorepeat" "250 30"</option>.</para>
    517       </listitem>
    518       <listitem>
    519         <para>Section "Monitor". Specify the <option>VertRefresh</option>
    520         and <option>HorizSync</option> values if the system does not
    521         automatically detect the monitor and its values.</para>
    522       </listitem>
    523       <listitem>
    524         <para>Section "Device". You may want to set some of the options
    525         available for your selected video driver. A description of the driver
    526         parameters is in the man page for your driver.</para>
    527       </listitem>
    528       <listitem><para>Section "Screen". Add a DefaultDepth statement such as:
    529         <option>DefaultDepth 24</option>. In the SubSection for your
    530         default depth, add a modes line such as:
    531         <option>Modes "1600x1200" "1280x1024" "1024x768"</option>. The first
    532         mode listed will normally be the starting resolution.</para>
    533       </listitem>
    534     </itemizedlist>
    535 
    536     <para>Test the system with:</para>
    537 
    538 <screen><userinput>X -config ~/xorg.conf.new</userinput></screen>
    539 
    540     <para>You will only get a gray background with an X-shaped mouse cursor,
    541     but it confirms the system is working. Exit with
    542     <keycap>Control+Alt+Backspace</keycap>. If the system does not work, take
    543     a look at <filename>/var/log/Xorg.0.log</filename> to see what went
    544     wrong.</para>
    545 
    546     <para>Move the configuration file to its final location:</para>
    547 
    548 <screen role="root"><userinput>mv ~/xorg.conf.new /etc/X11/xorg.conf</userinput></screen>
    549 
    550     <para>Create <filename>.xinitrc</filename>:</para>
    551 
    552 <screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
    553 <literal># Begin .xinitrc file
    554 xterm  -g 80x40+0+0   &amp;
    555 xclock -g 100x100-0+0 &amp;
    556 twm</literal>
    557 EOF</userinput></screen>
    558 
    559     <para>This provides an initial screen with an xterm and a clock that is
    560     managed by a simple window manager, Tab Window Manager. For details of
    561     <command>twm</command>, see the man page.</para>
    562 
    563     <indexterm zone="xorg xorg-config">
    564       <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
    565     </indexterm>
    566 
    567     <note>
    568       <para>When needed, <application>Xorg</application> creates the directory
    569       <filename>/tmp/.ICE-unix</filename> if it does not exist. If this
    570       directory is not owned by <systemitem class="username">root</systemitem>,
    571       <application>Xorg</application> delays startup by a few seconds and also
    572       appends a warning to the logfile. This also affects startup of other
    573       applications. To improve performance, it is advisable to manually create
    574       the directory before <application>Xorg</application> uses it. Add the
    575       file creation to <filename>/etc/sysconfig/createfiles</filename> that is
    576       sourced by the <filename>/etc/rc.d/init.d/cleanfs</filename> startup
    577       script.</para>
    578 
    579 <screen role="root"><userinput>cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"
    580 <literal>/tmp/.ICE-unix dir 1777 root root</literal>
    581 EOF</userinput></screen>
    582 
    583     </note>
    584 
    585     <indexterm zone="xorg xorg-config">
    586       <primary
    587       sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
    588     </indexterm>
    589 
    590     <para>Start <application>X</application> with:</para>
    591 
    592 <screen><userinput>startx</userinput></screen>
    593 
    594     <para>to get a basic functional <application>X Window
    595     System</application>.</para>
    596 
    597     <para>At this point, you should check out <xref linkend='x-setup'/> for
    598     the necessary configuration to make <application>X</application> fully
    599     functional. Additionally, you can have a look at <xref linkend='x-config'/>
    600     for information on fine tuning your <application>X</application>
    601     configuration.</para>
    602 
    603     <para>For a list of the package contents and a description of the commands,
    604     see the sections in the <xref linkend='xfree86-contents'/>.</para>
    605 
    606   </sect2>
    607 
    608474</sect1>
  • x/installing/xorg7.xml

    r9d91468a r3f72a148  
    44  <!ENTITY % general-entities SYSTEM "../../general.ent">
    55  %general-entities;
    6 
    7     <!-- Inserted as a reminder to do this. The mention of a test suite
    8          is usually right before the root user installation commands. Please
    9          delete these 12 (including one blank) lines after you are done.-->
    10 
    11     <!-- Use one of the two mentions below about a test suite,
    12          delete the line that is not applicable. Of course, if the
    13          test suite uses syntax other than "make check", revise the
    14          line to reflect the actual syntax to run the test suite -->
    15 
    16     <!-- <para>This package does not come with a test suite.</para> -->
    17     <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
    186]>
    197
     
    3220-->
    3321
    34 
    3522  </sect1info>
    3623
    37   <title>Xorg-&xorg7-version;</title>
     24  <title>Introduction to Xorg-&xorg7-version;</title>
    3825
    3926  <indexterm zone="xorg7">
     
    4128  </indexterm>
    4229
    43   <sect2 role="package">
    44     <title>Introduction to Xorg</title>
    4530
    46     <para><application>Xorg</application> is a freely redistributable,
    47     open-source implementation of the <application>X</application> Window
    48     System. This system provides a client/server interface between display
    49     hardware (the mouse, keyboard, and video displays) and the desktop
    50     environment, while also providing both the windowing infrastructure and a
    51     standardized application interface (API).</para>
     31  <para><application>Xorg</application> is a freely redistributable,
     32  open-source implementation of the <application>X</application> Window
     33  System. This system provides a client/server interface between display
     34  hardware (the mouse, keyboard, and video displays) and the desktop
     35  environment, while also providing both the windowing infrastructure and a
     36  standardized application interface (API).</para>
    5237
    53     <bridgehead renderas="sect3">Xorg Dependencies</bridgehead>
     38  <para condition="html" role="usernotes">User Notes:
     39  <ulink url='&blfs-wiki;/Xorg-&xorg7-version;'/></para>
    5440
    55     <bridgehead renderas="sect4">Required</bridgehead>
    56     <para role="required"><xref linkend="fontconfig"/>,
    57     <xref linkend="libpng"/>, and
    58     <xref linkend="pkgconfig"/></para>
     41  <bridgehead renderas="sect3">Xorg Download and Installation
     42  Instructions</bridgehead>
    5943
    60     <bridgehead renderas="sect4">Optional</bridgehead>
    61     <para role="optional"><xref linkend="linux-pam"/></para>
     44  <para>Xorg-7.0.0 introduced a completly auto-tooled, modular build system.
     45  The code is otherwise identical to that in the Xorg-6.9.0 release.
     46  With the new modular build system, it is no longer possible to download
     47  the entire package in a single file.  In fact, there may be as many as
     48  280 files that need to be fetched from the download location.  To assist
     49  with such a large task, installing <xref linkend="wget"/> is strongly
     50  recommended for downloading the needed files.  A complete
     51  <application>wget</application> file list is provided for each section
     52  that includes multiple packages.</para>
    6253
    63     <para condition="html" role="usernotes">User Notes:
    64     <ulink url='&blfs-wiki;/Xorg-&xorg7-version;'/></para>
     54  <para>Given the number of packages available, deciding which packages you
     55  need to install for your particular setup may seem a bit overwhelming at
     56  first.  Take a look at
     57  <ulink url="http://lists.x.org/archives/xorg-modular/2005-November/000801.html">this thread</ulink>
     58  to get an idea of what you will need.  If you are
     59  unsure, you should install all packages at the cost of extra
     60  disk space.</para>
    6561
    66     <bridgehead renderas="sect3">Xorg Download and Installation
    67     Instructions</bridgehead>
     62  <note>
     63    <para>Even if you intend to download only the necessary packages, you
     64    should download the wget file lists and use the package versions in the
     65    file.  Newer packages are likey intended for the next release of
     66    <application>Xorg</application> and have already proven to be
     67    incompatible with the current version of
     68    <application>GTK+</application>.  The installed size of
     69    <application>Xorg</application> can be reduced considerably by
     70    installing only the packages that you will need and use, however, the
     71    BLFS book cannot account for all dependencies and build options for
     72    the individual <application>Xorg</application> packages.  The
     73    instructions assume that all packages have been built.  A
     74    <ulink url="http://wiki.linuxfromscratch.org/blfs/wiki/Xorg-&xorg7-version;">wiki</ulink>
     75    page containing dependency information, is under development.  You are
     76    encouraged to add to these pages if you discover additional information
     77    that may be helpful to other users who selectively install individual
     78    packages.</para>
     79  </note>
    6880
    69     <para>With the modular build system, it is no longer possible to download
    70     the entire package in a single file.  In fact, there may be as many as
    71     280 files that need to be fetched from the download location.  To assist
    72     with such a large task, it is strongly recommended to install
    73     <xref linkend="wget"/> for downloading the needed files.  A complete
    74     <application>wget</application> script is available for each section at
    75     <ulink
    76     url="http://anduin.linuxfromscratch.org/sources/BLFS/svn/x/wget/"/>.</para>
     81  <para>Additionally, because of the large number of repetitive commands,
     82  you are encouraged to script the build.  For most sections, you can use
     83  a script with commands similar to the following, to compile and install
     84  all packages in a wget file list:</para>
    7785
    78     <note>
    79       <para>Even if you intend to download only the necessary packages, you
    80       should download the wget scripts and use the package versions listed.
    81       Newer packages are likey intended for the next release of
    82       <application>Xorg</application> and have already proven to be
    83       incompatible with the current version of
    84       <application>GTK+</application>.</para>
    85     </note>
    86 
    87     <para>Given the number of packages available, deciding which packages you
    88     need to install for your particular setup may seem a bit overwhelming at
    89     first.  Take a look at<ulink
    90     url="http://lists.x.org/archives/xorg-modular/2005-November/000801.html">
    91     this thread</ulink> to get an idea of what you will need.  If you are
    92     unsure, you should install all packages at the cost of extra
    93     disk space.</para>
    94 
    95     <note>
    96       <para>The installed size of <application>Xorg</application> can
    97       be reduced considerably by installing only the packages that you will
    98       need and use. However, the BLFS book cannot account for all dependencies
    99       and build options for individual <application>Xorg</application>
    100       packages.  The instructions assume that all packages have been built
    101       from a particular group unless otherwise noted. A
    102       <ulink url="http://wiki.linuxfromscratch.org/blfs/wiki/Xorg-&xorg7-version;">
    103       wiki</ulink> page containing dependency information, for users who wish
    104       to cut down on the installed size of <application>Xorg</application>, is
    105       under development.  You are encouraged to add to these
    106       pages if you discover additional information that may be helpful to
    107       other users.</para>
    108     </note>
    109 
    110     <para>Additionally, because of the large number of repetitive commands,
    111     you are encouraged to script the build.  For most sections, you can use
    112     the following commands to compile and install all packages in your build
    113     directory:</para>
    114 
    115 <screen>for package in *.tar.bz2
     86<screen>bash -e #exit on all errors
     87for package in $(cat ../wgetlist.wget)
    11688do
    117   packagedir=`echo $package | sed 's/.tar.bz2//'`
    118   tar -xf $package &amp;&amp;
    119   cd $packagedir &amp;&amp;
    120   ./configure $XORG_CONFIG &amp;&amp;
    121   make &amp;&amp;
     89  packagedir=$(echo $package | sed 's/.tar.bz2//')
     90  tar -xf $package
     91  cd $packagedir
     92  ./configure $XORG_CONFIG
     93  make
    12294  make install
    123   if [ $? -ne 0 ]; then
    124     break #stop the build if the previous command failed
    125   fi
    126   cd .. &amp;&amp;
     95  cd ..
    12796  rm -rf $packagedir
     97  rm -f $package
    12898done 2&gt;&amp;1 | tee -a ../xorg-compile.log #log the entire loop</screen>
    12999
    130   </sect2>
     100  <para>The above shell will exit immediately on error.  If it runs to
     101  completion, you should manually exit the shell before continuing onto
     102  the next set of instructions.</para>
    131103
    132104  <sect2>
    133105    <title>Setting up the Xorg Build Environment</title>
    134106
    135       <para>First, you'll need to create a working directory:</para>
     107    <para>First, you'll need to create a working directory:</para>
    136108
    137109<screen><userinput>mkdir xc &amp;&amp;
     
    156128    command:</para>
    157129
    158 <screen><userinput>export XORG_PREFIX="<replaceable>&lt;/usr&gt;</replaceable>"</userinput></screen>
     130<screen><userinput>export XORG_PREFIX="<replaceable>&lt;PREFIX&gt;</replaceable>"</userinput></screen>
    159131
    160132    <para>Throughout these instructions, you will use the same three
     
    164136<screen><userinput>export XORG_CONFIG="--prefix=$XORG_PREFIX --sysconfdir=/etc --localstatedir=/var"</userinput></screen>
    165137
    166     <note>
    167       <para>If you've decided to use an alternate prefix, be sure to add
    168       <filename class="directory"><replaceable>&lt;/usr&gt;</replaceable>/lib/pkgconfig</filename>
    169       to your <envar>PKG_CONFIG_PATH</envar> variable.</para>
    170     </note>
    171 
    172   </sect2>
    173 
    174   <sect2>
    175     <title>Xorg Protocol Headers</title>
    176 
    177     <indexterm zone="xorg7">
    178       <primary sortas="a-xorg7-proto">Xorg Protocol Headers</primary>
    179     </indexterm>
    180 
    181       <para>The <application>Xorg</application> protocol headers provide the
    182       header files required to build the system, and to allow other
    183       applications to build against the installed X Window system.</para>
    184 
    185       <para><application>Xorg</application> Proto packages can be downloaded
    186       individually from <ulink
    187       url="http://xorg.freedesktop.org/releases/individual/proto/"/>.</para>
    188 
    189     <sect3 role="installation">
    190       <title>Installation of Xorg Protocol Headers</title>
    191 
    192       <para>Install the <application>Xorg</application> protocol headers
    193       by running the following commands for each package to be installed.</para>
    194 
    195 <screen><userinput>./configure $XORG_CONFIG</userinput></screen>
    196 
    197       <para>Now as the <systemitem class="username">root</systemitem>
    198       user:</para>
    199 
    200 <screen><userinput role="root">make install</userinput></screen>
    201 
    202     </sect3>
    203 
    204   </sect2>
    205 
    206   <sect2>
    207     <title>Xorg Utilities</title>
    208 
    209     <indexterm zone="xorg7">
    210       <primary sortas="a-xorg7-data">Xorg Utilities</primary>
    211     </indexterm>
    212 
    213       <para>The <application>Xorg</application> utility packages provide
    214       needed utilities, not for the <application>Xorg</application>
    215       installation itself, but for other applications that make use of
    216       legacy X11R6 installation methods.</para>
    217 
    218       <para><application>Xorg</application> Utility packages can be downloaded
    219       individually from <ulink
    220       url="http://xorg.freedesktop.org/releases/individual/util/"/>.</para>
    221 
    222     <sect3 role="installation">
    223       <title>Installation of Xorg Utilities</title>
    224 
    225       <para>First install the <application>xorg-cf-files</application> package
    226       with the following commands:</para>
    227 
    228 <screen><userinput>sed -i "s@/usr/X11R6@$XORG_PREFIX@" site.def &amp;&amp;
    229 sed -i "s@/usr/X11R6@$XORG_PREFIX@" X11.tmpl &amp;&amp;
    230 ./configure $XORG_CONFIG --with-config-dir=$XORG_PREFIX/lib/X11/config &amp;&amp;
    231 make</userinput></screen>
    232 
    233       <para>Now as the <systemitem class="username">root</systemitem>
    234       user:</para>
    235 
    236 <screen><userinput role="root">make install</userinput></screen>
    237 
    238       <para>Next, install the <application>Imake</application> package with
    239       these commands:</para>
    240 
    241 <screen><userinput>./configure $XORG_CONFIG --with-config-dir=$XORG_PREFIX/lib/X11/config &amp;&amp;
    242 make</userinput></screen>
    243 
    244       <para>Now as the <systemitem class="username">root</systemitem>
    245       user:</para>
    246 
    247 <screen><userinput role="root">make install</userinput></screen>
    248 
    249 
    250       <para>Finally, build the three remaining packages with the standard build
    251       commands:</para>
    252 
    253 
    254 <screen><userinput>./configure $XORG_CONFIG &amp;&amp;
    255 make</userinput></screen>
    256 
    257       <para>Now as the <systemitem class="username">root</systemitem>
    258       user:</para>
    259 
    260 <screen><userinput role="root">make install</userinput></screen>
    261 
    262     </sect3>
    263 
    264   </sect2>
    265 
    266   <sect2>
    267     <title>Xorg Libraries</title>
    268 
    269     <indexterm zone="xorg7">
    270       <primary sortas="a-xorg7-lib">Xorg Libraries</primary>
    271     </indexterm>
    272 
    273       <para>The <application>Xorg</application> libraries provide library
    274       routines that are used within all X Window applications.</para>
    275 
    276       <para><application>Xorg</application> Library packages can be downloaded
    277       individually from <ulink
    278       url="http://xorg.freedesktop.org/releases/individual/lib/"/>.</para>
    279 
    280     <sect3>
    281       <title>Meeting Library Dependencies</title>
    282 
    283       <para>These 17 libraries must be built first, in the order provided,
    284       to cover the dependencies of the other library packages:</para>
    285 
    286 <screen>xtrans-1.0.0
    287 libXau-1.0.0
    288 libXdmcp-1.0.0
    289 libX11-1.0.0
    290 libXext-1.0.0
    291 libICE-1.0.0
    292 libSM-1.0.0
    293 libXt-1.0.0
    294 libXmu-1.0.0
    295 libXpm-3.5.4.2
    296 libXp-1.0.0
    297 libXfixes-3.0.1.2
    298 libXrender-0.9.0.2
    299 libfontenc-1.0.1
    300 libxkbfile-1.0.2
    301 libXprintUtil-1.0.1
    302 libXv-1.0.1</screen>
    303 
    304     </sect3>
    305 
    306     <sect3 role="installation">
    307       <title>Installation of Xorg Libraries</title>
    308 
    309       <para>Install the libraries by running the following commands for each
    310       of the chosen packages:</para>
    311 
    312 <screen><userinput>./configure $XORG_CONFIG &amp;&amp;
    313 make</userinput></screen>
    314 
    315       <para>Now as the <systemitem class="username">root</systemitem>
    316       user:</para>
    317 
    318 <screen><userinput role="root">make install</userinput></screen>
    319 
    320     </sect3>
    321 
    322     <sect3 role="configuration">
    323       <title>Configuration of Xorg Libraries</title>
    324 
    325         <para>If you've chosen to install <application>Xorg</application> into
    326         <filename class="directory">/usr</filename>, then no further
    327         configuration is necessary and you can skip the rest of this section.
    328         If you've opted for an alternate prefix, you should create two symlinks
    329         to satisfy the expected environment of several packages.
    330         Execute the following commands as the root user:</para>
    331 
    332 <screen role="root"><userinput>ln -sv $XORG_PREFIX/lib/X11 /usr/lib/X11 &amp;&amp;
    333 ln -sv $XORG_PREFIX/include/X11 /usr/include/X11</userinput></screen>
    334 
    335         <para>As with other library directories, as the root user you must add
    336         <filename class="directory">$XORG_PREFIX/lib</filename> to
    337         <filename>/etc/ld.so.conf</filename> and execute
    338         <command>/sbin/ldconfig</command>.</para>
    339 
    340     </sect3>
    341 
    342   </sect2>
    343 
    344   <sect2>
    345     <title>Xorg Data</title>
    346 
    347     <indexterm zone="xorg7">
    348       <primary sortas="a-xorg7-data">Xorg Data</primary>
    349     </indexterm>
    350 
    351       <para>The <application>Xorg</application> data packages provide
    352       static data such as images and keymaps to the
    353       <application>Xorg</application> applications.</para>
    354 
    355       <para><application>Xorg</application> Data packages can be downloaded
    356       individually from <ulink
    357       url="http://xorg.freedesktop.org/releases/individual/data/"/>.</para>
    358 
    359     <sect3 role="installation">
    360       <title>Installation of Xorg Data</title>
    361 
    362       <para>First, configure the xbitmap package by running the following
    363       command:</para>
    364 
    365 <screen><userinput>./configure $XORG_CONFIG</userinput></screen>
    366 
    367       <para>Now install as the <systemitem class="username">root</systemitem>
    368       user:</para>
    369 
    370 <screen><userinput role="root">make install</userinput></screen>
    371 
    372       <note>
    373         <para>At this point, you should continue to the applications
    374         installation.  After the applications installation has completed, you
    375         should return here and install the xcursor-themes and xkb-data
    376         packages.</para>
    377       </note>
    378 
    379       <para>Compile the xcursor-themes and xkb-data packages with the
    380       following commands:</para>
    381 
    382 <screen><userinput>./configure $XORG_CONFIG &amp;&amp;
    383 make</userinput></screen>
    384 
    385       <para>Install the packages as the
    386       <systemitem class="username">root</systemitem> user:</para>
    387 
    388 <screen><userinput role="root">make install</userinput></screen>
    389 
    390     </sect3>
    391 
    392   </sect2>
    393 
    394   <sect2>
    395     <title>Xorg Applications</title>
    396 
    397     <indexterm zone="xorg7">
    398       <primary sortas="a-xorg7-app">Xorg Applications</primary>
    399     </indexterm>
    400 
    401     <note>
    402       <para>You must install <xref linkend="mesalib"/> before you install
    403       Xorg Applications.</para>
    404     </note>
    405 
    406       <para>The <application>Xorg</application> applications provide the
    407       expected applications available in previous X Window
    408       implementations.</para>
    409 
    410       <para><application>Xorg</application> applications can be downloaded
    411       individually from <ulink
    412       url="http://xorg.freedesktop.org/releases/individual/app/"/>.</para>
    413 
    414     <sect3 role="installation">
    415       <title>Installation of Xorg Applications</title>
    416 
    417       <para>Install the applications by running the following commands for each
    418       chosen package:</para>
    419 
    420 <screen><userinput>./configure $XORG_CONFIG &amp;&amp;
    421 make</userinput></screen>
    422 
    423       <para>Now as the <systemitem class="username">root</systemitem>
    424       user:</para>
    425 
    426 <screen><userinput role="root">make install</userinput></screen>
    427 
    428       <note>
    429         <para>Remember to return to the data packages and install the
    430         xcursor-themes and xkb-data packages.</para>
    431       </note>
    432 
    433 </sect3>
    434 
    435     <sect3 role="installation">
    436 
    437       <title>Installation of luit</title>
    438 
    439       <note>
    440         <para>The luit package should not be compiled at this point.  You
    441         should install the luit application after the fonts have been
    442         installed.</para>
    443       </note>
    444 
    445       <para>A patch is required to fix a race condition in
    446       <application>luit</application> that was discovered shortly after
    447       release.  Download the patch from
    448       <ulink url="&patch-root;/luit-1.0.1-race-1.patch"/>.</para>
    449 
    450       <para>Install luit with the following commands:</para>
    451 
    452 <screen><userinput>patch -Np1 -i luit-1.0.1-race-1.patch &amp;&amp;
    453 ./configure $XORG_CONFIG &amp;&amp;
    454 make</userinput></screen>
    455 
    456       <para>Now as the <systemitem class="username">root</systemitem>
    457       user:</para>
    458 
    459 <screen><userinput role="root">make install</userinput></screen>
    460 
    461     </sect3>
    462 
    463   </sect2>
    464 
    465   <sect2>
    466     <title>Xorg Fonts</title>
    467 
    468     <indexterm zone="xorg7">
    469       <primary sortas="a-xorg7-fonts">Xorg Fonts</primary>
    470     </indexterm>
    471 
    472       <para>The <application>Xorg</application> font packages provide
    473       needed fonts to the <application>Xorg</application> applications.</para>
    474 
    475       <para><application>Xorg</application> Font packages can be downloaded
    476       individually from <ulink
    477       url="http://xorg.freedesktop.org/releases/individual/font/"/>.</para>
    478 
    479     <sect3 role="installation">
    480       <title>Installation of Xorg Fonts</title>
    481 
    482       <para>Run the following commands for each package:</para>
    483 
    484       <note>
    485         <para>You should install encodings and font-util before all
    486         other font packages.</para>
    487       </note>
    488 
    489 
    490 <screen><userinput>./configure $XORG_CONFIG</userinput></screen>
    491 
    492       <para>Now as the <systemitem class="username">root</systemitem>
    493       user:</para>
    494 
    495 <screen><userinput role="root">make install</userinput></screen>
    496 
    497       <para>When all of the fonts have been installed, the system must be
    498       configured so that <application>Fontconfig</application> can find the
    499       TrueType fonts since they are outside of the default search path of
    500       <filename class="directory">/usr/share/fonts</filename>.  Make symlinks
    501       to the <application>Xorg</application> TrueType font directories by
    502       running the following commands as the
    503       <systemitem class="username">root</systemitem> user:</para>
    504 
    505 <screen><userinput role="root">install -d -m755 /usr/share/fonts &amp;&amp;
    506 ln -svn $XORG_PREFIX/lib/X11/fonts/OTF /usr/share/fonts/X11-OTF &amp;&amp;
    507 ln -svn $XORG_PREFIX/lib/X11/fonts/TTF /usr/share/fonts/X11-TTF</userinput></screen>
    508 
    509       <note>
    510         <para>If you haven't done so, and intend to install
    511         <application>luit</application>, do so now.</para>
    512       </note>
    513 
    514     </sect3>
    515 
    516   </sect2>
    517 
    518   <sect2>
    519     <title>Xorg Server</title>
    520 
    521     <indexterm zone="xorg7">
    522       <primary sortas="a-xorg7-server">Xorg Server</primary>
    523     </indexterm>
    524 
    525     <para>The <application>Xorg</application> Server is the core
    526     of the X Window system.</para>
    527 
    528       <para>The Xorg Server is a single download.  Get it from
    529       <ulink url="http://xorg.freedesktop.org/releases/individual/xserver/xorg-server-1.0.2.tar.bz2"/>.</para>
    530 
    531     <sect3 role="installation">
    532       <title>Installation of Xorg Server</title>
    533 
    534       <note>
    535         <para>You must have the <application>Mesa</application> source
    536         directory available when building the
    537         <application>Xorg-server</application>.</para>
    538       </note>
    539 
    540 <!-- To be removed if/when proposed glibc patch is added to LFS SVN
    541      Leave in in for a couple of weeks with 'you may need' and a testcase
    542      around it to save the support list silly questions.  Should remove in
    543      a couple of weeks -->
    544       <para>Recent glibc may have a problem with it's installed sys/kd.h file. 
    545       This has recently been fixed in LFS svn.  Execute the
    546       following commands to work around a broken kd.h file.  The commands will
    547       only make the modification if needed:</para>
    548 
    549 <screen><userinput>grep "__undef_LINUX" \
    550     /usr/include/sys/kd.h 2&gt;&amp;1 &gt; /dev/null || \
    551     sed -i.bak '/CONFIG_H/i #include &lt;linux/types.h&gt;' \
    552         hw/xfree86/os-support/linux/lnx_agp.c</userinput></screen>
    553 <!-- End remove -->
    554 
    555       <para>Install the server by running the following commands:</para>
    556 
    557 <screen><userinput>./configure $XORG_CONFIG \
    558     --with-mesa-source='<replaceable>&lt;/path/to&gt;</replaceable>/Mesa-&mesalib-version;' \
    559     --with-fontdir=$XORG_PREFIX/lib/X11/fonts \
    560     --with-module-dir=$XORG_PREFIX/lib/X11/modules &amp;&amp;
    561 make</userinput></screen>
    562 
    563       <para>Now as the <systemitem class="username">root</systemitem>
    564       user:</para>
    565 
    566 <screen><userinput role="root">make install</userinput></screen>
    567 
    568     </sect3>
    569 
    570   </sect2>
    571 
    572   <sect2>
    573     <title>Xorg Drivers</title>
    574 
    575     <indexterm zone="xorg7">
    576       <primary sortas="a-xorg7-driver">Xorg Drivers</primary>
    577     </indexterm>
    578 
    579       <para>The <application>Xorg</application> drivers provide the means
    580       for the xserver to take advantage of installed hardware.</para>
    581 
    582       <para><application>Xorg</application> Driver packages can be downloaded
    583       individually from <ulink
    584       url="http://xorg.freedesktop.org/releases/individual/driver/"/>.</para>
    585 
    586     <sect3 role="installation">
    587       <title>Installation of Xorg Drivers</title>
    588 
    589       <warning><para>It is very important not to build display drivers that
    590       cannot be used with your hardware.  For instance, do not build Sun drivers
    591       for an x86 PC as the Sun drivers will expect to see SPARC symbols
    592       exported from the kernel.  Failure to follow this warning will result
    593       in a display lockup, which requires a hard reboot, when configuring
    594       <application>Xorg</application> for the first time.</para></warning>
    595 
    596       <para>Install the drivers by running the following commands for each
    597       package:</para>
    598 
    599 <screen><userinput>./configure $XORG_CONFIG \
    600     --with-xorg-module-dir=$XORG_PREFIX/lib/X11/modules &amp;&amp;
    601 make</userinput></screen>
    602 
    603       <para>Now as the <systemitem class="username">root</systemitem>
    604       user:</para>
    605 
    606 <screen><userinput role="root">make install</userinput></screen>
    607 
    608     </sect3>
    609 
    610   </sect2>
    611 
    612   <sect2 role="configuration" id='xorg7-config'>
    613     <title>Configuring Xorg</title>
    614 
    615     <para>As the <systemitem class="username">root</systemitem> user ensure you
    616     have executed <command>ldconfig</command> and
    617     create the <filename>xorg.conf</filename> file with:</para>
    618 
    619 <screen><userinput>cd ~ &amp;&amp;
    620 Xorg -configure</userinput></screen>
    621 
    622     <para>The screen will go black and you may hear some clicking of the monitor.
    623     This command will create a file, <filename>xorg.conf.new</filename>, in your
    624     home directory.</para>
    625 
    626     <indexterm zone="xorg7 xorg7-config">
    627       <primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary>
    628     </indexterm>
    629 
    630     <para>Edit <filename>xorg.conf.new</filename> to suit your system. The
    631     details of the file are located in the xorg.conf man page. Some things
    632     you may want to do are:</para>
    633 
    634     <itemizedlist>
    635       <listitem>
    636         <para>Section "Files". Change the order of the font paths searched.
    637         You may want to put 100dpi fonts ahead of 75dpi fonts if your system
    638         normally comes up closer to 100 dots per inch. You may want to remove
    639         some font directories completely.</para>
    640       </listitem>
    641       <listitem>
    642         <para>Section "Module". If you are going to install NVidia
    643         drivers, remove the "dri" line.</para>
    644       </listitem>
    645       <listitem>
    646         <para>Sections "InputDevice". You may want to change the
    647         keyboard autorepeat rate by adding
    648         <option>Option "Autorepeat" "250 30"</option>.</para>
    649       </listitem>
    650       <listitem>
    651         <para>Section "Monitor". Specify the <option>VertRefresh</option>
    652         and <option>HorizSync</option> values if the system does not
    653         automatically detect the monitor and its values.</para>
    654       </listitem>
    655       <listitem>
    656         <para>Section "Device". You may want to set some of the options
    657         available for your selected video driver. A description of the driver
    658         parameters is in the man page for your driver.</para>
    659       </listitem>
    660       <listitem><para>Section "Screen". Add a DefaultDepth statement such as:
    661         <option>DefaultDepth 24</option>. In the SubSection for your
    662         default depth, add a modes line such as:
    663         <option>Modes "1600x1200" "1280x1024" "1024x768"</option>. The first
    664         mode listed will normally be the starting resolution.</para>
    665       </listitem>
    666     </itemizedlist>
    667 
    668     <para>Test the system with:</para>
    669 
    670 <screen><userinput>X -config ~/xorg.conf.new</userinput></screen>
    671 
    672     <para>You will only get a gray background with an X-shaped mouse cursor,
    673     but it confirms the system is working. Exit with
    674     <keycap>Control+Alt+Backspace</keycap>. If the system does not work, take
    675     a look at <filename>/var/log/Xorg.0.log</filename> to see what went
    676     wrong.</para>
    677 
    678     <para>As the <systemitem class="username">root</systemitem> user, create
    679     the configuration directory and move the configuration file to the new
    680     directory:</para>
    681 
    682 <screen role="root"><userinput>install -v -m755 -D ~/xorg.conf.new /etc/X11/xorg.conf</userinput></screen>
    683 
    684     <para>As the <systemitem class="username">root</systemitem> user, create
    685     <filename>.xinitrc</filename>:</para>
    686 
    687 <screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
    688 <literal># Begin .xinitrc file
    689 xterm  -g 80x40+0+0   &amp;
    690 xclock -g 100x100-0+0 &amp;
    691 twm</literal>
    692 EOF</userinput></screen>
    693 
    694     <para>This provides an initial screen with a small clock that is
    695     managed by a simple window manager, Tab Window Manager. For details of
    696     <command>twm</command>, see the man page.</para>
    697 
    698     <note>
    699       <para>The above file is the default configuration for Xorg.  Xorg's
    700       distribution no longer includes <command>xterm</command>, and as such the
    701       <command>startx</command> command will fail if you have not yet
    702       installed <xref linkend="xterm2"/>.</para>
    703     </note>
    704 
    705     <indexterm zone="xorg7 xorg7-config">
    706       <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
    707     </indexterm>
    708 
    709     <note>
    710       <para>When needed, <application>Xorg</application> creates the directory
    711       <filename class='directory'>/tmp/.ICE-unix</filename> if it does not
    712       exist. If this directory is not owned by
    713       <systemitem class="username">root</systemitem>,
    714       <application>Xorg</application> delays startup by a few seconds and also
    715       appends a warning to the logfile. This also affects startup of other
    716       applications. To improve performance, it is advisable to manually create
    717       the directory before <application>Xorg</application> uses it. Add the
    718       file creation to <filename>/etc/sysconfig/createfiles</filename> that is
    719       sourced by the <filename>/etc/rc.d/init.d/cleanfs</filename> startup
    720       script.</para>
    721 
    722 <screen role="root"><userinput>cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"
    723 <literal>/tmp/.ICE-unix dir 1777 root root</literal>
    724 EOF</userinput></screen>
    725     </note>
    726 
    727     <indexterm zone="xorg7 xorg7-config">
    728       <primary
    729       sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
    730     </indexterm>
    731 
    732     <para>Start <application>X</application> with:</para>
    733 
    734 <screen><userinput>startx</userinput></screen>
    735 
    736     <para>and a basic functional <application>X Window
    737     System</application> should be displayed.</para>
    738 
    739     <para>At this point, you should check out <xref linkend='x-setup'/> for
    740     the necessary configuration to make <application>X</application> fully
    741     functional. Additionally, you can have a look at <xref linkend='x-config'/>
    742     for information on fine tuning your <application>X</application>
    743     configuration.</para>
    744 
    745     <para>For a list of the package contents and a description of the commands,
    746     see the sections in the <xref linkend='xfree86-contents'/>.</para>
     138    <para>If you've decided to use an alternate prefix, be sure to add
     139    <filename class="directory">
     140    <replaceable>&lt;PREFIX&gt;</replaceable>/bin</filename> to your
     141    <envar>PATH</envar> environment variable and  <filename class="directory">
     142    <replaceable>&lt;PREFIX&gt;</replaceable>/lib/pkgconfig</filename>
     143    to your <envar>PKG_CONFIG_PATH</envar> variable.  For detailed instrucitons,
     144    see <xref linkend="postlfs-config-profile"/>.  You should also add
     145    <filename class="directory">
     146    <replaceable>&lt;PREFIX&gt;</replaceable>/lib</filename> to the
     147    <filename>/etc/ld.so.conf</filename> file.</para>
    747148
    748149  </sect2>
  • x/lib/mesalib.xml

    r9d91468a r3f72a148  
    6969    <xref linkend="pkgconfig"/></para>
    7070
    71     <bridgehead renderas="sect3">Optional Downloads</bridgehead>
    72     <para><ulink
    73     url="http://prdownloads.sourceforge.net/mesa3d/MesaGLUT-&mesalib-version;.tar.bz2"/>
    74     provides a working <filename class='libraryfile'>libglut</filename>.</para>
    75 
     71    <bridgehead renderas="sect3">Recommended Download</bridgehead>
    7672    <para><ulink
    7773    url="http://prdownloads.sourceforge.net/mesa3d/MesaDemos-&mesalib-version;.tar.bz2"/>
    7874    provides a demo and a diagnostic program to verify that GL is working
    7975    properly.</para>
     76
     77    <bridgehead renderas="sect3">Optional Download</bridgehead>
     78    <para><ulink
     79    url="http://prdownloads.sourceforge.net/mesa3d/MesaGLUT-&mesalib-version;.tar.bz2"/>
     80    provides a working <filename class='libraryfile'>libglut</filename>.</para>
    8081
    8182    <note>
     
    102103sed -i 's@lib/modules@lib/X11/modules@' src/glx/x11/dri_glx.c</userinput></screen>
    103104
    104     <para>Install <application>MesaLib</application>
     105    <para>Build <application>MesaLib</application>
    105106    by running the following command:</para>
    106107
     
    109110    <para>This package does not come with a test suite.</para>
    110111
    111     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     112    <para>Now, as the <systemitem class="username">root</systemitem> user,
     113    issue the following commands to install <application>MesaLib</application>.
     114    Again you should adjust the commands if you've installed the X Window
     115    System into any prefix other than
     116    <filename class="directory">/usr</filename>:</para>
    112117
    113118<screen role="root"><userinput>bin/installmesa /usr &amp;&amp;
     
    123128
    124129    <para>Install the demos as the
    125     <systemitem class="username">root</systemitem> user:</para>
     130    <systemitem class="username">root</systemitem> user, again adjusting for
     131    the prefix of your X Window System:</para>
    126132
    127133<screen role="root"><userinput>install -v -m755 glxinfo glxgears /usr/bin</userinput></screen>
     
    139145    <systemitem class="username">root</systemitem> user:</para>
    140146
    141 <screen><userinput role="root">ln -s -v <replaceable>&lt;/usr/X11&gt;</replaceable>/include/GL /usr/include</userinput></screen>
     147<screen><userinput role="root">ln -s -v <replaceable>&lt;PREFIX&gt;</replaceable>/include/GL /usr/include</userinput></screen>
    142148
    143149  </sect2>
Note: See TracChangeset for help on using the changeset viewer.