Changeset 71df408


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

Location:
x/installing
Files:
24 edited

Legend:

Unmodified
Added
Removed

  • x/installing/TTF-and-OTF-fonts.xml

    rbdfc854 r71df408  
    208208    xreflabel="Caladea">Caladea</bridgehead>
    209209
    210       <para><ulink
    211       url="http://gsdview.appspot.com/chromeos-localmirror/distfiles/crosextrafonts-20130214.tar.gz">Caladea</ulink>
     210    <para>
     211      <ulink url=
     212      "http://gsdview.appspot.com/chromeos-localmirror/distfiles/crosextrafonts-20130214.tar.gz">Caladea</ulink>
    212213      (created as a Chrome OS extra font, hence the 'crosextrafonts' tarball
    213       name) is metrically compatible with MS Cambria and can be used if you have
    214       to edit a document which somebody started in Microsoft Office using
    215       Cambria and then return it to them.</para>
     214      name) is metrically compatible with MS Cambria and can be used if you
     215      have to edit a document which somebody started in Microsoft Office using
     216      Cambria and then return it to them.
     217    </para>
    216218
    217219    <bridgehead renderas="sect3" id="cantarell-fonts"
    … …  
    222224    </indexterm>
    223225
    224       <para><ulink
    225       url="&gnome-download-http;/cantarell-fonts/0.0/">Cantarell fonts</ulink>
    226       - The Cantarell typeface family provides a contemporary Humanist sans
    227       serif. It is particularly optimised for legibility at small sizes and is
    228       the preferred font family for the <application>GNOME-3</application> user
    229       interface.</para>
     226    <para>
     227      <ulink url=
     228      "&gnome-download-http;/cantarell-fonts/0.0/">Cantarell fonts</ulink>
     229      &ndash; The Cantarell typeface family provides a contemporary Humanist
     230      sans serif. It is particularly optimised for legibility at small sizes
     231      and is the preferred font family for the
     232      <application>GNOME-3</application> user interface.
     233    </para>
    230234
    231235    <bridgehead renderas="sect3" id="Carlito"
    232236    xreflabel="Carlito">Carlito</bridgehead>
    233237
    234       <para><ulink
    235       url="http://gsdview.appspot.com/chromeos-localmirror/distfiles/crosextrafonts-carlito-20130920.tar.gz">Carlito</ulink>
     238    <para>
     239      <ulink url=
     240      "http://gsdview.appspot.com/chromeos-localmirror/distfiles/crosextrafonts-carlito-20130920.tar.gz">Carlito</ulink>
    236241      (created as another Chrome OS extra font, again the 'crosextrafonts-'
    237242      prefix in the tarball name) is metrically compatible with MS Calibri and
    238243      can be used if you have to edit a document which somebody started in
    239       Microsoft Office using Calibri and then return it to them.</para>
     244      Microsoft Office using Calibri and then return it to them.
     245    </para>
    240246
    241247    <bridgehead renderas="sect3" id="dejavu-fonts"
    … …  
    249255      <ulink
    250256      url="https://sourceforge.net/projects/dejavu/files/dejavu/">DejaVu
    251       fonts</ulink> - These fonts are an extension of, and replacement for, the
    252       Bitstream Vera fonts and provide Latin-based scripts with accents and
    253       punctuation such as "smart-quotes" and variant spacing characters, as well
    254       as Cyrillic, Greek, Arabic, Hebrew, Armenian, Georgian and some other
    255       glyphs. In the absence of the Bitstream Vera fonts (which had much less
    256       coverage), these are the default fallback fonts.
     257      fonts</ulink> &ndash; These fonts are an extension of, and replacement
     258      for, the Bitstream Vera fonts and provide Latin-based scripts with
     259      accents and punctuation such as "smart-quotes" and variant spacing
     260      characters, as well as Cyrillic, Greek, Arabic, Hebrew, Armenian,
     261      Georgian and some other glyphs. In the absence of the Bitstream Vera
     262      fonts (which had much less coverage), these are the default fallback
     263      fonts.
    257264    </para>
    258265
    … …  
    261268
    262269    <para>
    263       <ulink url="https://ftp.gnu.org/gnu/freefont/">GNU
    264       FreeFont</ulink> - This set of fonts covers many non-CJK characters, in
     270      <ulink url="https://ftp.gnu.org/gnu/freefont/">GNU FreeFont</ulink>
     271      &ndash; This set of fonts covers many non-CJK characters, in
    265272      particular some of the variants of latin and cyrillic letters used in
    266273      minority languages, but the glyphs are comparatively small (unlike DejaVu
    … …  
    308315    xreflabel="corefonts">Microsoft Core Fonts</bridgehead>
    309316
    310     <para>The <ulink url="http://corefonts.sourceforge.net/">Microsoft Core
    311        fonts</ulink> date from 2002. They were supplied with old versions of
    312        Microsoft Windows and were apparently made available for general use.
    313        You can extract them from the 'exe' files using
    314        <application>bsd-tar</application> from <xref linkend="libarchive"/>.
    315        Be sure to read the license before using them. At one time some of
    316        these fonts (particularly Arial, Times New Roman, and to a lesser
    317        extent Courier New) were widely specified on web pages. The full set
    318        contains Andale Mono, Arial, Arial Black, Comic Sans MS, Courier
    319        New, Georgia, Impact, Times New Roman, Trebuchet MS, Verdana and
    320        Webdings.
     317    <para>
     318      The <ulink url="http://corefonts.sourceforge.net/">Microsoft Core
     319      fonts</ulink> date from 2002. They were supplied with old versions of
     320      Microsoft Windows and were apparently made available for general use.
     321      You can extract them from the 'exe' files using
     322      <application>bsd-tar</application> from <xref linkend="libarchive"/>.
     323      Be sure to read the license before using them. At one time some of
     324      these fonts (particularly Arial, Times New Roman, and to a lesser
     325      extent Courier New) were widely specified on web pages. The full set
     326      contains Andale Mono, Arial, Arial Black, Comic Sans MS, Courier
     327      New, Georgia, Impact, Times New Roman, Trebuchet MS, Verdana and
     328      Webdings.
    321329    </para>
    322330
    … …  
    387395
    388396    <para>
    389       When KDE Frameworks 5 was first released, it used the <ulink
    390       url="http://download.kde.org/stable/plasma/5.4.3/oxygen-fonts-5.4.3.tar.xz">Oxygen fonts</ulink>
     397      When KDE Frameworks 5 was first released, it used the <ulink url=
     398      "http://download.kde.org/stable/plasma/5.4.3/oxygen-fonts-5.4.3.tar.xz">
     399      Oxygen fonts</ulink>
    391400      which were designed for integrated use with the KDE desktop. Those fonts
    392401      are no-longer actively maintained, so KDE made a decision to switch to
    … …  
    415424    <para>
    416425      This set of fonts from Adobe (seven different weights) includes what is
    417       now the preferred monospace font for those applications which use
    418       <xref linkend="gsettings-desktop-schemas"/>. The github release <ulink
    419       url="https://github.com/adobe-fonts/source-code-pro.git#release">source-code-pro</ulink>
     426      now the preferred monospace font for those applications which use <xref
     427      linkend="gsettings-desktop-schemas"/>. The github release <ulink url=
     428      "https://github.com/adobe-fonts/source-code-pro.git#release">
     429      source-code-pro</ulink>
    420430      contains OTF (preferred) and TTF as well as the source and WOFF fonts.
    421431    </para>
    … …  
    426436
    427437    <para>
    428       There is also an older TTF version of this available from <ulink
    429       url="https://fonts.google.com/specimen/Source+Code+Pro?selection.family=Source+Code+Pro">Google
    430       fonts</ulink> but that has very limited coverage (adequate for most
     438      There is also an older TTF version of this available from <ulink url=
     439      "https://fonts.google.com/specimen/Source+Code+Pro?selection.family=Source+Code+Pro">
     440      Google fonts</ulink> but that has very limited coverage (adequate for most
    431441      European languages using a latin alphabet).
    432442    </para>
    … …  
    492502
    493503<!-- prefer the less-old Opendesktop-fonts to fireflysung
    494       <bridgehead renderas="sect4" id="fireflysung"
    495       xreflabel="fireflysung">Fireflysung</bridgehead>
    496 
    497       <para>
    498         <ulink
    499         url="http://ftp.osuosl.org/pub/blfs/conglomeration/Xorg//fireflysung-1.3.0.tar.gz">fireflysung</ulink>
    500         - This font ('AR PL New Sung') was one of the first libre fonts to
    501         provides Chinese coverage. <application>fontconfig</application> knows
    502         it is to be treated as a Serif font.
    503       </para> -->
    504 
    505       <bridgehead renderas="sect4" id="NotoSansCJK"
    506       xreflabel="Noto Sans CJK">Noto Sans CJK</bridgehead>
    507 
    508       <!-- indexterm entry retained for future linkage from kde -->
    509       <indexterm zone="TTF-and-OTF-fonts NotoSansCJK">
    510         <primary sortas="a-noto-sans-cjk">Noto Sans CJK</primary>
    511       </indexterm>
    512 
    513       <para><ulink
    514         url="https://www.google.com/get/noto/help/cjk/">Noto Sans CJK</ulink>
    515         - Sans-Serif sets of all CJK fonts in a ttc - as the link says, you can
    516           choose to install the TTC and cover all the languages in all weights in
    517           a 110MB file, or you can download subsets. There are also Monospace
    518           versions.
    519        </para>
    520 
    521       <bridgehead renderas="sect4" id="Opendesktop-fonts"
    522       xreflabel="Opendesktop-fonts">Opendesktop fonts</bridgehead>
    523 
    524       <para>A copy of version 1.4.2 of the <ulink
    525         url="https://sources.archlinux.org/other/opendesktop-fonts/">opendesktop-fonts</ulink>
    526         is preserved at Arch. This was a later development of fireflysung which
    527         BLFS used to recommend, adding Kai and Mono fonts. The name of the Sung
    528         font remains 'AR PL New Sung' so they cannot both be installed together.
    529       </para>
    530 
    531       <para>
    532         At one time there was a 1.6 release, and more recently some versions at
    533         github, which also included a Sans font (Odohei), but those have dropped
    534         off the web and it is unclear if there was a problem.
    535         <application>Fontconfig</application> does not know anything about the
    536         later fonts (AR PL New Kai, AR PL New Sung Mono) and will default to
    537         treating them as Sans.
    538       </para>
     504    <bridgehead renderas="sect4" id="fireflysung"
     505    xreflabel="fireflysung">Fireflysung</bridgehead>
     506
     507    <para>
     508      <ulink url=
     509      "http://ftp.osuosl.org/pub/blfs/conglomeration/Xorg//fireflysung-1.3.0.tar.gz">fireflysung</ulink>
     510      &ndash; This font ('AR PL New Sung') was one of the first libre fonts to
     511      provides Chinese coverage. <application>fontconfig</application> knows
     512      it is to be treated as a Serif font.
     513    </para> -->
     514
     515    <bridgehead renderas="sect4" id="NotoSansCJK"
     516    xreflabel="Noto Sans CJK">Noto Sans CJK</bridgehead>
     517
     518    <!-- indexterm entry retained for future linkage from kde -->
     519    <indexterm zone="TTF-and-OTF-fonts NotoSansCJK">
     520      <primary sortas="a-noto-sans-cjk">Noto Sans CJK</primary>
     521    </indexterm>
     522
     523    <para><ulink
     524      url="https://www.google.com/get/noto/help/cjk/">Noto Sans CJK</ulink>
     525      &ndash; Sans-Serif sets of all CJK fonts in a ttc &ndash; as the link
     526      says, you can choose to install the TTC and cover all the languages in
     527      all weights in a 110MB file, or you can download subsets. There are
     528      also Monospace versions.
     529    </para>
     530
     531    <bridgehead renderas="sect4" id="Opendesktop-fonts"
     532    xreflabel="Opendesktop-fonts">Opendesktop fonts</bridgehead>
     533
     534    <para>A copy of version 1.4.2 of the <ulink
     535      url="https://sources.archlinux.org/other/opendesktop-fonts/">opendesktop-fonts</ulink>
     536      is preserved at Arch. This was a later development of fireflysung which
     537      BLFS used to recommend, adding Kai and Mono fonts. The name of the Sung
     538      font remains 'AR PL New Sung' so they cannot both be installed together.
     539    </para>
     540
     541    <para>
     542      At one time there was a 1.6 release, and more recently some versions at
     543      github, which also included a Sans font (Odohei), but those have dropped
     544      off the web and it is unclear if there was a problem.
     545      <application>Fontconfig</application> does not know anything about the
     546      later fonts (AR PL New Kai, AR PL New Sung Mono) and will default to
     547      treating them as Sans.
     548    </para>
    539549
    540550<!-- comment, because not recommended
    541       <bridgehead renderas="sect4" id="UKai"
    542       xreflabel="UKai">UKai</bridgehead>
    543 
    544       <para>
    545         <ulink
    546         url="http://packages.debian.org/sid/fonts-arphic-ukai">UKai fonts</ulink>
    547         - sets of Chinese Kai fonts in a ttc which contain variations of
    548         Simplified and Traditional (Taiwanese, second variant for different
    549         <ulink url="https://en.wikipedia.org/wiki/Bopomofo">bopomofo</ulink>,
    550         and Cantonese). This ships with old-syntax files which can install to
    551         <filename class="directory">/etc/fonts/conf.d/</filename> but see <xref
    552         linkend="editing-old-style-conf-files"/>.
    553       </para>
     551    <bridgehead renderas="sect4" id="UKai"
     552    xreflabel="UKai">UKai</bridgehead>
     553
     554    <para>
     555      <ulink
     556      url="http://packages.debian.org/sid/fonts-arphic-ukai">UKai fonts</ulink>
     557      &ndash; sets of Chinese Kai fonts in a ttc which contain variations of
     558      Simplified and Traditional (Taiwanese, second variant for different
     559      <ulink url="https://en.wikipedia.org/wiki/Bopomofo">bopomofo</ulink>,
     560      and Cantonese). This ships with old-syntax files which can install to
     561      <filename class="directory">/etc/fonts/conf.d/</filename> but see <xref
     562      linkend="editing-old-style-conf-files"/>.
     563    </para>
    554564-->
    555565
    556       <bridgehead renderas="sect4" id="UMing"
    557       xreflabel="UMing">UMing</bridgehead>
    558 
    559       <para>
    560         <ulink
    561         url="http://packages.debian.org/sid/fonts-arphic-uming">UMing fonts</ulink>
    562         - sets of Chinese Ming fonts (from Debian, use the '.orig' tarball) in
    563         a ttc which contain variations of Simplified and Traditional Chinese
    564         (Taiwanese, with second variant for different
    565         <ulink url="https://en.wikipedia.org/wiki/Bopomofo">bopomofo</ulink>,
    566         and Cantonese for Hong Kong). This ships with old-syntax files which you
    567         can install to
    568         <filename class="directory">/etc/fonts/conf.d/</filename> but see <xref
    569         linkend="editing-old-style-conf-files"/>.
    570       </para>
    571 
    572       <bridgehead renderas="sect4" id="wenquanyi-zenhei"
    573       xreflabel="WenQuanYi ZenHei">WenQuanYi Zen Hei</bridgehead>
    574 
    575       <indexterm zone="TTF-and-OTF-fonts wenquanyi-zenhei">
    576         <primary sortas="a-wenquanyi-zenhei">WenQuanYi Zen Hei</primary>
    577       </indexterm>
    578 
    579       <para>
    580         <ulink
    581         url="https://sourceforge.net/projects/wqy/files/wqy-zenhei/">WenQuanYi
    582         Zen Hei</ulink> provides a Sans-Serif font which covers all CJK scripts
    583         including Korean. Although it includes old-style conf files, these are
    584         not required: <application>fontconfig</application> will already treat
    585         these fonts (the 'sharp' contains bitmaps, the monospace appears not
    586         to be Mono in its ASCII part) as Sans, Serif, and Monospace. If all
    587         you wish to do is to be able to render Han and Korean text without
    588         worrying about the niceties of the shapes used, the main font from
    589         this package is a good font to use.
    590       </para>
     566    <bridgehead renderas="sect4" id="UMing"
     567    xreflabel="UMing">UMing</bridgehead>
     568
     569    <para>
     570      <ulink url=
     571      "http://packages.debian.org/sid/fonts-arphic-uming">UMing fonts</ulink>
     572      &ndash; sets of Chinese Ming fonts (from Debian, use the '.orig' tarball)
     573      in a ttc which contain variations of Simplified and Traditional Chinese
     574      (Taiwanese, with second variant for different
     575      <ulink url="https://en.wikipedia.org/wiki/Bopomofo">bopomofo</ulink>,
     576      and Cantonese for Hong Kong). This ships with old-syntax files which you
     577      can install to
     578      <filename class="directory">/etc/fonts/conf.d/</filename> but see <xref
     579      linkend="editing-old-style-conf-files"/>.
     580    </para>
     581
     582    <bridgehead renderas="sect4" id="wenquanyi-zenhei"
     583    xreflabel="WenQuanYi ZenHei">WenQuanYi Zen Hei</bridgehead>
     584
     585    <indexterm zone="TTF-and-OTF-fonts wenquanyi-zenhei">
     586      <primary sortas="a-wenquanyi-zenhei">WenQuanYi Zen Hei</primary>
     587    </indexterm>
     588
     589    <para>
     590      <ulink
     591      url="https://sourceforge.net/projects/wqy/files/wqy-zenhei/">WenQuanYi
     592      Zen Hei</ulink> provides a Sans-Serif font which covers all CJK scripts
     593      including Korean. Although it includes old-style conf files, these are
     594      not required: <application>fontconfig</application> will already treat
     595      these fonts (the 'sharp' contains bitmaps, the monospace appears not
     596      to be Mono in its ASCII part) as Sans, Serif, and Monospace. If all
     597      you wish to do is to be able to render Han and Korean text without
     598      worrying about the niceties of the shapes used, the main font from
     599      this package is a good font to use.
     600    </para>
    591601
    592602
    … …  
    594604    xreflabel="Japanese fonts">Japanese fonts:</bridgehead>
    595605
    596       <para>
    597         In Japanese, Gothic fonts are Sans, Mincho are Serif. BLFS used to
    598         only mention the Kochi fonts, but those appear to now be the
    599         least-preferred of the Japanese fonts.
    600       </para>
    601 
    602       <para>
    603         Apart from the fonts detailed below, also consider <xref
    604         linkend="NotoSansCJK"/>.
    605       </para>
    606 
    607       <bridgehead renderas="sect4" id="IPAex"
    608       xreflabel="IPAex fonts">IPAex fonts</bridgehead>
    609 
    610        <!-- indexterm retained for expected link from tuning fontconfig -->
    611       <indexterm zone="TTF-and-OTF-fonts IPAex">
    612         <primary sortas="a-ipaex-fonts">IPAex fonts</primary>
    613       </indexterm>
    614 
    615       <para>
    616         The <ulink url="http://ipafont.ipa.go.jp/">IPAex fonts</ulink> are
    617         the current version of the IPA fonts. Click on 'English' at the link and
    618         then click on the Download icon to find IPAex Font Ver.003.01.
    619         Unfortunately, <application>fontconfig</application> only knows about
    620         the older IPAfonts and the forked IPA Mona font (which is not easily
    621         available and which apparently does not meet Debian's Free Software
    622         guidelines). Therefore if you install the IPAex fonts you may wish
    623         to make it known to fontconfig, see <xref
    624         linkend="prefer-chosen-CJK-fonts"/> for one possible way to do this.
    625       </para>
    626 
    627       <bridgehead renderas="sect4" id="Kochi"
    628       xreflabel="Kochi">Kochi fonts</bridgehead>
    629 
    630       <para>
    631         The <ulink url="https://osdn.net/projects/efont/releases/p1357">Kochi
    632         Substitute fonts</ulink> were the first truly libre Japanese fonts (the
    633         earlier Kochi fonts were allegedly plagiarized from a commercial font).
    634       </para>
    635 
    636       <bridgehead renderas="sect4" id="VLGothic"
    637       xreflabel="VL Gothic">VL Gothic</bridgehead>
    638 
    639       <indexterm zone="TTF-and-OTF-fonts VLGothic">
    640         <primary sortas="a-vlgothic-fonts">VL Gothic</primary>
    641       </indexterm>
    642 
    643       <para>
    644         The <ulink url="https://osdn.net/projects/vlgothic/releases/">VL
    645         Gothic</ulink> font is a modern Japanese font in two variants with
    646         monotonic or proportional spacing for the non-Japanese characters.
    647       </para>
     606    <para>
     607      In Japanese, Gothic fonts are Sans, Mincho are Serif. BLFS used to
     608      only mention the Kochi fonts, but those appear to now be the
     609      least-preferred of the Japanese fonts.
     610    </para>
     611
     612    <para>
     613      Apart from the fonts detailed below, also consider <xref
     614      linkend="NotoSansCJK"/>.
     615    </para>
     616
     617    <bridgehead renderas="sect4" id="IPAex"
     618    xreflabel="IPAex fonts">IPAex fonts</bridgehead>
     619
     620     <!-- indexterm retained for expected link from tuning fontconfig -->
     621    <indexterm zone="TTF-and-OTF-fonts IPAex">
     622      <primary sortas="a-ipaex-fonts">IPAex fonts</primary>
     623    </indexterm>
     624
     625    <para>
     626      The <ulink url="http://ipafont.ipa.go.jp/">IPAex fonts</ulink> are
     627      the current version of the IPA fonts. Click on 'English' at the link and
     628      then click on the Download icon to find IPAex Font Ver.003.01.
     629      Unfortunately, <application>fontconfig</application> only knows about
     630      the older IPAfonts and the forked IPA Mona font (which is not easily
     631      available and which apparently does not meet Debian's Free Software
     632      guidelines). Therefore if you install the IPAex fonts you may wish
     633      to make it known to fontconfig, see <xref
     634      linkend="prefer-chosen-CJK-fonts"/> for one possible way to do this.
     635    </para>
     636
     637    <bridgehead renderas="sect4" id="Kochi"
     638    xreflabel="Kochi">Kochi fonts</bridgehead>
     639
     640    <para>
     641      The <ulink url="https://osdn.net/projects/efont/releases/p1357">Kochi
     642      Substitute fonts</ulink> were the first truly libre Japanese fonts (the
     643      earlier Kochi fonts were allegedly plagiarized from a commercial font).
     644    </para>
     645
     646    <bridgehead renderas="sect4" id="VLGothic"
     647    xreflabel="VL Gothic">VL Gothic</bridgehead>
     648
     649    <indexterm zone="TTF-and-OTF-fonts VLGothic">
     650      <primary sortas="a-vlgothic-fonts">VL Gothic</primary>
     651    </indexterm>
     652
     653    <para>
     654      The <ulink url="https://osdn.net/projects/vlgothic/releases/">VL
     655      Gothic</ulink> font is a modern Japanese font in two variants with
     656      monotonic or proportional spacing for the non-Japanese characters.
     657    </para>
    648658
    649659
    … …  
    674684    </para>
    675685
    676     <para>Alternatively, consider <xref linkend="NotoSansCJK"/> (all of the
     686    <para>
     687      Alternatively, consider <xref linkend="NotoSansCJK"/> (all of the
    677688      variants cover Hangul) or <xref linkend="wenquanyi-zenhei"/>.
    678689    </para>
    679690
    680     </sect2>
     691  </sect2>
    681692
    682693</sect1>

  • x/installing/installing.xml

    rbdfc854 r71df408  
    1616  <title>X Window System Environment</title>
    1717
    18   <para>This chapter contains instructions to build and configure a graphical
    19   user environment.</para>
     18  <para>
     19    This chapter contains instructions to build and configure a graphical
     20    user environment.
     21  </para>
    2022
    21   <para><application>Xorg</application>, in addition to clearing up some
    22   licensing issues with <ulink url="http://www.xfree86.org/">XFree86</ulink>,
    23   introduced a completely auto-tooled build for the X Window system. This
    24   means that the packages build and install using the conventional
    25   <command>configure</command>, <command>make</command>, and <command>make
    26   install</command> commands, as opposed to a proprietary build system that
    27   required hand editing of configuration parameters in a C-like syntax.</para>
     23  <para>
     24    <application>Xorg</application>, in addition to clearing up some
     25    licensing issues with <ulink url="http://www.xfree86.org/">XFree86</ulink>,
     26    introduced a completely auto-tooled build for the X Window system. This
     27    means that the packages build and install using the conventional
     28    <command>configure</command>, <command>make</command>, and <command>make
     29    install</command> commands, as opposed to a proprietary build system that
     30    required hand editing of configuration parameters in a C-like syntax.
     31  </para>
    2832
    29   <para><application>Xorg</application> also brought with it a modular build
    30   system. While this separation into modules resulted in full control of the
    31   features available to the X server on any given installation, it also made
    32   the installation more tedious as it requires installing more than 100
    33   different packages to obtain a functional X Window environment. Most large
    34   commercial distributions have elected to use <application>Xorg</application>
    35   over the <application>XFree86</application> distribution due to both
    36   licensing issues and the increased functionality provided by it over
    37   <application>XFree86</application>. With the modular build system, also came
    38   incremental updates to individual packages. The distribution of
    39   <application>Xorg</application> is given a release number by the developers,
    40   in this case Xorg-&xorg-version;, and is referred to as the "katamari" by
    41   the upstream developers.</para>
     33  <para>
     34    <application>Xorg</application> also brought with it a modular build
     35    system. While this separation into modules resulted in full control of the
     36    features available to the X server on any given installation, it also made
     37    the installation more tedious as it requires installing more than 100
     38    different packages to obtain a functional X Window environment. Most large
     39    commercial distributions have elected to use <application>Xorg</application>
     40    over the <application>XFree86</application> distribution due to both
     41    licensing issues and the increased functionality provided by it over
     42    <application>XFree86</application>. With the modular build system, also came
     43    incremental updates to individual packages. The distribution of
     44    <application>Xorg</application> is given a release number by the developers,
     45    in this case Xorg-&xorg-version;, and is referred to as the "katamari" by
     46    the upstream developers.
     47  </para>
    4248
    4349  <!--
    44   <para>Additionally, the BLFS book appends a build number
    45   to the end of version string to indicate whether a group of incremental
    46   updates has been applied, while still retaining the versioning scheme of the
    47   upstream developers. For instance, Xorg-&xorg-version;-1 would indicate that
    48   this is the 1st release, and is consistent with the katamari, while
    49   Xorg-&xorg-version;-2 would indicate that individual package updates have
    50   been applied to the katamari.</para>
     50  <para>
     51    Additionally, the BLFS book appends a build number
     52    to the end of version string to indicate whether a group of incremental
     53    updates has been applied, while still retaining the versioning scheme of the
     54    upstream developers. For instance, Xorg-&xorg-version;-1 would indicate that
     55    this is the 1st release, and is consistent with the katamari, while
     56    Xorg-&xorg-version;-2 would indicate that individual package updates have
     57    been applied to the katamari.
     58  </para>
    5159  -->
    5260

  • x/installing/libXau.xml

    rbdfc854 r71df408  
    3030    <title>Introduction to libXau</title>
    3131
    32     <para>The <application>libXau</application> package contains a library
    33     implementing the X11 Authorization Protocol. This is useful for
    34     restricting client access to the display.</para>
     32    <para>
     33      The <application>libXau</application> package contains a library
     34      implementing the X11 Authorization Protocol. This is useful for
     35      restricting client access to the display.
     36    </para>
    3537
    3638    &lfs91_checked;
    … …  
    3941    <itemizedlist spacing="compact">
    4042      <listitem>
    41         <para>Download (HTTP): <ulink url="&libXau-download-http;"/></para>
     43        <para>
     44          Download (HTTP): <ulink url="&libXau-download-http;"/>
     45        </para>
    4246      </listitem>
    4347      <listitem>
    44         <para>Download (FTP): <ulink url="&libXau-download-ftp;"/></para>
     48        <para>
     49          Download (FTP): <ulink url="&libXau-download-ftp;"/>
     50        </para>
    4551      </listitem>
    4652      <listitem>
    47         <para>Download MD5 sum: &libXau-md5sum;</para>
     53        <para>
     54          Download MD5 sum: &libXau-md5sum;
     55        </para>
    4856      </listitem>
    4957      <listitem>
    50         <para>Download size: &libXau-size;</para>
     58        <para>
     59          Download size: &libXau-size;
     60        </para>
    5161      </listitem>
    5262      <listitem>
    53         <para>Estimated disk space required: &libXau-buildsize;</para>
     63        <para>
     64          Estimated disk space required: &libXau-buildsize;
     65        </para>
    5466      </listitem>
    5567      <listitem>
    56         <para>Estimated build time: &libXau-time;</para>
     68        <para>
     69          Estimated build time: &libXau-time;
     70        </para>
    5771      </listitem>
    5872    </itemizedlist>
    … …  
    6175
    6276    <bridgehead renderas="sect4">Required</bridgehead>
    63     <para role="required"><xref linkend="xorgproto"/></para>
     77    <para role="required">
     78      <xref linkend="xorgproto"/>
     79    </para>
    6480
    6581    <para condition="html" role="usernotes">User Notes:
    … …  
    7187    <title>Installation of libXau</title>
    7288
    73     <para>Install <application>libXau</application> by running the following
    74     commands:</para>
     89    <para>
     90      Install <application>libXau</application> by running the following
     91      commands:
     92    </para>
    7593
    7694<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
    7795make</userinput></screen>
    7896
    79     <para>To test the results, issue: <command>make check</command>.</para>
     97    <para>
     98      To test the results, issue: <command>make check</command>.
     99    </para>
    80100
    81     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     101    <para>
     102      Now, as the <systemitem class="username">root</systemitem> user:
     103    </para>
    82104
    83105<screen role="root"><userinput>make install</userinput></screen>
    … …  
    108130        <term><filename class='libraryfile'>libXau.so</filename></term>
    109131        <listitem>
    110           <para>is the library of X authority database routines.</para>
     132          <para>
     133            is the library of X authority database routines.
     134          </para>
    111135          <indexterm zone="libXau libXau-x7">
    112136            <primary sortas="c-libXau">libXau.so</primary>

  • x/installing/libXdmcp.xml

    rbdfc854 r71df408  
    3030    <title>Introduction to libXdmcp</title>
    3131
    32     <para>The <application>libXdmcp</application> package contains a library
    33     implementing the X Display Manager Control Protocol. This is useful for
    34     allowing clients to interact with the X Display Manager.</para>
     32    <para>
     33      The <application>libXdmcp</application> package contains a library
     34      implementing the X Display Manager Control Protocol. This is useful for
     35      allowing clients to interact with the X Display Manager.
     36    </para>
    3537
    3638    &lfs91_checked;
    … …  
    3941    <itemizedlist spacing="compact">
    4042      <listitem>
    41         <para>Download (HTTP): <ulink url="&libXdmcp-download-http;"/></para>
     43        <para>
     44          Download (HTTP): <ulink url="&libXdmcp-download-http;"/>
     45        </para>
    4246      </listitem>
    4347      <listitem>
    44         <para>Download (FTP): <ulink url="&libXdmcp-download-ftp;"/></para>
     48        <para>
     49          Download (FTP): <ulink url="&libXdmcp-download-ftp;"/>
     50        </para>
    4551      </listitem>
    4652      <listitem>
    47         <para>Download MD5 sum: &libXdmcp-md5sum;</para>
     53        <para>
     54          Download MD5 sum: &libXdmcp-md5sum;
     55        </para>
    4856      </listitem>
    4957      <listitem>
    50         <para>Download size: &libXdmcp-size;</para>
     58        <para>
     59          Download size: &libXdmcp-size;
     60        </para>
    5161      </listitem>
    5262      <listitem>
    53         <para>Estimated disk space required: &libXdmcp-buildsize;</para>
     63        <para>
     64          Estimated disk space required: &libXdmcp-buildsize;
     65        </para>
    5466      </listitem>
    5567      <listitem>
    56         <para>Estimated build time: &libXdmcp-time;</para>
     68        <para>
     69          Estimated build time: &libXdmcp-time;
     70        </para>
    5771      </listitem>
    5872    </itemizedlist>
    … …  
    6175
    6276    <bridgehead renderas="sect4">Required</bridgehead>
    63     <para role="required"><xref linkend="xorgproto"/></para>
     77    <para role="required">
     78      <xref linkend="xorgproto"/>
     79    </para>
    6480
    6581    <bridgehead renderas="sect4">Optional</bridgehead>
    … …  
    7894    <title>Installation of libXdmcp</title>
    7995
    80     <para>Install <application>libXdmcp</application> by running the following
    81     commands:</para>
     96    <para>
     97      Install <application>libXdmcp</application> by running the following
     98      commands:
     99    </para>
    82100
    83101<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
    84102make</userinput></screen>
    85103
    86     <para>This package does not come with a test suite.</para>
     104    <para>
     105      This package does not come with a test suite.
     106    </para>
    87107
    88     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     108    <para>
     109      Now, as the <systemitem class="username">root</systemitem> user:
     110    </para>
    89111
    90112<screen role="root"><userinput>make install</userinput></screen>
    … …  
    115137        <term><filename class='libraryfile'>libXdmcp.so</filename></term>
    116138        <listitem>
    117           <para>is the X Display Manager Control Protocol library.</para>
     139          <para>
     140            is the X Display Manager Control Protocol library.
     141          </para>
    118142          <indexterm zone="libXdmcp libXdmcp-x7">
    119143            <primary sortas="c-libXdmcp">libXdmcp.so</primary>

  • x/installing/libinput.xml

    rbdfc854 r71df408  
    157157
    158158    <note>
    159       <para>If you want to run the full tests, remove -Dtests from the
    160       <command>meson</command> command above. Please read "kernel configuration
    161       for running the libinput testsuite" (above).
     159      <para>
     160        If you want to run the full tests, remove -Dtests from the
     161        <command>meson</command> command above. Please read "kernel
     162        configuration for running the libinput testsuite" (above).
    162163      </para>
    163164

  • x/installing/libva.xml

    rbdfc854 r71df408  
    146146    <title>Installation of libva</title>
    147147
    148     <caution><para>If you are reinstalling this package, you will need
    149     to remove the older versions of the libraries.  These are in the
    150     form of libva*.so.1 and any symbolic links pointing to them.  In
    151     addition, any packages that use these files need to be rebuilt.
    152     </para></caution>
     148    <caution>
     149      <para>
     150        If you are reinstalling this package, you will need
     151        to remove the older versions of the libraries.  These are in the
     152        form of libva*.so.1 and any symbolic links pointing to them.  In
     153        addition, any packages that use these files need to be rebuilt.
     154      </para>
     155    </caution>
    153156
    154157    <para>

  • x/installing/libvdpau-va-gl.xml

    rbdfc854 r71df408  
    7474    </itemizedlist>
    7575
    76     <!-- It's been fixed upstream.  Lets see if it stays fixed ...
    77     <note><para>The tarball name for libvdpau-va-gl does not include the
    78     file name, although it does expand to libvdpau-va-gl-&libvdpau-va-gl-version;.
    79     The file should be renamed after downloading:</para>
    80 
    81 <screen><command>mv v&libvdpau-va-gl-version;.tar.gz libvdpau-va-gl-&libvdpau-va-gl-version;.tar.gz</command></screen>
    82     </note>-->
    83 
    84 
    8576    <bridgehead renderas="sect4">libvdpau-va-gl Dependencies</bridgehead>
    8677
    … …  
    140131    <title>Configuration</title>
    141132
    142     <para>To allow libvdpau to find libvdpau-va-gl, set an environment variable.
    143     As the <systemitem class="username">root</systemitem> user:</para>
     133    <para>
     134      To allow libvdpau to find libvdpau-va-gl, set an environment variable.
     135      As the <systemitem class="username">root</systemitem> user:
     136    </para>
    144137
    145138<screen role="root"><userinput>echo "export VDPAU_DRIVER=va_gl" >> /etc/profile.d/xorg.sh</userinput></screen>

  • x/installing/libxcb.xml

    rbdfc854 r71df408  
    3030    <title>Introduction to libxcb</title>
    3131
    32     <para>The <application>libxcb</application> package provides an interface
    33     to the X Window System protocol, which replaces the current Xlib interface.
    34     Xlib can also use XCB as a transport layer, allowing software to make
    35     requests and receive responses with both.</para>
     32    <para>
     33      The <application>libxcb</application> package provides an interface to
     34      the X Window System protocol, which replaces the current Xlib interface.
     35      Xlib can also use XCB as a transport layer, allowing software to make
     36      requests and receive responses with both.
     37    </para>
    3638
    3739    &lfs91_checked;
    … …  
    4042    <itemizedlist spacing="compact">
    4143      <listitem>
    42         <para>Download (HTTP): <ulink url="&libxcb-download-http;"/></para>
     44        <para>
     45          Download (HTTP): <ulink url="&libxcb-download-http;"/>
     46        </para>
    4347      </listitem>
    4448      <listitem>
    45         <para>Download (FTP): <ulink url="&libxcb-download-ftp;"/></para>
     49        <para>
     50          Download (FTP): <ulink url="&libxcb-download-ftp;"/>
     51        </para>
    4652      </listitem>
    4753      <listitem>
    48         <para>Download MD5 sum: &libxcb-md5sum;</para>
     54        <para>
     55          Download MD5 sum: &libxcb-md5sum;
     56        </para>
    4957      </listitem>
    5058      <listitem>
    51         <para>Download size: &libxcb-size;</para>
     59        <para>
     60          Download size: &libxcb-size;
     61        </para>
    5262      </listitem>
    5363      <listitem>
    54         <para>Estimated disk space required: &libxcb-buildsize;</para>
     64        <para>
     65          Estimated disk space required: &libxcb-buildsize;
     66        </para>
    5567      </listitem>
    5668      <listitem>
    57         <para>Estimated build time: &libxcb-time;</para>
     69        <para>
     70          Estimated build time: &libxcb-time;
     71        </para>
    5872      </listitem>
    5973    </itemizedlist>
    … …  
    86100    <title>Installation of libxcb</title>
    87101
    88     <para>Install <application>libxcb</application> by running the following
    89     commands:</para>
     102    <para>
     103      Install <application>libxcb</application> by running the following
     104      commands:
     105    </para>
    90106
    91107<screen><userinput>sed -i "s/pthread-stubs//" configure &amp;&amp;
    … …  
    96112make</userinput></screen>
    97113
    98     <para>To test the results, issue: <command>make check</command>.</para>
     114    <para>
     115      To test the results, issue: <command>make check</command>.
     116    </para>
    99117
    100     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     118    <para>
     119      Now, as the <systemitem class="username">root</systemitem> user:
     120    </para>
    101121
    102122<screen role="root"><userinput>make install</userinput></screen>
    … …  
    107127    <title>Command Explanations</title>
    108128
    109     <para><command>sed "s/pthread-stubs//" -i configure</command>: This
    110     sed removes a dependency on the libpthread-stubs package which is useless on
    111     Linux.</para>
     129    <para>
     130      <command>sed "s/pthread-stubs//" -i configure</command>: This sed
     131      removes a dependency on the libpthread-stubs package which is useless on
     132      Linux.
     133    </para>
    112134
    113     <para><parameter>--without-doxygen</parameter>: Do not use doxygen to
    114     generate API documentation (default: auto). Without it, if
    115     <xref linkend="doxygen"/> is installed, the API documentation will be
    116     generated and installed.</para>
     135    <para>
     136      <parameter>--without-doxygen</parameter>: Do not use doxygen to
     137      generate API documentation (default: auto). Without it, if
     138      <xref linkend="doxygen"/> is installed, the API documentation will be
     139      generated and installed.
     140    </para>
    117141
    118142  </sect2>
    … …  
    154178        <term><filename class="libraryfile">libxcb.so</filename></term>
    155179        <listitem>
    156           <para>is an interface to the X Window System protocol.</para>
     180          <para>
     181            is an interface to the X Window System protocol.
     182          </para>
    157183          <indexterm zone="libxcb libxcb-lib">
    158184            <primary sortas="c-libxcb">libxcb.so</primary>

  • x/installing/tuning-fontconfig.xml

    rbdfc854 r71df408  
    163163    <itemizedlist>
    164164      <listitem>
    165         <para>00-09 extra font directories</para>
    166       </listitem>
    167       <listitem>
    168         <para>10-19 system rendering defaults (antialising etc)</para>
    169       </listitem>
    170       <listitem>
    171         <para>20-29 font rendering options</para>
    172       </listitem>
    173       <listitem>
    174         <para>30-39 family substitution</para>
    175       </listitem>
    176       <listitem>
    177         <para>40-49 map family to generic type</para>
    178       </listitem>
    179       <listitem>
    180         <para>50-59 load alternate config files</para>
    181       </listitem>
    182       <listitem>
    183         <para>60-69 generic aliases, map generic to family</para>
    184       </listitem>
    185       <listitem>
    186         <para>70-79 adjust which fonts are available</para>
    187       </listitem>
    188       <listitem>
    189         <para>80-89 match target scan (modify scanned patterns)</para>
    190       </listitem>
    191       <listitem>
    192         <para>90-99 font synthesis</para>
     165        <para>
     166          00-09 extra font directories
     167        </para>
     168      </listitem>
     169      <listitem>
     170        <para>
     171          10-19 system rendering defaults (antialising etc)
     172        </para>
     173      </listitem>
     174      <listitem>
     175        <para>
     176          20-29 font rendering options
     177        </para>
     178      </listitem>
     179      <listitem>
     180        <para>
     181          30-39 family substitution
     182        </para>
     183      </listitem>
     184      <listitem>
     185        <para>
     186          40-49 map family to generic type
     187        </para>
     188      </listitem>
     189      <listitem>
     190        <para>
     191          50-59 load alternate config files
     192        </para>
     193      </listitem>
     194      <listitem>
     195        <para>
     196          60-69 generic aliases, map generic to family
     197        </para>
     198      </listitem>
     199      <listitem>
     200        <para>
     201          70-79 adjust which fonts are available
     202        </para>
     203      </listitem>
     204      <listitem>
     205        <para>
     206          80-89 match target scan (modify scanned patterns)
     207        </para>
     208      </listitem>
     209      <listitem>
     210        <para>
     211          90-99 font synthesis
     212        </para>
    193213      </listitem>
    194214    </itemizedlist>

  • x/installing/twm.xml

    rbdfc854 r71df408  
    3030    <title>Introduction to twm</title>
    3131
    32     <para>The <application>twm</application> package contains a very minimal
    33     window manager.</para>
     32    <para>
     33      The <application>twm</application> package contains a very minimal
     34      window manager.
     35    </para>
    3436
    3537    &not-katamari;
    … …  
    4042    <itemizedlist spacing="compact">
    4143      <listitem>
    42         <para>Download (HTTP): <ulink url="&twm-download-http;"/></para>
     44        <para>
     45          Download (HTTP): <ulink url="&twm-download-http;"/>
     46        </para>
    4347      </listitem>
    4448      <listitem>
    45         <para>Download (FTP): <ulink url="&twm-download-ftp;"/></para>
     49        <para>
     50          Download (FTP): <ulink url="&twm-download-ftp;"/>
     51        </para>
    4652      </listitem>
    4753      <listitem>
    48         <para>Download MD5 sum: &twm-md5sum;</para>
     54        <para>
     55          Download MD5 sum: &twm-md5sum;
     56        </para>
    4957      </listitem>
    5058      <listitem>
    51         <para>Download size: &twm-size;</para>
     59        <para>
     60          Download size: &twm-size;
     61        </para>
    5262      </listitem>
    5363      <listitem>
    54         <para>Estimated disk space required: &twm-buildsize;</para>
     64        <para>
     65          Estimated disk space required: &twm-buildsize;
     66        </para>
    5567      </listitem>
    5668      <listitem>
    57         <para>Estimated build time: &twm-time;</para>
     69        <para>
     70          Estimated build time: &twm-time;
     71        </para>
    5872      </listitem>
    5973    </itemizedlist>
    … …  
    6276
    6377    <bridgehead renderas="sect4">Required</bridgehead>
    64     <para role="required"><xref linkend="xorg-server"/></para>
     78    <para role="required">
     79      <xref linkend="xorg-server"/>
     80    </para>
    6581
    6682    <bridgehead renderas="sect4">Recommended</bridgehead>
    67     <para role="recommended"><xref linkend="xorg7-legacy"/></para>
     83    <para role="recommended">
     84      <xref linkend="xorg7-legacy"/>
     85    </para>
    6886
    6987    <para condition="html" role="usernotes">User Notes:
    … …  
    7593    <title>Installation of twm</title>
    7694
    77     <para>Install <application>twm</application> by running the
    78     following commands:</para>
     95    <para>
     96      Install <application>twm</application> by running the
     97      following commands:
     98    </para>
    7999
    80100<screen><userinput>sed -i -e '/^rcdir =/s,^\(rcdir = \).*,\1/etc/X11/app-defaults,' src/Makefile.in &amp;&amp;
    … …  
    82102make</userinput></screen>
    83103
    84     <para>This package does not come with a test suite.</para>
     104    <para>
     105      This package does not come with a test suite.
     106    </para>
    85107
    86     <para>Now, as the <systemitem class="username">root</systemitem>
    87     user:</para>
     108    <para>
     109      Now, as the <systemitem class="username">root</systemitem> user:
     110    </para>
    88111
    89112<screen role="root"><userinput>make install</userinput></screen>
    … …  
    93116  <sect2 role="commands">
    94117    <title>Command Explanations</title>
    95     <para><command>sed -i -e '/^rcdir =/s...</command>: This command ensures
    96     the <application>twm</application> configuration file gets installed in
    97     the proper location.</para>
     118    <para>
     119      <command>sed -i -e '/^rcdir =/s...</command>: This command ensures
     120      the <application>twm</application> configuration file gets installed in
     121      the proper location.
     122    </para>
    98123  </sect2>
    99124
    … …  
    121146        <term><command>twm</command></term>
    122147        <listitem>
    123           <para>is the Tab Window Manager for the X Window System.</para>
     148          <para>
     149            is the Tab Window Manager for the X Window System.
     150          </para>
    124151          <indexterm zone="twm twm">
    125152            <primary sortas="b-twm">twm</primary>

  • x/installing/util-macros.xml

    rbdfc854 r71df408  
    3030    <title>Introduction to util-macros</title>
    3131
    32     <para>The <application>util-macros</application> package contains the
    33     <application>m4</application> macros used by all of the
    34     <application>Xorg</application> packages.</para>
     32    <para>
     33      The <application>util-macros</application> package contains the
     34      <application>m4</application> macros used by all of the
     35      <application>Xorg</application> packages.
     36    </para>
    3537
    3638    &lfs91_checked;
    … …  
    3941    <itemizedlist spacing="compact">
    4042      <listitem>
    41         <para>Download (HTTP): <ulink url="&util-macros-download-http;"/></para>
     43        <para>
     44          Download (HTTP): <ulink url="&util-macros-download-http;"/>
     45        </para>
    4246      </listitem>
    4347      <listitem>
    44         <para>Download (FTP): <ulink url="&util-macros-download-ftp;"/></para>
     48        <para>
     49          Download (FTP): <ulink url="&util-macros-download-ftp;"/>
     50        </para>
    4551      </listitem>
    4652      <listitem>
    47         <para>Download MD5 sum: &util-macros-md5sum;</para>
     53        <para>
     54          Download MD5 sum: &util-macros-md5sum;
     55        </para>
    4856      </listitem>
    4957      <listitem>
    50         <para>Download size: &util-macros-size;</para>
     58        <para>
     59          Download size: &util-macros-size;
     60        </para>
    5161      </listitem>
    5262      <listitem>
    53         <para>Estimated disk space required: &util-macros-buildsize;</para>
     63        <para>
     64          Estimated disk space required: &util-macros-buildsize;
     65        </para>
    5466      </listitem>
    5567      <listitem>
    56         <para>Estimated build time: &util-macros-time;</para>
     68        <para>
     69          Estimated build time: &util-macros-time;
     70        </para>
    5771      </listitem>
    5872    </itemizedlist>
    … …  
    7488    <title>Installation of util-macros</title>
    7589
    76     <para>Install <application>util-macros</application> by running the following
    77     commands:</para>
     90    <para>
     91      Install <application>util-macros</application> by running the following
     92      commands:
     93    </para>
    7894
    7995<screen><userinput>./configure $XORG_CONFIG</userinput></screen>
    8096
    81     <para>This package does not come with a test suite.</para>
     97    <para>
     98      This package does not come with a test suite.
     99    </para>
    82100
    83     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     101    <para>
     102      Now, as the <systemitem class="username">root</systemitem> user:
     103    </para>
    84104
    85105<screen role="root"><userinput>make install</userinput></screen>

  • x/installing/x7app.xml

    rbdfc854 r71df408  
    144144    <title>Introduction to Xorg Applications</title>
    145145
    146     <para>The <application>Xorg</application> applications provide the
    147     expected applications available in previous X Window
    148     implementations.</para>
     146    <para>
     147      The <application>Xorg</application> applications provide the
     148      expected applications available in previous X Window implementations.
     149    </para>
    149150
    150151    &lfs91_checked;
    … …  
    153154    <itemizedlist spacing="compact">
    154155      <listitem>
    155         <para>Download (HTTP): <ulink url="&x7apps-download-http;"/></para>
     156        <para>
     157          Download (HTTP): <ulink url="&x7apps-download-http;"/>
     158        </para>
    156159      </listitem>
    157160      <listitem>
    158         <para>Download (FTP): <ulink url="&x7apps-download-ftp;"/></para>
     161        <para>
     162          Download (FTP): <ulink url="&x7apps-download-ftp;"/>
     163        </para>
    159164      </listitem>
    160165      <listitem>
    161         <para>Download size: &x7apps-size;</para>
     166        <para>
     167          Download size: &x7apps-size;
     168        </para>
    162169      </listitem>
    163170      <listitem>
    164         <para>Estimated disk space required: &x7apps-buildsize;</para>
     171        <para>
     172          Estimated disk space required: &x7apps-buildsize;
     173        </para>
    165174      </listitem>
    166175      <listitem>
    167         <para>Estimated build time: &x7apps-time;</para>
     176        <para>
     177          Estimated build time: &x7apps-time;
     178        </para>
    168179      </listitem>
    169180    </itemizedlist>
    … …  
    195206    <title>Downloading Xorg Applications</title>
    196207
    197     <para>First, create a list of files to be downloaded. This file will also
    198     be used to verify the integrity of the downloads when complete:</para>
     208    <para>
     209      First, create a list of files to be downloaded. This file will also
     210      be used to verify the integrity of the downloads when complete:
     211    </para>
    199212
    200213<screen><userinput>cat &gt; app-&xorg-version;.md5 &lt;&lt; "EOF"
    … …  
    238251EOF</userinput></screen>
    239252
    240     <para>To download the needed files using <application>wget</application>,
    241     use the following commands:</para>
     253    <para>
     254      To download the needed files using <application>wget</application>,
     255      use the following commands:
     256    </para>
    242257
    243258<screen><userinput>mkdir app &amp;&amp;
    … …  
    254269&as_root;
    255270
    256     <para>First, start a subshell that will exit on error:</para>
     271    <para>
     272      First, start a subshell that will exit on error:
     273    </para>
    257274
    258275<screen><userinput>bash -e</userinput></screen>
    259276
    260     <para>Install all of the packages by running the following
    261     commands:</para>
     277    <para>
     278      Install all of the packages by running the following commands:
     279    </para>
    262280
    263281<screen><userinput>for package in $(grep -v '^#' ../app-&xorg-version;.md5 | awk '{print $2}')
    … …  
    279297done</userinput></screen>
    280298
    281     <para>Finally, exit the shell that was started earlier:</para>
     299    <para>
     300      Finally, exit the shell that was started earlier:
     301    </para>
    282302
    283303<screen><userinput>exit</userinput></screen>
    284304
    285   <para>
    286     Unless you installed the optional dependencies, remove an undocumented
    287     script which is reported to be broken (<command>xkeystone</command>
    288     provided by the <application>xrandr</application> package).
    289   </para>
     305    <para>
     306      Unless you installed the optional dependencies, remove an undocumented
     307      script which is reported to be broken (<command>xkeystone</command>
     308      provided by the <application>xrandr</application> package).
     309    </para>
    290310
    291311<screen><userinput>as_root rm -f $XORG_PREFIX/bin/xkeystone</userinput></screen>
    … …  
    336356        <term><command>iceauth</command></term>
    337357        <listitem>
    338           <para>is the ICE authority file utility.</para>
     358          <para>
     359            is the ICE authority file utility.
     360          </para>
    339361          <indexterm zone="xorg7-app iceauth-x7">
    340362            <primary sortas="b-iceauth">iceauth</primary>
    … …  
    346368        <term><command>luit</command></term>
    347369        <listitem>
    348           <para>provides locale and ISO 2022 support for Unicode
    349           terminals.</para>
     370          <para>
     371            provides locale and ISO 2022 support for Unicode terminals.
     372          </para>
    350373          <indexterm zone="xorg7-app luit-x7">
    351374            <primary sortas="b-luit">luit</primary>
    … …  
    357380        <term><command>mkfontdir</command></term>
    358381        <listitem>
    359           <para>creates an index of X font files in a directory.</para>
     382          <para>
     383            creates an index of X font files in a directory.
     384          </para>
    360385          <indexterm zone="xorg7-app mkfontdir-x7">
    361386            <primary sortas="b-mkfontdir">mkfontdir</primary>
    … …  
    367392        <term><command>mkfontscale</command></term>
    368393        <listitem>
    369           <para>creates an index of scalable font files for X.</para>
     394          <para>
     395            creates an index of scalable font files for X.
     396          </para>
    370397          <indexterm zone="xorg7-app mkfontscale-x7">
    371398            <primary sortas="b-mkfontscale">mkfontscale</primary>
    … …  
    377404        <term><command>sessreg</command></term>
    378405        <listitem>
    379           <para>manages utmp/wtmp entries for non-init clients.</para>
     406          <para>
     407            manages utmp/wtmp entries for non-init clients.
     408          </para>
    380409          <indexterm zone="xorg7-app sessreg-x7">
    381410            <primary sortas="b-sessreg">sessreg</primary>
    … …  
    387416        <term><command>setxkbmap</command></term>
    388417        <listitem>
    389           <para>sets the keyboard using the X Keyboard Extension.</para>
     418          <para>
     419            sets the keyboard using the X Keyboard Extension.
     420          </para>
    390421          <indexterm zone="xorg7-app setxkbmap-x7">
    391422            <primary sortas="b-setxkbmap">setxkbmap</primary>
    … …  
    397428        <term><command>smproxy</command></term>
    398429        <listitem>
    399           <para>is the Session Manager Proxy.</para>
     430          <para>
     431            is the Session Manager Proxy.
     432          </para>
    400433          <indexterm zone="xorg7-app smproxy-x7">
    401434            <primary sortas="b-smproxy">smproxy</primary>
    … …  
    407440        <term><command>x11perf</command></term>
    408441        <listitem>
    409           <para>is an X11 server performance test program.</para>
     442          <para>
     443            is an X11 server performance test program.
     444          </para>
    410445          <indexterm zone="xorg7-app x11perf-x7">
    411446            <primary sortas="b-x11perf">x11perf</primary>
    … …  
    417452        <term><command>x11perfcomp</command></term>
    418453        <listitem>
    419           <para>is an X11 server performance comparison program.</para>
     454          <para>
     455            is an X11 server performance comparison program.
     456          </para>
    420457          <indexterm zone="xorg7-app x11perfcomp-x7">
    421458            <primary sortas="b-x11perfcomp">x11perfcomp</primary>
    … …  
    427464        <term><command>xauth</command></term>
    428465        <listitem>
    429           <para>is the X authority file utility.</para>
     466          <para>
     467            is the X authority file utility.
     468          </para>
    430469          <indexterm zone="xorg7-app xauth-x7">
    431470            <primary sortas="b-xauth">xauth</primary>
    … …  
    437476        <term><command>xbacklight</command></term>
    438477        <listitem>
    439           <para>adjusts backlight brightness using RandR extension.</para>
     478          <para>
     479            adjusts backlight brightness using RandR extension.
     480          </para>
    440481          <indexterm zone="xorg7-app xbacklight-x7">
    441482            <primary sortas="b-xbacklight">xbacklight</primary>
    … …  
    447488        <term><command>xcmsdb</command></term>
    448489        <listitem>
    449           <para>is the Device Color Characterization utility for the X
    450           Color Management System.</para>
     490          <para>
     491            is the Device Color Characterization utility for the X
     492            Color Management System.
     493          </para>
    451494          <indexterm zone="xorg7-app xcmsdb-x7">
    452495            <primary sortas="b-xcmsdb">xcmsdb</primary>
    … …  
    458501        <term><command>xcursorgen</command></term>
    459502        <listitem>
    460           <para>creates an X cursor file from a collection of PNG
    461           images.</para>
     503          <para>
     504            creates an X cursor file from a collection of PNG images.
     505          </para>
    462506          <indexterm zone="xorg7-app xcursorgen-x7">
    463507            <primary sortas="b-xcursorgen">xcursorgen</primary>
    … …  
    469513        <term><command>xdpr</command></term>
    470514        <listitem>
    471           <para>dumps an X window directly to a printer.</para>
     515          <para>
     516            dumps an X window directly to a printer.
     517          </para>
    472518          <indexterm zone="xorg7-app xdpr-x7">
    473519            <primary sortas="b-xdpr">xdpr</primary>
    … …  
    479525        <term><command>xdpyinfo</command></term>
    480526        <listitem>
    481           <para>is a display information utility for X.</para>
     527          <para>
     528            is a display information utility for X.
     529          </para>
    482530          <indexterm zone="xorg7-app xdpyinfo-x7">
    483531            <primary sortas="b-xdpyinfo">xdpyinfo</primary>
    … …  
    489537        <term><command>xdriinfo</command></term>
    490538        <listitem>
    491           <para>queries configuration information of DRI drivers.</para>
     539          <para>
     540            queries configuration information of DRI drivers.
     541          </para>
    492542          <indexterm zone="xorg7-app xdriinfo-x7">
    493543            <primary sortas="b-xdriinfo">xdriinfo</primary>
    … …  
    499549        <term><command>xev</command></term>
    500550        <listitem>
    501           <para>prints contents of X events.</para>
     551          <para>
     552            prints contents of X events.
     553          </para>
    502554          <indexterm zone="xorg7-app xev-x7">
    503555            <primary sortas="b-xev">xev</primary>
    … …  
    509561        <term><command>xgamma</command></term>
    510562        <listitem>
    511           <para>alters a monitor's gamma correction through the X
    512           server.</para>
     563          <para>
     564            alters a monitor's gamma correction through the X server.
     565          </para>
    513566          <indexterm zone="xorg7-app xgamma-x7">
    514567            <primary sortas="b-xgamma">xgamma</primary>
    … …  
    520573        <term><command>xhost</command></term>
    521574        <listitem>
    522           <para>is a server access control program for X.</para>
     575          <para>
     576            is a server access control program for X.
     577          </para>
    523578          <indexterm zone="xorg7-app xhost-x7">
    524579            <primary sortas="b-xhost">xhost</primary>
    … …  
    530585        <term><command>xinput</command></term>
    531586        <listitem>
    532           <para>is a utility to configure and test X input devices.</para>
     587          <para>
     588            is a utility to configure and test X input devices.
     589          </para>
    533590          <indexterm zone="xorg7-app xinput-x7">
    534591            <primary sortas="b-xinput">xinput</primary>
    … …  
    540597        <term><command>xkbbell</command></term>
    541598        <listitem>
    542           <para>is an XKB utility program that raises a bell event.</para>
     599          <para>
     600            is an XKB utility program that raises a bell event.
     601          </para>
    543602          <indexterm zone="xorg7-app xkbbell-x7">
    544603            <primary sortas="b-xkbbell">xkbbell</primary>
    … …  
    550609        <term><command>xkbcomp</command></term>
    551610        <listitem>
    552           <para>compiles an XKB keyboard description.</para>
     611          <para>
     612            compiles an XKB keyboard description.
     613          </para>
    553614          <indexterm zone="xorg7-app xkbcomp-x7">
    554615            <primary sortas="b-xkbcomp">xkbcomp</primary>
    … …  
    560621        <term><command>xkbevd</command></term>
    561622        <listitem>
    562           <para>is the XKB event daemon.</para>
     623          <para>
     624            is the XKB event daemon.
     625          </para>
    563626          <indexterm zone="xorg7-app xkbevd-x7">
    564627            <primary sortas="b-xkbevd">xkbevd</primary>
    … …  
    570633        <term><command>xkbvleds</command></term>
    571634        <listitem>
    572           <para>shows the XKB status of keyboard LEDs.</para>
     635          <para>
     636            shows the XKB status of keyboard LEDs.
     637          </para>
    573638          <indexterm zone="xorg7-app xkbvleds-x7">
    574639            <primary sortas="b-xkbvleds">xkbvleds</primary>
    … …  
    580645        <term><command>xkbwatch</command></term>
    581646        <listitem>
    582           <para>monitors modifier keys and LEDs.</para>
     647          <para>
     648            monitors modifier keys and LEDs.
     649          </para>
    583650          <indexterm zone="xorg7-app xkbwatch-x7">
    584651            <primary sortas="b-xkbwatch">xkbwatch</primary>
    … …  
    590657        <term><command>xkill</command></term>
    591658        <listitem>
    592           <para>kills a client by its X resource.</para>
     659          <para>
     660            kills a client by its X resource.
     661          </para>
    593662          <indexterm zone="xorg7-app xkill-x7">
    594663            <primary sortas="b-xkill">xkill</primary>
    … …  
    600669        <term><command>xlsatoms</command></term>
    601670        <listitem>
    602           <para>lists interned atoms defined on the server.</para>
     671          <para>
     672            lists interned atoms defined on the server.
     673          </para>
    603674          <indexterm zone="xorg7-app xlsatoms-x7">
    604675            <primary sortas="b-xlsatoms">xlsatoms</primary>
    … …  
    610681        <term><command>xlsclients</command></term>
    611682        <listitem>
    612           <para>lists client applications running on a display.</para>
     683          <para>
     684            lists client applications running on a display.
     685          </para>
    613686          <indexterm zone="xorg7-app xlsclients-x7">
    614687            <primary sortas="b-xlsclients">xlsclients</primary>
    … …  
    620693        <term><command>xmessage</command></term>
    621694        <listitem>
    622           <para>displays a message or query in a window.</para>
     695          <para>
     696            displays a message or query in a window.
     697          </para>
    623698          <indexterm zone="xorg7-app xmessage-x7">
    624699            <primary sortas="b-xmessage">xmessage</primary>
    … …  
    630705        <term><command>xmodmap</command></term>
    631706        <listitem>
    632           <para>is a utility for modifying keymaps and pointer button
    633           mappings in X.</para>
     707          <para>
     708            is a utility for modifying keymaps and pointer button
     709            mappings in X.
     710          </para>
    634711          <indexterm zone="xorg7-app xmodmap-x7">
    635712            <primary sortas="b-xmodmap">xmodmap</primary>
    … …  
    641718        <term><command>xpr</command></term>
    642719        <listitem>
    643           <para>prints an X window dump.</para>
     720          <para>
     721            prints an X window dump.
     722          </para>
    644723          <indexterm zone="xorg7-app xpr-x7">
    645724            <primary sortas="b-xpr">xpr</primary>
    … …  
    651730        <term><command>xprop</command></term>
    652731        <listitem>
    653           <para>is a property displayer for X.</para>
     732          <para>
     733            is a property displayer for X.
     734          </para>
    654735          <indexterm zone="xorg7-app xprop-x7">
    655736            <primary sortas="b-xprop">xprop</primary>
    … …  
    661742        <term><command>xrandr</command></term>
    662743        <listitem>
    663           <para>is a primitive command line interface to RandR
    664           extension.</para>
     744          <para>
     745            is a primitive command line interface to RandR extension.
     746          </para>
    665747          <indexterm zone="xorg7-app xrandr-x7">
    666748            <primary sortas="b-xrandr">xrandr</primary>
    … …  
    672754        <term><command>xrdb</command></term>
    673755        <listitem>
    674           <para>is the X server resource database utility.</para>
     756          <para>
     757            is the X server resource database utility.
     758          </para>
    675759          <indexterm zone="xorg7-app xrdb-x7">
    676760            <primary sortas="b-xrdb">xrdb</primary>
    … …  
    682766        <term><command>xrefresh</command></term>
    683767        <listitem>
    684           <para>refreshes all or part of an X screen.</para>
     768          <para>
     769            refreshes all or part of an X screen.
     770          </para>
    685771          <indexterm zone="xorg7-app xrefresh-x7">
    686772            <primary sortas="b-xrefresh">xrefresh</primary>
    … …  
    692778        <term><command>xset</command></term>
    693779        <listitem>
    694           <para>is the user preference utility for X.</para>
     780          <para>
     781            is the user preference utility for X.
     782          </para>
    695783          <indexterm zone="xorg7-app xset-x7">
    696784            <primary sortas="b-xset">xset</primary>
    … …  
    702790        <term><command>xsetroot</command></term>
    703791        <listitem>
    704           <para>is the root window parameter setting utility for X.</para>
     792          <para>
     793            is the root window parameter setting utility for X.
     794          </para>
    705795          <indexterm zone="xorg7-app xsetroot-x7">
    706796            <primary sortas="b-xsetroot">xsetroot</primary>
    … …  
    712802        <term><command>xvinfo</command></term>
    713803        <listitem>
    714           <para>prints out X-Video extension adaptor information.</para>
     804          <para>
     805            prints out X-Video extension adaptor information.
     806          </para>
    715807          <indexterm zone="xorg7-app xvinfo-x7">
    716808            <primary sortas="b-xvinfo">xvinfo</primary>
    … …  
    722814        <term><command>xwd</command></term>
    723815        <listitem>
    724           <para>dumps an image of an X window.</para>
     816          <para>
     817            dumps an image of an X window.
     818          </para>
    725819          <indexterm zone="xorg7-app xwd-x7">
    726820            <primary sortas="b-xwd">xwd</primary>
    … …  
    732826        <term><command>xwininfo</command></term>
    733827        <listitem>
    734           <para>is a window information utility for X.</para>
     828          <para>
     829            is a window information utility for X.
     830          </para>
    735831          <indexterm zone="xorg7-app xwininfo-x7">
    736832            <primary sortas="b-xwininfo">xwininfo</primary>
    … …  
    742838        <term><command>xwud</command></term>
    743839        <listitem>
    744           <para>is an image displayer for X.</para>
     840          <para>
     841            is an image displayer for X.
     842          </para>
    745843          <indexterm zone="xorg7-app xwud-x7">
    746844            <primary sortas="b-xwud">xwud</primary>

  • x/installing/x7driver-ati.xml

    rbdfc854 r71df408  
    152152CONFIG_EXTRA_FIRMWARE_DIR="/lib/firmware"</literal></screen>
    153153
    154      <note><para>CONFIG_EXTRA_FIRMWARE should all be on one line.  It
    155      is shown above as two lines for presentation only.</para></note>
     154     <note>
     155       <para>
     156         CONFIG_EXTRA_FIRMWARE should all be on one line.  It
     157         is shown above as two lines for presentation only.
     158       </para>
     159     </note>
    156160
    157161      <tip>

  • x/installing/x7driver-intel.xml

    rbdfc854 r71df408  
    2323]>
    2424
    25   <!-- Begin Xorg Intel Driver -->
    26   <sect2 id="xorg-intel-driver" xreflabel="Xorg Intel Driver-&xorg-intel-driver-version;">
     25<sect2 id="xorg-intel-driver" xreflabel="Xorg Intel Driver-&xorg-intel-driver-version;">
    2726
    2827  <sect2info>
    … …  
    3130  </sect2info>
    3231
    33     <title>Xorg Intel Driver-&xorg-intel-driver-version;</title>
    34 
    35     <indexterm zone="xorg-intel-driver">
    36       <primary sortas="a-xorg-intel-driver">xorg-intel-driver</primary>
    37     </indexterm>
    38 
    39     <sect3 role="package">
    40       <title>Introduction to Xorg Intel Driver</title>
    41 
     32  <title>Xorg Intel Driver-&xorg-intel-driver-version;</title>
     33
     34  <indexterm zone="xorg-intel-driver">
     35    <primary sortas="a-xorg-intel-driver">xorg-intel-driver</primary>
     36  </indexterm>
     37
     38  <sect3 role="package">
     39    <title>Introduction to Xorg Intel Driver</title>
     40
     41    <para>
     42      The <application>Xorg Intel Driver</application> package contains the
     43      X.Org Video Driver for Intel integrated video chips including 8xx, 9xx,
     44      Gxx, Qxx, HD, Iris, and Iris Pro graphics processors.
     45    </para>
     46
     47    &lfs91_checked;
     48
     49    <note>
    4250      <para>
    43         The <application>Xorg Intel Driver</application> package contains the X.Org
    44         Video Driver for Intel integrated video chips including 8xx, 9xx, Gxx, Qxx,
    45         HD, Iris, and Iris Pro graphics processors.
     51        This is a development version of the Intel driver
     52        which is needed to work properly with the latest hardware.
    4653      </para>
    47 
    48       &lfs91_checked;
    49 
    50       <note><para>This is a development version of the Intel driver
    51       which is needed to work properly with the latest hardware.</para></note>
    52 
    53       <bridgehead renderas="sect4">Package Information</bridgehead>
    54       <itemizedlist spacing="compact">
    55         <listitem>
    56           <para>
    57             Download (HTTP): <ulink url="&xorg-intel-driver-download-http;"/>
    58           </para>
    59         </listitem>
    60         <listitem>
    61           <para>
    62             Download (FTP): <ulink url="&xorg-intel-driver-download-ftp;"/>
    63           </para>
    64         </listitem>
    65         <listitem>
    66           <para>
    67             Download MD5 sum: &xorg-intel-driver-md5sum;
    68           </para>
    69         </listitem>
    70         <listitem>
    71           <para>
    72             Download size: &xorg-intel-driver-size;
    73           </para>
    74         </listitem>
    75         <listitem>
    76           <para>
    77             Estimated disk space required: &xorg-intel-driver-buildsize;
    78           </para>
    79         </listitem>
    80         <listitem>
    81           <para>
    82             Estimated build time: &xorg-intel-driver-time;
    83           </para>
    84         </listitem>
    85       </itemizedlist>
    86 
    87       <bridgehead renderas="sect4">Xorg Intel Driver Dependencies</bridgehead>
    88 
    89       <bridgehead renderas="sect5">Required</bridgehead>
    90       <para role="required">
    91         <xref linkend="xcb-util"/> and
    92         <xref linkend="xorg-server"/>
    93       </para>
    94 
    95       <para condition="html" role="usernotes">
    96         User Notes: <ulink url="&blfs-wiki;/xorg-intel-driver"/>
    97       </para>
    98     </sect3>
    99 
    100     <sect3 role="kernel" id="xorg-intel-driver-kernel">
    101       <title>Kernel Configuration</title>
     54    </note>
     55
     56    <bridgehead renderas="sect4">Package Information</bridgehead>
     57    <itemizedlist spacing="compact">
     58      <listitem>
     59        <para>
     60          Download (HTTP): <ulink url="&xorg-intel-driver-download-http;"/>
     61        </para>
     62      </listitem>
     63      <listitem>
     64        <para>
     65          Download (FTP): <ulink url="&xorg-intel-driver-download-ftp;"/>
     66        </para>
     67      </listitem>
     68      <listitem>
     69        <para>
     70          Download MD5 sum: &xorg-intel-driver-md5sum;
     71        </para>
     72      </listitem>
     73      <listitem>
     74        <para>
     75          Download size: &xorg-intel-driver-size;
     76        </para>
     77      </listitem>
     78      <listitem>
     79        <para>
     80          Estimated disk space required: &xorg-intel-driver-buildsize;
     81        </para>
     82      </listitem>
     83      <listitem>
     84        <para>
     85          Estimated build time: &xorg-intel-driver-time;
     86        </para>
     87      </listitem>
     88    </itemizedlist>
     89
     90    <bridgehead renderas="sect4">Xorg Intel Driver Dependencies</bridgehead>
     91
     92    <bridgehead renderas="sect5">Required</bridgehead>
     93    <para role="required">
     94      <xref linkend="xcb-util"/> and
     95      <xref linkend="xorg-server"/>
     96    </para>
     97
     98    <para condition="html" role="usernotes">
     99      User Notes: <ulink url="&blfs-wiki;/xorg-intel-driver"/>
     100    </para>
     101  </sect3>
     102
     103  <sect3 role="kernel" id="xorg-intel-driver-kernel">
     104    <title>Kernel Configuration</title>
    102105
    103106    <para>
    … …  
    111114   &lt;*&gt; Intel 8xx/9xx/G3x/G4x/HD Graphics                   [CONFIG_DRM_I915]</literal></screen>
    112115
    113       <indexterm zone="xorg-intel-driver xorg-intel-driver-kernel">
    114         <primary sortas="d-xorg-intel-driver">xorg-intel-driver</primary>
    115       </indexterm>
    116     </sect3>
    117 
    118     <sect3 role="installation">
    119       <title>Installation of Xorg Intel Driver</title>
     116    <indexterm zone="xorg-intel-driver xorg-intel-driver-kernel">
     117      <primary sortas="d-xorg-intel-driver">xorg-intel-driver</primary>
     118    </indexterm>
     119  </sect3>
     120
     121  <sect3 role="installation">
     122    <title>Installation of Xorg Intel Driver</title>
    120123
    121124<!-- appears to be in the current git version, but commenting since I do not have an 32-bit
    122       <para>
    123         If you are building on i686, apply a sed to fix a type mismatch.
    124       </para>
     125    <para>
     126      If you are building on i686, apply a sed to fix a type mismatch.
     127    </para>
    125128
    126129<screen><userinput remap="pre">case $(uname -m) in
    … …  
    129132esac</userinput></screen>-->
    130133
    131       <para>
    132         Install <application>Xorg Intel Driver</application> by running the following
    133         commands:
    134       </para>
    135 
    136       <screen><userinput>./autogen.sh $XORG_CONFIG     \
     134    <para>
     135      Install <application>Xorg Intel Driver</application> by running the
     136      following commands:
     137    </para>
     138
     139<screen><userinput>./autogen.sh $XORG_CONFIG     \
    137140            --enable-kms-only \
    138141            --enable-uxa      \
    … …  
    140143make</userinput></screen>
    141144
    142       <para>
    143         This package does not come with a test suite.
    144       </para>
    145 
    146       <para>
    147         Now, as the <systemitem class="username">root</systemitem> user:
    148       </para>
     145    <para>
     146      This package does not come with a test suite.
     147    </para>
     148
     149    <para>
     150      Now, as the <systemitem class="username">root</systemitem> user:
     151    </para>
    149152
    150153<screen role="root"><userinput>make install &amp;&amp;
    … …  
    155158sed -i '/\.TH/s/4/1/' /usr/share/man/man1/intel-virtual-output.1</userinput></screen>
    156159
    157     </sect3>
    158 
    159     <sect3>
    160       <title>Working around problems with the Intel driver</title>
    161 
    162       <para>
    163         The SandyBridge New Acceleration (SNA) code is intended to replace the
    164         old UXA (UMA Acceleration Architecture), but it is a large body of code
    165         and may cause problems.  However, the version of the code in the
    166         version control system listed above has been tested successfully with
    167         both SNA and UXA capabilities.
    168      </para>
    169 
    170       <para>
    171         To work around this problem, as well as enabling support for UXA, it is
    172         necessary to force UXA to be used by creating a configuration file.  If
    173         this problem applies to you, create the following file as the
    174         <systemitem class="username">root</systemitem> user and modify it as
    175         needed:
    176       </para>
     160  </sect3>
     161
     162  <sect3>
     163    <title>Working around problems with the Intel driver</title>
     164
     165    <para>
     166      The SandyBridge New Acceleration (SNA) code is intended to replace the
     167      old UXA (UMA Acceleration Architecture), but it is a large body of code
     168      and may cause problems.  However, the version of the code in the
     169      version control system listed above has been tested successfully with
     170      both SNA and UXA capabilities.
     171    </para>
     172
     173    <para>
     174      To work around this problem, as well as enabling support for UXA, it is
     175      necessary to force UXA to be used by creating a configuration file.  If
     176      this problem applies to you, create the following file as the
     177      <systemitem class="username">root</systemitem> user and modify it as
     178      needed:
     179    </para>
    177180
    178181<screen role="root"><userinput>cat &gt;&gt; /etc/X11/xorg.conf.d/20-intel.conf &lt;&lt; "EOF"
    … …  
    186189EOF</userinput></screen>
    187190
    188     </sect3>
    189 
    190     <sect3 role="commands">
    191       <title>Command Explanations</title>
    192 
    193       <para>
    194         <parameter>--enable-kms-only</parameter>: This switch omits the UMS
    195         (User Mode Setting) code.
    196       </para>
    197 
    198       <para>
    199         <parameter>--enable-uxa</parameter>: This switch allows the old UXA code
    200         to be compiled in addition to the default SNA.
    201       </para>
    202 
    203     </sect3>
    204 
    205     <sect3 role="content">
    206       <title>Contents</title>
    207 
    208       <segmentedlist>
    209         <segtitle>Installed Program</segtitle>
    210         <segtitle>Installed Library</segtitle>
    211         <segtitle>Installed Xorg Driver</segtitle>
    212 
    213         <seglistitem>
    214           <seg>
    215             intel-virtual-output
    216           </seg>
    217           <seg>
    218             libIntelXvMC.so
    219           </seg>
    220           <seg>
    221             intel_drv.so
    222           </seg>
    223         </seglistitem>
    224       </segmentedlist>
    225 
    226       <variablelist>
    227         <bridgehead renderas="sect4">Short Descriptions</bridgehead>
    228         <?dbfo list-presentation="list"?>
    229         <?dbhtml list-presentation="table"?>
    230 
    231         <varlistentry id="intel-virtual-output">
    232           <term><command>intel-virtual-output</command></term>
    233           <listitem>
    234             <para>
    235               is a utility to connect the integrated Intel GPU to discrete
    236               outputs on hybrid systems.
    237             </para>
    238             <indexterm zone="xorg-intel-driver intel-virtual-output">
    239               <primary sortas="b-intel-virtual-output">intel-virtual-output</primary>
    240             </indexterm>
    241            </listitem>
    242         </varlistentry>
    243 
    244         <varlistentry id="intel_drv">
    245           <term><filename class="libraryfile">intel_drv.so</filename></term>
    246           <listitem>
    247             <para>
    248               is an Xorg video driver for Intel integrated graphics chipsets.
    249             </para>
    250             <indexterm zone="xorg-intel-driver intel_drv">
    251               <primary sortas="c-intel_drv">intel_drv.so</primary>
    252             </indexterm>
    253           </listitem>
    254         </varlistentry>
    255 
    256       </variablelist>
    257 
    258     </sect3>
    259 
    260   </sect2>
    261   <!-- End Xorg Intel Driver -->
     191  </sect3>
     192
     193  <sect3 role="commands">
     194    <title>Command Explanations</title>
     195
     196    <para>
     197      <parameter>--enable-kms-only</parameter>: This switch omits the UMS
     198      (User Mode Setting) code.
     199    </para>
     200
     201    <para>
     202      <parameter>--enable-uxa</parameter>: This switch allows the old UXA code
     203      to be compiled in addition to the default SNA.
     204    </para>
     205
     206  </sect3>
     207
     208  <sect3 role="content">
     209    <title>Contents</title>
     210
     211    <segmentedlist>
     212      <segtitle>Installed Program</segtitle>
     213      <segtitle>Installed Library</segtitle>
     214      <segtitle>Installed Xorg Driver</segtitle>
     215
     216      <seglistitem>
     217        <seg>
     218          intel-virtual-output
     219        </seg>
     220        <seg>
     221          libIntelXvMC.so
     222        </seg>
     223        <seg>
     224          intel_drv.so
     225        </seg>
     226      </seglistitem>
     227    </segmentedlist>
     228
     229    <variablelist>
     230      <bridgehead renderas="sect4">Short Descriptions</bridgehead>
     231      <?dbfo list-presentation="list"?>
     232      <?dbhtml list-presentation="table"?>
     233
     234      <varlistentry id="intel-virtual-output">
     235        <term><command>intel-virtual-output</command></term>
     236        <listitem>
     237          <para>
     238            is a utility to connect the integrated Intel GPU to discrete
     239            outputs on hybrid systems.
     240          </para>
     241          <indexterm zone="xorg-intel-driver intel-virtual-output">
     242            <primary sortas="b-intel-virtual-output">intel-virtual-output</primary>
     243          </indexterm>
     244        </listitem>
     245      </varlistentry>
     246
     247      <varlistentry id="intel_drv">
     248        <term><filename class="libraryfile">intel_drv.so</filename></term>
     249        <listitem>
     250          <para>
     251            is an Xorg video driver for Intel integrated graphics chipsets.
     252          </para>
     253          <indexterm zone="xorg-intel-driver intel_drv">
     254            <primary sortas="c-intel_drv">intel_drv.so</primary>
     255          </indexterm>
     256        </listitem>
     257      </varlistentry>
     258
     259    </variablelist>
     260
     261  </sect3>
     262
     263</sect2>

  • x/installing/x7font.xml

    rbdfc854 r71df408  
    5757    <title>Introduction to Xorg Fonts</title>
    5858
    59     <para>The <application>Xorg</application> font packages provide some
    60     scalable fonts and supporting packages for <application>Xorg</application>
    61     applications. Many people will want to install other TTF or OTF fonts in
    62     addition to, or instead of, these. Some are listed at <xref
    63     linkend="TTF-and-OTF-fonts"/>.</para>
     59    <para>
     60      The <application>Xorg</application> font packages provide some scalable
     61      fonts and supporting packages for <application>Xorg</application>
     62      applications. Many people will want to install other TTF or OTF fonts in
     63      addition to, or instead of, these. Some are listed at <xref
     64      linkend="TTF-and-OTF-fonts"/>.
     65    </para>
    6466
    6567    &lfs91_checked;
    … …  
    6870    <itemizedlist spacing="compact">
    6971      <listitem>
    70         <para>Download (HTTP): <ulink url="&x7fonts-download-http;"/></para>
    71       </listitem>
    72       <listitem>
    73         <para>Download (FTP): <ulink url="&x7fonts-download-ftp;"/></para>
    74       </listitem>
    75       <listitem>
    76         <para>Download size: &x7fonts-size;</para>
    77       </listitem>
    78       <listitem>
    79         <para>Estimated disk space required: &x7fonts-buildsize;</para>
    80       </listitem>
    81       <listitem>
    82         <para>Estimated build time: &x7fonts-time;</para>
     72        <para>
     73          Download (HTTP): <ulink url="&x7fonts-download-http;"/>
     74        </para>
     75      </listitem>
     76      <listitem>
     77        <para>
     78          Download (FTP): <ulink url="&x7fonts-download-ftp;"/>
     79        </para>
     80      </listitem>
     81      <listitem>
     82        <para>
     83          Download size: &x7fonts-size;
     84        </para>
     85      </listitem>
     86      <listitem>
     87        <para>
     88          Estimated disk space required: &x7fonts-buildsize;
     89        </para>
     90      </listitem>
     91      <listitem>
     92        <para>
     93          Estimated build time: &x7fonts-time;
     94        </para>
    8395      </listitem>
    8496    </itemizedlist>
    … …  
    99111    <title>Downloading Xorg Fonts</title>
    100112
    101     <para>First, create a list of files to be downloaded. This file will also
    102     be used to verify the integrity of the downloads when complete:</para>
     113    <para>
     114      First, create a list of files to be downloaded. This file will also
     115      be used to verify the integrity of the downloads when complete:
     116    </para>
    103117
    104118<screen><userinput>cat &gt; font-&xorg-version;.md5 &lt;&lt; "EOF"
    … …  
    114128EOF</userinput></screen>
    115129
    116     <para>To download the needed files using <application>wget</application>,
    117     use the following commands:</para>
     130    <para>
     131      To download the needed files using <application>wget</application>,
     132      use the following commands:
     133    </para>
    118134
    119135<screen><userinput>mkdir font &amp;&amp;
    … …  
    130146&as_root;
    131147
    132     <para>First, start a subshell that will exit on error:</para>
     148    <para>
     149      First, start a subshell that will exit on error:
     150    </para>
    133151
    134152<screen><userinput>bash -e</userinput></screen>
    135153
    136     <para>Install all of the packages by running the following
    137     commands:</para>
     154    <para>
     155      Install all of the packages by running the following commands:
     156    </para>
    138157
    139158<screen><userinput>for package in $(grep -v '^#' ../font-&xorg-version;.md5 | awk '{print $2}')
    … …  
    149168done</userinput></screen>
    150169
    151     <para>Finally, exit the shell that was started earlier:</para>
     170    <para>
     171      Finally, exit the shell that was started earlier:
     172    </para>
    152173
    153174<screen><userinput>exit</userinput></screen>
    154175
    155     <para>When all of the fonts have been installed, the system must be
    156     configured so that <application>Fontconfig</application> can find the
    157     TrueType fonts since they are outside of the default search path of
    158     <filename class="directory">/usr/share/fonts</filename>.  Make symlinks
    159     to the <application>Xorg</application> TrueType font directories by
    160     running the following commands as the
    161     <systemitem class="username">root</systemitem> user:</para>
     176    <para>
     177      When all of the fonts have been installed, the system must be
     178      configured so that <application>Fontconfig</application> can find the
     179      TrueType fonts since they are outside of the default search path of
     180      <filename class="directory">/usr/share/fonts</filename>.  Make symlinks
     181      to the <application>Xorg</application> TrueType font directories by
     182      running the following commands as the
     183      <systemitem class="username">root</systemitem> user:
     184    </para>
    162185
    163186<screen role="root"><userinput>install -v -d -m755 /usr/share/fonts                               &amp;&amp;
    … …  
    190213        <term><command>bdftruncate</command></term>
    191214        <listitem>
    192           <para>generates a truncated BDF font from an ISO 10646-1 encoded
    193           BDF font.</para>
     215          <para>
     216            generates a truncated BDF font from an ISO 10646-1 encoded BDF font.
     217          </para>
    194218          <indexterm zone="xorg7-font bdftruncate-x7">
    195219            <primary sortas="b-bdftruncate">bdftruncate</primary>
    … …  
    201225        <term><command>ucs2any</command></term>
    202226        <listitem>
    203           <para>generates BDF fonts in any encoding from an ISO 10646-1 encoded
    204           BDF font.</para>
     227          <para>
     228            generates BDF fonts in any encoding from an ISO 10646-1 encoded
     229            BDF font.
     230          </para>
    205231          <indexterm zone="xorg7-font ucs2any-x7">
    206232            <primary sortas="b-ucs2any">ucs2any</primary>

  • x/installing/x7legacy.xml

    rbdfc854 r71df408  
    5050    <title>Introduction to Xorg Legacy</title>
    5151
    52     <para><application>Xorg</application>&apos;s ancestor (X11R1, in 1987) at
    53     first only provided bitmap fonts, with a tool (<command>bdftopcf</command>)
    54     to assist in their installation. With the introduction of
    55     <application>xorg-server-1.19.0</application>
    56     and <application>libXfont2</application> many people will not need them.
    57     There are still a few old packages which might require, or benefit from,
    58     these deprecated fonts and so the following packages are shown here.</para>
     52    <para>
     53      <application>Xorg</application>&apos;s ancestor (X11R1, in 1987) at
     54      first only provided bitmap fonts, with a tool
     55      (<command>bdftopcf</command>) to assist in their installation. With the
     56      introduction of <application>xorg-server-1.19.0</application> and
     57      <application>libXfont2</application> many people will not need them.
     58      There are still a few old packages which might require, or benefit from,
     59      these deprecated fonts and so the following packages are shown here.
     60    </para>
    5961
    6062    <note>
    … …  
    7274
    7375      <para revision="sysv">
    74        Please consult the BLFS-7.10 book at <ulink
    75        url="http://www.linuxfromscratch.org/blfs/view/7.10/x/x7font.html"/>
    76        if you wish to install any of those other fonts.
     76        Please consult the BLFS-7.10 book at <ulink
     77        url="http://www.linuxfromscratch.org/blfs/view/7.10/x/x7font.html"/>
     78        if you wish to install any of those other fonts.
    7779      </para>
    7880
    7981      <para revision="systemd">
    80        Please consult the BLFS-7.10 systemd book at <ulink
    81        url="http://www.linuxfromscratch.org/blfs/view/7.10-systemd/x/x7font.html"/>
    82        if you wish to install any of those other fonts.
     82        Please consult the BLFS-7.10 systemd book at <ulink url=
     83        "http://www.linuxfromscratch.org/blfs/view/7.10-systemd/x/x7font.html"/>
     84        if you wish to install any of those other fonts.
    8385      </para>
    8486    </note>
    … …  
    8991    <itemizedlist spacing="compact">
    9092      <listitem>
    91         <para>Download (HTTP): <ulink url="&x7legacy-download-http;"/></para>
    92       </listitem>
    93       <listitem>
    94         <para>Download (FTP): <ulink url="&x7legacy-download-ftp;"/></para>
    95       </listitem>
    96       <listitem>
    97         <para>Download size: &x7legacy-size;</para>
    98       </listitem>
    99       <listitem>
    100         <para>Estimated disk space required: &x7legacy-buildsize;</para>
    101       </listitem>
    102       <listitem>
    103         <para>Estimated build time: &x7legacy-time;</para>
     93        <para>
     94          Download (HTTP): <ulink url="&x7legacy-download-http;"/>
     95        </para>
     96      </listitem>
     97      <listitem>
     98        <para>
     99          Download (FTP): <ulink url="&x7legacy-download-ftp;"/>
     100        </para>
     101      </listitem>
     102      <listitem>
     103        <para>
     104          Download size: &x7legacy-size;
     105        </para>
     106      </listitem>
     107      <listitem>
     108        <para>
     109          Estimated disk space required: &x7legacy-buildsize;
     110        </para>
     111      </listitem>
     112      <listitem>
     113        <para>
     114          Estimated build time: &x7legacy-time;
     115        </para>
    104116      </listitem>
    105117    </itemizedlist>
    … …  
    120132    <title>Downloading Xorg Legacy</title>
    121133
    122     <para>First, create a list of files to be downloaded. This file will also
    123     be used to verify the integrity of the downloads when complete:</para>
     134    <para>
     135      First, create a list of files to be downloaded. This file will also
     136      be used to verify the integrity of the downloads when complete:
     137    </para>
    124138
    125139<screen><userinput>cat &gt; legacy.dat &lt;&lt; "EOF"
    … …  
    133147EOF</userinput></screen>
    134148
    135     <para>To download the needed files using <application>wget</application>,
    136     use the following commands:</para>
     149    <para>
     150      To download the needed files using <application>wget</application>,
     151      use the following commands:
     152    </para>
    137153
    138154<screen><userinput>mkdir legacy &amp;&amp;
    … …  
    150166&as_root;
    151167
    152     <para>First, start a subshell that will exit on error:</para>
     168    <para>
     169      First, start a subshell that will exit on error:
     170    </para>
    153171
    154172<screen><userinput>bash -e</userinput></screen>
    155173
    156     <para>Install all of the packages by running the following
    157     commands:</para>
     174    <para>
     175      Install all of the packages by running the following commands:
     176    </para>
    158177
    159178<screen><userinput>for package in $(grep -v '^#' ../legacy.md5 | awk '{print $2}')
    … …  
    170189done</userinput></screen>
    171190
    172     <para>Finally, exit the shell that was started earlier:</para>
     191    <para>
     192      Finally, exit the shell that was started earlier:
     193    </para>
    173194
    174195<screen><userinput>exit</userinput></screen>
    … …  
    201222        <term><command>bdftopcf</command></term>
    202223        <listitem>
    203           <para>converts an X font from Bitmap Distribution Format to Portable
    204           Compiled Format.</para>
     224          <para>
     225            converts an X font from Bitmap Distribution Format to Portable
     226            Compiled Format.
     227          </para>
    205228          <indexterm zone="xorg7-legacy bdftopcf-x7">
    206229            <primary sortas="b-bdftopcf">bdftopcf</primary>

  • 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>

  • x/installing/xcb-proto.xml

    rbdfc854 r71df408  
    3030    <title>Introduction to xcb-proto</title>
    3131
    32     <para>The <application>xcb-proto</application> package provides the
    33     XML-XCB protocol descriptions that <application>libxcb</application>
    34     uses to generate the majority of its code and API.</para>
     32    <para>
     33      The <application>xcb-proto</application> package provides the
     34      XML-XCB protocol descriptions that <application>libxcb</application>
     35      uses to generate the majority of its code and API.
     36    </para>
    3537
    3638    &lfs91_checked;
    … …  
    3941    <itemizedlist spacing="compact">
    4042      <listitem>
    41         <para>Download (HTTP): <ulink url="&xcb-proto-download-http;"/></para>
     43        <para>
     44          Download (HTTP): <ulink url="&xcb-proto-download-http;"/>
     45        </para>
    4246      </listitem>
    4347      <listitem>
    44         <para>Download (FTP): <ulink url="&xcb-proto-download-ftp;"/></para>
     48        <para>
     49          Download (FTP): <ulink url="&xcb-proto-download-ftp;"/>
     50        </para>
    4551      </listitem>
    4652      <listitem>
    47         <para>Download MD5 sum: &xcb-proto-md5sum;</para>
     53        <para>
     54          Download MD5 sum: &xcb-proto-md5sum;
     55        </para>
    4856      </listitem>
    4957      <listitem>
    50         <para>Download size: &xcb-proto-size;</para>
     58        <para>
     59          Download size: &xcb-proto-size;
     60        </para>
    5161      </listitem>
    5262      <listitem>
    53         <para>Estimated disk space required: &xcb-proto-buildsize;</para>
     63        <para>
     64          Estimated disk space required: &xcb-proto-buildsize;
     65        </para>
    5466      </listitem>
    5567      <listitem>
    56         <para>Estimated build time: &xcb-proto-time;</para>
     68        <para>
     69          Estimated build time: &xcb-proto-time;
     70        </para>
    5771      </listitem>
    5872    </itemizedlist>
    … …  
    7488    <title>Installation of xcb-proto</title>
    7589
    76     <para>Install <application>xcb-proto</application> by running the following
    77     commands:</para>
     90    <para>
     91      Install <application>xcb-proto</application> by running the following
     92      commands:
     93    </para>
    7894
    7995<screen><userinput>./configure $XORG_CONFIG</userinput></screen>
    8096
    81     <para>To test the results, issue: <command>make check</command>.</para>
     97    <para>
     98      To test the results, issue: <command>make check</command>.
     99    </para>
    82100
    83     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     101    <para>
     102      Now, as the <systemitem class="username">root</systemitem> user:
     103    </para>
    84104
    85105<screen role="root"><userinput>make install</userinput></screen>

  • x/installing/xcb-util.xml

    rbdfc854 r71df408  
    101101make</userinput></screen>
    102102
    103     <para>This package does not come with a test suite.</para>
     103    <para>
     104      This package does not come with a test suite.
     105    </para>
    104106
    105107    <para>

  • x/installing/xclock.xml

    rbdfc854 r71df408  
    3030    <title>Introduction to xclock</title>
    3131
    32     <para>The <application>xclock</application> package contains a simple
    33     clock application which is used in the default xinit configuration.</para>
     32    <para>
     33      The <application>xclock</application> package contains a simple
     34      clock application which is used in the default xinit configuration.
     35    </para>
    3436
    3537    &not-katamari;
    … …  
    4042    <itemizedlist spacing="compact">
    4143      <listitem>
    42         <para>Download (HTTP): <ulink url="&xclock-download-http;"/></para>
     44        <para>
     45          Download (HTTP): <ulink url="&xclock-download-http;"/>
     46        </para>
    4347      </listitem>
    4448      <listitem>
    45         <para>Download (FTP): <ulink url="&xclock-download-ftp;"/></para>
     49        <para>
     50          Download (FTP): <ulink url="&xclock-download-ftp;"/>
     51        </para>
    4652      </listitem>
    4753      <listitem>
    48         <para>Download MD5 sum: &xclock-md5sum;</para>
     54        <para>
     55          Download MD5 sum: &xclock-md5sum;
     56        </para>
    4957      </listitem>
    5058      <listitem>
    51         <para>Download size: &xclock-size;</para>
     59        <para>
     60          Download size: &xclock-size;
     61        </para>
    5262      </listitem>
    5363      <listitem>
    54         <para>Estimated disk space required: &xclock-buildsize;</para>
     64        <para>
     65          Estimated disk space required: &xclock-buildsize;
     66        </para>
    5567      </listitem>
    5668      <listitem>
    57         <para>Estimated build time: &xclock-time;</para>
     69        <para>
     70          Estimated build time: &xclock-time;
     71        </para>
    5872      </listitem>
    5973    </itemizedlist>
    … …  
    6276
    6377    <bridgehead renderas="sect4">Required</bridgehead>
    64     <para role="required"><xref linkend="xorg7-lib"/></para>
     78    <para role="required">
     79      <xref linkend="xorg7-lib"/>
     80    </para>
    6581
    6682    <para condition="html" role="usernotes">User Notes:
    … …  
    7288    <title>Installation of xclock</title>
    7389
    74     <para>Install <application>xclock</application> by running the
    75     following commands:</para>
     90    <para>
     91      Install <application>xclock</application> by running the
     92      following commands:
     93    </para>
    7694
    7795<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
    7896make</userinput></screen>
    7997
    80     <para>This package does not come with a test suite.</para>
     98    <para>
     99      This package does not come with a test suite.
     100    </para>
    81101
    82     <para>Now, as the <systemitem class="username">root</systemitem>
    83     user:</para>
     102    <para>
     103      Now, as the <systemitem class="username">root</systemitem> user:
     104    </para>
    84105
    85106<screen role="root"><userinput>make install</userinput></screen>
    … …  
    110131        <term><command>xclock</command></term>
    111132        <listitem>
    112           <para>is an analog/digital clock for X.</para>
     133          <para>
     134            is an analog/digital clock for X.
     135          </para>
    113136          <indexterm zone="xclock xclock">
    114137            <primary sortas="b-xclock">xclock</primary>

  • x/installing/xinit.xml

    rbdfc854 r71df408  
    3030    <title>Introduction to xinit</title>
    3131
    32     <para>The <application>xinit</application> package contains a usable script
    33     to start the xserver.</para>
     32    <para>
     33      The <application>xinit</application> package contains a usable script
     34      to start the xserver.
     35    </para>
    3436
    3537    &not-katamari;
    … …  
    4042    <itemizedlist spacing="compact">
    4143      <listitem>
    42         <para>Download (HTTP): <ulink url="&xinit-download-http;"/></para>
    43       </listitem>
    44       <listitem>
    45         <para>Download (FTP): <ulink url="&xinit-download-ftp;"/></para>
    46       </listitem>
    47       <listitem>
    48         <para>Download MD5 sum: &xinit-md5sum;</para>
    49       </listitem>
    50       <listitem>
    51         <para>Download size: &xinit-size;</para>
    52       </listitem>
    53       <listitem>
    54         <para>Estimated disk space required: &xinit-buildsize;</para>
    55       </listitem>
    56       <listitem>
    57         <para>Estimated build time: &xinit-time;</para>
     44        <para>
     45          Download (HTTP): <ulink url="&xinit-download-http;"/>
     46        </para>
     47      </listitem>
     48      <listitem>
     49        <para>
     50          Download (FTP): <ulink url="&xinit-download-ftp;"/>
     51        </para>
     52      </listitem>
     53      <listitem>
     54        <para>
     55          Download MD5 sum: &xinit-md5sum;
     56        </para>
     57      </listitem>
     58      <listitem>
     59        <para>
     60          Download size: &xinit-size;
     61        </para>
     62      </listitem>
     63      <listitem>
     64        <para>
     65          Estimated disk space required: &xinit-buildsize;
     66        </para>
     67      </listitem>
     68      <listitem>
     69        <para>
     70          Estimated build time: &xinit-time;
     71        </para>
    5872      </listitem>
    5973    </itemizedlist>
    … …  
    8296    <title>Installation of xinit</title>
    8397
    84     <para>Install <application>xinit</application> by running the
    85     following commands:</para>
     98    <para>
     99      Install <application>xinit</application> by running the
     100      following commands:
     101    </para>
    86102
    87103<screen><userinput>./configure $XORG_CONFIG --with-xinitdir=/etc/X11/app-defaults &amp;&amp;
    88104make</userinput></screen>
    89105
    90     <para>This package does not come with a test suite.</para>
    91 
    92     <para>Now, as the <systemitem class="username">root</systemitem>
    93     user:</para>
     106    <para>
     107      This package does not come with a test suite.
     108    </para>
     109
     110    <para>
     111      Now, as the <systemitem class="username">root</systemitem> user:
     112    </para>
    94113
    95114<screen role="root"><userinput>make install &amp;&amp;
    … …  
    98117    <note revision='sysv'>
    99118
    100       <para>If starting Xorg from the command line, the default instructions
    101       above starts Xorg on the current virtual terminal.  It may be convenient
    102       to see Xorg and associated application messages on the current virtual
    103       terminal, normally tty1, and start the graphical environment on the first
    104       available unused virtual terminal, normally tty7.  To do this, set the suid bit
    105       on the Xorg application as the  <systemitem
    106       class="username">root</systemitem> user:</para>
     119      <para>
     120        If starting Xorg from the command line, the default instructions
     121        above starts Xorg on the current virtual terminal.  It may be
     122        convenient to see Xorg and associated application messages on the
     123        current virtual terminal, normally tty1, and start the graphical
     124        environment on the first available unused virtual terminal, normally
     125        tty7.  To do this, set the suid bit on the Xorg application as the
     126        <systemitem class="username">root</systemitem> user:
     127      </para>
    107128     
    108129<screen role="nodump"><userinput>chmod u+s $XORG_PREFIX/libexec/Xorg</userinput></screen>
    109130
    110       <para>At this point you can start Xorg on virtual terminal 7 with
    111       <command>startx &lt;client arguments&gt; -- vt7</command>.  Now
    112       you can toggle between tty1 and tty7 with the Ctrl-Alt-F1 and
    113       Ctrl-Alt-F7 key combinations.</para>
     131      <para>
     132        At this point you can start Xorg on virtual terminal 7 with
     133        <command>startx &lt;client arguments&gt; -- vt7</command>.  Now
     134        you can toggle between tty1 and tty7 with the Ctrl-Alt-F1 and
     135        Ctrl-Alt-F7 key combinations.
     136      </para>
    114137     
    115       <para>To automatically start Xorg on the first available virtual terminal,
    116       modify the <command>startx</command> script as the  <systemitem
    117       class="username">root</systemitem> user with:</para>
     138      <para>
     139        To automatically start Xorg on the first available virtual terminal,
     140        modify the <command>startx</command> script as the  <systemitem
     141        class="username">root</systemitem> user with:
     142      </para>
    118143     
    119144<screen role="nodump"><userinput>sed -e '/$serverargs $vtarg/ s/serverargs/: #&amp;/' $XORG_PREFIX/bin/startx</userinput></screen>
    120145
    121       <para>After this change, the virtual terminal does not need to be
    122       specified on the startx command line.</para>
     146      <para>
     147        After this change, the virtual terminal does not need to be
     148        specified on the startx command line.
     149      </para>
    123150
    124151    </note>
    … …  
    149176        <term><command>startx</command></term>
    150177        <listitem>
    151           <para>initializes an X session.</para>
     178          <para>
     179            initializes an X session.
     180          </para>
    152181          <indexterm zone="xinit startx">
    153182            <primary sortas="b-startx">startx</primary>
    … …  
    159188        <term><command>xinit</command></term>
    160189        <listitem>
    161           <para>is the X Window System initializer.</para>
     190          <para>
     191            is the X Window System initializer.
     192          </para>
    162193          <indexterm zone="xinit xinit">
    163194            <primary sortas="b-xinit">xinit</primary>

  • x/installing/xorg7.xml

    rbdfc854 r71df408  
    2121
    2222
    23   <para><application>Xorg</application> is a freely redistributable,
    24   open-source implementation of the <application>X</application> Window
    25   System. This system provides a client/server interface between display
    26   hardware (the mouse, keyboard, and video displays) and the desktop
    27   environment, while also providing both the windowing infrastructure and a
    28   standardized application interface (API).</para>
     23  <para>
     24    <application>Xorg</application> is a freely redistributable,
     25    open-source implementation of the <application>X</application> Window
     26    System. This system provides a client/server interface between display
     27    hardware (the mouse, keyboard, and video displays) and the desktop
     28    environment, while also providing both the windowing infrastructure and a
     29    standardized application interface (API).
     30  </para>
    2931
    3032  <para condition="html" role="usernotes">User Notes:
    … …  
    3436  Instructions</bridgehead>
    3537
    36   <para>Xorg-7.0 introduced a completely auto-tooled, modular build system.
    37   With the new modular build system, it is no longer possible to download
    38   the entire package in a single file. In fact, there will be well over 100
    39   packages that need to be fetched from the download location. To assist
    40   with such a large task, installing <xref linkend="wget"/> is strongly
    41   recommended for downloading the needed files.  A complete
    42   <application>wget</application> file list is provided for each page
    43   that includes multiple packages.</para>
    44 
    45   <para>Given the number of packages available, deciding which packages you
    46   need to install for your particular setup may seem a bit overwhelming at
    47   first.  Take a look at
    48   <ulink url="http://wiki.x.org/wiki/ModuleDescriptions">this page</ulink>
    49   and
    50   <ulink url="http://lists.x.org/archives/xorg-modular/2005-November/000801.html">this thread</ulink>
    51   to get an idea of what you will need.  If you are unsure, you should
    52   install all packages at the cost of extra disk space.</para>
     38  <para>
     39    Xorg-7.0 introduced a completely auto-tooled, modular build system.
     40    With the new modular build system, it is no longer possible to download
     41    the entire package in a single file. In fact, there will be well over 100
     42    packages that need to be fetched from the download location. To assist
     43    with such a large task, installing <xref linkend="wget"/> is strongly
     44    recommended for downloading the needed files.  A complete
     45    <application>wget</application> file list is provided for each page
     46    that includes multiple packages.
     47  </para>
     48
     49  <para>
     50    Given the number of packages available, deciding which packages you
     51    need to install for your particular setup may seem a bit overwhelming at
     52    first.  Take a look at <ulink url=
     53    "http://wiki.x.org/wiki/ModuleDescriptions">this page</ulink>
     54    and <ulink url=
     55    "http://lists.x.org/archives/xorg-modular/2005-November/000801.html">
     56    this thread</ulink>
     57    to get an idea of what you will need.  If you are unsure, you should
     58    install all packages at the cost of extra disk space.
     59  </para>
    5360
    5461  <note>
    55     <para>Even if you intend to download only the necessary packages, you
    56     should download the wget file lists.  The list of files are ordered by
    57     dependency, and the package versions listed in the files are known to
    58     work well with each other. Further, the wget file lists contain comments
    59     for specific packages that are deprecated or are not recommended to
    60     install. Newer packages are likely intended for the
    61     next release of <application>Xorg</application> and have already proved
    62     to be incompatible with current versions of software installed in BLFS.
    63     The installed size of <application>Xorg</application> can be reduced
    64     considerably by installing only the packages that you will need and use,
    65     however, the BLFS book cannot account for all dependencies and build
    66     options for the individual <application>Xorg</application> packages.
    67     The instructions assume that all packages have been built.  A
    68     <ulink url="&blfs-wiki;/Xorg7">wiki</ulink>
    69     page containing dependency information is under development.  You are
    70     encouraged to add to these pages if you discover additional information
    71     that may be helpful to other users who selectively install individual
    72     packages.</para>
     62    <para>
     63      Even if you intend to download only the necessary packages, you
     64      should download the wget file lists.  The list of files are ordered by
     65      dependency, and the package versions listed in the files are known to
     66      work well with each other. Further, the wget file lists contain comments
     67      for specific packages that are deprecated or are not recommended to
     68      install. Newer packages are likely intended for the
     69      next release of <application>Xorg</application> and have already proved
     70      to be incompatible with current versions of software installed in BLFS.
     71      The installed size of <application>Xorg</application> can be reduced
     72      considerably by installing only the packages that you will need and use,
     73      however, the BLFS book cannot account for all dependencies and build
     74      options for the individual <application>Xorg</application> packages.
     75      The instructions assume that all packages have been built.  A
     76      <ulink url="&blfs-wiki;/Xorg7">wiki</ulink>
     77      page containing dependency information is under development.  You are
     78      encouraged to add to these pages if you discover additional information
     79      that may be helpful to other users who selectively install individual
     80      packages.
     81    </para>
    7382  </note>
    7483
    75   <para>Additionally, because of the large number of repetitive commands,
    76   you are encouraged to partially automate the build. Instructions have been
    77   given that utilize the <xref linkend="sudo"/> package. It is recommended that
    78   you use the <parameter>:NOPASSWD</parameter> configuration option for the
    79   user that will be building the xorg packages.</para>
     84  <para>
     85    Additionally, because of the large number of repetitive commands,
     86    you are encouraged to partially automate the build. Instructions have been
     87    given that utilize the <xref linkend="sudo"/> package. It is recommended
     88    that you use the <parameter>:NOPASSWD</parameter> configuration option
     89    for the user that will be building the xorg packages.
     90  </para>
    8091
    8192  <sect2 id="xorg-env" xreflabel="Xorg build environment">
    8293    <title>Setting up the Xorg Build Environment</title>
    8394
    84     <note><para>The following instructions assume that the shell
    85     startup files have been set up as described in
    86     <xref linkend="postlfs-config-profile" />.
    87     </para></note>
    88 
    89     <para>First, you'll need to create a working directory:</para>
     95    <note>
     96      <para>
     97        The following instructions assume that the shell
     98        startup files have been set up as described in
     99        <xref linkend="postlfs-config-profile" />.
     100      </para>
     101    </note>
     102
     103    <para>
     104      First, you'll need to create a working directory:
     105    </para>
    90106
    91107<screen><userinput>mkdir xc &amp;&amp;
    92108cd xc</userinput></screen>
    93109
    94     <para>As with previous releases of the X Window System, it may be
    95     desirable to install <application>Xorg</application> into an alternate
    96     prefix.  This is no longer common practice among Linux distributions.
    97     The common installation prefix for <application>Xorg</application> on
    98     Linux is <filename class="directory">/usr</filename>.  There is no
    99     standard alternate prefix, nor is there any exception in the current
    100     revision of the Filesystem Hierarchy Standard for Release 7 of the X
    101     Window System.  Alan Coopersmith of Sun Microsystems, once
    102     stated "At Sun, we were using
    103     <filename class="directory">/usr/X11</filename> and plan to stick with
    104     it."  Only the <filename class="directory">/opt/*</filename> prefix or
    105     the <filename class="directory">/usr</filename> prefix adhere to the
    106     current FHS guidelines.</para>
    107 
    108     <para>Choose your installation prefix, and set the
    109     <envar>XORG_PREFIX</envar> variable with the following
    110     command:</para>
     110    <para>
     111      As with previous releases of the X Window System, it may be
     112      desirable to install <application>Xorg</application> into an alternate
     113      prefix.  This is no longer common practice among Linux distributions.
     114      The common installation prefix for <application>Xorg</application> on
     115      Linux is <filename class="directory">/usr</filename>.  There is no
     116      standard alternate prefix, nor is there any exception in the current
     117      revision of the Filesystem Hierarchy Standard for Release 7 of the X
     118      Window System.  Alan Coopersmith of Sun Microsystems, once
     119      stated "At Sun, we were using
     120      <filename class="directory">/usr/X11</filename> and plan to stick with
     121      it."  Only the <filename class="directory">/opt/*</filename> prefix or
     122      the <filename class="directory">/usr</filename> prefix adhere to the
     123      current FHS guidelines.
     124    </para>
     125
     126    <para>
     127      Choose your installation prefix, and set the <envar>XORG_PREFIX</envar>
     128      variable with the following command:
     129    </para>
    111130
    112131<screen><userinput>export XORG_PREFIX="<replaceable>&lt;PREFIX&gt;</replaceable>"</userinput></screen>
    113132
    114     <para>Throughout these instructions, you will use the following
    115     <command>configure</command> switches for all of the packages.  Create the
    116     <envar>XORG_CONFIG</envar> variable to use for this parameter
    117     substitution:</para>
     133    <para>
     134      Throughout these instructions, you will use the following
     135      <command>configure</command> switches for all of the packages. Create the
     136      <envar>XORG_CONFIG</envar> variable to use for this parameter
     137      substitution:
     138    </para>
    118139
    119140<screen><userinput>export XORG_CONFIG="--prefix=$XORG_PREFIX --sysconfdir=/etc \
    120141    --localstatedir=/var --disable-static"</userinput></screen>
    121142
    122     <para>Create an <filename>/etc/profile.d/xorg.sh</filename> configuration
    123     file containing these variables as the
    124     <systemitem class="username">root</systemitem> user:</para>
     143    <para>
     144      Create an <filename>/etc/profile.d/xorg.sh</filename> configuration
     145      file containing these variables as the
     146      <systemitem class="username">root</systemitem> user:
     147    </para>
    125148
    126149<screen role="root"><userinput>cat &gt; /etc/profile.d/xorg.sh &lt;&lt; EOF
    … …  
    131154chmod 644 /etc/profile.d/xorg.sh</userinput></screen>
    132155
    133     <note><para>There is some confustion about the above 'here' document.
    134     The backslash in front of the dollar sign is correct.  Bash
    135     will remove it when creating /etc/profile.d/xorg.sh.  However, if
    136     you are creating the file with an editor, a copy and paste operation
    137     will not remove the baskslash.  It must then be removed manually.
    138     </para></note>
     156    <note>
     157      <para>
     158        There is some confustion about the above 'here' document.
     159        The backslash in front of the dollar sign is correct.  Bash
     160        will remove it when creating /etc/profile.d/xorg.sh.  However, if
     161        you are creating the file with an editor, a copy and paste operation
     162        will not remove the baskslash.  It must then be removed manually.
     163      </para>
     164    </note>
    139165
    140166    <para>
    … …  
    151177EOF</userinput></screen>
    152178
    153     <note><para>If you've decided to use the standard <filename
    154     class="directory">/usr</filename> prefix, you can omit the remainder of
    155     this page and continue at <xref linkend='util-macros'/>.</para></note>
    156 
    157     <para>If you've decided to <emphasis>not</emphasis> use the standard
    158     prefix, be sure to add <filename
    159     class="directory">$XORG_PREFIX/bin</filename> to your <envar>PATH</envar>
    160     environment variable, and <filename class="directory">
    161     $XORG_PREFIX/lib/pkgconfig</filename> and <filename class="directory">
    162     $XORG_PREFIX/share/pkgconfig</filename> to your
    163     <envar>PKG_CONFIG_PATH</envar> variable. It is also helpful to specify
    164     additional search paths for <command>gcc</command> and an include directory
    165     for the <command>aclocal</command> program.  Issue the following commands
    166     as the <systemitem class="username">root</systemitem> user:</para>
     179    <note>
     180      <para>
     181        If you've decided to use the standard <filename
     182        class="directory">/usr</filename> prefix, you can omit the remainder of
     183        this page and continue at <xref linkend='util-macros'/>.
     184      </para>
     185    </note>
     186
     187    <para>
     188      If you've decided to <emphasis>not</emphasis> use the standard
     189      prefix, be sure to add <filename
     190      class="directory">$XORG_PREFIX/bin</filename> to your <envar>PATH</envar>
     191      environment variable, and <filename class="directory">
     192      $XORG_PREFIX/lib/pkgconfig</filename> and <filename class="directory">
     193      $XORG_PREFIX/share/pkgconfig</filename> to your
     194      <envar>PKG_CONFIG_PATH</envar> variable. It is also helpful to specify
     195      additional search paths for <command>gcc</command> and an include
     196      directory for the <command>aclocal</command> program.  Issue the
     197      following commands as the <systemitem class="username">root</systemitem>
     198      user:
     199    </para>
    167200
    168201<screen role="root"><userinput>cat &gt;&gt; /etc/profile.d/xorg.sh &lt;&lt; "EOF"
    … …  
    181214EOF</userinput></screen>
    182215
    183     <para>The script above needs to be activated.  Normally it will be
    184     automatic at login, but to activate it now, as a regular user, run:</para>
     216    <para>
     217      The script above needs to be activated.  Normally it will be
     218      automatic at login, but to activate it now, as a regular user, run:
     219    </para>
    185220
    186221<screen><userinput>source /etc/profile.d/xorg.sh</userinput></screen>
    187222
    188     <para>You should also add
    189     <filename class="directory"> $XORG_PREFIX/lib</filename> to the
    190     <filename>/etc/ld.so.conf</filename> file. Again, as the
    191     <systemitem class="username">root</systemitem> user, issue the following
    192     command:</para>
     223    <para>
     224      You should also add
     225      <filename class="directory"> $XORG_PREFIX/lib</filename> to the
     226      <filename>/etc/ld.so.conf</filename> file. Again, as the
     227      <systemitem class="username">root</systemitem> user, issue the following
     228      command:
     229    </para>
    193230
    194231<screen role="root"><userinput>echo "$XORG_PREFIX/lib" >> /etc/ld.so.conf</userinput></screen>
    195232
    196     <para>You should also modify
    197     <filename>/etc/man_db.conf</filename>, adding appropriate
    198     MANDATORY_MANPATH, MANPATH_MAP, and MANDB_MAP entries following the
    199     examples for <filename class="directory">/usr/X11R6</filename>. Issue the
    200     following command as the <systemitem class="username">root</systemitem>
    201     user:</para>
     233    <para>
     234      You should also modify
     235      <filename>/etc/man_db.conf</filename>, adding appropriate
     236      MANDATORY_MANPATH, MANPATH_MAP, and MANDB_MAP entries following the
     237      examples for <filename class="directory">/usr/X11R6</filename>. Issue the
     238      following command as the <systemitem class="username">root</systemitem>
     239      user:
     240    </para>
    202241
    203242<screen role="root"><userinput>sed "s@<replaceable>/usr/X11R6</replaceable>@$XORG_PREFIX@g" -i /etc/man_db.conf</userinput></screen>
    204243
    205     <para>Some applications look for shared files in <filename
    206     class="directory">/usr/share/X11</filename>.  Create a symbolic link to the
    207     proper location as the <systemitem class="username">root</systemitem>
    208     user:</para>
     244    <para>
     245      Some applications look for shared files in <filename
     246      class="directory">/usr/share/X11</filename>.  Create a symbolic link to
     247      the proper location as the <systemitem class="username">root</systemitem>
     248      user:
     249    </para>
    209250
    210251<screen role="root"><userinput>ln -svf $XORG_PREFIX/share/X11 /usr/share/X11</userinput></screen>
    211252
    212     <para>If building KDE, some cmake files look for Xorg in places other than
    213     $XORG_PREFIX.  Allow cmake to find Xorg with:</para>
     253    <para>
     254      If building KDE, some cmake files look for Xorg in places other than
     255      $XORG_PREFIX.  Allow cmake to find Xorg with:
     256    </para>
    214257
    215258<screen role="root"><userinput>ln -svf $XORG_PREFIX /usr/X11R6</userinput></screen>
    216259<!--
    217     <para>Finally, if building on x86_64, you will need to create the
    218     <filename class="directory">$XORG_PREFIX/lib</filename> directory and the
    219     <filename>$XORG_PREFIX/lib64</filename> symlink. Again, as the
    220     <systemitem class="username">root</systemitem> user, issue the following
    221     commands:</para>
     260    <para>
     261      Finally, if building on x86_64, you will need to create the
     262      <filename class="directory">$XORG_PREFIX/lib</filename> directory and the
     263      <filename>$XORG_PREFIX/lib64</filename> symlink. Again, as the
     264      <systemitem class="username">root</systemitem> user, issue the following
     265      commands:
     266    </para>
    222267
    223268<screen role="root"><userinput>install -v -m755 -d $XORG_PREFIX &amp;&amp;

  • x/installing/xorgproto.xml

    rbdfc854 r71df408  
    3030    <title>Introduction to xorgproto</title>
    3131
    32     <para>The <application>xorgproto</application> package provides the
    33     header files required to build the X Window system, and to allow other
    34     applications to build against the installed X Window system.</para>
     32    <para>
     33      The <application>xorgproto</application> package provides the
     34      header files required to build the X Window system, and to allow other
     35      applications to build against the installed X Window system.
     36    </para>
    3537
    3638    &lfs91_checked;

  • x/installing/xterm.xml

    rbdfc854 r71df408  
    3131    <title>Introduction to xterm</title>
    3232
    33     <para><application>xterm</application> is a terminal emulator for
    34     the X Window System.</para>
     33    <para>
     34      <application>xterm</application> is a terminal emulator for
     35      the X Window System.
     36    </para>
    3537
    3638    &not-katamari;
    … …  
    4143    <itemizedlist spacing="compact">
    4244      <listitem>
    43         <para>Download (HTTP): <ulink url="&xterm-download-http;"/></para>
    44       </listitem>
    45       <listitem>
    46         <para>Download (FTP): <ulink url="&xterm-download-ftp;"/></para>
    47       </listitem>
    48       <listitem>
    49         <para>Download MD5 sum: &xterm-md5sum;</para>
    50       </listitem>
    51       <listitem>
    52         <para>Download size: &xterm-size;</para>
    53       </listitem>
    54       <listitem>
    55         <para>Estimated disk space required: &xterm-buildsize;</para>
    56       </listitem>
    57       <listitem>
    58         <para>Estimated build time: &xterm-time;</para>
     45        <para>
     46          Download (HTTP): <ulink url="&xterm-download-http;"/>
     47        </para>
     48      </listitem>
     49      <listitem>
     50        <para>
     51          Download (FTP): <ulink url="&xterm-download-ftp;"/>
     52        </para>
     53      </listitem>
     54      <listitem>
     55        <para>
     56          Download MD5 sum: &xterm-md5sum;
     57        </para>
     58      </listitem>
     59      <listitem>
     60        <para>
     61          Download size: &xterm-size;
     62        </para>
     63      </listitem>
     64      <listitem>
     65        <para>
     66          Estimated disk space required: &xterm-buildsize;
     67        </para>
     68      </listitem>
     69      <listitem>
     70        <para>
     71          Estimated build time: &xterm-time;
     72        </para>
    5973      </listitem>
    6074    </itemizedlist>
    … …  
    6377
    6478    <bridgehead renderas="sect4">Required</bridgehead>
    65     <para role="required"><xref linkend="xorg7-app"/></para>
     79    <para role="required">
     80      <xref linkend="xorg7-app"/>
     81    </para>
    6682
    6783    <bridgehead renderas="sect4">Required (at runtime)</bridgehead>
    … …  
    87103    <title>Installation of xterm</title>
    88104
    89     <para>Install <application>xterm</application> by running the
    90     following commands:</para>
     105    <para>
     106      Install <application>xterm</application> by running the
     107      following commands:
     108    </para>
    91109
    92110<screen><userinput>sed -i '/v0/{n;s/new:/new:kb=^?:/}' termcap &amp;&amp;
    … …  
    99117make</userinput></screen>
    100118
    101     <para>This package does not come with a test suite.</para>
    102 
    103     <para>Now, as the <systemitem class="username">root</systemitem>
    104     user:</para>
     119    <para>
     120      This package does not come with a test suite.
     121    </para>
     122
     123    <para>
     124      Now, as the <systemitem class="username">root</systemitem> user:
     125    </para>
    105126
    106127<screen role="root"><userinput>make install    &amp;&amp;
    … …  
    115136    <title>Command Explanations</title>
    116137
    117     <para><command>sed -i ... termcap</command>,
    118     <command>printf ... >> terminfo</command>: These commands modify the terminal
    119     description so that the Backspace key is expected to send the character
    120     with ASCII code 127. This is done for consistency with the Linux console.</para>
    121 
    122     <para><envar>TERMINFO=/usr/share/terminfo</envar>: This ensures
    123     that the <command>xterm</command> terminfo files are installed to the
    124     system terminfo database.</para>
    125 
    126     <para><parameter>--with-app-defaults=...</parameter>: Sets the location
    127     for the <filename class="directory">app-defaults</filename>
    128     directory.</para>
    129 
    130     <para><command>make install-ti</command>: This command installs corrected
    131     terminfo description files for use with
    132     <application>xterm</application>.</para>
     138    <para>
     139      <command>sed -i ... termcap</command>,
     140      <command>printf ... >> terminfo</command>:
     141      These commands modify the terminal description so that the Backspace
     142      key is expected to send the character with ASCII code 127. This is done
     143      for consistency with the Linux console.
     144    </para>
     145
     146    <para>
     147      <envar>TERMINFO=/usr/share/terminfo</envar>: This ensures
     148      that the <command>xterm</command> terminfo files are installed to the
     149      system terminfo database.
     150    </para>
     151
     152    <para>
     153      <parameter>--with-app-defaults=...</parameter>: Sets the location
     154      for the <filename class="directory">app-defaults</filename>
     155      directory.
     156    </para>
     157
     158    <para>
     159      <command>make install-ti</command>: This command installs corrected
     160      terminfo description files for use with
     161      <application>xterm</application>.
     162    </para>
    133163
    134164  </sect2>
    … …  
    137167    <title>Configuring xterm</title>
    138168
    139     <para>There are two ways to configure xterm.  You can add the X resource
    140     definitions to the user's <filename>~/.Xresources</filename> file, or
    141     add them to the system-wide
    142     <filename>$XORG_PREFIX/share/X11/app-defaults/Xterm</filename> file.</para>
    143 
    144     <para>In order for xterm to follow the locale settings in the environment,
    145     use TrueType fonts, and follow the Linux convention about the code sent by
    146     the Backspace key, add the following definitions as the
    147     <systemitem class="username">root</systemitem> user:</para>
     169    <para>
     170      There are two ways to configure xterm.  You can add the X resource
     171      definitions to the user's <filename>~/.Xresources</filename> file, or
     172      add them to the system-wide
     173      <filename>$XORG_PREFIX/share/X11/app-defaults/Xterm</filename> file.
     174    </para>
     175
     176    <para>
     177      In order for xterm to follow the locale settings in the environment,
     178      use TrueType fonts, and follow the Linux convention about the code sent by
     179      the Backspace key, add the following definitions as the
     180      <systemitem class="username">root</systemitem> user:
     181    </para>
    148182
    149183<screen role="root"><userinput>cat &gt;&gt; /etc/X11/app-defaults/XTerm &lt;&lt; "EOF"
    … …  
    180214        <term><command>koi8rxterm</command></term>
    181215        <listitem>
    182           <para>is a wrapper script to set up xterm with a KOI8-R locale.</para>
     216          <para>
     217            is a wrapper script to set up xterm with a KOI8-R locale.
     218          </para>
    183219          <indexterm zone="xterm2 koi8rxterm">
    184220            <primary sortas="b-koi8rxterm">koi8rxterm</primary>
    … …  
    190226        <term><command>resize</command></term>
    191227        <listitem>
    192           <para>prints a shell command for setting the TERM and TERMCAP
    193           environment  variables to indicate the current size of xterm
    194           window.</para>
     228          <para>
     229            prints a shell command for setting the TERM and TERMCAP
     230            environment  variables to indicate the current size of xterm
     231            window.
     232          </para>
    195233          <indexterm zone="xterm2 resize">
    196234            <primary sortas="b-resize">resize</primary>
    … …  
    202240        <term><command>uxterm</command></term>
    203241        <listitem>
    204           <para>is a wrapper script that modifies the current locale to use
    205           UTF-8 and starts xterm with the proper settings.</para>
     242          <para>
     243            is a wrapper script that modifies the current locale to use
     244            UTF-8 and starts xterm with the proper settings.
     245          </para>
    206246          <indexterm zone="xterm2 uxterm">
    207247            <primary sortas="b-uxterm">uxterm</primary>
    … …  
    213253        <term><command>xterm</command></term>
    214254        <listitem>
    215           <para>is a terminal emulator for the X Window System.</para>
     255          <para>
     256            is a terminal emulator for the X Window System.
     257          </para>
    216258          <indexterm zone="xterm2 xterm2">
    217259            <primary sortas="b-xterm2">xterm</primary>
Note: See TracChangeset for help on using the changeset viewer.