diff --git a/README.adoc b/README.adoc
index f54d935..29fd7db 100644
--- a/README.adoc
+++ b/README.adoc
@@ -11653,9 +11653,13 @@ They contain data structs and magic constant for kernel to userland communicatio
 
 ==== userland directory
 
-Userland test programs.
+Userland test programs. They can be used in the following ways:
 
-For usage in the guest, build with:
+* inside a full system simulation
+* inside <<user-mode-simulation>>
+* directly on the host
+
+For usage inside full system, first ensure that Buildroot has been built for the toolchain, and then build the examples with:
 
 ....
 ./build-userland
@@ -11663,7 +11667,7 @@ For usage in the guest, build with:
 
 Source: link:build-userland[].
 
-This makes them visible immediately on the 9P mount `/mnt/9p/out_root_overlay`.
+This makes them visible immediately on the <<9p>> mount of a running simulator.
 
 In order to place them in the root filesystem image itself, you must also run:
 
@@ -11671,7 +11675,9 @@ In order to place them in the root filesystem image itself, you must also run:
 ./build-buildroot
 ....
 
-It is possible to build and run those examples directly on your host:
+===== userland directory host build
+
+It is possible to build and run some of the userland examples directly on your host:
 
 ....
 cd userland
@@ -11705,14 +11711,6 @@ TODO: OpenMP does not like `-static`:
 
 See: https://stackoverflow.com/questions/23869981/linking-openmp-statically-with-gcc
 
-It is also possible to build other architectures with the host toolchain for other archs than your host arch:
-
-....
-./build-userland --arch arm --host --userland-build-id host
-....
-
-You won't be able to run those executables directly, but this is interesting if you are playing around with <<qemu-user-mode>>.
-
 ==== buildroot_packages directory
 
 Source: link:buildroot_packages/[]