Changeset 62a598f for prologue/why.xml


Ignore:
Timestamp:
10/15/2022 10:01:50 PM (19 months ago)
Author:
David Bryant <davidbryant@…>
Branches:
11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, bdubbs/gcc13, multilib, renodr/libudev-from-systemd, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/update-glibc
Children:
87f8108, c5d10b5
Parents:
b64efa2
Message:

Corrected grammatical errors, polished English idiom. Tried
to introduce some variety by rephrasing "This package contains ...".

File:
1 edited

Legend:

Unmodified
Added
Removed

  • prologue/why.xml

    rb64efa2 r62a598f  
    1111  <title>Rationale for Packages in the Book</title>
    1212
    13     <para>As stated earlier, the goal of LFS is to build a complete and usable
    14     foundation-level system.  This includes all packages needed to replicate
    15     itself while providing a relatively minimal base from which to customize
    16     a more complete system based on the choices of the user.  This does not
     13    <para>The goal of LFS is to build a complete and usable
     14    foundation-level system&mdash;including all the packages needed to replicate
     15    itself&mdash;and providing a relatively minimal base from which to customize
     16    a more complete system based on the user's choices.  This does not
    1717    mean that LFS is the smallest system possible.  Several important packages
    18     are included that are not strictly required.  The lists below document the
    19     rationale for each package in the book.</para>
     18    are included that are not, strictly speaking, required.  The list below documents the
     19    reasons each package in the book has been included.</para>
    2020
    2121    <itemizedlist>
    … …  
    2525
    2626        <para>This package contains utilities to administer Access
    27         Control Lists, which are used to define more fine-grained
     27        Control Lists, which are used to define fine-grained
    2828        discretionary access rights for files and directories.
    2929        </para>
    … …  
    3333        <para>Attr</para>
    3434
    35         <para>This package contains programs for administering
    36         extended attributes on filesystem objects.
     35        <para>This package contains programs for managing
     36        extended attributes on file system objects.
    3737        </para>
    3838      </listitem>
    … …  
    4141        <para>Autoconf</para>
    4242
    43         <para>This package contains programs for producing shell scripts that
     43        <para>This package supplies programs for producing shell scripts that
    4444        can automatically configure source code from a developer's
    45         template. It is often needed to rebuild a package after updates
    46         to the build procedures.</para>
     45        template. It is often needed to rebuild a package after
     46        the build procedure has been updated.</para>
    4747      </listitem>
    4848
    … …  
    5151
    5252        <para>This package contains programs for generating Make files from
    53         a template. It is often needed to rebuild a package after updates
    54         to the build procedures.</para>
     53        a template. It is often needed to rebuild a package after
     54        the build procedure has been updated.</para>
    5555      </listitem>
    5656
    … …  
    6161        a Bourne Shell interface to the system.  It was chosen over
    6262        other shell packages because of its common usage and extensive
    63         capabilities beyond basic shell functions.</para>
     63        capabilities.</para>
    6464      </listitem>
    6565
    … …  
    6868
    6969        <para>This package provides an arbitrary precision numeric processing language.
    70         It satisfies a requirement needed when building the Linux kernel.</para>
     70        It satisfies a requirement for building the Linux kernel.</para>
    7171      </listitem>
    7272
    … …  
    7474        <para>Binutils</para>
    7575
    76         <para>This package contains a linker, an assembler, and other
     76        <para>This package supplies a linker, an assembler, and other
    7777        tools for handling object files. The programs in this package are
    78         needed to compile most of the packages in an LFS system and beyond.</para>
     78        needed to compile most of the packages in an LFS system.</para>
    7979      </listitem>
    8080
    … …  
    8383
    8484        <para>This package contains the GNU version of yacc (Yet Another
    85         Compiler Compiler) needed to build several other LFS programs.</para>
     85        Compiler Compiler) needed to build several of the LFS programs.</para>
    8686      </listitem>
    8787
    … …  
    9696        <para>Check</para>
    9797
    98         <para>This package contains a test harness for other programs.</para>
     98        <para>This package provides a test harness for other programs.</para>
    9999      </listitem>
    100100
    … …  
    112112
    113113        <para>This package contains programs to implement a message bus system,
    114         which a simple way for applications to talk to one another.
     114        a simple way for applications to talk to one another.
    115115        </para>
    116116      </listitem>
    … …  
    119119        <para>DejaGNU</para>
    120120
    121         <para>This package contains a framework for testing other programs.</para>
     121        <para>This package supplies a framework for testing other programs.</para>
    122122      </listitem>
    123123
    … …  
    133133        <para>E2fsprogs</para>
    134134
    135         <para>This package contains the utilities for handling the ext2, ext3
     135        <para>This package supplies utilities for handling the ext2, ext3
    136136        and ext4 file systems.  These are the most common and thoroughly
    137137        tested file systems that Linux supports.</para>
    … …  
    142142
    143143        <para>This package is a device manager.  It dynamically controls the ownership,
    144         permissions, names, and symbolic links of devices in the /dev directory as
    145         devices are added or removed from the system.
     144        permissions, names, and symbolic links of devices in the /dev directory when
     145        devices are added to or removed from the system.
    146146        </para>
    147147      </listitem>
    … …  
    150150        <para>Expat</para>
    151151
    152         <para>This package contains a relatively small XML parsing library.  It
     152        <para>This package yields a relatively small XML parsing library.  It
    153153        is required by the XML::Parser Perl module.</para>
    154154      </listitem>
    … …  
    172172        <para>Findutils</para>
    173173
    174         <para>This package contains programs to find files in a file system.
     174        <para>This package provides programs to find files in a file system.
    175175        It is used in many packages' build scripts.</para>
    176176      </listitem>
    … …  
    188188        <para>Gawk</para>
    189189
    190         <para>This package contains programs for manipulating text files.
     190        <para>This package supplies programs for manipulating text files.
    191191        It is the GNU version of awk (Aho-Weinberg-Kernighan). It is used in
    192192        many other packages' build scripts.</para>
    … …  
    196196        <para>GCC</para>
    197197
    198         <para>This package is the Gnu Compiler Collection.  It contains the
     198        <para>This is the Gnu Compiler Collection.  It contains the
    199199        C and C++ compilers as well as several others not built by LFS.
    200200        </para>
    … …  
    211211        <para>Gettext</para>
    212212
    213         <para>This package contains utilities and libraries for
    214         internationalization and localization of numerous packages.</para>
     213        <para>This package provides utilities and libraries for
     214        the internationalization and localization of many packages.</para>
    215215      </listitem>
    216216
    … …  
    225225        <para>GMP</para>
    226226
    227         <para>This package contains math libraries that provide useful functions
    228         for arbitrary precision arithmetic.  It is required to build GCC.</para>
     227        <para>This package supplies math libraries that provide useful functions
     228        for arbitrary precision arithmetic.  It is needed to build GCC.</para>
    229229      </listitem>
    230230
    … …  
    232232        <para>Gperf</para>
    233233
    234         <para>This package contains a program that generates a perfect hash
    235         function from a key set. It is required for Eudev.</para>
     234        <para>This package produces a program that generates a perfect hash
     235        function from a set of keys. It is required by Eudev.</para>
    236236      </listitem>
    237237
    … …  
    246246        <para>Groff</para>
    247247
    248         <para>This package contains programs for processing and formatting text.
     248        <para>This package contributes programs for processing and formatting text.
    249249        One important function of these programs is to format man pages.</para>
    250250      </listitem>
    … …  
    253253        <para>GRUB</para>
    254254
    255         <para>This package is the Grand Unified Boot Loader.  It is one
    256         of several boot loaders available, but is the most flexible.
     255        <para>This is the Grand Unified Boot Loader.  It is
     256        the most flexible of several boot loaders available.
    257257        </para>
    258258      </listitem>
    … …  
    262262
    263263        <para>This package contains programs for compressing and
    264         decompressing files. It is needed to decompress many packages in LFS
    265         and beyond.</para>
     264        decompressing files. It is needed to decompress many packages
     265        in LFS.</para>
    266266      </listitem>
    267267
    … …  
    276276        <para>Inetutils</para>
    277277
    278         <para>This package contains programs for basic network
     278        <para>This package supplies programs for basic network
    279279        administration.</para>
    280280      </listitem>
    … …  
    283283        <para>Intltool</para>
    284284
    285         <para>This package contains tools for extracting translatable
     285        <para>This package contributes tools for extracting translatable
    286286        strings from source files.</para>
    287287      </listitem>
    … …  
    305305        <para>Kbd</para>
    306306
    307         <para>This package contains key-table files, keyboard utilities
     307        <para>This package produces key-table files, keyboard utilities
    308308        for non-US keyboards, and a number of console fonts.</para>
    309309      </listitem>
    … …  
    312312        <para>Kmod</para>
    313313
    314         <para>This package contains programs needed to administer Linux
     314        <para>This package supplies programs needed to administer Linux
    315315        kernel modules.</para>
    316316      </listitem>
    … …  
    320320
    321321        <para>This package contains a very nice text file viewer that
    322         allows scrolling up or down when viewing a file. It is also used by
    323         Man-DB for viewing manpages.</para>
     322        allows scrolling up or down when viewing a file. It is also used
     323        when viewing manpages.</para>
    324324      </listitem>
    325325
    … …  
    358358        <para>Libpipeline</para>
    359359
    360         <para>The Libpipeline package contains a library for manipulating
     360        <para>The Libpipeline package supplies a library for manipulating
    361361        pipelines of subprocesses in a flexible and convenient way. It is
    362362        required by the Man-DB package.</para>
    … …  
    367367
    368368        <para>This package contains the GNU generic library support
    369         script. It wraps the complexity of using shared libraries in a
     369        script. It wraps the complexity of using shared libraries into a
    370370        consistent, portable interface.  It is needed by the test
    371371        suites in other LFS packages.</para>
    … …  
    382382        <para>M4</para>
    383383
    384         <para>This package contains a general text macro processor useful
     384        <para>This package provides a general text macro processor useful
    385385        as a build tool for other programs.</para>
    386386      </listitem>
    … …  
    405405        <para>This package contains programs for finding and viewing man pages.
    406406        It was chosen instead of the <application>man</application> package
    407         due to superior internationalization capabilities.  It supplies
     407        because of its superior internationalization capabilities.  It supplies
    408408        the man program.</para>
    409409      </listitem>
    … …  
    412412        <para>Man-pages</para>
    413413
    414         <para>This package contains the actual contents of the basic
     414        <para>This package provides the actual contents of the basic
    415415        Linux man pages.</para>
    416416      </listitem>
    … …  
    420420
    421421        <para>This package provides a software tool for automating the building
    422         of software. The main goal for Meson is to minimize the amount of time
    423         that software developers need to spend configuring their build
     422        of software. The main goal of Meson is to minimize the amount of time
     423        that software developers need to spend configuring a build
    424424        system.  It's required to build Systemd, as well as many BLFS
    425425        packages.</para>
    … …  
    430430        <para>MPC</para>
    431431
    432         <para>This package contains functions for the arithmetic of complex
     432        <para>This package supplies arithmetic functions for complex
    433433        numbers. It is required by GCC.</para>
    434434      </listitem>
    … …  
    444444        <para>Ninja</para>
    445445
    446         <para>This package contains a small build system with a focus on speed.
     446        <para>This package furnishes a small build system with a focus on speed.
    447447        It is designed to have its input files generated by a higher-level build
    448448        system, and to run builds as fast as possible.
    … …  
    457457        handling of character screens.  It is often used to provide
    458458        cursor control for a menuing system. It is needed by a number of
    459         packages in LFS.</para>
     459        the packages in LFS.</para>
    460460      </listitem>
    461461
    … …  
    464464
    465465        <para>This package provides management tools and libraries relating to
    466         cryptography. These are useful for providing cryptographic functions to
     466        cryptography. These supply cryptographic functions to
    467467        other packages, including the Linux kernel.</para>
    468468      </listitem>
    … …  
    503503        <para>Psmisc</para>
    504504
    505         <para>This package contains programs for displaying information
     505        <para>This package produces programs for displaying information
    506506        about running processes. These programs are useful for system
    507507        administration.</para>
    … …  
    512512
    513513        <para>This package provides an interpreted language that has a design
    514         philosophy that emphasizes code readability.</para>
     514        philosophy emphasizing code readability.</para>
    515515
    516516      </listitem>
    … …  
    519519        <para>Readline</para>
    520520
    521         <para>This package is a set of libraries that offers command-line
     521        <para>This package is a set of libraries that offer command-line
    522522        editing and history capabilities.  It is used by Bash.</para>
    523523      </listitem>
    … …  
    527527
    528528        <para>This package allows editing of text without opening it in a
    529         text editor. It is also needed by most LFS packages' configure
     529        text editor. It is also needed by many LFS packages' configure
    530530        scripts.</para>
    531531      </listitem>
    … …  
    535535
    536536        <para>This package contains programs for handling passwords
    537         in a secure way.</para>
     537        securely.</para>
    538538      </listitem>
    539539
    … …  
    541541        <para>Sysklogd</para>
    542542
    543         <para>This package contains programs for logging system messages,
    544         such as those given by the kernel or daemon processes when unusual
     543        <para>This package supplies programs for logging system messages,
     544        such as those emitted by the kernel or daemon processes when unusual
    545545        events occur.</para>
    546546      </listitem>
    … …  
    551551        <para>This package provides an <application>init</application> program
    552552        and several additional boot and system control capabilities as an
    553         alternative to Sysvinit.  It is used by many commercial distributions.
     553        alternative to Sysvinit.  It is used by many Linux distributions.
    554554        </para>
    555555      </listitem>
    … …  
    559559
    560560        <para>This package provides the <application>init</application>
    561         program, which is the parent of all other processes on the Linux
     561        program, the parent of all the other processes on a running Linux
    562562        system. </para>
    563563      </listitem>
    … …  
    567567
    568568        <para>This package provides archiving and extraction capabilities
    569         of virtually all packages used in LFS.</para>
     569        of virtually all the packages used in LFS.</para>
    570570      </listitem>
    571571
    … …  
    574574
    575575        <para>This package contains the Tool Command Language used
    576         in many test suites in LFS packages.</para>
     576        in many test suites.</para>
    577577      </listitem>
    578578
    … …  
    580580        <para>Texinfo</para>
    581581
    582         <para>This package contains programs for reading, writing, and
     582        <para>This package supplies programs for reading, writing, and
    583583        converting info pages.  It is used in the installation
    584584        procedures of many LFS packages.</para>
    … …  
    594594
    595595      <listitem>
    596         <para>Wheel</para>
    597 
    598         <para>This package contains a Python module that is the
    599         reference implementation of the Python wheel packaging standard.
    600         </para>
    601       </listitem>
    602 
    603       <listitem>
    604596        <para>Vim</para>
    605597
    606         <para>This package contains an editor. It was chosen because of its
     598        <para>This package provides an editor. It was chosen because of its
    607599        compatibility with the classic vi editor and its huge number of powerful
    608600        capabilities.  An editor is a very personal choice for
    609         many users and any other editor could be substituted if desired.</para>
     601        many users. Any other editor can be substituted, if you wish.</para>
     602      </listitem>
     603     
     604      <listitem>
     605        <para>Wheel</para>
     606
     607        <para>This package supplies a Python module that is the
     608        reference implementation of the Python wheel packaging standard.
     609        </para>
    610610      </listitem>
    611611
    … …  
    634634        <para>Zstd</para>
    635635
    636         <para>This package contains compression and decompression routines
     636        <para>This package supplies compression and decompression routines
    637637        used by some programs. It provides high compression ratios and a very
    638638        wide range of compression / speed trade-offs.</para>
Note: See TracChangeset for help on using the changeset viewer.