boost: start

README.adoc

@@ -1074,7 +1074,7 @@ cd userland/c
 ./test
 ....
 
-As mentioned at <<user-mode-tests>>, tests under link:userland/libs[] require certain optional libraries to be installed, and are not built or tested by default.
+As mentioned at <<userland-libs-directory>>, tests under link:userland/libs[] require certain optional libraries to be installed, and are not built or tested by default.
 
 You can install those libraries with:
 
@@ -3737,10 +3737,10 @@ This script skips a manually configured list of tests, notably:
 
 * tests that depend on a full running kernel and cannot be run in user mode simulation, e.g. those that rely on kernel modules
 * tests that require user interaction
-* tests that take perceptible ammounts of time
+* tests that take perceptible amounts of time
 * known bugs we didn't have time to fix ;-)
 
-Tests under link:userland/libs/[] depend on certain libraries being available on the target, e.g. <<blas>> for link:userland/libs/openblas[]. They are not run by default, but can be enabled with `--package` and `--package-all`.
+Tests under link:userland/libs/[] are only run if `--package` or `--package-all` are given as described at <<userland-libs-directory>>.
 
 The gem5 tests require building statically with build id `static`, see also: xref:gem5-syscall-emulation-mode[xrefstyle=full]. TODO automate this better.
 
@@ -14807,6 +14807,14 @@ TODO also consider the following:
 * http://www.cs.virginia.edu/stream/ref.html STREAM memory bandwidth benchmarks.
 * https://github.com/kozyraki/stamp transactional memory benchmarks
 
+==== Boost
+
+https://en.wikipedia.org/wiki/Boost_(C%2B%2B_libraries)
+
+link:userland/libs/boost[]
+
+* link:userland/libs/boost/bimap.cpp[]
+
 ==== Dhrystone
 
 https://en.wikipedia.org/wiki/Dhrystone
@@ -15100,6 +15108,18 @@ Don't forget to explicitly rebuild PARSEC with:
 You may also want to test if your patches are still functionally correct inside of QEMU first, which is a faster emulator.
 * sell your soul, and compile natively inside the guest. We won't do this, not only because it is evil, but also because Buildroot explicitly does not support it: https://buildroot.org/downloads/manual/manual.html#faq-no-compiler-on-target ARM employees have been known to do this: https://github.com/arm-university/arm-gem5-rsk/blob/aa3b51b175a0f3b6e75c9c856092ae0c8f2a7cdc/parsec_patches/qemu-patch.diff
 
+[[userland-libs-directory]]
+==== userland/libs directory
+
+Tests under link:userland/libs[] require certain optional libraries to be installed on the target, and are not built or tested by default, you must enable them with either:
+
+....
+--package <package>
+--package-all
+....
+
+See for example <<blas>>.
+
 === Userland content bibliography
 
 * The Linux Programming Interface by Michael Kerrisk https://www.amazon.co.uk/Linux-Programming-Interface-System-Handbook/dp/1593272200 Lots of open source POSIX examples: https://github.com/cirosantilli/linux-programming-interface-kerrisk