source: general/genlib/boost.xml@ 059e4c3

10.0 10.1 11.0 11.1 11.2 9.1 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 059e4c3 was 059e4c3, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Update to ibus-1.5.21.
Update to boost-1.71.0.
Update to poppler-0.80.0.
Update to babl-0.1.72.

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

  • Property mode set to 100644
File size: 7.4 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 "4cdf9b5c2dc01fb2b7b733d5af30e558">
10 <!ENTITY boost-size "95 MB">
11 <!ENTITY boost-buildsize "943 MB (168 MB installed)">
12 <!ENTITY boost-time "1.5 SBU (Using parallelism=4; add 1.1 SBU for tests)">
13]>
14
15<sect1 id="boost" xreflabel="Boost-&boost-version;">
16 <?dbhtml filename="boost.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Boost-&boost-version;</title>
24
25 <indexterm zone="boost">
26 <primary sortas="a-Boost">Boost</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Boost</title>
31
32 <para>
33 <application>Boost</application> provides a set of free peer-reviewed
34 portable C++ source libraries. It includes libraries for linear algebra,
35 pseudorandom number generation, multithreading, image processing, regular
36 expressions and unit testing.
37 </para>
38
39 &lfs90_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&boost-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&boost-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &boost-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &boost-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &boost-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &boost-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">Boost Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Recommended</bridgehead>
78 <para role="recommended">
79 <xref linkend="which"/>
80 </para>
81
82 <bridgehead renderas="sect4">Optional</bridgehead>
83 <para role="optional">
84 <xref linkend="icu"/>,
85 <xref linkend="python2"/>, and
86 <ulink url="https://www.open-mpi.org/">Open MPI</ulink>
87 </para>
88
89 <para condition="html" role="usernotes">User Notes:
90 <ulink url="&blfs-wiki;/boost"/>
91 </para>
92 </sect2>
93
94 <sect2 role="installation">
95 <title>Installation of Boost</title>
96<!--
97 <para>
98 First, fix a bug with the header files path, when Python3 is used:
99 </para>
100
101<screen><userinput>sed -e '/using python/ s@;@: /usr/include/python${PYTHON_VERSION/3*/${PYTHON_VERSION}m} ;@' \
102 -i bootstrap.sh</userinput></screen>
103-->
104 <para>
105 Install <application>Boost</application> by running the following
106 commands:
107 </para>
108
109
110<screen><userinput>./bootstrap.sh --prefix=/usr &amp;&amp;
111./b2 stage threading=multi link=shared</userinput></screen>
112
113 <para>
114 To run the Boost.Build's regression test, <xref linkend="python2"/>
115 is required.
116 Run the tests with: issue <command>pushd tools/build/test;
117 python test_all.py; popd</command>.
118 All 152 tests should pass.
119 </para>
120
121 <para>
122 To run every library's regression tests, issue <command>pushd status;
123 ../b2; popd</command>. A few tests may fail. They take a very long time
124 (over 119 SBU at -j4) and use a very large amount of disk space
125 (46 GB). You should use the <parameter>-jN</parameter> switch to
126 speed them up.
127 </para>
128
129 <para>
130 Now, as the <systemitem class="username">root</systemitem> user:
131 </para>
132
133<!-- dev note: ./b2 - -prefix=<DESTDIR>/usr install threading=multi link=shared -->
134
135<screen role="root"><userinput>./b2 install threading=multi link=shared &amp;&amp;
136ln -svf detail/sha1.hpp /usr/include/boost/uuid/sha1.hpp</userinput></screen>
137
138 </sect2>
139
140 <sect2 role="commands">
141 <title>Command Explanations</title>
142
143 <para>
144 <parameter>threading=multi</parameter>: This parameter ensures that
145 <application>Boost</application> is built with multithreading support.
146 </para>
147
148 <para>
149 <parameter>link=shared</parameter>: This parameter ensures that only
150 shared libraries are created, except for libboost_exception and
151 libboost_test_exec_monitor which are created as static. Most people
152 will not need the static libraries, and most programs using
153 <application>Boost</application> only use the headers. Omit
154 this parameter if you do need static libraries.
155 </para>
156
157 <para>
158 <parameter>ln -svf detail/sha1.hpp ...</parameter>: The
159 <filename>uuid/sha1.hpp</filename> used to be a regular header, but by
160 boost_1_66_0 it had been changed to load the similar
161 <filename>detail/sha1.hpp</filename> header, with a message that it had
162 been deprecated. It has now been removed, but not every package which uses
163 it has been changed. An example is one of the libraries downloaded as a
164 git version by libreoffice. The symlink enables this and similar packages
165 to build.
166 </para>
167
168 <para>
169 <option>-jN</option>: This switch may be added to the
170 <command>b2</command> command lines, to run up to N processes in
171 parallel.
172 </para>
173
174 <para>
175 <option>--with-python=python3</option>: Add this switch to the <command>
176 bootstrap</command> command, if you want Boost
177 to use Python3 instead of Python2. Using Python3 is known to cause the
178 installation to fail on some systems.
179 </para>
180
181 </sect2>
182
183 <sect2 role="content">
184 <title>Contents</title>
185
186 <segmentedlist>
187 <segtitle>Installed Programs</segtitle>
188 <segtitle>Installed Libraries</segtitle>
189 <segtitle>Installed Directory</segtitle>
190
191 <seglistitem>
192 <seg>
193 None
194 </seg>
195 <seg>
196 libboost_atomic.so, libboost_chrono.a, libboost_chrono.so,
197 libboost_container.so, libboost_context.so, libboost_coroutine.so,
198 libboost_date_time.so, libboost_exception.a, libboost-fiber.so,
199 libboost_filesystem.so,
200 libboost_graph.so, libboost_iostreams.so, libboost_locale.so,
201 libboost_log_setup.so, libboost_log.so, libboost_math_c99.so,
202 libboost_math_c99f.so, libboost_math_c99l.so, libboost_math_tr1.so,
203 libboost_math_tr1f.so, libboost_math_tr1l.so,
204 libboost_prg_exec_monitor.so, libboost_program_options.so,
205 libboost_python27.so or libboost_python3.so, libboost_random.so,
206 libboost_regex.so, libboost_serialization.so, libboost_signals.so,
207 libboost_stacktrace_addr2line.so, libboost_stacktrace_basic.so,
208 libboost_stacktrace_noop.so,
209 libboost_system.a, libboost_system.so, libboost_test_exec_monitor.a,
210 libboost_thread.so, libboost_timer.a, libboost_timer.so,
211 libboost_type_erasure.so,
212 libboost_unit_test_framework.so,
213 libboost_wave.so, and libboost_wserialization.so
214 </seg>
215 <seg>
216 /usr/include/boost
217 </seg>
218 </seglistitem>
219 </segmentedlist>
220
221 </sect2>
222
223</sect1>
Note: See TracBrowser for help on using the repository browser.