From 8e036992fa6f4dbc869eff3718852a7d2ec1ee5a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ciro=20Santilli=20=E5=85=AD=E5=9B=9B=E4=BA=8B=E4=BB=B6=20?=
 =?UTF-8?q?=E6=B3=95=E8=BD=AE=E5=8A=9F?= <ciro.santilli@gmail.com>
Date: Tue, 20 Nov 2018 00:00:00 +0000
Subject: [PATCH] prebuilt: tell users to checkout ot latest tag, otherwise too
 unstable

---
 README.adoc | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/README.adoc b/README.adoc
index e0ff4f4..b37ccee 100644
--- a/README.adoc
+++ b/README.adoc
@@ -498,7 +498,9 @@ Our prebuilts currently include:
 * Linux kernel
 * root filesystem
 
-Advantage: saves time and disk space on the initial install, which is expensive in largely due to building the toolchain.
+For more details, see our our <<release,release procedure>>.
+
+Advantage of this setup: saves time and disk space on the initial install, which is expensive in largely due to building the toolchain.
 
 The limitations are severe however:
 
@@ -522,18 +524,21 @@ This setup might be good enough for those developing simulators, as that require
 
 ==== Prebuilt Buildroot setup getting started
 
-Some times it works with the host QEMU:
+Checkout to the latest tag and use the Ubuntu packaged QEMU:
 
 ....
 sudo apt-get install qemu-system-x86
 git clone https://github.com/cirosantilli/linux-kernel-module-cheat
 cd linux-kernel-module-cheat
+git checkout "$(git rev-list --tags --max-count=1)"
 ./release-download-latest
 unzip lkmc-*.zip
 ./run --prebuilt
 ....
 
-but to be sure, build your own at a tested revision:
+You have to checkout to the latest tag to ensure that the scripts match the release format: https://stackoverflow.com/questions/1404796/how-to-get-the-latest-tag-name-in-current-branch-in-git
+
+Be saner and use our custom built QEMU instead:
 
 ....
 git submodule update --init --recursive "$(./getvar qemu_src_dir)"
@@ -543,16 +548,7 @@ git submodule update --init --recursive "$(./getvar qemu_src_dir)"
 
 This also allows you to <<your-first-qemu-hack,modify QEMU>> if you're into that sort of thing.
 
-To try an older prebuilt:
-
-* download it from: link:https://github.com/cirosantilli/linux-kernel-module-cheat/releases[]
-* checkout this repo to match the SHA of the release
-
-then do whatever that checked out README says.
-
-If you are curious to see what the releases contain in detail, have a look at our <<release,release procedure>>.
-
-To build the kernel modules, simply do:
+To build the kernel modules as in <<your-first-kernel-module-hack>> do:
 
 ....
 ./build-linux -- modules_prepare
@@ -562,6 +558,8 @@ To build the kernel modules, simply do:
 
 `modules_prepare` does the minimal build procedure required on the kernel for us to be able to compile the kernel modules, and is way faster than doing a full kernel build. A full kernel build would also work however.
 
+This command automatically falls back to the Ubuntu packaged GCC since you don't have the Buildroot toolchain.
+
 To modify the Linux kernel, build and use it as usual:
 
 ....