Cleanup/tidy the texinfo documentation, courtesy of Paul <paukoen@gmail.com>

This was submitted on the mailing list. I further added the full list of
authors to the copying section. There were a few copyright authors missing in
the file that Paul submitted.

There are some TODO entries at the start of the document, which Paul left for
us. We need to work on those.

Also TODO: integrate this into build system, so that we have these options:
./build docs html
./build docs html-onepage
./build docs pdf
etc

1 files changed, 0 insertions, 152 deletions

diff --git a/docs/src/install/t60_unbrick.texi b/docs/src/install/t60_unbrick.texi
deleted file mode 100644
index 9036ec7e..00000000
--- a/docs/src/install/t60_unbrick.texi
+++ /dev/null
@@ -1,152 +0,0 @@
-\input texinfo
-@documentencoding UTF-8
-
-@ifnottex
-@paragraphindent 0
-@end ifnottex
-@titlepage
-@title ThinkPad T60: Recovery guide
-@end titlepage
-
-@node Top
-@top ThinkPad T60: Recovery guide
-
-@menu
-* ThinkPad T60 Recovery guide::
-* Brick type 1 bucts not reset::
-* bad rom or user error system won't boot::
-@end menu
-
-@node ThinkPad T60 Recovery guide
-@chapter ThinkPad T60: Recovery guide
-@anchor{#thinkpad-t60-recovery-guide}
-This section documents how to recover from a bad flash that prevents your ThinkPad T60 from booting.
-
-@uref{index.html,Back to previous index}
-@menu
-* Table of Contents::
-@end menu
-
-@node Table of Contents
-@section Table of Contents
-@anchor{#table-of-contents}
-@itemize
-@item
-Types of brick:
-@itemize
-@item
-@ref{#bucts_brick,Brick type 1: bucts not reset}
-@item
-@ref{#recovery,Brick type 2: bad rom (or user error), system won't boot}
-@end itemize
-
-@end itemize
-
-@node Brick type 1 bucts not reset
-@chapter Brick type 1: bucts not reset.
-@anchor{#brick-type-1-bucts-not-reset.}
-You still have Lenovo BIOS, or you had libreboot running and you flashed another ROM; and you had bucts 1 set and the ROM wasn't dd'd.* or if Lenovo BIOS was present and libreboot wasn't flashed.@*@* In this case, unbricking is easy: reset BUC.TS to 0 by removing that yellow cmos coin (it's a battery) and putting it back after a minute or two:@* @image{../resources/images/t60_dev/0006,,,,JPG}@*@* *Those dd commands should be applied to all newly compiled T60 ROM images (the ROM images in libreboot binary archives already have this applied!):@* dd if=coreboot.rom of=top64k.bin bs=1 skip=$[$(stat -c %s coreboot.rom) - 0x10000] count=64k@* dd if=coreboot.rom bs=1 skip=$[$(stat -c %s coreboot.rom) - 0x20000] count=64k | hexdump@* dd if=top64k.bin of=coreboot.rom bs=1 seek=$[$(stat -c %s coreboot.rom) - 0x20000] count=64k conv=notrunc@* (doing this makes the ROM suitable for use when flashing a system that still has Lenovo BIOS running, using those instructions: @uref{http://www.coreboot.org/Board:lenovo/x60/Installation,http://www.coreboot.org/Board:lenovo/x60/Installation}. (it says x60, but instructions for t60 are identical)
-
-@node bad rom or user error system won't boot
-@chapter bad rom (or user error), system won't boot
-@anchor{#bad-rom-or-user-error-system-wont-boot}
-In this scenario, you compiled a ROM that had an incorrect configuration, or there is an actual bug preventing your system from booting. Or, maybe, you set BUC.TS to 0 and shut down after first flash while Lenovo BIOS was running. In any case, your system is bricked and will not boot at all.
-
-"Unbricking" means flashing a known-good (working) ROM. The problem: you can't boot the system, making this difficult. In this situation, external hardware (see hardware requirements above) is needed which can flash the SPI chip (where libreboot resides).
-
-Remove those screws and remove the HDD:@* @image{../resources/images/t60_dev/0001,,,,JPG} @image{../resources/images/t60_dev/0002,,,,JPG}
-
-Lift off the palm rest:@* @image{../resources/images/t60_dev/0003,,,,JPG}
-
-Lift up the keyboard, pull it back a bit, flip it over like that and then disconnect it from the board:@* @image{../resources/images/t60_dev/0004,,,,JPG} @image{../resources/images/t60_dev/0005,,,,JPG} @image{../resources/images/t60_dev/0006,,,,JPG}
-
-Gently wedge both sides loose:@* @image{../resources/images/t60_dev/0007,,,,JPG} @image{../resources/images/t60_dev/0008,,,,JPG}
-
-Remove that cable from the position:@* @image{../resources/images/t60_dev/0009,,,,JPG} @image{../resources/images/t60_dev/0010,,,,JPG}
-
-Now remove that bezel. Remove wifi, nvram battery and speaker connector (also remove 56k modem, on the left of wifi):@* @image{../resources/images/t60_dev/0011,,,,JPG}
-
-Remove those screws:@* @image{../resources/images/t60_dev/0012,,,,JPG}
-
-Disconnect the power jack:@* @image{../resources/images/t60_dev/0013,,,,JPG}
-
-Remove nvram battery:@* @image{../resources/images/t60_dev/0014,,,,JPG}
-
-Disconnect cable (for 56k modem) and disconnect the other cable:@* @image{../resources/images/t60_dev/0015,,,,JPG} @image{../resources/images/t60_dev/0016,,,,JPG}
-
-Disconnect speaker cable:@* @image{../resources/images/t60_dev/0017,,,,JPG}
-
-Disconnect the other end of the 56k modem cable:@* @image{../resources/images/t60_dev/0018,,,,JPG}
-
-Make sure you removed it:@* @image{../resources/images/t60_dev/0019,,,,JPG}
-
-Unscrew those:@* @image{../resources/images/t60_dev/0020,,,,JPG}
-
-Make sure you removed those:@* @image{../resources/images/t60_dev/0021,,,,JPG}
-
-Disconnect LCD cable from board:@* @image{../resources/images/t60_dev/0022,,,,JPG}
-
-Remove those screws then remove the LCD assembly:@* @image{../resources/images/t60_dev/0023,,,,JPG} @image{../resources/images/t60_dev/0024,,,,JPG} @image{../resources/images/t60_dev/0025,,,,JPG}
-
-Once again, make sure you removed those:@* @image{../resources/images/t60_dev/0026,,,,JPG}
-
-Remove the shielding containing the motherboard, then flip it over. Remove these screws, placing them on a steady surface in the same layout as they were in before you removed them. Also, you should mark each screw hole after removing the screw (a permanent marker pen will do), this is so that you have a point of reference when re-assembling the system:@* @image{../resources/images/t60_dev/0027,,,,JPG} @image{../resources/images/t60_dev/0028,,,,JPG} @image{../resources/images/t60_dev/0029,,,,JPG} @image{../resources/images/t60_dev/0031,,,,JPG} @image{../resources/images/t60_dev/0032,,,,JPG} @image{../resources/images/t60_dev/0033,,,,JPG}
-
-Now wire up the BBB and the Pomona with your PSU.@* Refer to @uref{bbb_setup.html,bbb_setup.html} for how to setup the BBB for flashing.@* @strong{Note, the guide mentions a 3.3v DC PSU but you don't need this on the T60: if you don't have or don't want to use an external PSU, then make sure not to connect the 3.3v leads mentioned in the guide; instead, connect the AC adapter (the one that normally charges your battery) so that the board has power (but don't boot it up)}@* @image{../resources/images/t60_dev/0030,,,,JPG}@* Correlate the following with the BBB guide linked above:
-
-@verbatim
-POMONA 5250:
-===  DVD drive ====
- 18              -       - 1
- 22              -       - NC               ---- RAM is on this end
- NC              -       - 21
- 3.3V (PSU)      -       - 17 - this is pin 1 on the flash chip
-===  audio jacks ===
-This is how you will connect. Numbers refer to pin numbers on the BBB, on the plugs near the DC jack.
-@end verbatim
-
-Connect the pomona from the BBB to the flash chip. No pics unfortunately. (use the text diagram above).
-
-Flashrom binaries for ARM (tested on a BBB) are distributed in libreboot_util. Alternatively, libreboot also distributes flashrom source code which can be built.
-
-SSH'd into the BBB:@* # @strong{./flashrom -p linux_spi:dev=/dev/spidev1.0,spispeed=512 -w yourrom.rom}
-
-It should be @strong{Verifying flash... VERIFIED} at the end. If flashrom complains about multiple flash chip definitions detected, then choose one of them following the instructions in the output.
-
-Put those screws back:@* @image{../resources/images/t60_dev/0047,,,,JPG}
-
-Put it back into lower chassis:@* @image{../resources/images/t60_dev/0048,,,,JPG}
-
-Attach LCD and insert screws (also, attach the lcd cable to the board):@* @image{../resources/images/t60_dev/0049,,,,JPG}
-
-Insert those screws:@* @image{../resources/images/t60_dev/0050,,,,JPG}
-
-On the CPU (and there is another chip south-east to it, sorry forgot to take pic) clean off the old thermal paste (with the alcohol) and apply new (Artic Silver 5 is good, others are good too) you should also clean the heatsink the same way@* @image{../resources/images/t60_dev/0051,,,,JPG}
-
-Attach the heatsink and install the screws (also, make sure to install the AC jack as highlighted):@* @image{../resources/images/t60_dev/0052,,,,JPG}
-
-Reinstall that upper bezel:@* @image{../resources/images/t60_dev/0053,,,,JPG}
-
-Do that:@* @image{../resources/images/t60_dev/0054,,,,JPG} @image{../resources/images/t60_dev/0055,,,,JPG}
-
-Re-attach modem, wifi, (wwan?), and all necessary cables. Sorry, forgot to take pics. Look at previous removal steps to see where they go back to.
-
-Attach keyboard and install nvram battery:@* @image{../resources/images/t60_dev/0056,,,,JPG} @image{../resources/images/t60_dev/0057,,,,JPG}
-
-Place keyboard and (sorry, forgot to take pics) reinstall the palmrest and insert screws on the underside:@* @image{../resources/images/t60_dev/0058,,,,JPG}
-
-It lives!@* @image{../resources/images/t60_dev/0071,,,,JPG} @image{../resources/images/t60_dev/0072,,,,JPG} @image{../resources/images/t60_dev/0073,,,,JPG}
-
-Always stress test ('stress -c 2' and xsensors. below 90C is ok) when replacing cpu paste/heatsink:@* @image{../resources/images/t60_dev/0074,,,,JPG}
-
-Copyright © 2014, 2015 Leah Woods <info@@minifree.org>@* Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license can be found at @uref{../resources/licenses/gfdl-1.3.txt,gfdl-1.3.txt}
-
-Updated versions of the license (when available) can be found at @uref{https://www.gnu.org/licenses/licenses.html,https://www.gnu.org/licenses/licenses.html}
-
-UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS, ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
-
-TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES, COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
-
-The disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability.
-
-@bye