source: general/genlib/boost.xml@ eab496c5

10.0 10.1 11.0 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since eab496c5 was eab496c5, checked in by Bruce Dubbs <bdubbs@…>, 4 years ago

Update to pycairo-1.16.2
Tag python modules and dependencies

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

  • Property mode set to 100644
File size: 6.8 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 "b2dfbd6c717be4a7bb2d88018eaccf75">
10 <!ENTITY boost-size "82 MB">
11 <!ENTITY boost-buildsize "875 MB (add 2 MB for checks)">
12 <!ENTITY boost-time "1.2 SBU (using -j4; add 2.2 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 &lfs82_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). In addition, one file needs to be renamed
116 to avoid a conflict with a standard python module.
117 Run the tests with: issue <command>pushd tools/build/test;
118 mv zlib.py zlib.py-orig; python test_all.py; popd</command>.
119 All 133 tests should pass.
120 </para>
121
122 <para>
123 To run every library's regression tests, issue <command>pushd status;
124 ../b2; popd</command>. A few tests may fail. They take very long (over
125 120 SBU at -j1, 50 SBU at -j4) and use a very large amount of disk space
126 (up to 40 GB). You can use the <parameter>-jN</parameter> switch to
127 speed them up.
128 </para>
129
130 <para>
131 Now, as the <systemitem class="username">root</systemitem> user:
132 </para>
133
134<!-- dev note: ./b2 - -prefix=<DESTDIR>/usr install threading=multi link=shared -->
135
136<screen role="root"><userinput>./b2 install threading=multi link=shared</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. Indeed 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 <option>-jN</option>: This switch may be added to the
159 <command>b2</command> command lines, to run up to N processes in
160 parallel.
161 </para>
162
163 <para>
164 <option>--with-python=python3</option>: Add this switch to the <command>
165 bootstrap</command> command, if you want Boost
166 to use Python3 instead of Python2.
167 </para>
168
169 </sect2>
170
171 <sect2 role="content">
172 <title>Contents</title>
173
174 <segmentedlist>
175 <segtitle>Installed Programs</segtitle>
176 <segtitle>Installed Libraries</segtitle>
177 <segtitle>Installed Directory</segtitle>
178
179 <seglistitem>
180 <seg>
181 None
182 </seg>
183 <seg>
184 libboost_atomic.so, libboost_chrono.a, libboost_chrono.so,
185 libboost_container.so, libboost_context.so, libboost_coroutine.so,
186 libboost_date_time.so, libboost_exception.a, libboost-fiber.so,
187 libboost_filesystem.so,
188 libboost_graph.so, libboost_iostreams.so, libboost_locale.so,
189 libboost_log_setup.so, libboost_log.so, libboost_math_c99.so,
190 libboost_math_c99f.so, libboost_math_c99l.so, libboost_math_tr1.so,
191 libboost_math_tr1f.so, libboost_math_tr1l.so,
192 libboost_prg_exec_monitor.so, libboost_program_options.so,
193 libboost_python.so or libboost_python3.so, libboost_random.so,
194 libboost_regex.so, libboost_serialization.so, libboost_signals.so,
195 libboost_stacktrace_addr2line.so, libboost_stacktrace_basic.so,
196 libboost_stacktrace_noop.so,
197 libboost_system.a, libboost_system.so, libboost_test_exec_monitor.a,
198 libboost_thread.so, libboost_timer.a, libboost_timer.so,
199 libboost_type_erasure.so, libboost_unit_test_framework.a,
200 libboost_unit_test_framework.so,
201 libboost_wave.so, and libboost_wserialization.so
202 </seg>
203 <seg>
204 /usr/include/boost
205 </seg>
206 </seglistitem>
207 </segmentedlist>
208
209 </sect2>
210
211</sect1>
Note: See TracBrowser for help on using the repository browser.