Libreboot release 6 beta 3.r20140720

- Fixed typo that existed in 2nd beta where the release date of the
  2nd beta was listed as being in year 2016, when in actual fact it
  was 2014.
- Documentation: added (preliminary) details about (rare) buggy CPU's
  on the ThinkPad T60 that were found to fail (instability, kernel
  panics, etc) without the microcode updates.
- Documentation: added docs/howtos/x60_heatsink.html for showing how
  to change the heatsink on the Thinkpad X60
- Added ROM images for Azerty (French) keyboard layout in GRUB
  (courtesy of Olivier Mondoloni)
- Tidied up some scripts:
  - Re-factored those scripts (made easier to read/maintain):
    build-x60, build-x60t, build-t60, build-macbook21
  - Reduced the number of grub configs to 2 (or 1, for macbook21), the
    build scripts now generate the other configs at build time.
  - Deleted build-x60, build-x60t, build-t60, build-macbook21 and
    replaced with intelligent (generic) buildrom-withgrub script
  - Updated build to use buildrom-withgrub script for building the ROM
    images.
  - coreboot.rom and coreboot_serial.rom renamed to
    coreboot_usqwerty.rom and coreboot_serial_usqwerty.rom
  - coreboot_dvorak and coreboot_serial_dvorak.rom renamed to
    coreboot_usdvorak.rom and coreboot_serial_usdvorak.rom
  - Renamed coreboot*rom to libreboot*rom
  - Made flash, lenovobios_firstflash and lenovobios_secondflash
    scripts fail if the specified file does not exist.
  - Updated all relevant parts of the documentation to reflect the
    above.
- Replaced background.png with background.jpg. added
  gnulove.jpg. (resources/grub/background/)
- Updated buildrom-withgrub to use background.jpg instead of
  background.png
- Updated buildrom-withgrub to use gnulove.jpg aswell
- Updated resources/grub/config/macbook21/grub*cfg to use gnulove.jpg
  background.
- Updated resources/grub/config/{x60,t60,x60t}/grub*cfg to use
  background.jpg background.
- Documentation: updated docs/index.html#grub_custom_keyboard to be
  more generally useful.
- nvramtool:
  - Updated builddeps-coreboot script to build it
  - Updated build script to include it in libreboot_bin
- Documentation: added docs/howtos/x60_security.html (security
  hardening for X60)

1 files changed, 92 insertions, 36 deletions

diff --git a/docs/RELEASE.html b/docs/RELEASE.html
index 7d41aeb..6e12ca7 100644
--- a/docs/RELEASE.html
+++ b/docs/RELEASE.html
@@ -32,7 +32,7 @@
 
 	<h2>Releases</h2>
 	<ul>
-		<li><a href="#release6">6th release</a> (2014 July 16th, <b>pre-release, 2nd beta</b>)</h1>
+		<li><a href="#release6">6th release</a> (2014 July 20th, <b>pre-release, 3rd beta</b>)</h1>
 		<li><a href="#release5">5th release</a> (2014 March 7th, revised 2014 June 22nd)</h1>
 		<li><a href="#release4">4th release</a> (2014 February 21st)</h1>
 		<li><a href="#release3">3rd release</a> (2013 December 14th)</h1>
@@ -52,18 +52,16 @@
 
 <hr/>
 
-	<h1 id="release6">6th release (pre-release, 2nd beta)</h1>
+	<h1 id="release6">6th release (pre-release, 3rd beta)</h1>
 
 		<ul>
-			<li>Released 2014 July 11th (<i>pre-</i>release) <b>1st beta</b></li>
-			<li>Revised (pre-release, 2nd beta) 2016 July 16th</li>
+			<li>Released 2014 July 11th (pre-release) 1st beta</li>
+			<li>Revised (pre-release, 2nd beta) 2014 July 16th</li>
+			<li>Revised (pre-release, 3rd beta) 2014 July 20th</li>
 		</ul>
 
 		<div class="important">
 			<h2>Warning: <u>BETA</u> release! <u>TESTING</u> needed! <u>BUGS</u> present!</h2>
-				<p>
-					(the above warning is quite benign. See TODO's)
-				</p>
 				<p style="font-size:1.2em;">
 					<b><u><i>If flashing on an X60 then note that you might want to enable wifi and trackpoint after booting libreboot the first time (meaning, **after** you powered off and subsequently booted again). </i></u></b>
 					See <b>docs/index.html#x60_wifi</b> and <b>docs/index.html#x60_trackpoint</b> for how to do that.
@@ -72,21 +70,21 @@
 
 		<h2>Binaries (for flashing)</h2>
 			<ul>
-				<li><a href="http://libreboot.org/release/5/prerelease_beta2/libreboot_bin.tar.gz">http://libreboot.org/release/5/prerelease_beta2/libreboot_bin.tar.gz</a></li>
-				<li><a href="http://libreboot.org/release/5/prerelease_beta2/libreboot_bin.tar.gz.gpg.sig">http://libreboot.org/release/5/prerelease_beta2/libreboot_bin.tar.gz.gpg.sig</a></li>
-				<li><a href="http://libreboot.org/release/5/prerelease_beta2/libreboot_bin.tar.gz.sha512sum.txt">http://libreboot.org/release/5/prerelease_beta2/libreboot_bin.tar.gz.sha512sum.txt</a></li>
+				<li><a href="http://libreboot.org/release/5/prerelease_beta3/libreboot_bin.tar.gz">http://libreboot.org/release/5/prerelease_beta3/libreboot_bin.tar.gz</a></li>
+				<li><a href="http://libreboot.org/release/5/prerelease_beta3/libreboot_bin.tar.gz.gpg.sig">http://libreboot.org/release/5/prerelease_beta3/libreboot_bin.tar.gz.gpg.sig</a></li>
+				<li><a href="http://libreboot.org/release/5/prerelease_beta3/libreboot_bin.tar.gz.sha512sum.txt">http://libreboot.org/release/5/prerelease_beta3/libreboot_bin.tar.gz.sha512sum.txt</a></li>
 			</ul>
 		<h2>Source code (for hacking)</h2>
 			<ul>
-				<li><a href="http://libreboot.org/release/5/prerelease_beta2/libreboot_src.tar.gz">http://libreboot.org/release/5/prerelease_beta2/libreboot_src.tar.gz</a></li>
-				<li><a href="http://libreboot.org/release/5/prerelease_beta2/libreboot_src.tar.gz.gpg.sig">http://libreboot.org/release/5/prerelease_beta2/libreboot_src.tar.gz.gpg.sig</a></li>
-				<li><a href="http://libreboot.org/release/5/prerelease_beta2/libreboot_src.tar.gz.sha512sum.txt">http://libreboot.org/release/5/prerelease_beta2/libreboot_src.tar.gz.sha512sum.txt</a></li>
+				<li><a href="http://libreboot.org/release/5/prerelease_beta3/libreboot_src.tar.gz">http://libreboot.org/release/5/prerelease_beta3/libreboot_src.tar.gz</a></li>
+				<li><a href="http://libreboot.org/release/5/prerelease_beta3/libreboot_src.tar.gz.gpg.sig">http://libreboot.org/release/5/prerelease_beta3/libreboot_src.tar.gz.gpg.sig</a></li>
+				<li><a href="http://libreboot.org/release/5/prerelease_beta3/libreboot_src.tar.gz.sha512sum.txt">http://libreboot.org/release/5/prerelease_beta3/libreboot_src.tar.gz.sha512sum.txt</a></li>
 			</ul>
 		<h2>Metadata (for re-creating the source archive)</h2>
 			<ul>
-				<li><a href="http://libreboot.org/release/5/prerelease_beta2/libreboot_meta.tar.gz">http://libreboot.org/release/5/prerelease_beta2/libreboot_meta.tar.gz</a></li>
-				<li><a href="http://libreboot.org/release/5/prerelease_beta2/libreboot_meta.tar.gz.gpg.sig">http://libreboot.org/release/5/prerelease_beta2/libreboot_meta.tar.gz.gpg.sig</a></li>
-				<li><a href="http://libreboot.org/release/5/prerelease_beta2/libreboot_meta.tar.gz.sha512sum.txt">http://libreboot.org/release/5/prerelease_beta2/libreboot_meta.tar.gz.sha512sum.txt</a></li>
+				<li><a href="http://libreboot.org/release/5/prerelease_beta3/libreboot_meta.tar.gz">http://libreboot.org/release/5/prerelease_beta3/libreboot_meta.tar.gz</a></li>
+				<li><a href="http://libreboot.org/release/5/prerelease_beta3/libreboot_meta.tar.gz.gpg.sig">http://libreboot.org/release/5/prerelease_beta3/libreboot_meta.tar.gz.gpg.sig</a></li>
+				<li><a href="http://libreboot.org/release/5/prerelease_beta3/libreboot_meta.tar.gz.sha512sum.txt">http://libreboot.org/release/5/prerelease_beta3/libreboot_meta.tar.gz.sha512sum.txt</a></li>
 			</ul>
 
 		<h2>Machines still supported (compared to previous release):</h2>
@@ -125,6 +123,28 @@
 					T60 15.4&quot; (1280x800 and 1680x1050) with Intel GPU is untested in this pre-release. Not much yet is known about panel names.
 					They will be tested at a later date.
 				</p>
+			<h2><u>*</u> T60 (microcode): some CPU's might not work (can be replaced)</h2>
+				<p>
+					A user with 2 T60's, each with a Core 2 Duo T7200 processor tried libreboot on each machine.
+					One worked, one did not. It should be explained that in addition to the microcode (on the CPU),
+					updates are usually supplied in coreboot (from Intel) which patch the onboard microcode to fix bugs. 
+					Errata's can be found at <a href="http://download.intel.com/design/mobile/SPECUPDT/30922214.pdf">http://download.intel.com/design/mobile/SPECUPDT/30922214.pdf</a>
+					and <a href="http://download.intel.com/design/mobile/SPECUPDT/31407918.pdf">http://download.intel.com/design/mobile/SPECUPDT/31407918.pdf</a>.
+					These microcode updates are not included in libreboot because they are proprietary (blobs). Most CPU's work fine without them: hundreds
+					of Core Duo T2300/T2400/T2500/L2300/L2400/L2500 processors have been tested on the X60, and a few T5600 CPU's have been tested on the T60 (and X60 and all work).
+					In the case of the T7200, it was found that one of the two tested had instability issues (kernel panics) without the updates: work is being done to find out 
+					exactly what version of the microcode that particular CPU had in this case.
+					If you find that your CPU gives you similar issues (after trying libreboot), the current workaround is to simply try another CPU
+					(fortunately, the CPU's in the T60 are installed in a socket so replacing them is easy).
+				</p>
+				<p>
+					There might be a patched kernel that can be used, or a kernel parameter that can be used in GRUB to work around these (rare) buggy CPU's
+					(it is unknown at the moment whether this is possible).
+					The Core 2 Duo T7600 is untested, but will be tested soon (the lead developer of libreboot project has 3 of them to try out). 
+				</p>
+				<p>
+					If reading this for 2nd beta, note that any debugging obtained so far will be included in the 3rd beta.
+				</p>
 			<h2><u>**</u> Warning: MacBook2,1 <u>UNTESTED</u>!</h2>
 				<p>
 					At the time of this pre-release, MacBook2,1 support is present but untested. I have ordered a MacBook2,1
@@ -145,10 +165,10 @@
 				<li>X60 now uses a single .config (for coreboot)</li>
 				<li>X60 now uses a single grub.cfg (for grub memdisk)</li>
 				<li>X60 now uses a single grub.elf (payload)</li>
-				<li>Added new native graphics code for X60 (replaces the old 'replay' code): 5320/9 from review.coreboot.org</li>
+				<li>Added new native graphics code for X60 (replaces the old 'replay' code) from Vladimir Serbinenko: 5320/9 from review.coreboot.org</li>
 				<li>T60 is now supported, with native graphics. (5345/4 from review.coreboot.org, cherry-picked on top of 5320/9 checkout)</li>
 				<li>
-					Added macbook2,1 support from review.coreboot.org (see 'getcb' script to know how that was done)
+					Added macbook2,1 support (from Mono Moosbart and Vladimir Serbinenko) from review.coreboot.org (see 'getcb' script to know how that was done)
 					<ul>
 						<li>Documentation: added information linking to correct page and talking about which models are supported.</li>
 						<li>Added resources/libreboot/config/macbook21config</li>
@@ -163,7 +183,7 @@
 				<li>T60: Copy CD option from the grub.cfg's for T60 *serial*.rom images into the grub configs for non-serial images. (T60's have CD/DVD drive on main laptop)</li>
 				<li>macbook21: remove options in build-macbook21 for *serial*.rom (there is no dock or serial port available for macbook21)</li>
 				<li>
-					Added patches for backlight controls on X60 and T60 (see ./resources/libreboot/patch/gitdiff and ./getcb and docs/i945_backlight.html)
+					Added patches for backlight controls on X60 and T60 with help from Denis Carikli (see ./resources/libreboot/patch/gitdiff and ./getcb and docs/i945_backlight.html)
 					<ul>
 						<li>Documentation: added docs/i945_backlight.html showing how backlight controls were made to work on X60/T60</li>
 					</ul>
@@ -175,7 +195,7 @@
 					</ul>
 				</li>
 				<li>
-					X60/T60: Merged patches for 3D fix when using kernel 3.12 or higher (see ./resources/libreboot/patch/gitdiff and ./getcb)
+					X60/T60: Merged patches for 3D fix (from Paul Menzel) when using kernel 3.12 or higher (see ./resources/libreboot/patch/gitdiff and ./getcb)
 					<ul>
 						<li>based on 5927/11 and 5932/5 from review.coreboot.org</li>
 					</ul>
@@ -332,10 +352,9 @@
 				<li>Removed instructions for building source code in the 'get' script (they don't really belong there)</li>
 				<li>Added libfuse-dev and liblzma-dev to the list of GRUB dependencies in 'builddeb' script.</li>
 				<li>Converted the 'RELEASE' file to 'docs/RELEASE.html'</li>
-				<li><b><u><i>TODO:</i></u></b> Add copyright license as appropriate to all of the parts that are mine. (REMOVE THIS LINE WHENDONE)</li>
 				<li>Added those dependencies to builddeb script (for GRUB part): gawk libdevmapper-dev libtool libfreetype6-dev</li>
 				<li>Added to build script the instruction at the end to create a sha512sum.txt with a file manifest plus checksums.</li>
-				<li>Deleted RELEASE, DEBLOB and BACKPORT file (no longer needed)</li>
+				<li>Deleted the RELEASE and BACKPORT files (no longer needed)</li>
 				<li>
 					Documentation: added information about X60/T60 dock (ultrabase x6 and advanced mini dock) to relevant sections.
 					<ul>
@@ -347,7 +366,56 @@
 			Revisions for 2nd beta (2014 July 16th)
 		</h2>
 			<ul>
-				<li>Removed more blobs: Deleted all git files (and added instructions to getcb, for libreboot_meta.tar.gz): removes history of blobs (which itself also showed the patches and therefore the blobs when using 'git diff')</li>
+				<li>
+					Deleted all git-related files from the coreboot directory. This was necessary because
+					with those it is possible to run 'git diff' which shows the changes made in the form
+					of a patch (diff format); this includes the blobs that were deleted during deblobbing.
+				</li>
+			</ul>
+
+		<h2>
+			Revisions for 3rd beta (2014 July 20th)
+		</h2>
+			<ul>
+				<li>
+					Fixed typo that existed in 2nd beta where the release date of the 2nd beta was listed as being in year 2016, when in actual fact it was 2014.
+				</li>
+				<li>
+					Documentation: added (preliminary) details about (rare) buggy CPU's on the ThinkPad T60 that were found to fail (instability, kernel panics, etc)
+					without the microcode updates.
+				</li>
+				<li>Documentation: added docs/howtos/x60_heatsink.html for showing how to change the heatsink on the Thinkpad X60</li>
+				<li>Added ROM images for Azerty (French) keyboard layout in GRUB (courtesy of Olivier Mondoloni)</li>
+				<li>
+					Tidied up some scripts:
+					<ul>
+						<li><s>Re-factored those scripts (made easier to read/maintain): build-x60, build-x60t, build-t60, build-macbook21</s></li>
+						<li><s>Reduced the number of grub configs to 2 (or 1, for macbook21), the build scripts now generate the other configs at build time.</s></li>
+						<li>Deleted build-x60, build-x60t, build-t60, build-macbook21 and replaced with intelligent (generic) buildrom-withgrub script</li>
+						<li>Updated build to use buildrom-withgrub script for building the ROM images.</li>
+						<li>coreboot.rom and coreboot_serial.rom renamed to coreboot_usqwerty.rom and coreboot_serial_usqwerty.rom</li>
+						<li>coreboot_dvorak and coreboot_serial_dvorak.rom renamed to coreboot_usdvorak.rom and coreboot_serial_usdvorak.rom</li>
+						<li>Renamed coreboot*rom to libreboot*rom</li>
+						<li>Made flash, lenovobios_firstflash and lenovobios_secondflash scripts fail if the specified file does not exist.</li>
+						<li>Updated all relevant parts of the documentation to reflect the above.</li>
+					</ul>
+				</li>
+				<li>Replaced background.png with background.jpg. added gnulove.jpg. (resources/grub/background/)</li>
+				<li>Updated buildrom-withgrub to use background.jpg instead of background.png</li>
+				<li>Updated buildrom-withgrub to use gnulove.jpg aswell</li>
+				<li>Updated resources/grub/macbook21/grub*cfg to use gnulove.jpg background.</li>
+				<li>Updated resources/grub/{x60,t60,x60t}/grub*cfg to use background.jpg background.</li>
+				<li>Documentation: updated docs/index.html#grub_custom_keyboard to be more generally useful.</li>
+				<li>
+					nvramtool:
+					<ul>
+						<li>Updated builddeps-coreboot script to build it</li>
+						<li>Updated build script to include it in libreboot_bin</li>
+					</ul>
+				</li>
+				<li>
+					Documentation: added docs/howtos/x60_security.html (security hardening for X60)
+				</li>
 			</ul>
 
 		<div class="important">
@@ -375,17 +443,14 @@
 							</li>
 						</ul>
 					</li>
+					<li><b><u><i>TODO:</i></u></b> T60: find (for rare buggy CPU's that are unstable without microcode updates) if there is a workaround (patched kernel, special parameter, etc)</li>
 					<li><b><u><i>TODO:</i></u></b> Modify coreboot so that tft_brightness is 0xff by default (for fixing the looping issue automatically)</li>
 					<li><b><u><i>TODO:</i></u></b> Modify the Kconfig options in coreboot so that the (non-existent, deleted) microcode is never loaded when building.</li>
 					<li><b><u><i>TODO:</i></u></b> Ask Mono what license he wants to use for his pages (see notes in docs/index.html#macbook21) and then include a copy in the relevant part of the documentation. (note: the backups are not included for now, for this exact reason)</li>
 					<li><b><u><i>TODO:</i></u></b> Retroactively GPG-sign the final revisions of each previous release. (SHA512 sums aswell).</li>
 					<li><b><u><i>TODO:</i></u></b> For the gitdiff in resources/libreboot/patch, re-implement those changes as actual commits in git, using separate patch files for each change.</li>
-					<li><b><u><i>TODO:</i></u></b> Start GPG signing the release archives.</li>
 					<li><b><u><i>TODO:</i></u></b> Made the lenovobios_firstflash and lenovobios_secondflash scripts safer to use (checking for unintended errors, bad checksums and so on)</li>
-					<li><b><u><i>TODO:</i></u></b> cbfstool/flashrom/bucts: Investigate that idea: https://wiki.debian.org/HowToPackageForDebian (make a package for Trisquel 6 for cbfstool) (distributing a .deb for Trisquel 6)</li>
-					<li><b><u><i>TODO:</i></u></b> Added instructions to builddeps-cbfstool to fail if it detects that it is being executed from anywhere other than libreboot_bin</li>
 					<li><b><u><i>TODO:</i></u></b> Tested all of the remaining untested LCD panels under docs/index.html#supported_t60_list</li>
-					<li><b><u><i>TODO:</i></u></b> Documentation: start translating the documentations into other languages aswell.</li>
 					<li><b><u><i>TODO:</i></u></b> macbook21: from what I can tell, macbook21 has no dock or serial. investigate usbdebug and spkmodem option.</li>
 					<li><b><u><i>TODO:</i></u></b> Documentation: Added macbook2,1 unbricking tutorial.</li>
 					<li><b><u><i>TODO:</i></u></b> Documentation: macbook2,1: Show how to physically remove the built-in webcam (which doesn't work unless you install a non-free driver)</li>
@@ -406,22 +471,13 @@
 						</ul>
 					</li>
 					<li><b><u><i>TODO:</i></u></b> Documentation: Added (replicated) the same level of logs (from default firmware) that Mono did for macbook21, for t60/x60/x60t</li>
-					<li><b><u><i>TODO:</i></u></b> macbook21: make it's grub.cfg's use a background1280x800.png instead, because macbook21 uses this 16:10 resolution instead of 4:3</li>
 					<li><b><u><i>TODO:</i></u></b> Documentation: Write documentation showing how to install a GNU/Linux distribution on a macbook2,1 while stock (non-free) firmware is running.</li>
 					<li><b><u><i>TODO:</i></u></b> macbook21: Added script 'macbook21_firstflash' for flashing libreboot while Apple EFI firmware is running.</li>
 					<li><b><u><i>TODO:</i></u></b> Documentation: macbook21: added software-based flashing instructions for flashing libreboot while Apple EFI firmware is running.</li>
 					<li><b><u><i>TODO:</i></u></b> Documentation: updated the X60 unbrick tutorial to use the 5-pin method instead (safer / less dangerous).</li>
-					<li><b><u><i>TODO:</i></u></b> X60/X60s: create new x60sconfig in resources/libreboot/config</li>
-					<li><b><u><i>TODO:</i></u></b> Added script build-x60s which puts it's ROM's in bin/x60s and uses resources/libreboot/config/x60sconfig (still uses resources/grub/config/*)</li>
-					<li><b><u><i>TODO:</i></u></b> Added ./build-x60s instruction to build script</li>
 					<li><b><u><i>TODO:</i></u></b> Documentation: added unbricking tutorial for T60</li>
 					<li><b><u><i>TODO:</i></u></b> Documentation: Advise what parts of the unbricking tutorial to follow (or skip) for replacing motherboard</li>
 		 			<li><b><u><i>TODO:</i></u></b> Documentation: X60/T60: added information about checking custom ROM's using dd to see whether or not the top 64K region is duplicated below top or not. Advise caution about this in the tutorial that deals with flashing on top of Lenovo BIOS, citing the correct dd commands necessary if it is confirmed that the ROM has not been applied with dd yet. (in the case that the user compiled their own ROM's from libreboot, without using the build scripts, or if they forgot to use dd, etc).</li>
-					<li><b><u><i>TODO:</i></u></b> Updated 'build' script to include coreboot/util/nvramtool source directory as 'nvramtool_standalone' directory in libreboot_bin</li>
-					<li><b><u><i>TODO:</i></u></b> Added 'builddeps-nvramtool' for building nvramtool (for libreboot_bin, not src) standalone, which does 'make' in libreboot_bin/nvramtool_standalone then puts the nvramtool executable in libreboot_bin/ and then does 'make clean' in libreboot_bin/nvramtool_standalone/.</li>
-					<li><b><u><i>TODO:</i></u></b> Updated 'build' script to include 'builddeps-nvramtool' in libreboot_bin</li>
-					<li><b><u><i>TODO:</i></u></b> Updated 'build' script to include X60/T60/macbook21 cmos.layout files (from libreboot_src/coreboot/src/mainboard/oem/board/) in libreboot_bin, for use with nvramtool</li>
-					<li><b><u><i>TODO:</i></u></b> Documentation: updated the relevant parts that use nvramtool to mention the new 'builddeps-nvramtool' and the cmos.layout files in libreboot_bin. Emphasize that this is for libreboot_bin and not libreboot_src</li>
 					<li><b><u><i>TODO:</i></u></b> Documentation: Add a &quot;development guide&quot; for how to maintain libreboot ('get' scripts, deblob scripts, associated files under ./resources and so on)</li>
 					<li>
 						<b><u><i>TODO:</i></u></b> Investigate high boot speeds on X60/T60/macbook21