source: general/genlib/boost.xml@ d7b3aab

11.0 qt5new trunk
Last change on this file since d7b3aab was d7b3aab, checked in by Bruce Dubbs <bdubbs@…>, 5 months ago

Update to boost_1_76_0.

  • Property mode set to 100644
File size: 7.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY boost-download-http "https://dl.bintray.com/boostorg/release/&boost-version;/source/boost_&boost-dl-version;.tar.bz2">
8 <!ENTITY boost-download-ftp " ">
9 <!ENTITY boost-md5sum "33334dd7f862e8ac9fe1cc7c6584fb6d">
10 <!ENTITY boost-size "105 MB">
11 <!ENTITY boost-buildsize "1.0 GB (180 MB installed)">
12 <!ENTITY boost-time "1.4 SBU (Using parallelism=4; add 1.3 SBU for tests)">
13]>
14
15<sect1 id="boost" xreflabel="Boost-&boost-version;">
16 <?dbhtml filename="boost.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>Boost-&boost-version;</title>
23
24 <indexterm zone="boost">
25 <primary sortas="a-Boost">Boost</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to Boost</title>
30
31 <para>
32 <application>Boost</application> provides a set of free peer-reviewed
33 portable C++ source libraries. It includes libraries for linear algebra,
34 pseudorandom number generation, multithreading, image processing, regular
35 expressions and unit testing.
36 </para>
37
38 &lfs101_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&boost-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&boost-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &boost-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &boost-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &boost-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &boost-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73 <!--
74 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
75 <itemizedlist spacing="compact">
76 <listitem>
77 <para>
78 Recommended patch, required to build <xref linkend="libreoffice"/>:
79 <ulink url="&patch-root;/boost-&boost-version;-gcc_10-1.patch"/>
80 </para>
81 </listitem>
82 </itemizedlist>
83 -->
84
85 <bridgehead renderas="sect3">Boost Dependencies</bridgehead>
86
87 <bridgehead renderas="sect4">Recommended</bridgehead>
88 <para role="recommended">
89 <xref linkend="which"/>
90 </para>
91
92 <bridgehead renderas="sect4">Optional</bridgehead>
93 <para role="optional">
94 <xref linkend="icu"/> and
95 <ulink url="https://www.open-mpi.org/">Open MPI</ulink>
96 </para>
97
98 <para condition="html" role="usernotes">User Notes:
99 <ulink url="&blfs-wiki;/boost"/>
100 </para>
101 </sect2>
102
103 <sect2 role="installation">
104 <title>Installation of Boost</title>
105
106 <para>
107 This package can be built with several jobs running in parallel. In
108 the instructions below, <parameter>&lt;N&gt;</parameter> stands for the
109 number of jobs. Install <application>Boost</application> by running the
110 following commands:
111 </para>
112
113
114<screen><userinput>./bootstrap.sh --prefix=/usr --with-python=python3 &amp;&amp;
115./b2 stage -j<replaceable>&lt;N&gt;</replaceable> threading=multi link=shared</userinput></screen>
116
117 <para>
118 To run the Boost.Build's regression test, issue
119 <command>pushd tools/build/test; python3 test_all.py; popd</command>.
120 All 154 tests should pass.
121 </para>
122
123 <para>
124 To run every library's regression tests, issue <command>pushd status;
125 ../b2; popd</command>. A few tests may fail. They take a very long time
126 (over 119 SBU at -j4) and use a very large amount of disk space
127 (46 GB). You should use the <parameter>-jN</parameter> switch to
128 speed them up.
129 </para>
130
131 <para>
132 Now, as the <systemitem class="username">root</systemitem> user:
133 </para>
134
135<!-- dev note: ./b2 - -prefix=<DESTDIR>/usr install threading=multi link=shared -->
136
137<screen role="root"><userinput>./b2 install threading=multi link=shared <!-- &amp;&amp;
138 ln -svf detail/sha1.hpp /usr/include/boost/uuid/sha1.hpp--></userinput></screen>
139
140 </sect2>
141
142 <sect2 role="commands">
143 <title>Command Explanations</title>
144
145 <para>
146 <parameter>threading=multi</parameter>: This parameter ensures that
147 <application>Boost</application> is built with multithreading support.
148 </para>
149
150 <para>
151 <parameter>link=shared</parameter>: This parameter ensures that only
152 shared libraries are created, except for libboost_exception and
153 libboost_test_exec_monitor which are created as static. Most people
154 will not need the static libraries, and most programs using
155 <application>Boost</application> only use the headers. Omit
156 this parameter if you do need static libraries.
157 </para>
158
159 <para>
160 <option>-jN</option>: This switch may be added to the
161 <command>b2</command> command lines, to run up to N processes in
162 parallel.
163 </para>
164
165 <para>
166 <option>--with-python=python3</option>: Add this switch to the <command>
167 bootstrap</command> command, if you want Boost
168 to use Python3 instead of Python2. Using Python3 is known to cause the
169 installation to fail on some systems.
170 </para>
171
172 </sect2>
173
174 <sect2 role="content">
175 <title>Contents</title>
176
177 <segmentedlist>
178 <segtitle>Installed Programs</segtitle>
179 <segtitle>Installed Libraries</segtitle>
180 <segtitle>Installed Directory</segtitle>
181
182 <seglistitem>
183 <seg>
184 None
185 </seg>
186 <seg>
187 libboost_atomic.so, libboost_chrono.so, libboost_container.so,
188 libboost_context.so, libboost_contract.so, libboost_coroutine.so,
189 libboost_date_time.so, libboost_exception.a, libboost_fiber.so,
190 libboost_filesystem.so,
191 libboost_graph.so, libboost_iostreams.so, libboost_locale.so,
192 libboost_log_setup.so, libboost_log.so, libboost_math_c99.so,
193 libboost_math_c99f.so, libboost_math_c99l.so, libboost_math_tr1.so,
194 libboost_math_tr1f.so, libboost_math_tr1l.so,
195 libboost_nowide.so,
196 libboost_prg_exec_monitor.so, libboost_program_options.so,
197 libboost_python3&python3-minor;.so, libboost_random.so,
198 libboost_regex.so, libboost_serialization.so,
199 libboost_stacktrace_addr2line.so, libboost_stacktrace_basic.so,
200 libboost_stacktrace_noop.so, libboost_system.so,
201 libboost_test_exec_monitor.a, libboost_thread.so, libboost_timer.so,
202 libboost_type_erasure.so, libboost_unit_test_framework.so,
203 libboost_wave.so, and libboost_wserialization.so
204 </seg>
205 <seg>
206 /usr/include/boost
207 </seg>
208 </seglistitem>
209 </segmentedlist>
210
211 </sect2>
212
213</sect1>
Note: See TracBrowser for help on using the repository browser.