Skip to content

Commit

Permalink
Update user manual.
Browse files Browse the repository at this point in the history
  • Loading branch information
b2-bot committed Mar 10, 2024
1 parent faf37a4 commit 98d0995
Showing 1 changed file with 98 additions and 57 deletions.
155 changes: 98 additions & 57 deletions manual/release/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="generator" content="Asciidoctor 2.0.20">
<meta name="generator" content="Asciidoctor 2.0.22">
<meta name="author" content="René Ferdinand Rivera Morell, Vladimir Prus, Steven Watanabe">
<meta name="copyright" content="Copyright 2018-2021 René Ferdinand Rivera Morell; Copyright 2006, 2014 Vladimir Prus">
<title>B2 User Manual</title>
Expand Down Expand Up @@ -963,34 +963,35 @@ <h1>B2 User Manual</h1>
</li>
<li><a href="#b2.history">14. History</a>
<ul class="sectlevel2">
<li><a href="#_version_5_0_1">14.1. Version 5.0.1</a></li>
<li><a href="#_version_5_0_0">14.2. Version 5.0.0</a></li>
<li><a href="#_version_4_10_1">14.3. Version 4.10.1</a></li>
<li><a href="#_version_4_10_0">14.4. Version 4.10.0</a></li>
<li><a href="#_version_4_9_6">14.5. Version 4.9.6</a></li>
<li><a href="#_version_4_9_5">14.6. Version 4.9.5</a></li>
<li><a href="#_version_4_9_4">14.7. Version 4.9.4</a></li>
<li><a href="#_version_4_9_3">14.8. Version 4.9.3</a></li>
<li><a href="#_version_4_9_2">14.9. Version 4.9.2</a></li>
<li><a href="#_version_4_9_1">14.10. Version 4.9.1</a></li>
<li><a href="#_version_4_9_0">14.11. Version 4.9.0</a></li>
<li><a href="#_version_4_8_2">14.12. Version 4.8.2</a></li>
<li><a href="#_version_4_8_1">14.13. Version 4.8.1</a></li>
<li><a href="#_version_4_8_0">14.14. Version 4.8.0</a></li>
<li><a href="#_version_4_7_2">14.15. Version 4.7.2</a></li>
<li><a href="#_version_4_7_1">14.16. Version 4.7.1</a></li>
<li><a href="#_version_4_7_0">14.17. Version 4.7.0</a></li>
<li><a href="#_version_4_6_1">14.18. Version 4.6.1</a></li>
<li><a href="#_version_4_6_0">14.19. Version 4.6.0</a></li>
<li><a href="#_version_4_5_0">14.20. Version 4.5.0</a></li>
<li><a href="#_version_4_4_2">14.21. Version 4.4.2</a></li>
<li><a href="#_version_4_4_1">14.22. Version 4.4.1</a></li>
<li><a href="#_version_4_4_0">14.23. Version 4.4.0</a></li>
<li><a href="#_version_4_3_0">14.24. Version 4.3.0</a></li>
<li><a href="#_version_4_2_0">14.25. Version 4.2.0</a></li>
<li><a href="#_version_4_1_0">14.26. Version 4.1.0</a></li>
<li><a href="#_version_4_0_1">14.27. Version 4.0.1</a></li>
<li><a href="#_version_4_0_0">14.28. Version 4.0.0</a></li>
<li><a href="#_version_5_1_0">14.1. Version 5.1.0</a></li>
<li><a href="#_version_5_0_1">14.2. Version 5.0.1</a></li>
<li><a href="#_version_5_0_0">14.3. Version 5.0.0</a></li>
<li><a href="#_version_4_10_1">14.4. Version 4.10.1</a></li>
<li><a href="#_version_4_10_0">14.5. Version 4.10.0</a></li>
<li><a href="#_version_4_9_6">14.6. Version 4.9.6</a></li>
<li><a href="#_version_4_9_5">14.7. Version 4.9.5</a></li>
<li><a href="#_version_4_9_4">14.8. Version 4.9.4</a></li>
<li><a href="#_version_4_9_3">14.9. Version 4.9.3</a></li>
<li><a href="#_version_4_9_2">14.10. Version 4.9.2</a></li>
<li><a href="#_version_4_9_1">14.11. Version 4.9.1</a></li>
<li><a href="#_version_4_9_0">14.12. Version 4.9.0</a></li>
<li><a href="#_version_4_8_2">14.13. Version 4.8.2</a></li>
<li><a href="#_version_4_8_1">14.14. Version 4.8.1</a></li>
<li><a href="#_version_4_8_0">14.15. Version 4.8.0</a></li>
<li><a href="#_version_4_7_2">14.16. Version 4.7.2</a></li>
<li><a href="#_version_4_7_1">14.17. Version 4.7.1</a></li>
<li><a href="#_version_4_7_0">14.18. Version 4.7.0</a></li>
<li><a href="#_version_4_6_1">14.19. Version 4.6.1</a></li>
<li><a href="#_version_4_6_0">14.20. Version 4.6.0</a></li>
<li><a href="#_version_4_5_0">14.21. Version 4.5.0</a></li>
<li><a href="#_version_4_4_2">14.22. Version 4.4.2</a></li>
<li><a href="#_version_4_4_1">14.23. Version 4.4.1</a></li>
<li><a href="#_version_4_4_0">14.24. Version 4.4.0</a></li>
<li><a href="#_version_4_3_0">14.25. Version 4.3.0</a></li>
<li><a href="#_version_4_2_0">14.26. Version 4.2.0</a></li>
<li><a href="#_version_4_1_0">14.27. Version 4.1.0</a></li>
<li><a href="#_version_4_0_1">14.28. Version 4.0.1</a></li>
<li><a href="#_version_4_0_0">14.29. Version 4.0.0</a></li>
</ul>
</li>
</ul>
Expand Down Expand Up @@ -16712,7 +16713,47 @@ <h5 id="_b2listsoperator"><a class="anchor" href="#_b2listsoperator"></a><code>b
<h2 id="b2.history"><a class="anchor" href="#b2.history"></a>14. History</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="_version_5_0_1"><a class="anchor" href="#_version_5_0_1"></a>14.1. Version 5.0.1</h3>
<h3 id="_version_5_1_0"><a class="anchor" href="#_version_5_1_0"></a>14.1. Version 5.1.0</h3>
<div class="paragraph">
<p>This is mostly a bugfix release to account for issues impacting Boost Libraries.
There is one "big" change though. It can be rather difficult to find build
failures when running larger builds. To facilitate figuring out problems the
brief summary output at the end of a build is now less brief. It now includes
a <strong>sorted</strong> list of the targets that got skipped and failed. The output of those
lists mirrors the general skipped/failed items. Hence it&#8217;s possible to search
for the same strings in the rest of the output quickly.</p>
</div>
<div class="ulist">
<ul>
<li>
<p><strong>New</strong>: Add listing of failed and skipped targets to end of build summary to
make it easier to find what fails.&#8201;&#8212;&#8201;<em>René Ferdinand Rivera Morell</em></p>
</li>
<li>
<p><strong>New</strong>: Add <code>mpi.run-flags</code> to <code>mpi</code> toolset that allows for arbitrary flags
applied to running mpi targets. This allows, for example, adding
<code>--oversubscribe</code> flag to make it possible to run tests where the tasks are
more than the nodes available.&#8201;&#8212;&#8201;<em>René Ferdinand Rivera Morell</em></p>
</li>
<li>
<p>Fix spurious errors when the header scanning tries to scan empty file names.&#8201;&#8212;&#8201;<em>René Ferdinand Rivera Morell</em></p>
</li>
<li>
<p>Make C/C++/ObjC include directive scanning pattern more strict to avoid
trying to scan for empty file names.&#8201;&#8212;&#8201;<em>Andrey Semashev</em></p>
</li>
<li>
<p>Fix mingw linker commands to always replace backslashes with forward slashes.&#8201;&#8212;&#8201;<em>Christian Seiler</em></p>
</li>
<li>
<p>Fix QCC debug build flag. The QCC toolset was using an old, no longer
supported, debug symbols option.&#8201;&#8212;&#8201;<em>John McFarlane</em></p>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="_version_5_0_1"><a class="anchor" href="#_version_5_0_1"></a>14.2. Version 5.0.1</h3>
<div class="ulist">
<ul>
<li>
Expand All @@ -16730,7 +16771,7 @@ <h3 id="_version_5_0_1"><a class="anchor" href="#_version_5_0_1"></a>14.1. Versi
</div>
</div>
<div class="sect2">
<h3 id="_version_5_0_0"><a class="anchor" href="#_version_5_0_0"></a>14.2. Version 5.0.0</h3>
<h3 id="_version_5_0_0"><a class="anchor" href="#_version_5_0_0"></a>14.3. Version 5.0.0</h3>
<div class="paragraph">
<p>This is a new era in B2. The drive of this new major version is to move the
core build system from being implemented in Jam to C++. This initial release
Expand Down Expand Up @@ -16794,7 +16835,7 @@ <h3 id="_version_5_0_0"><a class="anchor" href="#_version_5_0_0"></a>14.2. Versi
</div>
</div>
<div class="sect2">
<h3 id="_version_4_10_1"><a class="anchor" href="#_version_4_10_1"></a>14.3. Version 4.10.1</h3>
<h3 id="_version_4_10_1"><a class="anchor" href="#_version_4_10_1"></a>14.4. Version 4.10.1</h3>
<div class="ulist">
<ul>
<li>
Expand All @@ -16805,7 +16846,7 @@ <h3 id="_version_4_10_1"><a class="anchor" href="#_version_4_10_1"></a>14.3. Ver
</div>
</div>
<div class="sect2">
<h3 id="_version_4_10_0"><a class="anchor" href="#_version_4_10_0"></a>14.4. Version 4.10.0</h3>
<h3 id="_version_4_10_0"><a class="anchor" href="#_version_4_10_0"></a>14.5. Version 4.10.0</h3>
<div class="paragraph">
<p>This release contains many bug fixes but along the way also cleanup and
refactoring of many toolsets, thanks to Nikita.</p>
Expand Down Expand Up @@ -16906,7 +16947,7 @@ <h3 id="_version_4_10_0"><a class="anchor" href="#_version_4_10_0"></a>14.4. Ver
</div>
</div>
<div class="sect2">
<h3 id="_version_4_9_6"><a class="anchor" href="#_version_4_9_6"></a>14.5. Version 4.9.6</h3>
<h3 id="_version_4_9_6"><a class="anchor" href="#_version_4_9_6"></a>14.6. Version 4.9.6</h3>
<div class="ulist">
<ul>
<li>
Expand All @@ -16916,7 +16957,7 @@ <h3 id="_version_4_9_6"><a class="anchor" href="#_version_4_9_6"></a>14.5. Versi
</div>
</div>
<div class="sect2">
<h3 id="_version_4_9_5"><a class="anchor" href="#_version_4_9_5"></a>14.6. Version 4.9.5</h3>
<h3 id="_version_4_9_5"><a class="anchor" href="#_version_4_9_5"></a>14.7. Version 4.9.5</h3>
<div class="ulist">
<ul>
<li>
Expand Down Expand Up @@ -16944,7 +16985,7 @@ <h3 id="_version_4_9_5"><a class="anchor" href="#_version_4_9_5"></a>14.6. Versi
</div>
</div>
<div class="sect2">
<h3 id="_version_4_9_4"><a class="anchor" href="#_version_4_9_4"></a>14.7. Version 4.9.4</h3>
<h3 id="_version_4_9_4"><a class="anchor" href="#_version_4_9_4"></a>14.8. Version 4.9.4</h3>
<div class="ulist">
<ul>
<li>
Expand Down Expand Up @@ -16975,7 +17016,7 @@ <h3 id="_version_4_9_4"><a class="anchor" href="#_version_4_9_4"></a>14.7. Versi
</div>
</div>
<div class="sect2">
<h3 id="_version_4_9_3"><a class="anchor" href="#_version_4_9_3"></a>14.8. Version 4.9.3</h3>
<h3 id="_version_4_9_3"><a class="anchor" href="#_version_4_9_3"></a>14.9. Version 4.9.3</h3>
<div class="ulist">
<ul>
<li>
Expand All @@ -16985,7 +17026,7 @@ <h3 id="_version_4_9_3"><a class="anchor" href="#_version_4_9_3"></a>14.8. Versi
</div>
</div>
<div class="sect2">
<h3 id="_version_4_9_2"><a class="anchor" href="#_version_4_9_2"></a>14.9. Version 4.9.2</h3>
<h3 id="_version_4_9_2"><a class="anchor" href="#_version_4_9_2"></a>14.10. Version 4.9.2</h3>
<div class="ulist">
<ul>
<li>
Expand All @@ -16995,7 +17036,7 @@ <h3 id="_version_4_9_2"><a class="anchor" href="#_version_4_9_2"></a>14.9. Versi
</div>
</div>
<div class="sect2">
<h3 id="_version_4_9_1"><a class="anchor" href="#_version_4_9_1"></a>14.10. Version 4.9.1</h3>
<h3 id="_version_4_9_1"><a class="anchor" href="#_version_4_9_1"></a>14.11. Version 4.9.1</h3>
<div class="ulist">
<ul>
<li>
Expand All @@ -17010,7 +17051,7 @@ <h3 id="_version_4_9_1"><a class="anchor" href="#_version_4_9_1"></a>14.10. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_9_0"><a class="anchor" href="#_version_4_9_0"></a>14.11. Version 4.9.0</h3>
<h3 id="_version_4_9_0"><a class="anchor" href="#_version_4_9_0"></a>14.12. Version 4.9.0</h3>
<div class="paragraph">
<p>This release has mostly internal cleanups and restructuring. The most
significant being: fixing all memory leaks, automatic build system
Expand Down Expand Up @@ -17079,7 +17120,7 @@ <h3 id="_version_4_9_0"><a class="anchor" href="#_version_4_9_0"></a>14.11. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_8_2"><a class="anchor" href="#_version_4_8_2"></a>14.12. Version 4.8.2</h3>
<h3 id="_version_4_8_2"><a class="anchor" href="#_version_4_8_2"></a>14.13. Version 4.8.2</h3>
<div class="ulist">
<ul>
<li>
Expand All @@ -17090,7 +17131,7 @@ <h3 id="_version_4_8_2"><a class="anchor" href="#_version_4_8_2"></a>14.12. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_8_1"><a class="anchor" href="#_version_4_8_1"></a>14.13. Version 4.8.1</h3>
<h3 id="_version_4_8_1"><a class="anchor" href="#_version_4_8_1"></a>14.14. Version 4.8.1</h3>
<div class="ulist">
<ul>
<li>
Expand All @@ -17101,7 +17142,7 @@ <h3 id="_version_4_8_1"><a class="anchor" href="#_version_4_8_1"></a>14.13. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_8_0"><a class="anchor" href="#_version_4_8_0"></a>14.14. Version 4.8.0</h3>
<h3 id="_version_4_8_0"><a class="anchor" href="#_version_4_8_0"></a>14.15. Version 4.8.0</h3>
<div class="ulist">
<ul>
<li>
Expand Down Expand Up @@ -17144,7 +17185,7 @@ <h3 id="_version_4_8_0"><a class="anchor" href="#_version_4_8_0"></a>14.14. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_7_2"><a class="anchor" href="#_version_4_7_2"></a>14.15. Version 4.7.2</h3>
<h3 id="_version_4_7_2"><a class="anchor" href="#_version_4_7_2"></a>14.16. Version 4.7.2</h3>
<div class="ulist">
<ul>
<li>
Expand All @@ -17158,7 +17199,7 @@ <h3 id="_version_4_7_2"><a class="anchor" href="#_version_4_7_2"></a>14.15. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_7_1"><a class="anchor" href="#_version_4_7_1"></a>14.16. Version 4.7.1</h3>
<h3 id="_version_4_7_1"><a class="anchor" href="#_version_4_7_1"></a>14.17. Version 4.7.1</h3>
<div class="ulist">
<ul>
<li>
Expand All @@ -17168,7 +17209,7 @@ <h3 id="_version_4_7_1"><a class="anchor" href="#_version_4_7_1"></a>14.16. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_7_0"><a class="anchor" href="#_version_4_7_0"></a>14.17. Version 4.7.0</h3>
<h3 id="_version_4_7_0"><a class="anchor" href="#_version_4_7_0"></a>14.18. Version 4.7.0</h3>
<div class="paragraph">
<p>Many, many fixes and internal cleanups in this release. But also adding
auto-detection and bootstrap for VS 2022 preview toolset.</p>
Expand Down Expand Up @@ -17232,7 +17273,7 @@ <h3 id="_version_4_7_0"><a class="anchor" href="#_version_4_7_0"></a>14.17. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_6_1"><a class="anchor" href="#_version_4_6_1"></a>14.18. Version 4.6.1</h3>
<h3 id="_version_4_6_1"><a class="anchor" href="#_version_4_6_1"></a>14.19. Version 4.6.1</h3>
<div class="ulist">
<ul>
<li>
Expand All @@ -17245,7 +17286,7 @@ <h3 id="_version_4_6_1"><a class="anchor" href="#_version_4_6_1"></a>14.18. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_6_0"><a class="anchor" href="#_version_4_6_0"></a>14.19. Version 4.6.0</h3>
<h3 id="_version_4_6_0"><a class="anchor" href="#_version_4_6_0"></a>14.20. Version 4.6.0</h3>
<div class="paragraph">
<p>This release wraps up a few new features that make using some toolsets easier
(thanks to Nikita). It&#8217;s now also possible to specify empty flags features on
Expand Down Expand Up @@ -17308,7 +17349,7 @@ <h3 id="_version_4_6_0"><a class="anchor" href="#_version_4_6_0"></a>14.19. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_5_0"><a class="anchor" href="#_version_4_5_0"></a>14.20. Version 4.5.0</h3>
<h3 id="_version_4_5_0"><a class="anchor" href="#_version_4_5_0"></a>14.21. Version 4.5.0</h3>
<div class="paragraph">
<p>Some minor fixes to improve some old issues.</p>
</div>
Expand All @@ -17330,7 +17371,7 @@ <h3 id="_version_4_5_0"><a class="anchor" href="#_version_4_5_0"></a>14.20. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_4_2"><a class="anchor" href="#_version_4_4_2"></a>14.21. Version 4.4.2</h3>
<h3 id="_version_4_4_2"><a class="anchor" href="#_version_4_4_2"></a>14.22. Version 4.4.2</h3>
<div class="paragraph">
<p>This release is the first of the new home for B2 at Build Frameworks Group.</p>
</div>
Expand All @@ -17347,7 +17388,7 @@ <h3 id="_version_4_4_2"><a class="anchor" href="#_version_4_4_2"></a>14.21. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_4_1"><a class="anchor" href="#_version_4_4_1"></a>14.22. Version 4.4.1</h3>
<h3 id="_version_4_4_1"><a class="anchor" href="#_version_4_4_1"></a>14.23. Version 4.4.1</h3>
<div class="paragraph">
<p>Minor patch to correct missing fix for macOS default engine compiler.</p>
</div>
Expand All @@ -17360,7 +17401,7 @@ <h3 id="_version_4_4_1"><a class="anchor" href="#_version_4_4_1"></a>14.22. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_4_0"><a class="anchor" href="#_version_4_4_0"></a>14.23. Version 4.4.0</h3>
<h3 id="_version_4_4_0"><a class="anchor" href="#_version_4_4_0"></a>14.24. Version 4.4.0</h3>
<div class="paragraph">
<p>Along with a variety of fixes this version introduces "dynamic" response file
support for some toolsets. This means that under most circumstances, if
Expand Down Expand Up @@ -17451,7 +17492,7 @@ <h3 id="_version_4_4_0"><a class="anchor" href="#_version_4_4_0"></a>14.23. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_3_0"><a class="anchor" href="#_version_4_3_0"></a>14.24. Version 4.3.0</h3>
<h3 id="_version_4_3_0"><a class="anchor" href="#_version_4_3_0"></a>14.25. Version 4.3.0</h3>
<div class="paragraph">
<p>There are many invidual fixes in this release. Many thanks for the
contributions. Special thanks to Nikita for the many improvements to msvc
Expand Down Expand Up @@ -17551,7 +17592,7 @@ <h3 id="_version_4_3_0"><a class="anchor" href="#_version_4_3_0"></a>14.24. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_2_0"><a class="anchor" href="#_version_4_2_0"></a>14.25. Version 4.2.0</h3>
<h3 id="_version_4_2_0"><a class="anchor" href="#_version_4_2_0"></a>14.26. Version 4.2.0</h3>
<div class="paragraph">
<p>This release is predominantly minor fixes and cleanup of the engine. In
particular the bootstrap/build process now clearly communicates C++11
Expand Down Expand Up @@ -17593,7 +17634,7 @@ <h3 id="_version_4_2_0"><a class="anchor" href="#_version_4_2_0"></a>14.25. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_1_0"><a class="anchor" href="#_version_4_1_0"></a>14.26. Version 4.1.0</h3>
<h3 id="_version_4_1_0"><a class="anchor" href="#_version_4_1_0"></a>14.27. Version 4.1.0</h3>
<div class="paragraph">
<p>Many small bug fixes in this release. But there are some new features also.
There&#8217;s now an <code>lto</code> feature to specify the use of LTO, and what kind. The
Expand Down Expand Up @@ -17675,7 +17716,7 @@ <h3 id="_version_4_1_0"><a class="anchor" href="#_version_4_1_0"></a>14.26. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_0_1"><a class="anchor" href="#_version_4_0_1"></a>14.27. Version 4.0.1</h3>
<h3 id="_version_4_0_1"><a class="anchor" href="#_version_4_0_1"></a>14.28. Version 4.0.1</h3>
<div class="paragraph">
<p>This patch release fixes a minor issue when trying to configure toolsets that
override the toolset version with a non-version tag. Currently this is only
Expand All @@ -17685,7 +17726,7 @@ <h3 id="_version_4_0_1"><a class="anchor" href="#_version_4_0_1"></a>14.27. Vers
</div>
</div>
<div class="sect2">
<h3 id="_version_4_0_0"><a class="anchor" href="#_version_4_0_0"></a>14.28. Version 4.0.0</h3>
<h3 id="_version_4_0_0"><a class="anchor" href="#_version_4_0_0"></a>14.29. Version 4.0.0</h3>
<div class="paragraph">
<p>After even more years of development the landscape of build systems has changed
considerably, and so has the landscape of compilers. This version marks the
Expand Down

0 comments on commit 98d0995

Please sign in to comment.