glfs/general/genlib/boost.xml

<?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_1_49_0.tar.bz2">
  <!ENTITY boost-download-ftp  " ">
  <!ENTITY boost-md5sum        "0d202cb811f934282dea64856a175698">
  <!ENTITY boost-size          "47 MB">
  <!ENTITY boost-buildsize     "764 MB for default build - 634MB without static libs">
  <!ENTITY boost-time          "10 SBU for default build - 5.5 SBU without static libs">
]>

<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 free peer-reviewed
    portable C++ source libraries.</para>

    &lfs70_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">Additional Downloads</bridgehead>
    <itemizedlist spacing='compact'>
      <listitem>
        <para>Required patch: <ulink
        url="&patch-root;/boost-&boost-version;-fixes-1.patch"/></para>
      </listitem>
    </itemizedlist>
-->
    <bridgehead renderas="sect3">boost Dependencies</bridgehead>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="Optional">
    <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 as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>./bootstrap.sh --prefix=/usr &amp;&amp;
./b2 install link=shared</userinput></screen>

  </sect2>

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

    <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 Program</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directory</segtitle>

      <seglistitem>
        <seg>None</seg>
        <seg>libboost_{chrono, date_time, filesystem, graph, iostreams, locale, math_*,
        prg_exec_monitor, program_options, python, random, regex, serialization,
        signals, system, thread, unit_test_framework,
        wave, wserialization}.{so,a}, libboost_exception.a, libboost_test_monitor.a</seg>
        <seg>/usr/include/boost</seg>
      </seglistitem>
    </segmentedlist>
<!--
    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="a-automoc4">
        <term><command>automoc4</command></term>
        <listitem>
          <para>is a testing utility for boost-generated build trees.</para>
          <indexterm zone="a-automoc4 automoc4">
            <primary sortas="b-automoc4">automoc4</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>
-->
  </sect2>

</sect1>