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

Format general libraries

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/genlib/pth.xml

    rddc634b rd56e7df  
    3030    <title>Introduction to Pth</title>
    3131
    32     <para>The <application>Pth</application> package contains a very portable
    33     POSIX/ANSI-C based library for Unix platforms which provides non-preemptive
    34     priority-based scheduling for multiple threads of execution (multithreading)
    35     inside event-driven applications. All threads run in the same address space
    36     of the server application, but each thread has its own individual
    37     program-counter, run-time stack, signal mask and errno variable. </para>
     32    <para>
     33      The <application>Pth</application> package contains a very portable
     34      POSIX/ANSI-C based library for Unix platforms which provides
     35      non-preemptive priority-based scheduling for multiple threads of
     36      execution (multithreading) inside event-driven applications. All
     37      threads run in the same address space of the server application, but
     38      each thread has its own individual program-counter, run-time stack,
     39      signal mask and errno variable.
     40    </para>
    3841
    3942    &lfs91_checked;
    … …  
    4245    <itemizedlist spacing="compact">
    4346      <listitem>
    44         <para>Download (HTTP): <ulink url="&pth-download-http;"/></para>
     47        <para>
     48          Download (HTTP): <ulink url="&pth-download-http;"/>
     49        </para>
    4550      </listitem>
    4651      <listitem>
    47         <para>Download (FTP): <ulink url="&pth-download-ftp;"/></para>
     52        <para>
     53          Download (FTP): <ulink url="&pth-download-ftp;"/>
     54        </para>
    4855      </listitem>
    4956      <listitem>
    50         <para>Download MD5 sum: &pth-md5sum;</para>
     57        <para>
     58          Download MD5 sum: &pth-md5sum;
     59        </para>
    5160      </listitem>
    5261      <listitem>
    53         <para>Download size: &pth-size;</para>
     62        <para>
     63          Download size: &pth-size;
     64        </para>
    5465      </listitem>
    5566      <listitem>
    56         <para>Estimated disk space required: &pth-buildsize;</para>
     67        <para>
     68          Estimated disk space required: &pth-buildsize;
     69        </para>
    5770      </listitem>
    5871      <listitem>
    59         <para>Estimated build time: &pth-time;</para>
     72        <para>
     73          Estimated build time: &pth-time;
     74        </para>
    6075      </listitem>
    6176    </itemizedlist>
    … …  
    6984
    7085    <caution>
    71       <para>Don't add the <option>--enable-pthread</option> parameter to the
    72       <command>configure</command> command below else you will overwrite the
    73       pthread library and interface header installed by the
    74       <application>Glibc</application> package in LFS.</para>
     86      <para>
     87        Don't add the <option>--enable-pthread</option> parameter to the
     88        <command>configure</command> command below else you will overwrite the
     89        pthread library and interface header installed by the
     90        <application>Glibc</application> package in LFS.
     91      </para>
    7592    </caution>
    7693
    77     <para>Install <application>Pth</application> by running the
    78     following commands:</para>
     94    <para>
     95      Install <application>Pth</application> by running the
     96      following commands:
     97    </para>
    7998
    8099<screen><userinput>sed -i 's#$(LOBJS): Makefile#$(LOBJS): pth_p.h Makefile#' Makefile.in &amp;&amp;
    … …  
    84103make</userinput></screen>
    85104
    86     <para>To test the results, issue: <command>make test</command>.</para>
     105    <para>
     106      To test the results, issue: <command>make test</command>.
     107    </para>
    87108
    88     <para>Now, as the <systemitem class="username">root</systemitem>
    89     user:</para>
     109    <para>
     110      Now, as the <systemitem class="username">root</systemitem>
     111      user:
     112    </para>
    90113
    91114<screen role="root"><userinput>make install &amp;&amp;
    … …  
    98121    <title>Command Explanations</title>
    99122
    100     <para><command>sed -i 's#$(LOBJS) ...</command>: This <command>sed</command>
    101     fixes a race condition in the <filename>Makefile</filename>. It allows you
    102     to run <command>make</command> with multiple jobs (e.g., <command>make -j4</command>)
    103     <!-- how ironic that a package for using multiple threads has this bug in
    104     its Makefile -->.</para>
     123    <para>
     124      <command>sed -i 's#$(LOBJS) ...</command>: This <command>sed</command>
     125      fixes a race condition in the <filename>Makefile</filename>. It allows
     126      running <command>make</command> with multiple jobs (e.g., <command>make
     127      -j4</command>).
     128      <!-- how ironic that a package for using multiple threads has this bug in
     129      its Makefile -->
     130    </para>
    105131
    106132    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    107133      href="../../xincludes/static-libraries.xml"/>
    108134
    109     <para><parameter>--mandir=/usr/share/man</parameter>: This switch puts the
    110     man pages in <filename class="directory">/usr/share/man</filename> instead
    111     of <filename class="directory">/usr/man</filename>.</para>
     135    <para>
     136      <parameter>--mandir=/usr/share/man</parameter>: This switch puts the
     137      man pages in <filename class="directory">/usr/share/man</filename> instead
     138      of <filename class="directory">/usr/man</filename>.
     139    </para>
    112140  </sect2>
    113141
    … …  
    135163        <term><command>pth-config</command></term>
    136164        <listitem>
    137           <para>is a utility used to configure and build applications based on
    138           the pth(3) library. It can be used to query the C compiler and
    139           linker flags which are required to correctly compile and link the
    140           application against the pth(3) library.</para>
     165          <para>
     166            is a utility used to configure and build applications based on
     167            the pth(3) library. It can be used to query the C compiler and
     168            linker flags which are required to correctly compile and link the
     169            application against the pth(3) library.
     170          </para>
    141171          <indexterm zone="pth pth-config">
    142172            <primary sortas="b-pth-config">pth-config</primary>
    … …  
    148178        <term><filename class="libraryfile">libpth.so</filename></term>
    149179        <listitem>
    150           <para>contains the API functions used by the GNU Portable Threads
    151           Library.</para>
     180          <para>
     181            contains the API functions used by the GNU Portable Threads
     182            Library.
     183          </para>
    152184          <indexterm zone="pth libpth">
    153185            <primary sortas="c-libpth">libpth.so</primary>
Note: See TracChangeset for help on using the changeset viewer.