From bb40b7e278509c45c65e94f8dfa7d6c68b971271 Mon Sep 17 00:00:00 2001
From: Francis Rowe <info@gluglug.org.uk>
Date: Sun, 16 Aug 2015 23:32:50 +0100
Subject: docs/gnulinux/encrypted_*.html: emphasize use of grubtest.cfg

---
 docs/gnulinux/encrypted_parabola.html | 14 ++++++++++++--
 docs/gnulinux/encrypted_trisquel.html |  9 +++++++++
 2 files changed, 21 insertions(+), 2 deletions(-)

diff --git a/docs/gnulinux/encrypted_parabola.html b/docs/gnulinux/encrypted_parabola.html
index a11eb0d2..2f61cb69 100644
--- a/docs/gnulinux/encrypted_parabola.html
+++ b/docs/gnulinux/encrypted_parabola.html
@@ -522,9 +522,19 @@
 			<p>
 				Above the 'Load Operating System' menu entry you should also add a GRUB password, like so:
 			</p>
-	<pre><b><i>set superusers=&quot;root&quot;
-	password_pbkdf2 root grub.pbkdf2.sha512.10000.711F186347156BC105CD83A2ED7AF1EB971AA2B1EB2640172F34B0DEFFC97E654AF48E5F0C3B7622502B76458DA494270CC0EA6504411D676E6752FD1651E749.8DD11178EB8D1F633308FD8FCC64D0B243F949B9B99CCEADE2ECA11657A757D22025986B0FA116F1D5191E0A22677674C994EDBFADE62240E9D161688266A711
+	<pre><b><i>
+set superusers=&quot;root&quot;
+password_pbkdf2 root grub.pbkdf2.sha512.10000.711F186347156BC105CD83A2ED7AF1EB971AA2B1EB2640172F34B0DEFFC97E654AF48E5F0C3B7622502B76458DA494270CC0EA6504411D676E6752FD1651E749.8DD11178EB8D1F633308FD8FCC64D0B243F949B9B99CCEADE2ECA11657A757D22025986B0FA116F1D5191E0A22677674C994EDBFADE62240E9D161688266A711
 	</i></b></pre>
+			<p style="font-size:2em;">
+				MAKE SURE TO DO THIS ON grubtest.cfg *BEFORE* DOING IT ON grub.cfg.
+				Then select the menu entry that says <i>Switch to grubtest.cfg</i> and test that it works.
+				Then copy that to grub.cfg once you're satisfied.
+				WHY? BECAUSE AN INCORRECTLY SET PASSWORD CONFIG MEANS YOU CAN'T AUTHENTICATE, WHICH MEANS 'BRICK'.
+			</p>
+			<p>
+				(emphasis added, because it's needed. This is a common roadblock for users)
+			</p>
 
 			<p>
 				Note that the above entry specifies user 'root'; this is just a username for GRUB. You don't even need to use root.
diff --git a/docs/gnulinux/encrypted_trisquel.html b/docs/gnulinux/encrypted_trisquel.html
index b643e38b..544c19c9 100644
--- a/docs/gnulinux/encrypted_trisquel.html
+++ b/docs/gnulinux/encrypted_trisquel.html
@@ -309,6 +309,15 @@
 <b>set superusers=&quot;root&quot;</b>
 <b>password_pbkdf2 root grub.pbkdf2.sha512.10000.711F186347156BC105CD83A2ED7AF1EB971AA2B1EB2640172F34B0DEFFC97E654AF48E5F0C3B7622502B76458DA494270CC0EA6504411D676E6752FD1651E749.8DD11178EB8D1F633308FD8FCC64D0B243F949B9B99CCEADE2ECA11657A757D22025986B0FA116F1D5191E0A22677674C994EDBFADE62240E9D161688266A711</b>
 			</pre>
+			<p style="font-size:2em;">
+				MAKE SURE TO DO THIS ON grubtest.cfg *BEFORE* DOING IT ON grub.cfg.
+				Then select the menu entry that says <i>Switch to grubtest.cfg</i> and test that it works.
+				Then copy that to grub.cfg once you're satisfied.
+				WHY? BECAUSE AN INCORRECTLY SET PASSWORD CONFIG MEANS YOU CAN'T AUTHENTICATE, WHICH MEANS 'BRICK'.
+			</p>
+			<p>
+				(emphasis added, because it's needed. This is a common roadblock for users)
+			</p>
 
 			<p>
 				Obviously, replace it with the correct hash that you actually got for the password that you entered. Meaning, not the hash that you see above!
-- 
cgit v1.2.3-70-g09d2