source: general/genlib/boost.xml@ 8aeb474

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY boost-download-http "&sourceforge-repo;/boost/boost_&boost-dl-version;.tar.bz2">
  <!ENTITY boost-download-ftp  " ">
  <!ENTITY boost-md5sum        "4b6bd483b692fd138aef84ed2c8eb679">
  <!ENTITY boost-size          "49 MB">
  <!ENTITY boost-buildsize     "640 MB">
  <!ENTITY boost-time          "3.5 SBU">
]>

<sect1 id="boost" xreflabel="Boost-&boost-version;">
  <?dbhtml filename="boost.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>Boost-&boost-version;</title>

  <indexterm zone="boost">
    <primary sortas="a-Boost">Boost</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Boost</title>

    <para>
      <application>Boost</application> provides a set of free peer-reviewed
      portable C++ source libraries. It includes libraries for linear algebra,
      pseudorandom number generation, multithreading, image processing, regular
      expressions and unit testing.
    </para>

    &lfs72_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&boost-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&boost-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &boost-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &boost-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &boost-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &boost-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Boost Dependencies</bridgehead>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="Optional">
      <xref linkend="icu"/> and
      <xref linkend="python2"/>
    </para>

    <para condition="html" role="usernotes">User Notes:
      <ulink url="&blfs-wiki;/boost"/>
    </para>
  </sect2>

  <sect2 role="installation">
    <title>Installation of Boost</title>

    <para>
      Install <application>Boost</application> by running the following
      commands:
    </para>

<screen><userinput>./bootstrap.sh --prefix=/usr &amp;&amp;
./b2 stage threading=multi link=shared</userinput></screen>

    <para>
      This package does not come with a test suite.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>./b2 install threading=multi link=shared</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <parameter>threading=multi</parameter>: This parameter ensures that
      <application>Boost</application> is built with multithreading support.
    </para>

    <para>
      <parameter>link=shared</parameter>: This parameter ensures that only shared
      libraries are created, except for libboost_exception and libboost_test_exec_monitor
      which are created as static. Most people will not need the static libraries, indeed
      most programs using boost only use the headers, but omit this parameter if you
      do need them.
    </para>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directory</segtitle>

      <seglistitem>
        <seg>
          libboost_chrono.so, libboost_date_time.so, libboost_exception.a,
          libboost_filesystem.so, libboost_graph.so, libboost_iostreams.so,
          libboost_locale.so, libboost_math_c99f.so, libboost_math_c99l.so,
          libboost_math_c99.so, libboost_math_tr1f.so,
          libboost_math_tr1l.so, libboost_math_tr1.so,
          libboost_prg_exec_monitor.so, libboost_program_options.so,
          libboost_python.so, libboost_random.so, libboost_regex.so,
          libboost_serialization.so, libboost_signals.so,
          libboost_system.so, libboost_test_exec_monitor.a,
          libboost_thread.so, libboost_timer.so, libboost_unit_test_framework.so,
          libboost_wave.so and libboost_wserialization.so
        </seg>
        <seg>
          /usr/include/boost
        </seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

</sect1>