diff options
author | Peter Dimov <pdimov@pdimov.com> | 2017-10-21 17:44:55 +0300 |
---|---|---|
committer | Peter Dimov <pdimov@pdimov.com> | 2017-10-21 21:07:22 +0300 |
commit | 9caa61771a2f7ca307df3c2ea7b7a98199795d6e (patch) | |
tree | 70c338f7901dcbc245364fc70729fbaca66cfe93 /more | |
parent | 32681fe31265ab0e2365f9b9c17d54051783adae (diff) | |
download | boost-9caa61771a2f7ca307df3c2ea7b7a98199795d6e.tar.gz |
Update getting_started to reflect the arch-and-model tag (#167)
Update getting_started to reflect the arch-and-model tag
Diffstat (limited to 'more')
-rw-r--r-- | more/getting_started/detail/common-footnotes.rst | 4 | ||||
-rw-r--r-- | more/getting_started/detail/library-naming.rst | 35 | ||||
-rw-r--r-- | more/getting_started/index.html | 2 | ||||
-rw-r--r-- | more/getting_started/unix-variants.html | 86 | ||||
-rw-r--r-- | more/getting_started/windows.html | 86 |
5 files changed, 181 insertions, 32 deletions
diff --git a/more/getting_started/detail/common-footnotes.rst b/more/getting_started/detail/common-footnotes.rst index 980600b719..9875f036bb 100644 --- a/more/getting_started/detail/common-footnotes.rst +++ b/more/getting_started/detail/common-footnotes.rst @@ -20,7 +20,3 @@ these choices don't affect binary compatibility with other compiled code, you can't count on that with Boost libraries. -.. [#native] This feature of STLPort is deprecated because it's - impossible to make it work transparently to the user; we don't - recommend it. - diff --git a/more/getting_started/detail/library-naming.rst b/more/getting_started/detail/library-naming.rst index 08da85f071..6ae102c507 100644 --- a/more/getting_started/detail/library-naming.rst +++ b/more/getting_started/detail/library-naming.rst @@ -6,7 +6,7 @@ In order to choose the right binary for your build configuration you need to know how Boost binaries are named. Each library filename is composed of a common sequence of elements that describe how it was built. For example, -``libboost_regex-vc71-mt-d-1_34.lib`` can be broken down into the +``libboost_regex-vc71-mt-d-x86-1_34.lib`` can be broken down into the following elements: ``lib`` @@ -51,10 +51,39 @@ following elements: For example, if you build a debug version of your code for use with debug versions of the static runtime library and the - STLPort standard library in “native iostreams” mode, - the tag would be: ``-sgdpn``. If none of the above apply, the + STLPort standard library, + the tag would be: ``-sgdp``. If none of the above apply, the ABI tag is ommitted. +``-x86`` + *Architecture and address model tag*: in the first letter, encodes the architecture as follows: + + +-----+------------------+---------------------+ + |Key |Architecture |Boost.Build option | + +=====+==================+=====================+ + |``x``|x86-32, x86-64 |architecture=x86 | + +-----+------------------+---------------------+ + |``a``|ARM |architecture=arm | + +-----+------------------+---------------------+ + |``i``|IA-64 |architecture=ia64 | + +-----+------------------+---------------------+ + |``s``|Sparc |architecture=sparc | + +-----+------------------+---------------------+ + |``m``|MIPS/SGI |architecture=mips* | + +-----+------------------+---------------------+ + |``p``|RS/6000 & PowerPC |architecture=power | + +-----+------------------+---------------------+ + + The two digits following the letter encode the address model as follows: + + +------+------------------+---------------------+ + |Key |Address model |Boost.Build option | + +======+==================+=====================+ + |``32``|32 bit |address-model=32 | + +------+------------------+---------------------+ + |``64``|64 bit |address-model=64 | + +------+------------------+---------------------+ + ``-1_34`` *Version tag*: the full Boost release number, with periods replaced by underscores. For example, version 1.31.1 would be diff --git a/more/getting_started/index.html b/more/getting_started/index.html index 73a8597470..6358b390bc 100644 --- a/more/getting_started/index.html +++ b/more/getting_started/index.html @@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta name="generator" content="Docutils 0.12: http://docutils.sourceforge.net/" /> +<meta name="generator" content="Docutils 0.11: http://docutils.sourceforge.net/" /> <title>Boost Getting Started</title> <link rel="stylesheet" href="../../rst.css" type="text/css" /> </head> diff --git a/more/getting_started/unix-variants.html b/more/getting_started/unix-variants.html index a835ca54ca..1b2f88e216 100644 --- a/more/getting_started/unix-variants.html +++ b/more/getting_started/unix-variants.html @@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta name="generator" content="Docutils 0.12: http://docutils.sourceforge.net/" /> +<meta name="generator" content="Docutils 0.11: http://docutils.sourceforge.net/" /> <title>Boost Getting Started on Unix Variants</title> <meta content="Getting Started with Boost on Unix Variants (including Linux and MacOS)" name="description" /> <link rel="stylesheet" href="../../rst.css" type="text/css" /> @@ -572,7 +572,7 @@ command lines we explored earlier</a>.</p> you need to know how Boost binaries are named. Each library filename is composed of a common sequence of elements that describe how it was built. For example, -<tt class="docutils literal"><span class="pre">libboost_regex-vc71-mt-d-1_34.lib</span></tt> can be broken down into the +<tt class="docutils literal"><span class="pre">libboost_regex-vc71-mt-d-x86-1_34.lib</span></tt> can be broken down into the following elements:</p> <dl class="docutils"> <dt><tt class="docutils literal">lib</tt></dt> @@ -635,10 +635,80 @@ your compiler.</td> </blockquote> <p class="last">For example, if you build a debug version of your code for use with debug versions of the static runtime library and the -STLPort standard library in “native iostreams” mode, -the tag would be: <tt class="docutils literal"><span class="pre">-sgdpn</span></tt>. If none of the above apply, the +STLPort standard library, +the tag would be: <tt class="docutils literal"><span class="pre">-sgdp</span></tt>. If none of the above apply, the ABI tag is ommitted.</p> </dd> +<dt><tt class="docutils literal"><span class="pre">-x86</span></tt></dt> +<dd><p class="first"><em>Architecture and address model tag</em>: in the first letter, encodes the architecture as follows:</p> +<blockquote> +<table border="1" class="docutils"> +<colgroup> +<col width="11%" /> +<col width="41%" /> +<col width="48%" /> +</colgroup> +<thead valign="bottom"> +<tr><th class="head">Key</th> +<th class="head">Architecture</th> +<th class="head">Boost.Build option</th> +</tr> +</thead> +<tbody valign="top"> +<tr><td><tt class="docutils literal">x</tt></td> +<td>x86-32, x86-64</td> +<td>architecture=x86</td> +</tr> +<tr><td><tt class="docutils literal">a</tt></td> +<td>ARM</td> +<td>architecture=arm</td> +</tr> +<tr><td><tt class="docutils literal">i</tt></td> +<td>IA-64</td> +<td>architecture=ia64</td> +</tr> +<tr><td><tt class="docutils literal">s</tt></td> +<td>Sparc</td> +<td>architecture=sparc</td> +</tr> +<tr><td><tt class="docutils literal">m</tt></td> +<td>MIPS/SGI</td> +<td>architecture=mips*</td> +</tr> +<tr><td><tt class="docutils literal">p</tt></td> +<td>RS/6000 & PowerPC</td> +<td>architecture=power</td> +</tr> +</tbody> +</table> +</blockquote> +<p>The two digits following the letter encode the address model as follows:</p> +<blockquote class="last"> +<table border="1" class="docutils"> +<colgroup> +<col width="13%" /> +<col width="40%" /> +<col width="47%" /> +</colgroup> +<thead valign="bottom"> +<tr><th class="head">Key</th> +<th class="head">Address model</th> +<th class="head">Boost.Build option</th> +</tr> +</thead> +<tbody valign="top"> +<tr><td><tt class="docutils literal">32</tt></td> +<td>32 bit</td> +<td>address-model=32</td> +</tr> +<tr><td><tt class="docutils literal">64</tt></td> +<td>64 bit</td> +<td>address-model=64</td> +</tr> +</tbody> +</table> +</blockquote> +</dd> <dt><tt class="docutils literal"><span class="pre">-1_34</span></tt></dt> <dd><em>Version tag</em>: the full Boost release number, with periods replaced by underscores. For example, version 1.31.1 would be @@ -772,14 +842,6 @@ these choices don't affect binary compatibility with other compiled code, you can't count on that with Boost libraries.</td></tr> </tbody> </table> -<table class="docutils footnote" frame="void" id="native" rules="none"> -<colgroup><col class="label" /><col /></colgroup> -<tbody valign="top"> -<tr><td class="label">[6]</td><td>This feature of STLPort is deprecated because it's -impossible to make it work transparently to the user; we don't -recommend it.</td></tr> -</tbody> -</table> <!-- Copyright David Abrahams 2006. Distributed under the Boost --> <!-- Software License, Version 1.0. (See accompanying --> <!-- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) --> diff --git a/more/getting_started/windows.html b/more/getting_started/windows.html index 50c136bb87..c2196c3bc5 100644 --- a/more/getting_started/windows.html +++ b/more/getting_started/windows.html @@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta name="generator" content="Docutils 0.12: http://docutils.sourceforge.net/" /> +<meta name="generator" content="Docutils 0.11: http://docutils.sourceforge.net/" /> <title>Boost Getting Started on Windows</title> <link rel="stylesheet" href="../../rst.css" type="text/css" /> </head> @@ -660,7 +660,7 @@ you can probably <a class="reference internal" href="#test-your-program"><em>ski you need to know how Boost binaries are named. Each library filename is composed of a common sequence of elements that describe how it was built. For example, -<tt class="docutils literal"><span class="pre">libboost_regex-vc71-mt-d-1_34.lib</span></tt> can be broken down into the +<tt class="docutils literal"><span class="pre">libboost_regex-vc71-mt-d-x86-1_34.lib</span></tt> can be broken down into the following elements:</p> <dl class="docutils"> <dt><tt class="docutils literal">lib</tt></dt> @@ -723,10 +723,80 @@ your compiler.</td> </blockquote> <p class="last">For example, if you build a debug version of your code for use with debug versions of the static runtime library and the -STLPort standard library in “native iostreams” mode, -the tag would be: <tt class="docutils literal"><span class="pre">-sgdpn</span></tt>. If none of the above apply, the +STLPort standard library, +the tag would be: <tt class="docutils literal"><span class="pre">-sgdp</span></tt>. If none of the above apply, the ABI tag is ommitted.</p> </dd> +<dt><tt class="docutils literal"><span class="pre">-x86</span></tt></dt> +<dd><p class="first"><em>Architecture and address model tag</em>: in the first letter, encodes the architecture as follows:</p> +<blockquote> +<table border="1" class="docutils"> +<colgroup> +<col width="11%" /> +<col width="41%" /> +<col width="48%" /> +</colgroup> +<thead valign="bottom"> +<tr><th class="head">Key</th> +<th class="head">Architecture</th> +<th class="head">Boost.Build option</th> +</tr> +</thead> +<tbody valign="top"> +<tr><td><tt class="docutils literal">x</tt></td> +<td>x86-32, x86-64</td> +<td>architecture=x86</td> +</tr> +<tr><td><tt class="docutils literal">a</tt></td> +<td>ARM</td> +<td>architecture=arm</td> +</tr> +<tr><td><tt class="docutils literal">i</tt></td> +<td>IA-64</td> +<td>architecture=ia64</td> +</tr> +<tr><td><tt class="docutils literal">s</tt></td> +<td>Sparc</td> +<td>architecture=sparc</td> +</tr> +<tr><td><tt class="docutils literal">m</tt></td> +<td>MIPS/SGI</td> +<td>architecture=mips*</td> +</tr> +<tr><td><tt class="docutils literal">p</tt></td> +<td>RS/6000 & PowerPC</td> +<td>architecture=power</td> +</tr> +</tbody> +</table> +</blockquote> +<p>The two digits following the letter encode the address model as follows:</p> +<blockquote class="last"> +<table border="1" class="docutils"> +<colgroup> +<col width="13%" /> +<col width="40%" /> +<col width="47%" /> +</colgroup> +<thead valign="bottom"> +<tr><th class="head">Key</th> +<th class="head">Address model</th> +<th class="head">Boost.Build option</th> +</tr> +</thead> +<tbody valign="top"> +<tr><td><tt class="docutils literal">32</tt></td> +<td>32 bit</td> +<td>address-model=32</td> +</tr> +<tr><td><tt class="docutils literal">64</tt></td> +<td>64 bit</td> +<td>address-model=64</td> +</tr> +</tbody> +</table> +</blockquote> +</dd> <dt><tt class="docutils literal"><span class="pre">-1_34</span></tt></dt> <dd><em>Version tag</em>: the full Boost release number, with periods replaced by underscores. For example, version 1.31.1 would be @@ -869,14 +939,6 @@ these choices don't affect binary compatibility with other compiled code, you can't count on that with Boost libraries.</td></tr> </tbody> </table> -<table class="docutils footnote" frame="void" id="native" rules="none"> -<colgroup><col class="label" /><col /></colgroup> -<tbody valign="top"> -<tr><td class="label">[7]</td><td>This feature of STLPort is deprecated because it's -impossible to make it work transparently to the user; we don't -recommend it.</td></tr> -</tbody> -</table> <!-- Copyright David Abrahams 2006. Distributed under the Boost --> <!-- Software License, Version 1.0. (See accompanying --> <!-- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) --> |