Changeset 190568b


Ignore:
Timestamp:
03/15/2006 02:41:59 PM (16 years ago)
Author:
Randy McMurchy <randy@…>
Branches:
10.0, 10.1, 11.0, 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, nosym, perl-modules, qt5new, systemd-11177, systemd-13485, trunk, xry111/git-date, xry111/git-date-for-trunk, xry111/git-date-test
Children:
0602a99
Parents:
fa15c03
Message:

Fixed some typos and removed excess EOL whitespace from the Xorg7 instructions

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

File:
1 edited

Legend:

Unmodified
Added
Removed
  • x/installing/xorg7.xml

    rfa15c03 r190568b  
    1515      <keyword role="package">X11R&xorg7-version;-src.tar</keyword>
    1616      <keyword role="ftpdir">Xorg7</keyword>
    17     </keywordset> 
     17    </keywordset>
    1818########## Need a way to fix this on the mirrors ##########
    1919##### Maybe a single tarball is the way to handle it ######
     
    3232    <title>Introduction to Xorg</title>
    3333
    34     <para><application>Xorg</application> is a freely redistributable, 
    35     open-source implementation of the <application>X</application> Window 
    36     System. This system provides a client/server interface between display 
    37     hardware (the mouse, keyboard, and video displays) and the desktop 
    38     environment, while also providing both the windowing infrastructure and a 
     34    <para><application>Xorg</application> is a freely redistributable,
     35    open-source implementation of the <application>X</application> Window
     36    System. This system provides a client/server interface between display
     37    hardware (the mouse, keyboard, and video displays) and the desktop
     38    environment, while also providing both the windowing infrastructure and a
    3939    standardized application interface (API).</para>
    4040
     
    4545    <xref linkend="libdrm"/>,
    4646    <xref linkend="libpng"/>, and
    47     <xref linkend="pkgconfig"/>.</para>
     47    <xref linkend="pkgconfig"/></para>
    4848
    4949    <bridgehead renderas="sect4">Optional</bridgehead>
    50     <para role="optional"><xref linkend="linux-pam"/>.</para>
    51 
    52     <bridgehead renderas="sect3">Xorg Download and Installation 
     50    <para role="optional"><xref linkend="linux-pam"/></para>
     51
     52    <bridgehead renderas="sect3">Xorg Download and Installation
    5353    Instructions</bridgehead>
    5454
    5555    <para>With the modular build system, it is no longer possible to download
    56     the entire package in a single file.  In fact, there may be as many as 
    57     280 files that need to be fetched from the download location.  To assist 
    58     with such a large task, it is strongly recommended to install 
    59     <xref linkend="wget"/> for downloading the needed files.  A complete 
    60     <application>wget</application> script is available for each section at 
    61     <ulink 
     56    the entire package in a single file.  In fact, there may be as many as
     57    280 files that need to be fetched from the download location.  To assist
     58    with such a large task, it is strongly recommended to install
     59    <xref linkend="wget"/> for downloading the needed files.  A complete
     60    <application>wget</application> script is available for each section at
     61    <ulink
    6262    url="http://anduin.linuxfromscratch.org/sources/BLFS/svn/x/wget/"/>.</para>
    6363
    64     <para>Given the number of packages available, deciding which packages you 
    65     need to install for your particular setup may seem a bit overwhelming at 
    66     first.  Take a look at<ulink 
    67     url="http://lists.x.org/archives/xorg-modular/2005-November/000801.html"> 
    68     this thread</ulink> to get an idea of what you will need.  If you are 
    69     unsure, you should install all packages at the cost of extra 
     64    <para>Given the number of packages available, deciding which packages you
     65    need to install for your particular setup may seem a bit overwhelming at
     66    first.  Take a look at<ulink
     67    url="http://lists.x.org/archives/xorg-modular/2005-November/000801.html">
     68    this thread</ulink> to get an idea of what you will need.  If you are
     69    unsure, you should install all packages at the cost of extra
    7070    disk space.</para>
    7171
    72     <note><para>The installed size of <application>Xorg</application> can
    73     be reduced considerably by installing only the packages that you will
    74     need and use. However, the BLFS book cannot account for all dependencies
    75     and build options for individual <application>Xorg</application>
    76     packages.  The instructions assume that all packages have been built
    77     from a particular group unless otherwise noted. A
    78     <ulink url="http://wiki.linuxfromscratch.org/blfs/wiki/Xorg-7.0.0">
    79     wiki</ulink> page containing dependency information, for users who wish
    80     to cut down on the installed size of <application>Xorg</application>, is
    81     under development.  You are encouraged to add to these
    82     pages if you discover additional information that may be helpful to
    83     other users.</para></note>
     72    <note>
     73      <para>The installed size of <application>Xorg</application> can
     74      be reduced considerably by installing only the packages that you will
     75      need and use. However, the BLFS book cannot account for all dependencies
     76      and build options for individual <application>Xorg</application>
     77      packages.  The instructions assume that all packages have been built
     78      from a particular group unless otherwise noted. A
     79      <ulink url="http://wiki.linuxfromscratch.org/blfs/wiki/Xorg-7.0.0">
     80      wiki</ulink> page containing dependency information, for users who wish
     81      to cut down on the installed size of <application>Xorg</application>, is
     82      under development.  You are encouraged to add to these
     83      pages if you discover additional information that may be helpful to
     84      other users.</para>
     85    </note>
    8486
    8587    <para>Additionally, because of the large number of repetitive commands,
     
    113115cd xc</userinput></screen>
    114116
    115     <para>As with previous releases of the X Window System, it may be 
    116     desirable to install <application>Xorg</application> into an alternate 
    117     prefix.  This is no longer common practice among linux distributions. 
     117    <para>As with previous releases of the X Window System, it may be
     118    desirable to install <application>Xorg</application> into an alternate
     119    prefix.  This is no longer common practice among Linux distributions.
    118120    The common installation prefix for <application>Xorg</application> on
    119     linux is <filename class="directory">/usr</filename>.  There is no
    120     standard alternate prefix, nor is there any exception in the current 
    121     revision of the Filesystem Hierarchy Standard for Release 7 of the X 
    122     Window System.  Alan Coopersmith of Sun Microsystems, has recently 
    123     stated "At Sun, we were using 
    124     <filename class="directory">/usr/X11</filename> and plan to stick with 
    125     it."  Only the <filename class="directory">/opt/*</filename> prefix or 
    126     the <filename class="directory">/usr</filename> prefix adhere to the 
     121    Linux is <filename class="directory">/usr</filename>.  There is no
     122    standard alternate prefix, nor is there any exception in the current
     123    revision of the Filesystem Hierarchy Standard for Release 7 of the X
     124    Window System.  Alan Coopersmith of Sun Microsystems, has recently
     125    stated "At Sun, we were using
     126    <filename class="directory">/usr/X11</filename> and plan to stick with
     127    it."  Only the <filename class="directory">/opt/*</filename> prefix or
     128    the <filename class="directory">/usr</filename> prefix adhere to the
    127129    current FHS guidelines.</para>
    128    
    129     <para>Choose your installation prefix, and set the 
    130     <parameter>XORG_PREFIX</parameter> variable with the following
     130
     131    <para>Choose your installation prefix, and set the
     132    <envar>XORG_PREFIX</envar> variable with the following
    131133    command:</para>
    132134
    133135<screen><userinput>export XORG_PREFIX="<replaceable>[/usr]</replaceable>"</userinput></screen>
    134136
    135     <para>Throughout these instructions, you will use the same three 
    136     configure switches for all of the packages.  Create the
    137     <parameter>XORG_CONFIG</parameter> variable to use for substitution:</para>
     137    <para>Throughout these instructions, you will use the same three
     138    <command>configure</command> switches for all of the packages.  Create the
     139    <envar>XORG_CONFIG</envar> variable to use for substitution:</para>
    138140
    139141<screen><userinput>export XORG_CONFIG="--prefix=$XORG_PREFIX --sysconfdir=/etc --localstatedir=/var"</userinput></screen>
    140142
    141     <note><para>If you've decided to use an alternate prefix, be sure to
    142     add an the
    143     <replaceable>[/usr]</replaceable><filename class="directory">/lib/pkgconfig</filename>
    144     to your <parameter>PKG_CONFIG_PATH</parameter> variable.</para></note>
     143    <note>
     144      <para>If you've decided to use an alternate prefix, be sure to add
     145      <filename class="directory"><replaceable>[/usr]</replaceable>/lib/pkgconfig</filename>
     146      to your <envar>PKG_CONFIG_PATH</envar> variable.</para>
     147    </note>
    145148
    146149  </sect2>
     
    186189
    187190      <para>The <application>Xorg</application> utility packages provide
    188       needed utilities, not for the <application>Xorg</application> 
     191      needed utilities, not for the <application>Xorg</application>
    189192      installation itself, but for other applications that make use of
    190193      legacy X11R6 installation methods.</para>
     
    197200      <title>Installation of Xorg Utilities</title>
    198201
    199       <para>Install first, the <application>xorg-cf-files</application> package
     202      <para>First install the <application>xorg-cf-files</application> package
    200203      with the following commands:</para>
    201204
     
    222225
    223226
    224       <para>Finally, build the three remaining packages with the standard build 
     227      <para>Finally, build the three remaining packages with the standard build
    225228      commands:</para>
    226229
     
    255258      <title>Meeting Library Dependencies</title>
    256259
    257       <para>These 17 libraries must be built first, in the order provided, 
     260      <para>These 17 libraries must be built first, in the order provided,
    258261      to cover the dependencies of the other library packages:</para>
    259262
     
    281284      <title>Installation of Xorg Libraries</title>
    282285
    283       <para>Install the libraries by running the following commands for each 
     286      <para>Install the libraries by running the following commands for each
    284287      of the chosen packages:</para>
    285288
     
    298301
    299302        <para>If you've chosen to install <application>Xorg</application> into
    300         <filename class="directory">/usr</filename>, then no further 
     303        <filename class="directory">/usr</filename>, then no further
    301304        configuration is necessary and you can skip the rest of this section.
    302305        If you've opted for an alternate prefix, you should create two symlinks
    303         to satisfy the expected environment of several packages. 
     306        to satisfy the expected environment of several packages.
    304307        Execute the following commands as the root user:</para>
    305308
     
    307310ln -sv $XORG_PREFIX/include/X11 /usr/include/X11</userinput></screen>
    308311
    309         <para>As with other libraries, as the root user, you must add
     312        <para>As with other library directories, as the root user you must add
    310313        <filename class="directory">$XORG_PREFIX/lib</filename> to
    311         <filename>/etc/ld.so.conf</filename> and execute 
     314        <filename>/etc/ld.so.conf</filename> and execute
    312315        <command>/sbin/ldconfig</command>.</para>
    313316
     
    324327
    325328      <para>The <application>Xorg</application> data packages provide
    326       static data such as images and keymaps to the 
     329      static data such as images and keymaps to the
    327330      <application>Xorg</application> applications.</para>
    328331
     
    340343make</userinput></screen>
    341344
    342       <para>Now as the <systemitem class="username">root</systemitem>
    343       user:</para>
    344 
    345 <screen><userinput role="root">make install</userinput></screen>
    346 
    347       <note><para>At this point, you should continue to the applications
    348       installation.  After the applications installation has completed, you
    349       can use the same instructions above to install the xcursor-themes and
    350       xkb-data packages.</para></note>
     345      <para>Now as the <systemitem class="username">root</systemitem>
     346      user:</para>
     347
     348<screen><userinput role="root">make install</userinput></screen>
     349
     350      <note>
     351        <para>At this point, you should continue to the applications
     352        installation.  After the applications installation has completed, you
     353        can use the same instructions above to install the xcursor-themes and
     354        xkb-data packages.</para>
     355      </note>
    351356
    352357    </sect3>
     
    361366    </indexterm>
    362367
    363     <note><para>You must install <xref linkend="MesaLib"/> before you install
    364     Xorg Applications.</para></note>
     368    <note>
     369      <para>You must install <xref linkend="MesaLib"/> before you install
     370      Xorg Applications.</para>
     371    </note>
    365372
    366373      <para>The <application>Xorg</application> applications provide the
     
    369376
    370377      <para><application>Xorg</application> applications can be downloaded
    371       individually from <ulink 
     378      individually from <ulink
    372379      url="http://xorg.freedesktop.org/releases/X11R7.0/src/app/"/>.</para>
    373380
     
    375382      <title>Installation of Xorg Applications</title>
    376383
    377       <para>Install the applications by running the following commands for each 
     384      <para>Install the applications by running the following commands for each
    378385      chosen package:</para>
    379386
     
    381388make</userinput></screen>
    382389
    383       <para>Now as the <systemitem class="username">root</systemitem>
    384       user:</para>
    385 
    386 <screen><userinput role="root">make install</userinput></screen>
    387 
    388       <note><para>The luit package should not be compiled at this point.  You
    389       should install the luit application after the fonts have been
    390       installed.</para></note>
    391 
    392       <note><para>Remember to return to the data packages and install the
    393       xcursor-themes and xkb-data packages.</para></note>
     390      <para>Now as the <systemitem class="username">root</systemitem>
     391      user:</para>
     392
     393<screen><userinput role="root">make install</userinput></screen>
     394
     395      <note>
     396        <para>The luit package should not be compiled at this point.  You
     397        should install the luit application after the fonts have been
     398        installed.</para>
     399      </note>
     400
     401      <note>
     402        <para>Remember to return to the data packages and install the
     403        xcursor-themes and xkb-data packages.</para>
     404      </note>
    394405
    395406</sect3>
     
    401412      <para>A patch is required to fix a race condition in
    402413      <application>luit</application> that was discovered shortly after
    403       release.  Download the patch from 
     414      release.  Download the patch from
    404415      <ulink url="&patch-root;/luit-1.0.1-race-1.patch"/>.</para>
    405416
     
    410421make</userinput></screen>
    411422
    412       <para>Now as the <systemitem class="username">root</systemitem> 
     423      <para>Now as the <systemitem class="username">root</systemitem>
    413424      user:</para>
    414425
     
    438449      <para>Run the following commands for each package:</para>
    439450
    440       <note><para>You should install encodings and font-util before all
    441       other font packages</para></note>
     451      <note>
     452        <para>You should install encodings and font-util before all
     453        other font packages.</para>
     454      </note>
    442455
    443456
     
    449462<screen><userinput role="root">make install</userinput></screen>
    450463
    451       <note><para>If you haven't done so, and intend to install
    452       <application>luit</application>, do so now.</para></note>
     464      <note>
     465        <para>If you haven't done so, and intend to install
     466        <application>luit</application>, do so now.</para>
     467      </note>
     468
    453469    </sect3>
    454470
     
    471487      <title>Installation of Xorg Server</title>
    472488
    473       <note><para>You must have the <application>Mesa</application> source
    474       directory available when building the
    475       <application>Xorg-server</application>.</para></note>
     489      <note>
     490        <para>You must have the <application>Mesa</application> source
     491        directory available when building the
     492        <application>Xorg-server</application>.</para>
     493      </note>
    476494
    477495      <para>Install the server by running the following commands:</para>
     
    480498    hw/xfree86/os-support/linux/lnx_agp.c &amp;&amp;
    481499./configure --prefix=$XORG_PREFIX --sysconfdir=/etc \
    482     --localstatedir=/var --with-mesa-source='../../Mesa-&mesalib-version;' \
     500    --localstatedir=/var \
     501    --with-mesa-source='../../Mesa-&mesalib-version;' \
    483502    --with-fontdir=/usr/share/fonts \
    484503    --with-module-dir=$XORG_PREFIX/lib/X11/modules &amp;&amp;
     
    512531
    513532      <warning><para>It is very important not to build display drivers that
    514       cannot be used on your hardware.  For instance, do not build Sun drivers
     533      cannot be used with your hardware.  For instance, do not build Sun drivers
    515534      for an x86 PC as the Sun drivers will expect to see SPARC symbols
    516535      exported from the kernel.  Failure to follow this warning will result
     
    518537      <application>Xorg</application> for the first time.</para></warning>
    519538
    520       <para>Install the drivers by running the following commands for each 
     539      <para>Install the drivers by running the following commands for each
    521540      package:</para>
    522541
     
    537556    <title>Configuring Xorg</title>
    538557
    539     <para>Make certain that you have executed  <command>ldconfig</command> and
     558    <para>As the <systemitem class="username">root</systemitem> user ensure you
     559    have executed <command>ldconfig</command> and
    540560    create the <filename>xorg.conf</filename> file with:</para>
    541561
     
    544564
    545565    <para>The screen will go black and you may hear some clicking of the monitor.
    546     This command will create a file, <filename>xorg.conf.new</filename> in your
     566    This command will create a file, <filename>xorg.conf.new</filename>, in your
    547567    home directory.</para>
    548568
     
    599619    wrong.</para>
    600620
    601     <para>Move the configuration file to its final location:</para>
     621    <para>As the <systemitem class="username">root</systemitem> user, move
     622    the configuration file to its final location:</para>
    602623
    603624<screen role="root"><userinput>mv ~/xorg.conf.new /etc/X11/xorg.conf</userinput></screen>
    604625
    605     <para>Create <filename>.xinitrc</filename>:</para>
     626    <para>As the <systemitem class="username">root</systemitem> user, create
     627    <filename>.xinitrc</filename>:</para>
    606628
    607629<screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
     
    616638    <command>twm</command>, see the man page.</para>
    617639
    618     <note><para>The above file is the default configuration for Xorg.  Xorg's
    619     distribution no longer includes xterm, as such the startx will fail if
    620     you have not yet installed <xref linkend="xterm2"/>.</para></note>
     640    <note>
     641      <para>The above file is the default configuration for Xorg.  Xorg's
     642      distribution no longer includes <command>xterm</command>, and as such the
     643      <command>startx</command> command will fail if you have not yet
     644      installed <xref linkend="xterm2"/>.</para>
     645    </note>
    621646
    622647    <indexterm zone="xorg7 xorg7-config">
     
    626651    <note>
    627652      <para>When needed, <application>Xorg</application> creates the directory
    628       <filename>/tmp/.ICE-unix</filename> if it does not exist. If this
    629       directory is not owned by <systemitem class="username">root</systemitem>,
     653      <filename class='directory'>/tmp/.ICE-unix</filename> if it does not
     654      exist. If this directory is not owned by
     655      <systemitem class="username">root</systemitem>,
    630656      <application>Xorg</application> delays startup by a few seconds and also
    631657      appends a warning to the logfile. This also affects startup of other
     
    639665<literal>/tmp/.ICE-unix dir 1777 root root</literal>
    640666EOF</userinput></screen>
    641 
    642667    </note>
    643668
     
    651676<screen><userinput>startx</userinput></screen>
    652677
    653     <para>to get a basic functional <application>X Window
    654     System</application>.</para>
     678    <para>and a basic functional <application>X Window
     679    System</application> should be displayed.</para>
    655680
    656681    <para>At this point, you should check out <xref linkend='x-setup'/> for
Note: See TracChangeset for help on using the changeset viewer.