diff --git a/docs/UPDATING b/docs/UPDATING
index a49924c45..1c7cb620f 100644
--- a/docs/UPDATING
+++ b/docs/UPDATING
@@ -1,3 +1,13 @@
+20121207:
+	The join and lorder tools have been upgraded. Build them first:
+
+	# make -C usr.bin/lorder clean all install
+	# make -C usr.bin/join clean all install
+	# make -C usr.bin/tic clean all install
+	# make -C usr.bin/nbperf clean all install
+
+	Then do a "make build".
+
 20121205:
 	The tsort tool has been also upgraded and is now also used during
 	the build: