From db4e491cb4c8da4cb3e65c69c05e54ee4c1630ad Mon Sep 17 00:00:00 2001
From: Francis Rowe <info@gluglug.org.uk>
Date: Tue, 28 Jul 2015 10:54:09 -0400
Subject: FAQ: add anchor refs to all headers and subheaders

This makes it easier to link to sections of the page.
---
(limited to 'site/faq')

diff --git a/site/faq/index.php b/site/faq/index.php
index a87b049..d5057c1 100644
--- a/site/faq/index.php
+++ b/site/faq/index.php
@@ -43,7 +43,15 @@
 			<h2>Hardware compatibility</h2>
 				<ul class="cascade">
 					<li><a href="#compatibility">What systems are compatible with libreboot?</a></li>
-					<li><a href="#intel">When will modern Intel systems be supported?</a></li>
+					<li>
+						<a href="#intel">When will modern Intel systems be supported?</a>
+						<ul>
+							<li><a href="#intelme">Intel Management Engine (ME)</a></li>
+							<li><a href="#microcode">CPU microcode updates</a></li>
+							<li><a href="#fsp">Firmware Support Package (FSP)</a></li>
+							<li><a href="#intelbastards">Intel is uncooperative</a></li>
+						</ul>
+					</li>
 					<li><a href="#librem">Will the Purism LibreM laptops be supported?</a></li>
 					<li><a href="#thinkpads">Will the latest Thinkpad models be supported?</a></li>
 					<li><a href="#desktops">Will desktop/server hardware be supported?</a></li>
@@ -65,7 +73,7 @@
 					<li><a href="#gnuhurd">Can I use GNU/Hurd?</a></li>
 					<li><a href="#bsd">Can I use BSD?</a></li>
 					<li><a href="#windows">Can I use Windows?</a></li>
-					<li><a href="#other">Are other operating systems compatible?</a></li>
+					<li><a href="#otheros">Are other operating systems compatible?</a></li>
 				</ul>
 			<h2></h2>
 	</div>
@@ -73,7 +81,7 @@
 	<div>
 		<h1>Hardware compatibility</h1>
 
-			<h2 id="compatibility">What systems are compatible with libreboot?</h2>
+			<h2 id="compatibility">What systems are compatible with libreboot? <span class="ref">(<a href="#compatibility">#compatibility</a>)</span></h2>
 				<p>
 					See <a href="../docs/hcl/index.html">../docs/hcl/index.html</a>.
 				</p>
@@ -81,11 +89,11 @@
 					<a href="#pagetop">Back to top of page</a>
 				</p>
 
-			<h2 id="intel">When will modern Intel systems be supported?</h2>
+			<h2 id="intel">When will modern Intel systems be supported? <span class="ref">(<a href="#intel">#intel</a>)</span></h2>
 				<p>
 					The probability is currently estimated to be below 1%, that any post-2008 Intel hardware will ever be supported in libreboot. The main issues are as follows:
 				</p>
-				<h3>Intel Management Engine (ME)</h3>
+				<h3 id="intelme">Intel Management Engine (ME) <span class="ref">(<a href="#intelme">#intelme</a>)</span></h3>
 					<p>
 						The most glaring issue on modern Intel hardware (beyond year ~2008) is
 						the <i>Management Engine</i>. This is a separate processor that exists in all Intel chipsets
@@ -118,7 +126,7 @@
 						The Management Engine is a giant backdoor, allowing full access to your entire system for malicious adversaries.
 						The libreboot project strongly recommends that you avoid it entirely, and this means avoiding the latest generation of Intel hardware.
 					</p>
-				<h3>CPU microcode updates</h3>
+				<h3 id="microcode">CPU microcode updates <span class="ref">(<a href="#microcode">#microcode</a>)</span></h3>
 					<p>
 						All modern x86 CPUs (from Intel and AMD) use what is called <i>microcode</i>. CPUs are extremely complex,
 						and difficult to get right, so the circuitry is designed in a very generic way, where only basic instructions
@@ -144,7 +152,7 @@
 						you had the source code. If you try to upload your own modified updates, the CPU will reject them. In other words,
 						the microcode updates are <i><a href="https://www.gnu.org/proprietary/proprietary-tyrants.html">tivoized</a></i>.
 					</p>
-				<h3>Firmware Support Package (FSP)</h3>
+				<h3 id="fsp">Firmware Support Package (FSP) <span class="ref">(<a href="#fsp">#fsp</a>)</span></h3>
 					<p>
 						On all recent Intel systems, coreboot support has revolved around integrating a blob (for each system) called
 						the <i>FSP</i> (firmware support package), which handles most of the hardware initialization, including
@@ -152,7 +160,7 @@
 						of work on reverse engineering which will likely take many years, even for the most skilled developer working full-time.
 						Intel distributes the FSP blob to firmware developers (including coreboot).
 					</p>
-				<h3>Intel is uncooperative</h3>
+				<h3 id="intelbastards">Intel is uncooperative <span class="ref">(<a href="#intelbastards">#intelbastards</a>)</span></h3>
 					<p>
 						For years, coreboot has been struggling against Intel. Intel has been shown to be extremely uncooperative in general.
 						Many coreboot developers, and companies, have tried to get Intel to cooperate; namely, releasing source code
@@ -175,7 +183,7 @@
 					<a href="#pagetop">Back to top of page</a>
 				</p>
 
-			<h2 id="librem">Will the Purism LibreM laptops be supported?</h2>
+			<h2 id="librem">Will the Purism LibreM laptops be supported? <span class="ref">(<a href="#librem">#librem</a>)</span></h2>
 				<p>
 					Probably not (it uses latest generation of Intel hardware - see <a href="#intel">#intel</a>). It would be nice
 					if libreboot could run on these laptops, but it's extremely unlikely
@@ -188,7 +196,7 @@
 					<a href="#pagetop">Back to top of page</a>
 				</p>
 
-			<h2 id="thinkpads">Will the latest ThinkPad models be supported?</h2>
+			<h2 id="thinkpads">Will the latest ThinkPad models be supported? <span class="ref">(<a href="#thinkpads">#thinkpads</a>)</span></h2>
 				<p>
 					The latest ThinkPad generation supported in libreboot are the ones
 					using the GM45 (ICH9) chipsets, such as the ThinkPad X200 or T400. 
@@ -206,7 +214,7 @@
 					<a href="#pagetop">Back to top of page</a>
 				</p>
 
-			<h2 id="desktops">Will desktop/server hardware be supported?</h2>
+			<h2 id="desktops">Will desktop/server hardware be supported? <span class="ref">(<a href="#desktops">#desktops</a>)</span></h2>
 				<p>
 					A common issue with desktop hardware is the Video BIOS. Libreboot has to initialize the graphics chipset,
 					but most graphics cards lack a free Video BIOS for this purpose. Some desktop motherboards supported in
@@ -229,7 +237,7 @@
 					<a href="#pagetop">Back to top of page</a>
 				</p>
 
-			<h2 id="randomhardware">Hi, I have &lt;insert random system here&gt;, is it supported?</h2>
+			<h2 id="randomhardware">Hi, I have &lt;insert random system here&gt;, is it supported? <span class="ref">(<a href="#randomhardware">#randomhardware</a>)</span></h2>
 				<p>
 					Most likely not. First, you must consult coreboot's own hardware compatibility list
 					at <a href="http://www.coreboot.org/Supported_Motherboards">http://www.coreboot.org/Supported_Motherboards</a> and,
@@ -252,14 +260,14 @@
 					<a href="#pagetop">Back to top of page</a>
 				</p>
 
-			<h2 id="arm">What about ARM?</h2>
+			<h2 id="arm">What about ARM? <span class="ref">(<a href="#arm">#arm</a>)</span></h2>
 				<p>
 					TODO
 				</p>
 				<p>
 					<a href="#pagetop">Back to top of page</a>
 				</p>
-			<h2 id="amd">What about AMD?</h2>
+			<h2 id="amd">What about AMD? <span class="ref">(<a href="#amd">#amd</a>)</span></h2>
 				<p>
 					Libreboot has support for some AMD platforms, with more on the horizon.
 					See <a href="../docs/hcl/index.html">../docs/hcl/index.html</a>.
@@ -275,7 +283,7 @@
 	<div>
 		<h1>General questions</h1>
 
-			<h2 id="install">How do I install libreboot?</h2>
+			<h2 id="install">How do I install libreboot? <span class="ref">(<a href="#install">#install</a>)</span></h2>
 				<p>
 					See <a href="../docs/install/index.html">../docs/install/index.html</a>
 				</p>
@@ -283,7 +291,7 @@
 					<a href="#pagetop">Back to top of page</a>
 				</p>
 
-			<h2 id="bootpassword">How do I set a boot password?</h2>
+			<h2 id="bootpassword">How do I set a boot password? <span class="ref">(<a href="#bootpassword">#bootpassword</a>)</span></h2>
 				<p>
 					If you are using the GRUB payload, you can add a username and password (salted, hashed)
 					to your GRUB configuration that resides inside the flash chip. The following guides (which
@@ -294,7 +302,7 @@
 					<a href="#pagetop">Back to top of page</a>
 				</p>
 
-			<h2 id="writeprotect">How do I write-protect the flash chip?</h2>
+			<h2 id="writeprotect">How do I write-protect the flash chip? <span class="ref">(<a href="#writeprotect">#writeprotect</a>)</span></h2>
 				<p>
 					By default, there is no write-protection on a libreboot system. This is for usability reasons,
 					because most people do not have easy access to an external programmer for re-flashing their firmware,
@@ -315,7 +323,7 @@
 				<p>
 					<a href="#pagetop">Back to top of page</a>
 				</p>
-			<h2 id="biossettings">How do I change the BIOS settings?</h2>
+			<h2 id="biossettings">How do I change the BIOS settings? <span class="ref">(<a href="#biossettings">#biossettings</a>)</span></h2>
 				<p>
 					Libreboot actually uses the <a href="http://www.coreboot.org/GRUB2">GRUB payload</a>.
 					More information about payloads can be found at <a href="http://www.coreboot.org/Payloads">coreboot.org/Payloads</a>.
@@ -335,7 +343,7 @@
 				<p>
 					<a href="#pagetop">Back to top of page</a>
 				</p>
-			<h2 id="reinstallos">Do I need to re-flash when I re-install GNU/Linux?</h2>
+			<h2 id="reinstallos">Do I need to re-flash when I re-install GNU/Linux? <span class="ref">(<a href="#reinstallos">#reinstallos</a>)</span></h2>
 				<p>
 					Not anymore. Recent versions of libreboot (using the GRUB payload) will automatically
 					switch to a GRUB configuration on the HDD or SSD, if it exists. You can also load a different
@@ -346,7 +354,7 @@
 
 	<div>
 		<h1>Operating Systems</h1>
-			<h2 id="gnulinux">Can I use GNU/Linux?</h2>
+			<h2 id="gnulinux">Can I use GNU/Linux? <span class="ref">(<a href="#gnulinux">#gnulinux</a>)</span></h2>
 				<p>
 					Absolutely! GNU/Linux is well-tested in libreboot, and highly recommended.
 					See <a href="../docs/gnulinux/grub_boot_installer.html">installing GNU/Linux</a> and <a href="../docs/gnulinux/grub_cbfs.html">booting GNU/Linux</a>.
@@ -360,7 +368,7 @@
 					<a href="#pagetop">Back to top of page</a>
 				</p>
 
-			<h2 id="gnuhurd">Can I use GNU/Hurd?</h2>
+			<h2 id="gnuhurd">Can I use GNU/Hurd? <span class="ref">(<a href="#gnuhurd">#gnuhurd</a>)</span></h2>
 				<p>
 					Unknown. Probably not. Feel free to try it, and report your findings.
 				</p>
@@ -376,7 +384,7 @@
 					<a href="#pagetop">Back to top of page</a>
 				</p>
 
-			<h2 id="bsd">Can I use BSD?</h2>
+			<h2 id="bsd">Can I use BSD? <span class="ref">(<a href="#bsd">#bsd</a>)</span></h2>
 				<p>
 					Potentially. It may be possible to boot most BSD systems if you use
 					the <a href="http://coreboot.org/SeaBIOS">SeaBIOS</a> payload.
@@ -396,7 +404,7 @@
 					<a href="#pagetop">Back to top of page</a>
 				</p>
 
-			<h2 id="windows">Can I use Windows?</h2>
+			<h2 id="windows">Can I use Windows? <span class="ref">(<a href="#windows">#windows</a>)</span></h2>
 				<p>
 					Windows is incompatible with libreboot, and will probably remain so. <a href="https://gnu.org/philosophy/malware-microsoft.html">Never use Windows</a>.
 				</p>
@@ -404,7 +412,7 @@
 					<a href="#pagetop">Back to top of page</a>
 				</p>
 
-			<h2 id="other">Are other operating systems compatible?</h2>
+			<h2 id="otheros">Are other operating systems compatible? <span class="ref">(<a href="#otheros">#otheros</a>)</span></h2>
 				<p>
 					Unknown. Probably not.
 				</p>
--
cgit v0.9.1