From ece12d8da675d8ae13954d2172347160eb7cb7f6 Mon Sep 17 00:00:00 2001
From: Virgile Andreani <virgile.andreani@anbuco.fr>
Date: Tue, 18 Feb 2014 11:53:23 +0100
Subject: [PATCH 1/2] mk: Fix the regexp of SHOW_DOCS

The tag marks were missing, and `make tips` didn't work.
---
 Makefile.in | 4 ++--
 mk/main.mk  | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/Makefile.in b/Makefile.in
index 5e6e8f310c781..fb8b1ce9371c9 100644
--- a/Makefile.in
+++ b/Makefile.in
@@ -103,7 +103,7 @@
 #
 # </tips>
 #
-# <nittygritty>
+# <nitty-gritty>
 #
 # # The Rust Build System
 #
@@ -157,7 +157,7 @@
 #
 # Admittedly this is a little convoluted.
 #
-# </nittygritty>
+# </nitty-gritty>
 #
 
 ######################################################################
diff --git a/mk/main.mk b/mk/main.mk
index 53ba07e65cbdd..2c7c7c7cecd6d 100644
--- a/mk/main.mk
+++ b/mk/main.mk
@@ -446,13 +446,13 @@ all: $(ALL_TARGET_RULES) $(GENERATED) docs
 # $(1) is the name of the doc <section> in Makefile.in
 # pick everything between tags | remove first line | remove last line
 # | remove extra (?) line | strip leading `#` from lines
-SHOW_DOCS = $(Q)awk '/$(1)/,/<\/$(1)>/' $(S)/Makefile.in | sed '1d' | sed '$$d' | sed 's/^\# \?//'
+SHOW_DOCS = $(Q)awk '/<$(1)>/,/<\/$(1)>/' $(S)/Makefile.in | sed '1d' | sed '$$d' | sed 's/^\# \?//'
 
 help:
 	$(call SHOW_DOCS,help)
 
-hot-tips:
-	$(call SHOW_DOCS,hottips)
+tips:
+	$(call SHOW_DOCS,tips)
 
 nitty-gritty:
-	$(call SHOW_DOCS,nittygritty)
+	$(call SHOW_DOCS,nitty-gritty)

From 54f710fd2dca07313496d0b6f3f2e650d57a0833 Mon Sep 17 00:00:00 2001
From: Virgile Andreani <virgile.andreani@anbuco.fr>
Date: Tue, 18 Feb 2014 11:55:34 +0100
Subject: [PATCH 2/2] mk: Talk about `make clean` in the build help

---
 Makefile.in | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/Makefile.in b/Makefile.in
index fb8b1ce9371c9..04ff606d0b939 100644
--- a/Makefile.in
+++ b/Makefile.in
@@ -19,13 +19,17 @@
 #
 # First, start with one of these build targets:
 #
-#   * all - The default. Builds a complete, bootstrapped compiler.
+#   * all - The default. Build a complete, bootstrapped compiler.
 #           `rustc` will be in `${target-triple}/stage2/bin/`. Run it
 #           directly from the build directory if you like. This also
 #           comes with docs in `doc/`.
 #
 #   * check - Run the complete test suite
 #
+#   * clean - Clean the build repertory. It is advised to run this
+#             command if you want to build Rust again, after an update
+#             of the git repository.
+#
 #   * install - Install Rust. Note that installation is not necessary
 #               to use the compiler.
 #
@@ -152,7 +156,7 @@
 # libraries are managed and versioned without polluting the common
 # areas of the filesystem.
 #
-# General rust binaries may stil live in the host bin directory; they
+# General rust binaries may still live in the host bin directory; they
 # will just link against the libraries in the target lib directory.
 #
 # Admittedly this is a little convoluted.