Changeset bdea25ce


Ignore:
Timestamp:
02/05/2006 01:17:43 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
Children:
403a610
Parents:
4ae4324
Message:

Indenting chapter 6, part 7

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7351 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

Location:
chapter06
Files:
8 edited

Legend:

Unmodified
Added
Removed

  • chapter06/iproute2.xml

    r4ae4324 rbdea25ce  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-system-iproute2" role="wrap">
     9  <?dbhtml filename="iproute2.html"?>
     10
    711  <title>IPRoute2-&iproute2-version;</title>
    8 <?dbhtml filename="iproute2.html"?>
     12
    913  <indexterm zone="ch-system-iproute2">
    1014    <primary sortas="a-IPRoute2">IPRoute2</primary>
    1115  </indexterm>
     16
    1217  <sect2 role="package">
    1318    <title/>
    14     <para>The IPRoute2 package contains programs for basic and advanced
    15           IPV4-based networking.
    16     </para>
     19
     20    <para>The IPRoute2 package contains programs for basic and advanced IPV4-based
     21    networking.</para>
     22
    1723    <segmentedlist>
    1824      <segtitle>&buildtime;</segtitle>
    1925      <segtitle>&diskspace;</segtitle>
     26
    2027      <seglistitem>
    2128        <seg>0.1 SBU</seg>
    … …  
    2330      </seglistitem>
    2431    </segmentedlist>
     32
    2533    <segmentedlist>
    2634      <segtitle>&dependencies;</segtitle>
     35
    2736      <seglistitem>
    2837        <seg>Berkeley DB, GCC, Glibc, Make, and Linux-Headers</seg>
    2938      </seglistitem>
    3039    </segmentedlist>
     40
    3141  </sect2>
     42
    3243  <sect2 role="installation">
    3344    <title>Installation of IPRoute2</title>
    3445
    3546    <para>Prepare IPRoute2 for compilation:</para>
    36     <screen><userinput>chmod u+x configure &amp;&amp;
     47
     48<screen><userinput>chmod u+x configure &amp;&amp;
    3749./configure</userinput></screen>
    3850
    3951    <para>Compile the package:</para>
    4052
    41     <screen><userinput>make SBINDIR=/sbin</userinput></screen>
    42 
    43     <para>The meaning of the make option:</para>
     53<screen><userinput>make SBINDIR=/sbin</userinput></screen>
    4454
    4555    <variablelist>
    46     <varlistentry>
    47     <term><parameter>SBINDIR=/sbin</parameter></term>
    48     <listitem><para>This ensures that the IPRoute2 binaries will install into
    49       <filename class="directory">/sbin</filename>. This is the correct location
    50       according to the FHS, because some of the IPRoute2 binaries are used by
    51       the LFS-Bootscripts package.</para>
    52     </listitem>
    53     </varlistentry>
     56      <title>The meaning of the make option:</title>
     57
     58      <varlistentry>
     59        <term><parameter>SBINDIR=/sbin</parameter></term>
     60        <listitem>
     61          <para>This ensures that the IPRoute2 binaries will install into
     62          <filename class="directory">/sbin</filename>. This is the correct
     63          location according to the FHS, because some of the IPRoute2 binaries
     64          are used by the LFS-Bootscripts package.</para>
     65        </listitem>
     66      </varlistentry>
     67
    5468    </variablelist>
    5569
    … …  
    5872    <para>Install the package:</para>
    5973
    60     <screen><userinput>make SBINDIR=/sbin install</userinput></screen>
    61    
    62     <para>The <command>arpd</command> binary links against the Berkeley DB libraries
    63           that reside in <filename class="directory">/usr</filename> and
    64           uses a database in <filename>/var/lib/arpd/arpd.db</filename>. Thus,
    65           according to the FHS, it must be
    66           in <filename class="directory">/usr/sbin</filename>. Move it there:
    67     </para>
     74<screen><userinput>make SBINDIR=/sbin install</userinput></screen>
     75
     76    <para>The <command>arpd</command> binary links against the Berkeley DB
     77    libraries that reside in <filename class="directory">/usr</filename> and
     78    uses a database in <filename>/var/lib/arpd/arpd.db</filename>. Thus,
     79    according to the FHS, it must be in <filename
     80    class="directory">/usr/sbin</filename>. Move it there:</para>
    6881
    6982    <screen><userinput>mv -v /sbin/arpd /usr/sbin</userinput></screen>
    70      
     83
    7184  </sect2>
    7285
    7386  <sect2 id="contents-iproute2" role="content">
    7487    <title>Contents of IPRoute2</title>
     88
    7589    <segmentedlist>
    7690      <segtitle>Installed programs</segtitle>
     91
    7792      <seglistitem>
    7893        <seg>arpd, ctstat (link to lnstat), ifcfg, ifstat, ip, lnstat, nstat,
    79              routef, routel, rtacct, rtmon, rtpr, rtstat (link to lnstat), ss,
    80              and tc.
    81         </seg>
     94        routef, routel, rtacct, rtmon, rtpr, rtstat (link to lnstat), ss,
     95        and tc.</seg>
    8296      </seglistitem>
    8397    </segmentedlist>
    8498
    85     <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
    86 <?dbfo list-presentation="list"?>
    87 <?dbhtml list-presentation="table"?>
     99    <variablelist>
     100      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     101      <?dbfo list-presentation="list"?>
     102      <?dbhtml list-presentation="table"?>
     103
    88104      <varlistentry id="arpd">
    89         <term>
    90           <command>arpd</command>
    91         </term>
    92         <listitem>
    93           <para>Userspace ARP daemon, useful in really large networks, where
    94                 the kernelspace ARP implementation is insufficient, or
    95                 when setting up a honeypot</para>
     105        <term><command>arpd</command></term>
     106        <listitem>
     107          <para>Userspace ARP daemon, useful in really large networks, where the
     108          kernelspace ARP implementation is insufficient, or when setting up a
     109          honeypot</para>
    96110          <indexterm zone="ch-system-iproute2 arpd">
    97111            <primary sortas="b-arpd">arpd</primary>
    … …  
    101115
    102116      <varlistentry id="ctstat">
    103         <term>
    104           <command>ctstat</command>
    105         </term>
     117        <term><command>ctstat</command></term>
    106118        <listitem>
    107119          <para>Connection status utility</para>
    … …  
    113125
    114126      <varlistentry id="ifcfg">
    115         <term>
    116           <command>ifcfg</command>
    117         </term>
     127        <term><command>ifcfg</command></term>
    118128        <listitem>
    119129          <para>A shell script wrapper for the <command>ip</command> command</para>
    … …  
    125135
    126136      <varlistentry id="ifstat">
    127         <term>
    128           <command>ifstat</command>
    129         </term>
    130         <listitem>
    131           <para>Shows the interface statistics, including the amount of transmitted
    132                 and received packets by interface</para>
     137        <term><command>ifstat</command></term>
     138        <listitem>
     139          <para>Shows the interface statistics, including the amount of
     140          transmitted and received packets by interface</para>
    133141          <indexterm zone="ch-system-iproute2 ifstat">
    134142            <primary sortas="b-ifstat">ifstat</primary>
    … …  
    138146
    139147      <varlistentry id="ip">
    140         <term>
    141           <command>ip</command>
    142         </term>
    143         <listitem>
    144 
     148        <term><command>ip</command></term>
     149        <listitem>
    145150          <para>The main executable. It has several different functions:</para>
    146151
    147152          <para><command>ip link <replaceable>[device]</replaceable></command>
    148                 allows users to look at the state of devices and to make changes
    149           </para>
     153          allows users to look at the state of devices and to make changes</para>
    150154
    151155          <para><command>ip addr</command> allows users to look at addresses and
    152                 their properties, add new addresses, and delete old ones
    153           </para>
    154 
    155           <para><command>ip neighbor</command> allows users to look at
    156                 neighbor bindings and their properties, add new
    157                 neighbor entries, and delete old ones
    158           </para>
     156          their properties, add new addresses, and delete old ones</para>
     157
     158          <para><command>ip neighbor</command> allows users to look at neighbor
     159          bindings and their properties, add new neighbor entries, and delete
     160          old ones</para>
    159161
    160162          <para><command>ip rule</command> allows users to look at the routing
    161                 policies and change them
    162           </para>
     163          policies and change them</para>
    163164
    164165          <para><command>ip route</command> allows users to look at the routing
    165                 table and change routing table rules
    166           </para>
     166          table and change routing table rules</para>
    167167
    168168          <para><command>ip tunnel</command> allows users to look at the IP
    169                 tunnels and their properties, and change them
    170           </para>
     169          tunnels and their properties, and change them</para>
    171170
    172171          <para><command>ip maddr</command> allows users to look at the multicast
    173                 addresses and their properties, and change them
    174           </para>
     172          addresses and their properties, and change them</para>
    175173
    176174          <para><command>ip mroute</command> allows users to set, change, or
    177                 delete the multicast routing
    178           </para>
    179 
    180           <para><command>ip monitor</command> allows users to
    181                 continously monitor the state of devices, addresses and routes
    182           </para>
     175          delete the multicast routing</para>
     176
     177          <para><command>ip monitor</command> allows users to continously monitor
     178          the state of devices, addresses and routes</para>
    183179          <indexterm zone="ch-system-iproute2 ip">
    184180            <primary sortas="b-ip">ip</primary>
    … …  
    188184
    189185      <varlistentry id="lnstat">
    190         <term>
    191           <command>lnstat</command>
    192         </term>
     186        <term><command>lnstat</command></term>
    193187        <listitem>
    194188          <para>Provides Linux network statistics.  It is a generalized and more
    195                 feature-complete replacement for the old
    196                 <command>rtstat</command> program</para>
     189          feature-complete replacement for the old <command>rtstat</command>
     190          program</para>
    197191          <indexterm zone="ch-system-iproute2 lnstat">
    198192            <primary sortas="b-lnstat">lnstat</primary>
    … …  
    202196
    203197      <varlistentry id="nstat">
    204         <term>
    205           <command>nstat</command>
    206         </term>
     198        <term><command>nstat</command></term>
    207199        <listitem>
    208200          <para>Shows network statistics</para>
    … …  
    214206
    215207      <varlistentry id="routef">
    216         <term>
    217           <command>routef</command>
    218         </term>
    219         <listitem>
    220           <para>A component of <command>ip route</command>. This is for flushing the routing
    221                 tables
    222           </para>
     208        <term><command>routef</command></term>
     209        <listitem>
     210          <para>A component of <command>ip route</command>. This is for flushing
     211          the routing tables</para>
    223212          <indexterm zone="ch-system-iproute2 routef">
    224213            <primary sortas="b-routef">routef</primary>
    … …  
    228217
    229218      <varlistentry id="routel">
    230         <term>
    231           <command>routel</command>
    232         </term>
    233         <listitem>
    234           <para>A component of <command>ip route</command>. This is for listing the routing
    235                 tables
    236           </para>
     219        <term><command>routel</command></term>
     220        <listitem>
     221          <para>A component of <command>ip route</command>. This is for listing
     222          the routing tables</para>
    237223          <indexterm zone="ch-system-iproute2 routel">
    238224            <primary sortas="b-routel">routel</primary>
    … …  
    242228
    243229      <varlistentry id="rtacct">
    244         <term>
    245           <command>rtacct</command>
    246         </term>
    247         <listitem>
    248           <para>Displays the contents of <filename>/proc/net/rt_acct</filename></para>
     230        <term><command>rtacct</command></term>
     231        <listitem>
     232          <para>Displays the contents of
     233          <filename>/proc/net/rt_acct</filename></para>
    249234          <indexterm zone="ch-system-iproute2 rtacct">
    250235            <primary sortas="b-rtacct">rtacct</primary>
    … …  
    254239
    255240      <varlistentry id="rtmon">
    256         <term>
    257           <command>rtmon</command>
    258         </term>
     241        <term><command>rtmon</command></term>
    259242        <listitem>
    260243          <para>Route monitoring utility</para>
    … …  
    266249
    267250      <varlistentry id="rtpr">
    268         <term>
    269           <command>rtpr</command>
    270         </term>
     251        <term><command>rtpr</command></term>
    271252        <listitem>
    272253          <para>Converts the output of <command>ip -o</command> back into a
    273                 readable form</para>
     254          readable form</para>
    274255          <indexterm zone="ch-system-iproute2 rtpr">
    275256            <primary sortas="b-rtpr">rtpr</primary>
    … …  
    279260
    280261      <varlistentry id="rtstat">
    281         <term>
    282           <command>rtstat</command>
    283         </term>
     262        <term><command>rtstat</command></term>
    284263        <listitem>
    285264          <para>Route status utility</para>
    … …  
    291270
    292271      <varlistentry id="ss">
    293         <term>
    294           <command>ss</command>
    295         </term>
    296         <listitem>
    297           <para>Similar to the <command>netstat</command> command; shows active connections</para>
     272        <term><command>ss</command></term>
     273        <listitem>
     274          <para>Similar to the <command>netstat</command> command; shows active
     275          connections</para>
    298276          <indexterm zone="ch-system-iproute2 ss">
    299277            <primary sortas="b-ss">ss</primary>
    … …  
    303281
    304282      <varlistentry id="tc">
    305         <term>
    306           <command>tc</command>
    307         </term>
    308         <listitem>
    309           <para>Traffic Controlling Executable; this is for Quality Of
    310                 Service (QOS) and Class Of Service (COS)
    311                 implementations
    312           </para>
     283        <term><command>tc</command></term>
     284        <listitem>
     285          <para>Traffic Controlling Executable; this is for Quality Of Service
     286          (QOS) and Class Of Service (COS) implementations</para>
    313287
    314288          <para><command>tc qdisc</command> allows users to setup the queueing
    315                 discipline
    316           </para>
    317 
    318           <para><command>tc class</command> allows users to setup classes based on
    319                 the queuing discipline scheduling
    320           </para>
     289          discipline</para>
     290
     291          <para><command>tc class</command> allows users to setup classes based
     292          on the queuing discipline scheduling</para>
    321293
    322294          <para><command>tc estimator</command> allows users to estimate the
    323                 network flow into a network
    324           </para>
     295          network flow into a network</para>
    325296
    326297          <para><command>tc filter</command> allows users to setup the QOS/COS
    327                 packet filtering
    328           </para>
     298          packet filtering</para>
    329299
    330300          <para><command>tc policy</command> allows users to setup the QOS/COS
    331                 policies
    332           </para>
     301          policies</para>
    333302          <indexterm zone="ch-system-iproute2 ss">
    334303            <primary sortas="b-tc">tc</primary>
    … …  
    336305        </listitem>
    337306      </varlistentry>
     307
    338308    </variablelist>
     309
    339310  </sect2>
     311
    340312</sect1>
    341 

  • chapter06/kbd.xml

    r4ae4324 rbdea25ce  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-system-kbd" role="wrap">
    7 <title>Kbd-&kbd-version;</title>
    8 <?dbhtml filename="kbd.html"?>
    9 
    10 <indexterm zone="ch-system-kbd"><primary sortas="a-Kbd">Kbd</primary></indexterm>
    11 
    12 <sect2 role="package"><title/>
    13 <para>The Kbd package contains key-table files and keyboard utilities.</para>
    14 
    15 <segmentedlist>
    16 <segtitle>&buildtime;</segtitle>
    17 <segtitle>&diskspace;</segtitle>
    18 <seglistitem><seg>0.1 SBU</seg><seg>11.8 MB</seg></seglistitem>
    19 </segmentedlist>
    20 
    21 <segmentedlist>
    22 <segtitle>&dependencies;</segtitle>
    23 <seglistitem><seg>Bash, Binutils, Bison, Coreutils,
    24 Diffutils, Flex, GCC, Gettext, Glibc, Grep, Gzip, M4, Make, and Sed</seg></seglistitem>
    25 </segmentedlist>
    26 </sect2>
    27 
    28 <sect2 role="installation">
    29 <title>Installation of Kbd</title>
    30 
    31 <para>The behaviour of the Backspace and Delete keys is not consistent across the
    32 keymaps in the Kbd package. The following patch fixes this issue for
    33 i386 keymaps:</para>
     9  <?dbhtml filename="kbd.html"?>
     10
     11  <title>Kbd-&kbd-version;</title>
     12
     13  <indexterm zone="ch-system-kbd">
     14    <primary sortas="a-Kbd">Kbd</primary>
     15  </indexterm>
     16
     17  <sect2 role="package">
     18    <title/>
     19  <para>The Kbd package contains key-table files and keyboard utilities.</para>
     20
     21  <segmentedlist>
     22    <segtitle>&buildtime;</segtitle>
     23    <segtitle>&diskspace;</segtitle>
     24
     25    <seglistitem>
     26      <seg>0.1 SBU</seg>
     27      <seg>11.8 MB</seg>
     28    </seglistitem>
     29  </segmentedlist>
     30
     31  <segmentedlist>
     32    <segtitle>&dependencies;</segtitle>
     33
     34    <seglistitem>
     35      <seg>Bash, Binutils, Bison, Coreutils, Diffutils, Flex, GCC, Gettext,
     36      Glibc, Grep, Gzip, M4, Make, and Sed</seg>
     37    </seglistitem>
     38  </segmentedlist>
     39
     40  </sect2>
     41
     42  <sect2 role="installation">
     43    <title>Installation of Kbd</title>
     44
     45    <para>The behaviour of the Backspace and Delete keys is not consistent
     46    across the keymaps in the Kbd package. The following patch fixes this
     47    issue for i386 keymaps:</para>
    3448
    3549<screen><userinput>patch -Np1 -i ../&kbd-backspace-patch;</userinput></screen>
    3650
    37 <para>After patching, the Backspace key generates the character with code 127,
    38 and the Delete key generates a well-known escape sequence.</para>
    39 
    40 <para>Patch Kbd to fix a bug in <command>setfont</command> that is triggered
    41 when compiling with GCC-&gcc-version;:</para>
     51    <para>After patching, the Backspace key generates the character with code 127,
     52    and the Delete key generates a well-known escape sequence.</para>
     53
     54    <para>Patch Kbd to fix a bug in <command>setfont</command> that is triggered
     55    when compiling with GCC-&gcc-version;:</para>
    4256
    4357<screen><userinput>patch -Np1 -i ../&kbd-gcc4_fixes-patch;</userinput></screen>
    4458
    45 <para>Prepare Kbd for compilation:</para>
     59    <para>Prepare Kbd for compilation:</para>
    4660
    4761<screen><userinput>./configure</userinput></screen>
    4862
    49 <para>Compile the package:</para>
     63    <para>Compile the package:</para>
    5064
    5165<screen><userinput>make</userinput></screen>
    5266
    53 <para>This package does not come with a test suite.</para>
    54 
    55 <para>Install the package:</para>
     67    <para>This package does not come with a test suite.</para>
     68
     69    <para>Install the package:</para>
    5670
    5771<screen><userinput>make install</userinput></screen>
    5872
    59 <note><para>For some languages (e.g., Belarusian) the Kbd package doesn't
    60 provide a useful keymap (the stock <quote>by</quote> keymap assumes the
    61 ISO-8859-5 encoding, while everybody uses CP1251 instead). Users of such
    62 languages have to download working keymaps separately.</para></note>
    63 
    64 </sect2>
    65 
    66 <sect2 id="contents-kbd" role="content"><title>Contents of Kbd</title>
    67 
    68 <segmentedlist>
    69 <segtitle>Installed programs</segtitle>
    70 <seglistitem><seg>chvt, deallocvt, dumpkeys,
    71 fgconsole, getkeycodes, getunimap, kbd_mode, kbdrate, loadkeys, loadunimap,
    72 mapscrn, openvt, psfaddtable (link to psfxtable), psfgettable (link to
    73 psfxtable), psfstriptable (link to psfxtable), psfxtable, resizecons,
    74 setfont, setkeycodes, setleds, setlogcons, setmetamode, setvesablank,
    75 showconsolefont, showkey, unicode_start, and unicode_stop</seg></seglistitem>
    76 </segmentedlist>
    77 
    78 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
    79 <?dbfo list-presentation="list"?>
    80 <?dbhtml list-presentation="table"?>
    81 
    82 <varlistentry id="chvt">
    83 <term><command>chvt</command></term>
    84 <listitem>
    85 <para>Changes the foreground virtual terminal</para>
    86 <indexterm zone="ch-system-kbd chvt"><primary sortas="b-chvt">chvt</primary></indexterm>
    87 </listitem>
    88 </varlistentry>
    89 
    90 <varlistentry id="deallocvt">
    91 <term><command>deallocvt</command></term>
    92 <listitem>
    93 <para>Deallocates unused virtual terminals</para>
    94 <indexterm zone="ch-system-kbd deallocvt"><primary sortas="b-deallocvt">deallocvt</primary></indexterm>
    95 </listitem>
    96 </varlistentry>
    97 
    98 <varlistentry id="dumpkeys">
    99 <term><command>dumpkeys</command></term>
    100 <listitem>
    101 <para>Dumps the keyboard translation tables</para>
    102 <indexterm zone="ch-system-kbd dumpkeys"><primary sortas="b-dumpkeys">dumpkeys</primary></indexterm>
    103 </listitem>
    104 </varlistentry>
    105 
    106 <varlistentry id="fgconsole">
    107 <term><command>fgconsole</command></term>
    108 <listitem>
    109 <para>Prints the number of the active virtual terminal</para>
    110 <indexterm zone="ch-system-kbd fgconsole"><primary sortas="b-fgconsole">fgconsole</primary></indexterm>
    111 </listitem>
    112 </varlistentry>
    113 
    114 <varlistentry id="getkeycodes">
    115 <term><command>getkeycodes</command></term>
    116 <listitem>
    117 <para>Prints the kernel scancode-to-keycode mapping table</para>
    118 <indexterm zone="ch-system-kbd getkeycodes"><primary sortas="b-getkeycodes">getkeycodes</primary></indexterm>
    119 </listitem>
    120 </varlistentry>
    121 
    122 <varlistentry id="getunimap">
    123 <term><command>getunimap</command></term>
    124 <listitem>
    125 <para>Prints the currently used unicode-to-font mapping table</para>
    126 <indexterm zone="ch-system-kbd getunimap"><primary sortas="b-getunimap">getunimap</primary></indexterm>
    127 </listitem>
    128 </varlistentry>
    129 
    130 <varlistentry id="kbd_mode">
    131 <term><command>kbd_mode</command></term>
    132 <listitem>
    133 <para>Reports or sets the keyboard mode</para>
    134 <indexterm zone="ch-system-kbd kbd_mode"><primary sortas="b-kbd_mode">kbd_mode</primary></indexterm>
    135 </listitem>
    136 </varlistentry>
    137 
    138 <varlistentry id="kbdrate">
    139 <term><command>kbdrate</command></term>
    140 <listitem>
    141 <para>Sets the keyboard repeat and delay rates</para>
    142 <indexterm zone="ch-system-kbd kbdrate"><primary sortas="b-kbdrate">kbdrate</primary></indexterm>
    143 </listitem>
    144 </varlistentry>
    145 
    146 <varlistentry id="loadkeys">
    147 <term><command>loadkeys</command></term>
    148 <listitem>
    149 <para>Loads the keyboard translation tables</para>
    150 <indexterm zone="ch-system-kbd loadkeys"><primary sortas="b-loadkeys">loadkeys</primary></indexterm>
    151 </listitem>
    152 </varlistentry>
    153 
    154 <varlistentry id="loadunimap">
    155 <term><command>loadunimap</command></term>
    156 <listitem>
    157 <para>Loads the kernel unicode-to-font mapping table</para>
    158 <indexterm zone="ch-system-kbd loadunimap"><primary sortas="b-loadunimap">loadunimap</primary></indexterm>
    159 </listitem>
    160 </varlistentry>
    161 
    162 <varlistentry id="mapscrn">
    163 <term><command>mapscrn</command></term>
    164 <listitem>
    165 <para>An obsolete program that used to load
    166 a user-defined output character mapping table into the console driver; this is
    167 now done by <command>setfont</command></para>
    168 <indexterm zone="ch-system-kbd mapscrn"><primary sortas="b-mapscrn">mapscrn</primary></indexterm>
    169 </listitem>
    170 </varlistentry>
    171 
    172 <varlistentry id="openvt">
    173 <term><command>openvt</command></term>
    174 <listitem>
    175 <para>Starts a program on a new virtual terminal (VT)</para>
    176 <indexterm zone="ch-system-kbd openvt"><primary sortas="b-openvt">openvt</primary></indexterm>
    177 </listitem>
    178 </varlistentry>
    179 
    180 <varlistentry id="psfaddtable">
    181 <term><command>psfaddtable</command></term>
    182 <listitem>
    183 <para>A link to <command>psfxtable</command></para>
    184 <indexterm zone="ch-system-kbd psfaddtable"><primary sortas="b-psfaddtable">psfaddtable</primary></indexterm>
    185 </listitem>
    186 </varlistentry>
    187 
    188 <varlistentry id="psfgettable">
    189 <term><command>psfgettable</command></term>
    190 <listitem>
    191 <para>A link to <command>psfxtable</command></para>
    192 <indexterm zone="ch-system-kbd psfgettable"><primary sortas="b-psfgettable">psfgettable</primary></indexterm>
    193 </listitem>
    194 </varlistentry>
    195 
    196 <varlistentry id="psfstriptable">
    197 <term><command>psfstriptable</command></term>
    198 <listitem>
    199 <para>A link to <command>psfxtable</command></para>
    200 <indexterm zone="ch-system-kbd psfstriptable"><primary sortas="b-psfstriptable">psfstriptable</primary></indexterm>
    201 </listitem>
    202 </varlistentry>
    203 
    204 <varlistentry id="psfxtable">
    205 <term><command>psfxtable</command></term>
    206 <listitem>
    207 <para>Handle Unicode character tables for console fonts</para>
    208 <indexterm zone="ch-system-kbd psfxtable"><primary sortas="b-psfxtable">psfxtable</primary></indexterm>
    209 </listitem>
    210 </varlistentry>
    211 
    212 <varlistentry id="resizecons">
    213 <term><command>resizecons</command></term>
    214 <listitem>
    215 <para>Changes the kernel idea of the console size</para>
    216 <indexterm zone="ch-system-kbd resizecons"><primary sortas="b-resizecons">resizecons</primary></indexterm>
    217 </listitem>
    218 </varlistentry>
    219 
    220 <varlistentry id="setfont">
    221 <term><command>setfont</command></term>
    222 <listitem>
    223 <para>Changes the Enhanced Graphic Adapter (EGA) and Video Graphics
    224 Array (VGA) fonts on the console</para>
    225 <indexterm zone="ch-system-kbd setfont"><primary sortas="b-setfont">setfont</primary></indexterm>
    226 </listitem>
    227 </varlistentry>
    228 
    229 <varlistentry id="setkeycodes">
    230 <term><command>setkeycodes</command></term>
    231 <listitem>
    232 <para>Loads kernel scancode-to-keycode mapping table entries; this is
    233 useful if there are unusual keys on the keyboard</para>
    234 <indexterm zone="ch-system-kbd setkeycodes"><primary sortas="b-setkeycodes">setkeycodes</primary></indexterm>
    235 </listitem>
    236 </varlistentry>
    237 
    238 <varlistentry id="setleds">
    239 <term><command>setleds</command></term>
    240 <listitem>
    241 <para>Sets the keyboard flags and Light Emitting Diodes (LEDs)</para>
    242 <indexterm zone="ch-system-kbd setleds"><primary sortas="b-setleds">setleds</primary></indexterm>
    243 </listitem>
    244 </varlistentry>
    245 
    246 <varlistentry id="setlogcons">
    247 <term><command>setlogcons</command></term>
    248 <listitem>
    249 <para>Sends kernel messages to the console</para>
    250 <indexterm zone="ch-system-kbd setlogcons"><primary sortas="b-setlogcons">setlogcons</primary></indexterm>
    251 </listitem>
    252 </varlistentry>
    253 
    254 <varlistentry id="setmetamode">
    255 <term><command>setmetamode</command></term>
    256 <listitem>
    257 <para>Defines the keyboard meta-key handling</para>
    258 <indexterm zone="ch-system-kbd setmetamode"><primary sortas="b-setmetamode">setmetamode</primary></indexterm>
    259 </listitem>
    260 </varlistentry>
    261 
    262 <varlistentry id="setvesablank">
    263 <term><command>setvesablank</command></term>
    264 <listitem>
    265 <para>Lets the user adjust the built-in hardware screensaver (a blank
    266 screen)</para>
    267 <indexterm zone="ch-system-kbd setvesablank"><primary sortas="b-setvesablank">setvesablank</primary></indexterm>
    268 </listitem>
    269 </varlistentry>
    270 
    271 <varlistentry id="showconsolefont">
    272 <term><command>showconsolefont</command></term>
    273 <listitem>
    274 <para>Shows the current EGA/VGA console screen font</para>
    275 <indexterm zone="ch-system-kbd showconsolefont"><primary sortas="b-showconsolefont">showconsolefont</primary></indexterm>
    276 </listitem>
    277 </varlistentry>
    278 
    279 <varlistentry id="showkey">
    280 <term><command>showkey</command></term>
    281 <listitem>
    282 <para>Reports the scancodes, keycodes, and ASCII codes of the keys
    283 pressed on the keyboard</para>
    284 <indexterm zone="ch-system-kbd showkey"><primary sortas="b-showkey">showkey</primary></indexterm>
    285 </listitem>
    286 </varlistentry>
    287 
    288 <varlistentry id="unicode_start">
    289 <term><command>unicode_start</command></term>
    290 <listitem>
    291 <para>Puts the keyboard and console in UNICODE mode. Don't use this program
    292 unless your keymap file is in the ISO-8859-1 encoding. For other encodings,
    293 this utility produces incorrect results.</para>
    294 <indexterm zone="ch-system-kbd unicode_start"><primary sortas="b-unicode_start">unicode_start</primary></indexterm>
    295 </listitem>
    296 </varlistentry>
    297 
    298 <varlistentry id="unicode_stop">
    299 <term><command>unicode_stop</command></term>
    300 <listitem>
    301 <para>Reverts keyboard and console from UNICODE mode</para>
    302 <indexterm zone="ch-system-kbd unicode_stop"><primary sortas="b-unicode_stop">unicode_stop</primary></indexterm>
    303 </listitem>
    304 </varlistentry>
    305 </variablelist>
    306 
    307 </sect2>
     73    <note>
     74      <para>For some languages (e.g., Belarusian) the Kbd package doesn't
     75      provide a useful keymap (the stock <quote>by</quote> keymap assumes the
     76      ISO-8859-5 encoding, while everybody uses CP1251 instead). Users of such
     77      languages have to download working keymaps separately.</para>
     78    </note>
     79
     80  </sect2>
     81
     82  <sect2 id="contents-kbd" role="content">
     83    <title>Contents of Kbd</title>
     84
     85    <segmentedlist>
     86      <segtitle>Installed programs</segtitle>
     87
     88      <seglistitem>
     89        <seg>chvt, deallocvt, dumpkeys,
     90        fgconsole, getkeycodes, getunimap, kbd_mode, kbdrate, loadkeys, loadunimap,
     91        mapscrn, openvt, psfaddtable (link to psfxtable), psfgettable (link to
     92        psfxtable), psfstriptable (link to psfxtable), psfxtable, resizecons,
     93        setfont, setkeycodes, setleds, setlogcons, setmetamode, setvesablank,
     94        showconsolefont, showkey, unicode_start, and unicode_stop</seg>
     95      </seglistitem>
     96    </segmentedlist>
     97
     98    <variablelist>
     99      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     100      <?dbfo list-presentation="list"?>
     101      <?dbhtml list-presentation="table"?>
     102
     103      <varlistentry id="chvt">
     104        <term><command>chvt</command></term>
     105        <listitem>
     106          <para>Changes the foreground virtual terminal</para>
     107          <indexterm zone="ch-system-kbd chvt">
     108            <primary sortas="b-chvt">chvt</primary>
     109          </indexterm>
     110        </listitem>
     111      </varlistentry>
     112
     113      <varlistentry id="deallocvt">
     114        <term><command>deallocvt</command></term>
     115        <listitem>
     116          <para>Deallocates unused virtual terminals</para>
     117          <indexterm zone="ch-system-kbd deallocvt">
     118            <primary sortas="b-deallocvt">deallocvt</primary>
     119          </indexterm>
     120        </listitem>
     121      </varlistentry>
     122
     123      <varlistentry id="dumpkeys">
     124        <term><command>dumpkeys</command></term>
     125        <listitem>
     126          <para>Dumps the keyboard translation tables</para>
     127          <indexterm zone="ch-system-kbd dumpkeys">
     128            <primary sortas="b-dumpkeys">dumpkeys</primary>
     129          </indexterm>
     130        </listitem>
     131      </varlistentry>
     132
     133      <varlistentry id="fgconsole">
     134        <term><command>fgconsole</command></term>
     135        <listitem>
     136          <para>Prints the number of the active virtual terminal</para>
     137          <indexterm zone="ch-system-kbd fgconsole">
     138            <primary sortas="b-fgconsole">fgconsole</primary>
     139          </indexterm>
     140        </listitem>
     141      </varlistentry>
     142
     143      <varlistentry id="getkeycodes">
     144        <term><command>getkeycodes</command></term>
     145        <listitem>
     146          <para>Prints the kernel scancode-to-keycode mapping table</para>
     147          <indexterm zone="ch-system-kbd getkeycodes">
     148            <primary sortas="b-getkeycodes">getkeycodes</primary>
     149          </indexterm>
     150        </listitem>
     151      </varlistentry>
     152
     153      <varlistentry id="getunimap">
     154        <term><command>getunimap</command></term>
     155        <listitem>
     156          <para>Prints the currently used unicode-to-font mapping table</para>
     157          <indexterm zone="ch-system-kbd getunimap">
     158            <primary sortas="b-getunimap">getunimap</primary>
     159          </indexterm>
     160        </listitem>
     161      </varlistentry>
     162
     163      <varlistentry id="kbd_mode">
     164        <term><command>kbd_mode</command></term>
     165        <listitem>
     166          <para>Reports or sets the keyboard mode</para>
     167          <indexterm zone="ch-system-kbd kbd_mode">
     168            <primary sortas="b-kbd_mode">kbd_mode</primary>
     169          </indexterm>
     170        </listitem>
     171      </varlistentry>
     172
     173      <varlistentry id="kbdrate">
     174        <term><command>kbdrate</command></term>
     175        <listitem>
     176          <para>Sets the keyboard repeat and delay rates</para>
     177          <indexterm zone="ch-system-kbd kbdrate">
     178            <primary sortas="b-kbdrate">kbdrate</primary>
     179          </indexterm>
     180        </listitem>
     181      </varlistentry>
     182
     183      <varlistentry id="loadkeys">
     184        <term><command>loadkeys</command></term>
     185        <listitem>
     186          <para>Loads the keyboard translation tables</para>
     187          <indexterm zone="ch-system-kbd loadkeys">
     188            <primary sortas="b-loadkeys">loadkeys</primary>
     189          </indexterm>
     190        </listitem>
     191      </varlistentry>
     192
     193      <varlistentry id="loadunimap">
     194        <term><command>loadunimap</command></term>
     195        <listitem>
     196          <para>Loads the kernel unicode-to-font mapping table</para>
     197          <indexterm zone="ch-system-kbd loadunimap">
     198            <primary sortas="b-loadunimap">loadunimap</primary>
     199          </indexterm>
     200        </listitem>
     201      </varlistentry>
     202
     203      <varlistentry id="mapscrn">
     204        <term><command>mapscrn</command></term>
     205        <listitem>
     206          <para>An obsolete program that used to load a user-defined output
     207          character mapping table into the console driver; this is now done
     208          by <command>setfont</command></para>
     209          <indexterm zone="ch-system-kbd mapscrn">
     210            <primary sortas="b-mapscrn">mapscrn</primary>
     211          </indexterm>
     212        </listitem>
     213      </varlistentry>
     214
     215      <varlistentry id="openvt">
     216        <term><command>openvt</command></term>
     217        <listitem>
     218          <para>Starts a program on a new virtual terminal (VT)</para>
     219          <indexterm zone="ch-system-kbd openvt">
     220            <primary sortas="b-openvt">openvt</primary>
     221          </indexterm>
     222        </listitem>
     223      </varlistentry>
     224
     225      <varlistentry id="psfaddtable">
     226        <term><command>psfaddtable</command></term>
     227        <listitem>
     228          <para>A link to <command>psfxtable</command></para>
     229          <indexterm zone="ch-system-kbd psfaddtable">
     230            <primary sortas="b-psfaddtable">psfaddtable</primary>
     231          </indexterm>
     232        </listitem>
     233      </varlistentry>
     234
     235      <varlistentry id="psfgettable">
     236        <term><command>psfgettable</command></term>
     237        <listitem>
     238          <para>A link to <command>psfxtable</command></para>
     239          <indexterm zone="ch-system-kbd psfgettable">
     240            <primary sortas="b-psfgettable">psfgettable</primary>
     241          </indexterm>
     242        </listitem>
     243      </varlistentry>
     244
     245      <varlistentry id="psfstriptable">
     246        <term><command>psfstriptable</command></term>
     247        <listitem>
     248          <para>A link to <command>psfxtable</command></para>
     249          <indexterm zone="ch-system-kbd psfstriptable">
     250            <primary sortas="b-psfstriptable">psfstriptable</primary>
     251          </indexterm>
     252        </listitem>
     253      </varlistentry>
     254
     255      <varlistentry id="psfxtable">
     256        <term><command>psfxtable</command></term>
     257        <listitem>
     258          <para>Handle Unicode character tables for console fonts</para>
     259          <indexterm zone="ch-system-kbd psfxtable">
     260            <primary sortas="b-psfxtable">psfxtable</primary>
     261          </indexterm>
     262        </listitem>
     263      </varlistentry>
     264
     265      <varlistentry id="resizecons">
     266        <term><command>resizecons</command></term>
     267        <listitem>
     268          <para>Changes the kernel idea of the console size</para>
     269          <indexterm zone="ch-system-kbd resizecons">
     270            <primary sortas="b-resizecons">resizecons</primary>
     271          </indexterm>
     272        </listitem>
     273      </varlistentry>
     274
     275      <varlistentry id="setfont">
     276        <term><command>setfont</command></term>
     277        <listitem>
     278          <para>Changes the Enhanced Graphic Adapter (EGA) and Video Graphics
     279          Array (VGA) fonts on the console</para>
     280          <indexterm zone="ch-system-kbd setfont">
     281            <primary sortas="b-setfont">setfont</primary>
     282          </indexterm>
     283        </listitem>
     284      </varlistentry>
     285
     286      <varlistentry id="setkeycodes">
     287        <term><command>setkeycodes</command></term>
     288        <listitem>
     289          <para>Loads kernel scancode-to-keycode mapping table entries; this is
     290          useful if there are unusual keys on the keyboard</para>
     291          <indexterm zone="ch-system-kbd setkeycodes">
     292            <primary sortas="b-setkeycodes">setkeycodes</primary>
     293          </indexterm>
     294        </listitem>
     295      </varlistentry>
     296
     297      <varlistentry id="setleds">
     298        <term><command>setleds</command></term>
     299        <listitem>
     300          <para>Sets the keyboard flags and Light Emitting Diodes (LEDs)</para>
     301          <indexterm zone="ch-system-kbd setleds">
     302            <primary sortas="b-setleds">setleds</primary>
     303          </indexterm>
     304        </listitem>
     305      </varlistentry>
     306
     307      <varlistentry id="setlogcons">
     308        <term><command>setlogcons</command></term>
     309        <listitem>
     310          <para>Sends kernel messages to the console</para>
     311          <indexterm zone="ch-system-kbd setlogcons">
     312            <primary sortas="b-setlogcons">setlogcons</primary>
     313          </indexterm>
     314        </listitem>
     315      </varlistentry>
     316
     317      <varlistentry id="setmetamode">
     318        <term><command>setmetamode</command></term>
     319        <listitem>
     320          <para>Defines the keyboard meta-key handling</para>
     321          <indexterm zone="ch-system-kbd setmetamode">
     322            <primary sortas="b-setmetamode">setmetamode</primary>
     323          </indexterm>
     324        </listitem>
     325      </varlistentry>
     326
     327      <varlistentry id="setvesablank">
     328        <term><command>setvesablank</command></term>
     329        <listitem>
     330          <para>Lets the user adjust the built-in hardware screensaver (a blank
     331          screen)</para>
     332          <indexterm zone="ch-system-kbd setvesablank">
     333            <primary sortas="b-setvesablank">setvesablank</primary>
     334          </indexterm>
     335        </listitem>
     336      </varlistentry>
     337
     338      <varlistentry id="showconsolefont">
     339        <term><command>showconsolefont</command></term>
     340        <listitem>
     341          <para>Shows the current EGA/VGA console screen font</para>
     342          <indexterm zone="ch-system-kbd showconsolefont">
     343            <primary sortas="b-showconsolefont">showconsolefont</primary>
     344          </indexterm>
     345        </listitem>
     346      </varlistentry>
     347
     348      <varlistentry id="showkey">
     349        <term><command>showkey</command></term>
     350        <listitem>
     351          <para>Reports the scancodes, keycodes, and ASCII codes of the keys
     352          pressed on the keyboard</para>
     353          <indexterm zone="ch-system-kbd showkey">
     354            <primary sortas="b-showkey">showkey</primary>
     355          </indexterm>
     356        </listitem>
     357      </varlistentry>
     358
     359      <varlistentry id="unicode_start">
     360        <term><command>unicode_start</command></term>
     361        <listitem>
     362          <para>Puts the keyboard and console in UNICODE mode. Don't use this
     363          program unless your keymap file is in the ISO-8859-1 encoding. For
     364          other encodings, this utility produces incorrect results.</para>
     365          <indexterm zone="ch-system-kbd unicode_start">
     366            <primary sortas="b-unicode_start">unicode_start</primary>
     367          </indexterm>
     368        </listitem>
     369      </varlistentry>
     370
     371      <varlistentry id="unicode_stop">
     372        <term><command>unicode_stop</command></term>
     373        <listitem>
     374          <para>Reverts keyboard and console from UNICODE mode</para>
     375          <indexterm zone="ch-system-kbd unicode_stop">
     376            <primary sortas="b-unicode_stop">unicode_stop</primary>
     377          </indexterm>
     378        </listitem>
     379      </varlistentry>
     380
     381    </variablelist>
     382
     383  </sect2>
    308384
    309385</sect1>
    310 

  • chapter06/kernfs.xml

    r4ae4324 rbdea25ce  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-system-kernfs">
    7 <title>Mounting Virtual Kernel File Systems</title>
    8 <?dbhtml filename="kernfs.html"?>
     9  <?dbhtml filename="kernfs.html"?>
    910
    10 <para>Various file systems exported by the kernel are used to communicate to and
    11 from the kernel itself. These file systems are virtual in that no disk space is
    12 used for them. The content of the file systems resides in memory.</para>
     11  <title>Mounting Virtual Kernel File Systems</title>
    1312
    14 <para>Begin by creating directories onto which the file systems will be mounted:</para>
     13  <para>Various file systems exported by the kernel are used to communicate to and
     14  from the kernel itself. These file systems are virtual in that no disk space is
     15  used for them. The content of the file systems resides in memory.</para>
     16
     17  <para>Begin by creating directories onto which the file systems will be
     18  mounted:</para>
    1519
    1620<screen><userinput>mkdir -pv $LFS/{proc,sys}</userinput></screen>
    1721
    18 <para>Now mount the file systems:</para>
     22  <para>Now mount the file systems:</para>
    1923
    2024<screen><userinput>mount -vt proc proc $LFS/proc
    2125mount -vt sysfs sysfs $LFS/sys</userinput></screen>
    2226
    23 <para>Remember that if for any reason you stop working on the LFS
    24 system and start again later, it is important to check that these file
    25 systems are mounted again before entering the chroot
    26 environment.</para>
     27  <para>Remember that if for any reason you stop working on the LFS
     28  system and start again later, it is important to check that these file
     29  systems are mounted again before entering the chroot
     30  environment.</para>
    2731
    28 <para>Additional file systems will soon be mounted from within the
    29 chroot environment. To keep the host up to date, perform a <quote>fake
    30 mount</quote> for each of these now:</para>
     32  <para>Additional file systems will soon be mounted from within the
     33  chroot environment. To keep the host up to date, perform a <quote>fake
     34  mount</quote> for each of these now:</para>
    3135
    3236<screen><userinput>mount -vft tmpfs tmpfs $LFS/dev
    … …  
    3539
    3640</sect1>
    37 

  • chapter06/less.xml

    r4ae4324 rbdea25ce  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-system-less" role="wrap">
    7 <title>Less-&less-version;</title>
    8 <?dbhtml filename="less.html"?>
     9  <?dbhtml filename="less.html"?>
    910
    10 <indexterm zone="ch-system-less"><primary sortas="a-Less">Less</primary></indexterm>
     11  <title>Less-&less-version;</title>
    1112
    12 <sect2 role="package"><title/>
    13 <para>The Less package contains a text file viewer.</para>
     13  <indexterm zone="ch-system-less">
     14    <primary sortas="a-Less">Less</primary>
     15  </indexterm>
    1416
    15 <segmentedlist>
    16 <segtitle>&buildtime;</segtitle>
    17 <segtitle>&diskspace;</segtitle>
    18 <seglistitem><seg>0.1 SBU</seg><seg>2.3 MB</seg></seglistitem>
    19 </segmentedlist>
     17  <sect2 role="package">
     18    <title/>
    2019
    21 <segmentedlist>
    22 <segtitle>&dependencies;</segtitle>
    23 <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
    24 GCC, Glibc, Grep, Make, Ncurses, and Sed</seg></seglistitem>
    25 </segmentedlist>
    26 </sect2>
     20    <para>The Less package contains a text file viewer.</para>
    2721
    28 <sect2 role="installation">
    29 <title>Installation of Less</title>
     22    <segmentedlist>
     23      <segtitle>&buildtime;</segtitle>
     24      <segtitle>&diskspace;</segtitle>
    3025
    31 <para>Prepare Less for compilation:</para>
     26      <seglistitem>
     27        <seg>0.1 SBU</seg>
     28        <seg>2.3 MB</seg>
     29      </seglistitem>
     30    </segmentedlist>
     31
     32    <segmentedlist>
     33      <segtitle>&dependencies;</segtitle>
     34
     35      <seglistitem>
     36        <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep, Make,
     37        Ncurses, and Sed</seg>
     38      </seglistitem>
     39    </segmentedlist>
     40
     41  </sect2>
     42
     43  <sect2 role="installation">
     44    <title>Installation of Less</title>
     45
     46    <para>Prepare Less for compilation:</para>
    3247
    3348<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc</userinput></screen>
    3449
    35 <para>The meaning of the configure options:</para>
     50    <variablelist>
     51      <title>The meaning of the configure options:</title>
    3652
    37 <variablelist>
    38 <varlistentry>
    39 <term><parameter>--sysconfdir=/etc</parameter></term>
    40 <listitem><para>This option tells the programs created by the package to look in
    41 <filename class="directory">/etc</filename> for the configuration files.</para></listitem>
    42 </varlistentry>
    43 </variablelist>
     53      <varlistentry>
     54        <term><parameter>--sysconfdir=/etc</parameter></term>
     55        <listitem>
     56          <para>This option tells the programs created by the package to look
     57          in <filename class="directory">/etc</filename> for the configuration
     58          files.</para>
     59        </listitem>
     60      </varlistentry>
    4461
    45 <para>Compile the package:</para>
     62    </variablelist>
     63
     64    <para>Compile the package:</para>
    4665
    4766<screen><userinput>make</userinput></screen>
    4867
    49 <para>This package does not come with a test suite.</para>
     68    <para>This package does not come with a test suite.</para>
    5069
    51 <para>Install the package:</para>
     70    <para>Install the package:</para>
    5271
    5372<screen><userinput>make install</userinput></screen>
    54 </sect2>
    5573
    56 <sect2 id="contents-less" role="content"><title>Contents of Less</title>
     74  </sect2>
    5775
    58 <segmentedlist>
    59 <segtitle>Installed programs</segtitle>
    60 <seglistitem><seg>less, lessecho, and lesskey</seg></seglistitem>
    61 </segmentedlist>
     76  <sect2 id="contents-less" role="content">
     77    <title>Contents of Less</title>
    6278
    63 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
    64 <?dbfo list-presentation="list"?>
    65 <?dbhtml list-presentation="table"?>
     79    <segmentedlist>
     80      <segtitle>Installed programs</segtitle>
    6681
    67 <varlistentry id="less">
    68 <term><command>less</command></term>
    69 <listitem>
    70 <para>A file viewer or pager; it displays the contents of the given
    71 file, letting the user scroll, find strings, and jump to marks</para>
    72 <indexterm zone="ch-system-less less"><primary sortas="b-less">less</primary></indexterm>
    73 </listitem>
    74 </varlistentry>
     82      <seglistitem>
     83        <seg>less, lessecho, and lesskey</seg>
     84      </seglistitem>
     85    </segmentedlist>
    7586
    76 <varlistentry id="lessecho">
    77 <term><command>lessecho</command></term>
    78 <listitem>
    79 <para>Needed to expand meta-characters, such as <emphasis>*</emphasis>
    80 and <emphasis>?</emphasis>, in filenames on Unix systems</para>
    81 <indexterm zone="ch-system-less lessecho"><primary sortas="b-lessecho">lessecho</primary></indexterm>
    82 </listitem>
    83 </varlistentry>
     87    <variablelist>
     88      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     89      <?dbfo list-presentation="list"?>
     90      <?dbhtml list-presentation="table"?>
    8491
    85 <varlistentry id="lesskey">
    86 <term><command>lesskey</command></term>
    87 <listitem>
    88 <para>Used to specify the key bindings for <command>less</command></para>
    89 <indexterm zone="ch-system-less lesskey"><primary sortas="b-lesskey">lesskey</primary></indexterm>
    90 </listitem>
    91 </varlistentry>
    92 </variablelist>
     92      <varlistentry id="less">
     93        <term><command>less</command></term>
     94        <listitem>
     95          <para>A file viewer or pager; it displays the contents of the given
     96          file, letting the user scroll, find strings, and jump to marks</para>
     97          <indexterm zone="ch-system-less less">
     98            <primary sortas="b-less">less</primary>
     99          </indexterm>
     100        </listitem>
     101      </varlistentry>
    93102
    94 </sect2>
     103      <varlistentry id="lessecho">
     104        <term><command>lessecho</command></term>
     105        <listitem>
     106          <para>Needed to expand meta-characters, such as <emphasis>*</emphasis>
     107          and <emphasis>?</emphasis>, in filenames on Unix systems</para>
     108          <indexterm zone="ch-system-less lessecho">
     109            <primary sortas="b-lessecho">lessecho</primary>
     110          </indexterm>
     111        </listitem>
     112      </varlistentry>
     113
     114      <varlistentry id="lesskey">
     115        <term><command>lesskey</command></term>
     116        <listitem>
     117          <para>Used to specify the key bindings for <command>less</command></para>
     118          <indexterm zone="ch-system-less lesskey">
     119            <primary sortas="b-lesskey">lesskey</primary>
     120          </indexterm>
     121        </listitem>
     122      </varlistentry>
     123
     124    </variablelist>
     125
     126  </sect2>
    95127
    96128</sect1>
    97 

  • chapter06/libtool.xml

    r4ae4324 rbdea25ce  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-system-libtool" role="wrap">
    7 <title>Libtool-&libtool-version;</title>
    8 <?dbhtml filename="libtool.html"?>
     9  <?dbhtml filename="libtool.html"?>
    910
    10 <indexterm zone="ch-system-libtool"><primary sortas="a-Libtool">Libtool</primary></indexterm>
     11  <title>Libtool-&libtool-version;</title>
    1112
    12 <sect2 role="package"><title/>
    13 <para>The Libtool package contains the GNU generic library support script.
    14 It wraps the complexity of using shared libraries in a consistent, portable
    15 interface.</para>
     13  <indexterm zone="ch-system-libtool">
     14    <primary sortas="a-Libtool">Libtool</primary>
     15  </indexterm>
    1616
    17 <segmentedlist>
    18 <segtitle>&buildtime;</segtitle>
    19 <segtitle>&diskspace;</segtitle>
    20 <seglistitem><seg>1.8 SBU</seg><seg>19.0 MB</seg></seglistitem>
    21 </segmentedlist>
     17  <sect2 role="package">
     18    <title/>
    2219
    23 <segmentedlist>
    24 <segtitle>&dependencies;</segtitle>
    25 <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
    26 GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
    27 </segmentedlist>
    28 </sect2>
     20    <para>The Libtool package contains the GNU generic library support script.
     21    It wraps the complexity of using shared libraries in a consistent, portable
     22    interface.</para>
    2923
    30 <sect2 role="installation">
    31 <title>Installation of Libtool</title>
     24    <segmentedlist>
     25      <segtitle>&buildtime;</segtitle>
     26      <segtitle>&diskspace;</segtitle>
    3227
    33 <para>Prepare Libtool for compilation:</para>
     28      <seglistitem>
     29        <seg>1.8 SBU</seg>
     30        <seg>19.0 MB</seg>
     31      </seglistitem>
     32    </segmentedlist>
     33
     34    <segmentedlist>
     35      <segtitle>&dependencies;</segtitle>
     36
     37      <seglistitem>
     38        <seg>Bash, Binutils, Coreutils, Diffutils,
     39        GCC, Glibc, Grep, Make, and Sed</seg>
     40      </seglistitem>
     41    </segmentedlist>
     42
     43  </sect2>
     44
     45  <sect2 role="installation">
     46    <title>Installation of Libtool</title>
     47
     48    <para>Prepare Libtool for compilation:</para>
    3449
    3550<screen><userinput>./configure --prefix=/usr</userinput></screen>
    3651
    37 <para>Compile the package:</para>
     52    <para>Compile the package:</para>
    3853
    3954<screen><userinput>make</userinput></screen>
    4055
    41 <para>To test the results, issue:
    42 <userinput>make check</userinput>.</para>
     56    <para>To test the results, issue:
     57    <userinput>make check</userinput>.</para>
    4358
    44 <para>Install the package:</para>
     59    <para>Install the package:</para>
    4560
    4661<screen><userinput>make install</userinput></screen>
    4762
    48 </sect2>
     63  </sect2>
    4964
    5065
    51 <sect2 id="contents-libtool" role="content"><title>Contents of Libtool</title>
     66  <sect2 id="contents-libtool" role="content">
     67    <title>Contents of Libtool</title>
    5268
    53 <segmentedlist>
    54 <segtitle>Installed programs</segtitle>
    55 <segtitle>Installed libraries</segtitle>
    56 <seglistitem><seg>libtool and libtoolize</seg><seg>libltdl.[a,so]</seg></seglistitem>
    57 </segmentedlist>
     69    <segmentedlist>
     70      <segtitle>Installed programs</segtitle>
     71      <segtitle>Installed libraries</segtitle>
    5872
    59 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
    60 <?dbfo list-presentation="list"?>
    61 <?dbhtml list-presentation="table"?>
     73      <seglistitem>
     74        <seg>libtool and libtoolize</seg>
     75        <seg>libltdl.[a,so]</seg>
     76      </seglistitem>
     77    </segmentedlist>
    6278
    63 <varlistentry id="libtool">
    64 <term><command>libtool</command></term>
    65 <listitem>
    66 <para>Provides generalized library-building support services</para>
    67 <indexterm zone="ch-system-libtool libtool"><primary sortas="b-libtool">libtool</primary></indexterm>
    68 </listitem>
    69 </varlistentry>
     79    <variablelist>
     80      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     81      <?dbfo list-presentation="list"?>
     82      <?dbhtml list-presentation="table"?>
    7083
    71 <varlistentry id="libtoolize">
    72 <term><command>libtoolize</command></term>
    73 <listitem>
    74 <para>Provides a standard way to add <command>libtool</command> support to a package</para>
    75 <indexterm zone="ch-system-libtool libtoolize"><primary sortas="b-libtoolize">libtoolize</primary></indexterm>
    76 </listitem>
    77 </varlistentry>
     84      <varlistentry id="libtool">
     85        <term><command>libtool</command></term>
     86        <listitem>
     87          <para>Provides generalized library-building support services</para>
     88          <indexterm zone="ch-system-libtool libtool">
     89            <primary sortas="b-libtool">libtool</primary>
     90          </indexterm>
     91        </listitem>
     92      </varlistentry>
    7893
    79 <varlistentry id="libltdl">
    80 <term><filename class="libraryfile">libltdl</filename></term>
    81 <listitem>
    82 <para>Hides the various difficulties of dlopening libraries</para>
    83 <indexterm zone="ch-system-libtool libltdl"><primary sortas="c-libltdl">libltdl</primary></indexterm>
    84 </listitem>
    85 </varlistentry>
    86 </variablelist>
     94      <varlistentry id="libtoolize">
     95        <term><command>libtoolize</command></term>
     96        <listitem>
     97          <para>Provides a standard way to add <command>libtool</command>
     98          support to a package</para>
     99          <indexterm zone="ch-system-libtool libtoolize">
     100            <primary sortas="b-libtoolize">libtoolize</primary>
     101          </indexterm>
     102        </listitem>
     103      </varlistentry>
    87104
    88 </sect2>
     105      <varlistentry id="libltdl">
     106        <term><filename class="libraryfile">libltdl</filename></term>
     107        <listitem>
     108          <para>Hides the various difficulties of dlopening libraries</para>
     109          <indexterm zone="ch-system-libtool libltdl">
     110            <primary sortas="c-libltdl">libltdl</primary>
     111          </indexterm>
     112        </listitem>
     113      </varlistentry>
     114
     115    </variablelist>
     116
     117  </sect2>
    89118
    90119</sect1>
    91 

  • chapter06/linux-libc-headers.xml

    r4ae4324 rbdea25ce  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-system-linux-libc-headers" role="wrap">
    7 <title>Linux-Libc-Headers-&linux-libc-headers-version;</title>
    8 <?dbhtml filename="linux-libc-headers.html"?>
     9  <?dbhtml filename="linux-libc-headers.html"?>
    910
    10 <indexterm zone="ch-system-linux-libc-headers">
    11 <primary sortas="a-Linux-Libc-Headers">Linux-Libc-Headers</primary>
    12 </indexterm>
     11  <title>Linux-Libc-Headers-&linux-libc-headers-version;</title>
    1312
    14 <sect2 role="package"><title/>
    15 <para>The Linux-Libc-Headers package contains the
    16 <quote>sanitized</quote> kernel headers.</para>
     13  <indexterm zone="ch-system-linux-libc-headers">
     14    <primary sortas="a-Linux-Libc-Headers">Linux-Libc-Headers</primary>
     15  </indexterm>
    1716
    18 <segmentedlist>
    19 <segtitle>&buildtime;</segtitle>
    20 <segtitle>&diskspace;</segtitle>
    21 <seglistitem><seg>0.1 SBU</seg><seg>26.9 MB</seg></seglistitem>
    22 </segmentedlist>
     17  <sect2 role="package">
     18    <title/>
    2319
    24 <segmentedlist>
    25 <segtitle>&dependencies;</segtitle>
    26 <seglistitem><seg>Coreutils</seg></seglistitem>
    27 </segmentedlist>
     20    <para>The Linux-Libc-Headers package contains the
     21    <quote>sanitized</quote> kernel headers.</para>
    2822
    29 </sect2>
     23    <segmentedlist>
     24      <segtitle>&buildtime;</segtitle>
     25      <segtitle>&diskspace;</segtitle>
    3026
    31 <sect2 role="installation">
    32 <title>Installation of Linux-Libc-Headers</title>
     27      <seglistitem>
     28        <seg>0.1 SBU</seg>
     29        <seg>26.9 MB</seg>
     30      </seglistitem>
     31    </segmentedlist>
    3332
    34 <para>For years it has been common practice to use <quote>raw</quote>
    35 kernel headers (straight from a kernel tarball) in <filename
    36 class="directory">/usr/include</filename>, but over the last few
    37 years, the kernel developers have taken a strong stance that this
    38 should not be done. This gave birth to the Linux-Libc-Headers Project,
    39 which was designed to maintain an API stable version of the Linux
    40 headers.</para>
     33    <segmentedlist>
     34      <segtitle>&dependencies;</segtitle>
    4135
    42 <para>Install the header files:</para>
     36      <seglistitem>
     37        <seg>Coreutils</seg>
     38      </seglistitem>
     39    </segmentedlist>
     40
     41  </sect2>
     42
     43  <sect2 role="installation">
     44    <title>Installation of Linux-Libc-Headers</title>
     45
     46    <para>For years it has been common practice to use <quote>raw</quote>
     47    kernel headers (straight from a kernel tarball) in <filename
     48    class="directory">/usr/include</filename>, but over the last few
     49    years, the kernel developers have taken a strong stance that this
     50    should not be done. This gave birth to the Linux-Libc-Headers Project,
     51    which was designed to maintain an API stable version of the Linux
     52    headers.</para>
     53
     54    <para>Install the header files:</para>
    4355
    4456<screen><userinput>install -d /usr/include/asm
    … …  
    4658cp -Rv include/linux /usr/include</userinput></screen>
    4759
    48 <para>Ensure that all the headers are owned by root:</para>
     60    <para>Ensure that all the headers are owned by root:</para>
    4961
    5062<screen><userinput>chown -Rv root:root /usr/include/{asm,linux}</userinput></screen>
    5163
    52 <para>Make sure the users can read the headers:</para>
     64    <para>Make sure the users can read the headers:</para>
    5365
    5466<screen><userinput>find /usr/include/{asm,linux} -type d -exec chmod -v 755 {} \;
    5567find /usr/include/{asm,linux} -type f -exec chmod -v 644 {} \;</userinput></screen>
    5668
    57 </sect2>
     69  </sect2>
    5870
     71  <sect2 id="contents-linux-libc-headers" role="content">
     72    <title>Contents of Linux-Libc-Headers</title>
    5973
    60 <sect2 id="contents-linux-libc-headers" role="content"><title>Contents of Linux-Libc-Headers</title>
     74    <segmentedlist>
     75      <segtitle>Installed headers</segtitle>
    6176
    62 <segmentedlist>
    63 <segtitle>Installed headers</segtitle>
    64 <seglistitem><seg>/usr/include/{asm,linux}/*.h</seg></seglistitem>
    65 </segmentedlist>
     77      <seglistitem>
     78        <seg>/usr/include/{asm,linux}/*.h</seg>
     79      </seglistitem>
     80    </segmentedlist>
    6681
    67 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
    68 <?dbfo list-presentation="list"?>
    69 <?dbhtml list-presentation="table"?>
     82    <variablelist>
     83      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     84      <?dbfo list-presentation="list"?>
     85      <?dbhtml list-presentation="table"?>
    7086
    71 <varlistentry id="linux-libc-headers">
    72 <term><filename class="headerfile">/usr/include/{asm,linux}/*.h</filename></term>
    73 <listitem>
    74 <para>The Linux API headers</para>
    75 <indexterm zone="ch-system-linux-libc-headers linux-libc-headers"><primary sortas="e-/usr/include/{asm,linux}/*.h">/usr/include/{asm,linux}/*.h</primary></indexterm>
    76 </listitem>
    77 </varlistentry>
    78 </variablelist>
     87      <varlistentry id="linux-libc-headers">
     88        <term><filename class="headerfile">/usr/include/{asm,linux}/*.h</filename></term>
     89        <listitem>
     90          <para>The Linux API headers</para>
     91          <indexterm zone="ch-system-linux-libc-headers linux-libc-headers">
     92            <primary sortas="e-/usr/include/{asm,linux}/*.h">/usr/include/{asm,linux}/*.h</primary>
     93          </indexterm>
     94        </listitem>
     95      </varlistentry>
    7996
    80 </sect2>
     97    </variablelist>
     98
     99  </sect2>
    81100
    82101</sect1>
    83 

  • chapter06/m4.xml

    r4ae4324 rbdea25ce  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-system-m4" role="wrap">
    7 <title>M4-&m4-version;</title>
    8 <?dbhtml filename="m4.html"?>
     9  <?dbhtml filename="m4.html"?>
    910
    10 <indexterm zone="ch-system-m4"><primary sortas="a-M4">M4</primary></indexterm>
     11  <title>M4-&m4-version;</title>
    1112
    12 <sect2 role="package"><title/>
    13 <para>The M4 package contains a macro processor.</para>
     13  <indexterm zone="ch-system-m4">
     14    <primary sortas="a-M4">M4</primary>
     15  </indexterm>
    1416
    15 <segmentedlist>
    16 <segtitle>&buildtime;</segtitle>
    17 <segtitle>&diskspace;</segtitle>
    18 <seglistitem><seg>0.1 SBU</seg><seg>2.8 MB</seg></seglistitem>
    19 </segmentedlist>
     17  <sect2 role="package">
     18    <title/>
    2019
    21 <segmentedlist>
    22 <segtitle>&dependencies;</segtitle>
    23 <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, GCC,
    24 Gettext, Glibc, Grep, Make, Perl, and Sed</seg></seglistitem>
    25 </segmentedlist>
    26 </sect2>
     20    <para>The M4 package contains a macro processor.</para>
    2721
    28 <sect2 role="installation">
    29 <title>Installation of M4</title>
     22    <segmentedlist>
     23      <segtitle>&buildtime;</segtitle>
     24      <segtitle>&diskspace;</segtitle>
    3025
    31 <para>Prepare M4 for compilation:</para>
     26      <seglistitem>
     27        <seg>0.1 SBU</seg>
     28        <seg>2.8 MB</seg>
     29      </seglistitem>
     30    </segmentedlist>
     31
     32    <segmentedlist>
     33      <segtitle>&dependencies;</segtitle>
     34
     35      <seglistitem>
     36        <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc,
     37        Grep, Make, Perl, and Sed</seg>
     38      </seglistitem>
     39    </segmentedlist>
     40
     41  </sect2>
     42
     43  <sect2 role="installation">
     44    <title>Installation of M4</title>
     45
     46    <para>Prepare M4 for compilation:</para>
    3247
    3348<screen><userinput>./configure --prefix=/usr</userinput></screen>
    3449
    35 <para>Compile the package:</para>
     50    <para>Compile the package:</para>
    3651
    3752<screen><userinput>make</userinput></screen>
    3853
    39 <para>To test the results, issue:
    40 <userinput>make check</userinput>.</para>
     54    <para>To test the results, issue:
     55    <userinput>make check</userinput>.</para>
    4156
    42 <para>Install the package:</para>
     57    <para>Install the package:</para>
    4358
    4459<screen><userinput>make install</userinput></screen>
    4560
    46 </sect2>
     61  </sect2>
    4762
    4863
    49 <sect2 id="contents-m4" role="content"><title>Contents of M4</title>
     64  <sect2 id="contents-m4" role="content">
     65    <title>Contents of M4</title>
    5066
    51 <segmentedlist>
    52 <segtitle>Installed program</segtitle>
    53 <seglistitem><seg>m4</seg></seglistitem>
    54 </segmentedlist>
     67    <segmentedlist>
     68      <segtitle>Installed program</segtitle>
    5569
    56 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
    57 <?dbfo list-presentation="list"?>
    58 <?dbhtml list-presentation="table"?>
     70      <seglistitem>
     71        <seg>m4</seg>
     72      </seglistitem>
     73    </segmentedlist>
    5974
    60 <varlistentry id="m4">
    61 <term><command>m4</command></term>
    62 <listitem>
    63 <para>copies the given files while expanding the macros that they
    64 contain. These macros are either built-in or user-defined and can take
    65 any number of arguments. Besides performing macro expansion,
    66 <command>m4</command> has
    67 built-in functions for including named files, running Unix commands,
    68 performing integer arithmetic, manipulating text, recursion, etc. The
    69 <command>m4</command> program can be used either as a front-end to a compiler or as a
    70 macro processor in its own right.</para>
    71 <indexterm zone="ch-system-m4 m4"><primary sortas="b-m4">m4</primary></indexterm>
    72 </listitem>
    73 </varlistentry>
    74 </variablelist>
     75    <variablelist>
     76      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     77      <?dbfo list-presentation="list"?>
     78      <?dbhtml list-presentation="table"?>
    7579
    76 </sect2>
     80      <varlistentry id="m4">
     81        <term><command>m4</command></term>
     82        <listitem>
     83          <para>copies the given files while expanding the macros that they
     84          contain. These macros are either built-in or user-defined and can
     85          take any number of arguments. Besides performing macro expansion,
     86          <command>m4</command> has built-in functions for including named
     87          files, running Unix commands, performing integer arithmetic,
     88          manipulating text, recursion, etc. The <command>m4</command> program
     89          can be used either as a front-end to a compiler or as a macro processor
     90          in its own right.</para>
     91          <indexterm zone="ch-system-m4 m4">
     92            <primary sortas="b-m4">m4</primary>
     93          </indexterm>
     94        </listitem>
     95      </varlistentry>
     96
     97    </variablelist>
     98
     99  </sect2>
    77100
    78101</sect1>
    79 

  • chapter06/make.xml

    r4ae4324 rbdea25ce  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-system-make" role="wrap">
    7 <title>Make-&make-version;</title>
    8 <?dbhtml filename="make.html"?>
     9  <?dbhtml filename="make.html"?>
    910
    10 <indexterm zone="ch-system-make"><primary sortas="a-Make">Make</primary></indexterm>
     11  <title>Make-&make-version;</title>
    1112
    12 <sect2 role="package"><title/>
    13 <para>The Make package contains a program for compiling packages.</para>
     13  <indexterm zone="ch-system-make">
     14    <primary sortas="a-Make">Make</primary>
     15  </indexterm>
    1416
    15 <segmentedlist>
    16 <segtitle>&buildtime;</segtitle>
    17 <segtitle>&diskspace;</segtitle>
    18 <seglistitem><seg>0.2 SBU</seg><seg>7.1 MB</seg></seglistitem>
    19 </segmentedlist>
     17  <sect2 role="package">
     18    <title/>
    2019
    21 <segmentedlist>
    22 <segtitle>&dependencies;</segtitle>
    23 <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
    24 GCC, Gettext, Glibc, Grep, and Sed</seg></seglistitem>
    25 </segmentedlist>
    26 </sect2>
     20    <para>The Make package contains a program for compiling packages.</para>
    2721
    28 <sect2 role="installation">
    29 <title>Installation of Make</title>
     22    <segmentedlist>
     23      <segtitle>&buildtime;</segtitle>
     24      <segtitle>&diskspace;</segtitle>
    3025
    31 <para>Prepare Make for compilation:</para>
     26      <seglistitem>
     27        <seg>0.2 SBU</seg>
     28        <seg>7.1 MB</seg>
     29      </seglistitem>
     30    </segmentedlist>
     31
     32    <segmentedlist>
     33      <segtitle>&dependencies;</segtitle>
     34
     35      <seglistitem>
     36        <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc,
     37        Grep, and Sed</seg>
     38      </seglistitem>
     39    </segmentedlist>
     40
     41  </sect2>
     42
     43  <sect2 role="installation">
     44    <title>Installation of Make</title>
     45
     46    <para>Prepare Make for compilation:</para>
    3247
    3348<screen><userinput>./configure --prefix=/usr</userinput></screen>
    3449
    35 <para>Compile the package:</para>
     50    <para>Compile the package:</para>
    3651
    3752<screen><userinput>make</userinput></screen>
    3853
    39 <para>To test the results, issue:
    40 <userinput>make check</userinput>.</para>
     54    <para>To test the results, issue:
     55    <userinput>make check</userinput>.</para>
    4156
    42 <para>Install the package:</para>
     57    <para>Install the package:</para>
    4358
    4459<screen><userinput>make install</userinput></screen>
    4560
    46 </sect2>
     61  </sect2>
    4762
    4863
    49 <sect2 id="contents-make" role="content"><title>Contents of Make</title>
     64  <sect2 id="contents-make" role="content">
     65    <title>Contents of Make</title>
    5066
    51 <segmentedlist>
    52 <segtitle>Installed program</segtitle>
    53 <seglistitem><seg>make</seg></seglistitem>
    54 </segmentedlist>
     67    <segmentedlist>
     68      <segtitle>Installed program</segtitle>
    5569
    56 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
    57 <?dbfo list-presentation="list"?>
    58 <?dbhtml list-presentation="table"?>
     70      <seglistitem>
     71        <seg>make</seg>
     72      </seglistitem>
     73    </segmentedlist>
    5974
    60 <varlistentry id="make">
    61 <term><command>make</command></term>
    62 <listitem>
    63 <para>Automatically determines which pieces of a package need to
    64 be (re)compiled and then issues the relevant commands</para>
    65 <indexterm zone="ch-system-make make"><primary sortas="b-make">make</primary></indexterm>
    66 </listitem>
    67 </varlistentry>
    68 </variablelist>
     75    <variablelist>
     76      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     77      <?dbfo list-presentation="list"?>
     78      <?dbhtml list-presentation="table"?>
    6979
    70 </sect2>
     80      <varlistentry id="make">
     81        <term><command>make</command></term>
     82        <listitem>
     83          <para>Automatically determines which pieces of a package need to
     84          be (re)compiled and then issues the relevant commands</para>
     85          <indexterm zone="ch-system-make make">
     86            <primary sortas="b-make">make</primary>
     87          </indexterm>
     88        </listitem>
     89      </varlistentry>
     90
     91    </variablelist>
     92
     93  </sect2>
    7194
    7295</sect1>
    73 
Note: See TracChangeset for help on using the changeset viewer.