Ignore:
Timestamp:
03/21/2020 11:02:56 AM (4 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
baac59c
Parents:
bdfc854
Message:

Format the x/installing chapter

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • x/installing/x7lib.xml

    rbdfc854 r71df408  
    125125    <title>Introduction to Xorg Libraries</title>
    126126
    127     <para>The <application>Xorg</application> libraries provide library
    128     routines that are used within all X Window applications.</para>
     127    <para>
     128      The <application>Xorg</application> libraries provide library
     129      routines that are used within all X Window applications.
     130    </para>
    129131
    130132    &lfs91_checked;
    … …  
    133135    <itemizedlist spacing="compact">
    134136      <listitem>
    135         <para>Download (HTTP): <ulink url="&x7libs-download-http;"/></para>
     137        <para>
     138          Download (HTTP): <ulink url="&x7libs-download-http;"/>
     139        </para>
    136140      </listitem>
    137141      <listitem>
    138         <para>Download (FTP): <ulink url="&x7libs-download-ftp;"/></para>
     142        <para>
     143          Download (FTP): <ulink url="&x7libs-download-ftp;"/>
     144        </para>
    139145      </listitem>
    140146      <listitem>
    141         <para>Download size: &x7libs-size;</para>
     147        <para>
     148          Download size: &x7libs-size;
     149        </para>
    142150      </listitem>
    143151      <listitem>
    144         <para>Estimated disk space required: &x7libs-buildsize;</para>
     152        <para>
     153          Estimated disk space required: &x7libs-buildsize;
     154        </para>
    145155      </listitem>
    146156      <listitem>
    147         <para>Estimated build time: &x7libs-time;</para>
     157        <para>
     158          Estimated build time: &x7libs-time;
     159        </para>
    148160      </listitem>
    149161    </itemizedlist>
    … …  
    163175
    164176    <bridgehead renderas="sect4">Optional</bridgehead>
    165     <para role="optional"><xref linkend="xmlto"/> with one or more of the
    166     following: <xref linkend="fop"/>,
    167     <xref linkend="Links"/>,
    168     <xref linkend="lynx"/>,
    169     and <ulink url="&w3m-url;">W3m</ulink> (to generate additional PDF or text
    170     documentation for the libXfont package).</para>
     177    <para role="optional">
     178      <xref linkend="xmlto"/> with one or more of the following:
     179      <xref linkend="fop"/>,
     180      <xref linkend="Links"/>,
     181      <xref linkend="lynx"/>, and
     182      <ulink url="&w3m-url;">W3m</ulink> (to generate additional PDF or text
     183      documentation for the libXfont package).
     184    </para>
    171185
    172186    <para condition="html" role="usernotes">User Notes:
    … …  
    178192    <title>Downloading Xorg Libraries</title>
    179193
    180     <para>First, create a list of files to be downloaded. This file will also
    181     be used to verify the integrity of the downloads when complete:</para>
     194    <para>
     195      First, create a list of files to be downloaded. This file will also
     196      be used to verify the integrity of the downloads when complete:
     197    </para>
    182198
    183199<screen><userinput>cat &gt; lib-&xorg-version;.md5 &lt;&lt; "EOF"
    … …  
    216232EOF</userinput></screen>
    217233
    218     <para>To download the needed files using <application>wget</application>,
    219     use the following commands:</para>
     234    <para>
     235      To download the needed files using <application>wget</application>,
     236      use the following commands:
     237    </para>
    220238
    221239<screen><userinput>mkdir lib &amp;&amp;
    … …  
    232250&as_root;
    233251
    234     <para>Some libraries come with a test suite. If you wish to execute them,
    235     either comment out the <command>rm -rf ...</command> below, so that, after
    236     all libraries are installed, you can come back to the corresponding
    237     directory and run <command>make check</command>, or do individual builds,
    238     running the tests for each of those distributed with working test suites.
    239     Alternatively, you can uncomment the line #<command>make check
    240     ...</command>, and at the end, check the test results with:</para>
     252    <para>
     253      Some libraries come with a test suite. If you wish to execute them,
     254      either comment out the <command>rm -rf ...</command> below, so that,
     255      after all libraries are installed, you can come back to the corresponding
     256      directory and run <command>make check</command>, or do individual builds,
     257      running the tests for each of those distributed with working test suites.
     258      Alternatively, you can uncomment the line #<command>make check
     259      ...</command>, and at the end, check the test results with:
     260    </para>
    241261
    242262<screen><userinput>grep -A9 summary *make_check.log</userinput></screen>
    243263
    244     <para>BLFS developers have confirmed that
    245     <application>libX11</application>, <application>libXt</application> and
    246     <application>libxshmfence</application> are distributed with working test
    247     suites.</para>
    248 
    249     <para>First, start a subshell that will exit on error:</para>
     264    <para>
     265      BLFS developers have confirmed that
     266      <application>libX11</application>, <application>libXt</application> and
     267      <application>libxshmfence</application> are distributed with working test
     268      suites.
     269    </para>
     270
     271    <para>
     272      First, start a subshell that will exit on error:
     273    </para>
    250274
    251275<screen><userinput>bash -e</userinput></screen>
    252276
    253     <para>Install all of the packages by running the following
    254     commands:</para>
     277    <para>
     278      Install all of the packages by running the following commands:
     279    </para>
    255280
    256281<screen><userinput>for package in $(grep -v '^#' ../lib-&xorg-version;.md5 | awk '{print $2}')
    … …  
    285310done</userinput></screen>
    286311
    287     <para>Finally, exit the shell that was started earlier:</para>
     312    <para>
     313      Finally, exit the shell that was started earlier:
     314    </para>
    288315
    289316<screen><userinput>exit</userinput></screen>
    … …  
    294321    <title>Command Explanations</title>
    295322
    296     <para><command>./configure $XORG_CONFIG ICE_LIBS=-lpthread</command>:
    297     This fixes a change in glibc which breaks pulseaudio at runtime.</para>
     323    <para>
     324      <command>./configure $XORG_CONFIG ICE_LIBS=-lpthread</command>:
     325      This fixes a change in glibc which breaks pulseaudio at runtime.
     326    </para>
    298327
    299328<!--
    300     <para><command>sed ... src/xftfreetype.c include/X11/Xft/XftCompat.h</command>:
    301     Add fixes for changes in recent glibc headers.</para>
     329    <para>
     330      <command>sed ... src/xftfreetype.c include/X11/Xft/XftCompat.h</command>:
     331      Add fixes for changes in recent glibc headers.
     332    </para>
    302333-->
    303334
    304     <para><parameter>--disable-devel-docs</parameter>: Disable generation of
    305     text documentation in the libXfont2 package if
    306     <xref linkend="xmlto"/> is installed without a text browser. Omit
    307     this parameter (or the entire <command>case</command> statement) if a text
    308     browser is installed.</para>
    309 
    310     <para><option>--with-fop</option>: Use <xref linkend="fop"/> to
    311     generate PDF documentation (only for the libXfont package).</para>
     335    <para>
     336      <parameter>--disable-devel-docs</parameter>: Disable generation of
     337      text documentation in the libXfont2 package if
     338      <xref linkend="xmlto"/> is installed without a text browser. Omit this
     339      parameter (or the entire <command>case</command> statement) if a text
     340      browser is installed.
     341    </para>
     342
     343    <para>
     344      <option>--with-fop</option>: Use <xref linkend="fop"/> to
     345      generate PDF documentation (only for the libXfont package).
     346    </para>
    312347
    313348  </sect2>
    … …  
    316351    <title>Configuration of Xorg Libraries</title>
    317352
    318     <para>If you've chosen to install <application>Xorg</application> into
    319     <filename class="directory">/usr</filename>, then no further
    320     configuration is necessary and you can skip the rest of this section.
    321     If you've opted for an alternate prefix, you should create two symlinks
    322     to satisfy the expected environment of several packages.
    323     Execute the following commands as the root user:</para>
     353    <para>
     354      If you've chosen to install <application>Xorg</application> into
     355      <filename class="directory">/usr</filename>, then no further
     356      configuration is necessary and you can skip the rest of this section.
     357      If you've opted for an alternate prefix, you should create two symlinks
     358      to satisfy the expected environment of several packages.
     359      Execute the following commands as the root user:
     360    </para>
    324361
    325362<screen role="root"><userinput>ln -sv $XORG_PREFIX/lib/X11 /usr/lib/X11 &amp;&amp;
    … …  
    381418        <term><command>cxpm</command></term>
    382419        <listitem>
    383           <para>checks the format of an XPM file.</para>
     420          <para>
     421            checks the format of an XPM file.
     422          </para>
    384423          <indexterm zone="xorg7-lib cxpm">
    385424            <primary sortas="b-cxpm">cxpm</primary>
    … …  
    391430        <term><command>sxpm</command></term>
    392431        <listitem>
    393           <para>shows an XPM file and/or converts XPM 1 or 2 files to
    394           XPM 3.</para>
     432          <para>
     433            shows an XPM file and/or converts XPM 1 or 2 files to XPM 3.
     434          </para>
    395435          <indexterm zone="xorg7-lib sxpm">
    396436            <primary sortas="b-sxpm">sxpm</primary>
    … …  
    402442        <term><filename class="libraryfile">libdmx.so</filename></term>
    403443        <listitem>
    404           <para>is the X Window System DMX (Distributed Multihead X) extension
    405           library.</para>
     444          <para>
     445            is the X Window System DMX (Distributed Multihead X) extension
     446            library.
     447          </para>
    406448          <indexterm zone="xorg7-lib libdmx">
    407449            <primary sortas="c-libdmx">libdmx.so</primary>
    … …  
    413455        <term><filename class="libraryfile">libfontenc.so</filename></term>
    414456        <listitem>
    415           <para>is the X11 font encoding library.</para>
     457          <para>
     458            is the X11 font encoding library.
     459          </para>
    416460          <indexterm zone="xorg7-lib libfontenc">
    417461            <primary sortas="c-libfontenc">libfontenc.so</primary>
    … …  
    423467        <term><filename class="libraryfile">libFS.so</filename></term>
    424468        <listitem>
    425           <para>is the library interface to the X Font Server.</para>
     469          <para>
     470            is the library interface to the X Font Server.
     471          </para>
    426472          <indexterm zone="xorg7-lib libFS">
    427473            <primary sortas="c-libFS">libFS.so</primary>
    … …  
    433479        <term><filename class="libraryfile">libICE.so</filename></term>
    434480        <listitem>
    435           <para>is the X Inter Client Exchange Library.</para>
     481          <para>
     482            is the X Inter Client Exchange Library.
     483          </para>
    436484          <indexterm zone="xorg7-lib libICE">
    437485            <primary sortas="c-libICE">libICE.so</primary>
    … …  
    443491        <term><filename class="libraryfile">libpciaccess.so</filename></term>
    444492        <listitem>
    445           <para>is the generic PCI Access library for X.</para>
     493          <para>
     494            is the generic PCI Access library for X.
     495          </para>
    446496          <indexterm zone="xorg7-lib libpciaccess">
    447497            <primary sortas="c-libpciaccess">libpciaccess.so</primary>
    … …  
    453503        <term><filename class="libraryfile">libSM.so</filename></term>
    454504        <listitem>
    455           <para>is the X Session Management Library.</para>
     505          <para>
     506            is the X Session Management Library.
     507          </para>
    456508          <indexterm zone="xorg7-lib libSM">
    457509            <primary sortas="c-libSM">libSM.so</primary>
    … …  
    463515        <term><filename class="libraryfile">libX11.so</filename></term>
    464516        <listitem>
    465           <para>is the Xlib Library.</para>
     517          <para>
     518            is the Xlib Library.
     519          </para>
    466520          <indexterm zone="xorg7-lib libX11">
    467521            <primary sortas="c-libX11">libX11.so</primary>
    … …  
    473527        <term><filename class="libraryfile">libXaw6.so</filename></term>
    474528        <listitem>
    475           <para>is the X Athena Widgets Library, version 6.</para>
     529          <para>
     530            is the X Athena Widgets Library, version 6.
     531          </para>
    476532          <indexterm zone="xorg7-lib libXaw6">
    477533            <primary sortas="c-libXaw6">libXaw6.so</primary>
    … …  
    483539        <term><filename class="libraryfile">libXaw7.so</filename></term>
    484540        <listitem>
    485           <para>is the X Athena Widgets Library, version 7.</para>
     541          <para>
     542            is the X Athena Widgets Library, version 7.
     543          </para>
    486544          <indexterm zone="xorg7-lib libXaw7">
    487545            <primary sortas="c-libXaw7">libXaw7.so</primary>
    … …  
    493551        <term><filename class="libraryfile">libXaw.so</filename></term>
    494552        <listitem>
    495           <para>are symbolic links to the current X Athena Widgets Library,
    496           version 7.</para>
     553          <para>
     554            are symbolic links to the current X Athena Widgets Library,
     555            version 7.
     556          </para>
    497557          <indexterm zone="xorg7-lib libXaw">
    498558            <primary sortas="c-libXaw">libXaw.so</primary>
    … …  
    504564        <term><filename class="libraryfile">libXcomposite.so</filename></term>
    505565        <listitem>
    506           <para>is the X Composite Library.</para>
     566          <para>
     567            is the X Composite Library.
     568          </para>
    507569          <indexterm zone="xorg7-lib libXcomposite">
    508570            <primary sortas="c-libXcomposite">libXcomposite.so</primary>
    … …  
    514576        <term><filename class="libraryfile">libXcursor.so</filename></term>
    515577        <listitem>
    516           <para>is the X Cursor management library.</para>
     578          <para>
     579            is the X Cursor management library.
     580          </para>
    517581          <indexterm zone="xorg7-lib libXcursor">
    518582            <primary sortas="c-libXcursor">libXcursor.so</primary>
    … …  
    524588        <term><filename class="libraryfile">libXdamage.so</filename></term>
    525589        <listitem>
    526           <para>is the X Damage Library.</para>
     590          <para>
     591            is the X Damage Library.
     592          </para>
    527593          <indexterm zone="xorg7-lib libXdamage">
    528594            <primary sortas="c-libXdamage">libXdamage.so</primary>
    … …  
    534600        <term><filename class="libraryfile">libXext.so</filename></term>
    535601        <listitem>
    536           <para>is the Misc X Extension Library.</para>
     602          <para>
     603            is the Misc X Extension Library.
     604          </para>
    537605          <indexterm zone="xorg7-lib libXext">
    538606            <primary sortas="c-libXext">libXext.so</primary>
    … …  
    544612        <term><filename class="libraryfile">libXfixes.so</filename></term>
    545613        <listitem>
    546           <para>provides augmented versions of core protocol
    547           requests.</para>
     614          <para>
     615            provides augmented versions of core protocol requests.
     616          </para>
    548617          <indexterm zone="xorg7-lib libXfixes">
    549618            <primary sortas="c-libXfixes">libXfixes.so</primary>
    … …  
    555624        <term><filename class="libraryfile">libXfont2.so</filename></term>
    556625        <listitem>
    557           <para>is the X font library.</para>
     626          <para>
     627            is the X font library.
     628          </para>
    558629          <indexterm zone="xorg7-lib libXfont2">
    559630            <primary sortas="c-libXfont2">libXfont2.so</primary>
    … …  
    565636        <term><filename class="libraryfile">libXft.so</filename></term>
    566637        <listitem>
    567           <para>is the X FreeType interface library.</para>
     638          <para>
     639            is the X FreeType interface library.
     640          </para>
    568641          <indexterm zone="xorg7-lib libXft">
    569642            <primary sortas="c-libXft">libXft.so</primary>
    … …  
    575648        <term><filename class="libraryfile">libXinerama.so</filename></term>
    576649        <listitem>
    577           <para>is the Xinerama Library.</para>
     650          <para>
     651            is the Xinerama Library.
     652          </para>
    578653          <indexterm zone="xorg7-lib libXinerama">
    579654            <primary sortas="c-libXinerama">libXinerama.so</primary>
    … …  
    585660        <term><filename class="libraryfile">libXi.so</filename></term>
    586661        <listitem>
    587           <para>is the X Input Extension Library.</para>
     662          <para>
     663            is the X Input Extension Library.
     664          </para>
    588665          <indexterm zone="xorg7-lib libXi">
    589666            <primary sortas="c-libXi">libXi.so</primary>
    … …  
    595672        <term><filename class="libraryfile">libxkbfile.so</filename></term>
    596673        <listitem>
    597           <para>is the xkbfile Library.</para>
     674          <para>
     675            is the xkbfile Library.
     676          </para>
    598677          <indexterm zone="xorg7-lib libxkbfile">
    599678            <primary sortas="c-libxkbfile">libxkbfile.so</primary>
    … …  
    605684        <term><filename class="libraryfile">libXmu.so</filename></term>
    606685        <listitem>
    607           <para>is the X interface library for miscellaneous utilities not
    608           part of the Xlib standard.</para>
     686          <para>
     687            is the X interface library for miscellaneous utilities not
     688            part of the Xlib standard.
     689          </para>
    609690          <indexterm zone="xorg7-lib libXmu">
    610691            <primary sortas="c-libXmu">libXmu.so</primary>
    … …  
    616697        <term><filename class="libraryfile">libXmuu.so</filename></term>
    617698        <listitem>
    618           <para>is the Mini Xmu Library.</para>
     699          <para>
     700            is the Mini Xmu Library.
     701          </para>
    619702          <indexterm zone="xorg7-lib libXmuu">
    620703            <primary sortas="c-libXmuu">libXmuu.so</primary>
    … …  
    626709        <term><filename class="libraryfile">libXpm.so</filename></term>
    627710        <listitem>
    628           <para>is the X Pixmap Library.</para>
     711          <para>
     712            is the X Pixmap Library.
     713          </para>
    629714          <indexterm zone="xorg7-lib libXpm">
    630715            <primary sortas="c-libXpm">libXpm.so</primary>
    … …  
    636721        <term><filename class="libraryfile">libXrandr.so</filename></term>
    637722        <listitem>
    638           <para>is the X Resize, Rotate and Reflection extension library.</para>
     723          <para>
     724            is the X Resize, Rotate and Reflection extension library.
     725          </para>
    639726          <indexterm zone="xorg7-lib libXrandr">
    640727            <primary sortas="c-libXrandr">libXrandr.so</primary>
    … …  
    646733        <term><filename class="libraryfile">libXrender.so</filename></term>
    647734        <listitem>
    648           <para>is the X Render Library.</para>
     735          <para>
     736            is the X Render Library.
     737          </para>
    649738          <indexterm zone="xorg7-lib libXrender">
    650739            <primary sortas="c-libXrender">libXrender.so</primary>
    … …  
    656745        <term><filename class="libraryfile">libXRes.so</filename></term>
    657746        <listitem>
    658           <para>is the X-Resource extension client library.</para>
     747          <para>
     748            is the X-Resource extension client library.
     749          </para>
    659750          <indexterm zone="xorg7-lib libXRes">
    660751            <primary sortas="c-libXRes">libXRes.so</primary>
    … …  
    666757        <term><filename class="libraryfile">libxshmfence.so</filename></term>
    667758        <listitem>
    668           <para>exposes an event API on top of Linux futexes.</para>
     759          <para>
     760            exposes an event API on top of Linux futexes.
     761          </para>
    669762          <indexterm zone="xorg7-lib libxshmfence">
    670763            <primary sortas="c-libxshmfence">libxshmfence.so</primary>
    … …  
    676769        <term><filename class="libraryfile">libXss.so</filename></term>
    677770        <listitem>
    678           <para>is the X11 Screen Saver extension client library.</para>
     771          <para>
     772            is the X11 Screen Saver extension client library.
     773          </para>
    679774          <indexterm zone="xorg7-lib libXss">
    680775            <primary sortas="c-libXss">libXss.so</primary>
    … …  
    686781        <term><filename class="libraryfile">libXt.so</filename></term>
    687782        <listitem>
    688           <para>is the X Toolkit Library.</para>
     783          <para>
     784            is the X Toolkit Library.
     785          </para>
    689786          <indexterm zone="xorg7-lib libXt">
    690787            <primary sortas="c-libXt">libXt.so</primary>
    … …  
    696793        <term><filename class="libraryfile">libXtst.so</filename></term>
    697794        <listitem>
    698           <para>is the Xtst Library.</para>
     795          <para>
     796            is the Xtst Library.
     797          </para>
    699798          <indexterm zone="xorg7-lib libXtst">
    700799            <primary sortas="c-libXtst">libXtst.so</primary>
    … …  
    706805        <term><filename class="libraryfile">libXvMC.so</filename></term>
    707806        <listitem>
    708           <para>is the X-Video Motion Compensation Library.</para>
     807          <para>
     808            is the X-Video Motion Compensation Library.
     809          </para>
    709810          <indexterm zone="xorg7-lib libXvMC">
    710811            <primary sortas="c-libXvMC">libXvMC.so</primary>
    … …  
    716817        <term><filename class="libraryfile">libXvMCW.so</filename></term>
    717818        <listitem>
    718           <para>is the XvMC Wrapper including the Nonstandard VLD
    719           extension.</para>
     819          <para>
     820            is the XvMC Wrapper including the Nonstandard VLD extension.
     821          </para>
    720822          <indexterm zone="xorg7-lib libXvMCW">
    721823            <primary sortas="c-libXvMCW">libXvMCW.so</primary>
    … …  
    727829        <term><filename class="libraryfile">libXv.so</filename></term>
    728830        <listitem>
    729           <para>is the X Window System video extension library.</para>
     831          <para>
     832            is the X Window System video extension library.
     833          </para>
    730834          <indexterm zone="xorg7-lib libXv">
    731835            <primary sortas="c-libXv">libXv.so</primary>
    … …  
    737841        <term><filename class="libraryfile">libXxf86dga.so</filename></term>
    738842        <listitem>
    739           <para>is the client library for the XFree86-DGA extension.</para>
     843          <para>
     844            is the client library for the XFree86-DGA extension.
     845          </para>
    740846          <indexterm zone="xorg7-lib libXxf86dga">
    741847            <primary sortas="c-libXxf86dga">libXxf86dga.so</primary>
    … …  
    747853        <term><filename class="libraryfile">libXxf86vm.so</filename></term>
    748854        <listitem>
    749           <para>is the client library for the XFree86-VidMode X extension.</para>
     855          <para>
     856            is the client library for the XFree86-VidMode X extension.
     857          </para>
    750858          <indexterm zone="xorg7-lib libXxf86vm">
    751859            <primary sortas="c-libXxf86vm">libXxf86vm.so</primary>
Note: See TracChangeset for help on using the changeset viewer.