reorganize docs to build building html sources easier

2 files changed, 719 insertions, 0 deletions

diff --git a/docs/src/future/index.texi b/docs/src/future/index.texi
new file mode 100644
index 00000000..abb93da3
--- /dev/null
+++ b/docs/src/future/index.texi
@@ -0,0 +1,516 @@
+\input texinfo
+@documentencoding UTF-8
+
+@ifnottex
+@paragraphindent 0
+@end ifnottex
+@titlepage
+@title libreboot tutorials
+@end titlepage
+
+@node Top
+@top libreboot tutorials
+
+@menu
+* Development notes::
+* Table of contents::
+* standard test::
+* T60 cpu microcode::
+* i945 VRAM size::
+* LCD panels on i945 - fix incompatible panels::
+* i945 gfx X60/T60 VBT implementation experimental testing::
+* intelvbttool test results VGA ROM dumps::
+* Fallback patches::
+* Other - unlisted low priority::
+@end menu
+
+@node Development notes
+@chapter Development notes
+@anchor{#development-notes}
+These are development notes, for future use. For old (obselete) notes, see @uref{old.html,old.html}.
+
+Or go @uref{../tasks.html,back to main task list}.
+
+@node Table of contents
+@chapter Table of contents
+@anchor{#table-of-contents}
+@itemize
+@item
+@ref{#standard_test,Standard test}
+@item
+@ref{#t60_cpu_microcode,T60 cpu microcode}
+@item
+@ref{#i945_vram_size,i945 VRAM size}
+@item
+@ref{#lcd_i945_incompatibility,LCD panels on i945 - fix incompatible panels}
+@item
+@ref{#i945_vbt,i945 X60/T60 VBT implementation (experimental: testing)}
+@item
+@ref{#intelvbttool_results,IntelVbtTool results}
+@item
+@ref{#fallback_patches,Fallback patches for i945}
+@end itemize
+
+@node standard test
+@chapter standard test
+@anchor{#standard-test}
+These logs are usually obtained when testing changes related to graphics on i945 (X60 and T60).
+
+@itemize
+@item
+Make a copy of these files:
+@itemize
+@item
+/var/log/dmesg
+@item
+/var/log/kern.log
+@item
+/var/log/Xorg.0.log
+@item
+/proc/ioports
+@item
+/proc/iomem
+@item
+/sys/class/drm/card0/error
+@end itemize
+
+@item
+Record these outputs:
+@itemize
+@item
+sudo intel_reg_dumper
+@item
+uname -r
+@item
+lspci -vvvvnnnnxxxx
+@item
+sudo modprobe msr
+@item
+sudo inteltool -a
+@item
+sudo cbmem -c
+@end itemize
+
+@item
+Try some 3D games with latest kernel.
+@end itemize
+
+@ref{#pagetop,Back to top of page.}
+
+@node T60 cpu microcode
+@chapter T60 cpu microcode
+@anchor{#t60-cpu-microcode}
+TODO: T60: find (for rare buggy CPUs that are unstable without microcode updates) if there is a workaround (patched kernel, special parameter, etc) So far, only 1 processor has been found to have issues. See microcode errata sheets http://download.intel.com/design/mobile/SPECUPDT/31407918.pdf and http://download.intel.com/design/mobile/SPECUPDT/30922214.pdf and then look at the debugging results collected in @uref{../resources/images/t7200q,t7200q} directory (q means quirk).
+
+Every other T7200 tested so far has worked without microcode updates.
+
+@ref{#pagetop,Back to top of page.}
+
+@node i945 VRAM size
+@chapter i945 VRAM size
+@anchor{#i945-vram-size}
+Apparently, only 8MB VRAM is available on i945 GPUs (though it could do 64MB):@* phcoder: No. Hardware default is 8 MiB. When I wanted to make it configurable, I saw that docs mention only one other alternative: 1MiB. Later isn't event enough for 1024x768 at 24bpp without any acceleration or double buffering. It's possible that there are undocumented values. Which options do you have in vendor BIOS? How to find out how much vram you have:@* phcoder: TOM - BSM@* phcoder: check what vendor BIOS offers as options@* fchmmr: I thought it could do 64MB usually@* phcoder: not accorging to doc.@* phcoder: see mobile-945-express-chipset-datasheet page 93@* phcoder: see also src/northbridge/intel/i945/@{early_init,northbridge,gma@}.c@* fchmmr: "011 = DVMT (UMA) mode, 8 MB of memory pre-allocated for@* fchmmr: frame buffer."@* fchmmr: "Others - reserved"@* phcoder: the easiest way is a loop at this position which tries different values and reads (and prints) BSM with them@* stefanct: fchmmr: they suggest that you change the value and look how BSM reacts to that@* stefanct: as they pointed out earlier vram size = TOM - BSM@* stefanct: different values of GMS@* stefanct: phcoder: hm... this could be a hint. look at the text description of TOLUD at page 103@* stefanct: it mentions 64 MB in the text about BSM as well@* stefanct: table 18...@* phcoder: stefanct: I have a guess which value make is 64 but I will not tell to avoid skewing test results@* stefanct: phcoder: sure... i assumed you were not sure if it supports it at all. testing it properly is of course a good idea :)@* stefanct: test the various possible (but reserved) values of GMS and see what the resulting VRAM size is@* fchmmr: so, TOM - BSM
+
+@ref{#pagetop,Back to top of page.}
+
+@node LCD panels on i945 - fix incompatible panels
+@chapter LCD panels on i945 - fix incompatible panels
+@anchor{#lcd-panels-on-i945---fix-incompatible-panels}
+Fix T60 issues (see incompatible panels listed at @uref{../hcl/index.html#supported_t60_list,../hcl/index.html#supported_t60_list}).
+
+Run that tool (resources/utilities/i945gpu/intel-regs.py) as root on systems with the offending panels in:
+
+@itemize
+@item
+Coreboot (or libreboot, whatever) with VBIOS (disable native graphics also)
+@item
+(Factory BIOS also?)
+@end itemize
+
+This shows values in devicetree.cb and src/northbridge/intel/i945/gma.c, the idea is that you run it on factory bios or vbios and that it will (might) show different values: then you try those in the native graphics (in libreboot).
+
+Other values/registers might also need to be added to the script for these tests.
+
+check if intel_bios_reader from intel-gpu-tools reports the same value (BIOS has a hardcoded value) for PWM modulation frequency. This file can read the VBIOS (64K dump).
+
+Check other tools in intel-gpu-tools aswell, compare outputs. Possibly add more information to intel-regs.py output (submit changes to mtjm). Do oprom trace / replay (@uref{http://www.coreboot.org/User:GNUtoo#How_to_get_rid_of_the_vbios_of_the_x60_.5BNew_Version.5D,http://www.coreboot.org/User:GNUtoo#How_to_get_rid_of_the_vbios_of_the_x60_.5BNew_Version.5D})
+
+Study how EDID works and how gma.c handles it.
+
+Original getregs.py script can be found at @uref{http://hg.mtjm.eu/scripts/file/tip/intel-regs.py,http://hg.mtjm.eu/scripts/file/tip/intel-regs.py} written by Michał Masłowski.
+
+About fixing remaining LCD panels on 5345:@* 'polarity' is mentioned in coreboot log (cbmem -c). compare output (with working and non-working panel). (and see the other notes in future/index.html)
+
+There was a theory that working panels are 6bpc (bits per colour) and nonworking are 8bpc, but all EDIDs that we have here are for 6bpc panels.
+
+We should compare coreboot logs (from @code{cbmem -c} from systems with working and nonworking panels.
+
+How to dump EDID:
+
+# @strong{apt-get install i2c-tools}@* # @strong{modprobe i2c-dev}@* Find out the correct ID to use:@* # @strong{i2cdetect -l}@* Example:@* # @strong{i2cdump -y 2 0x50}
+
+Working panel: EDID dump from LG-Philips LP150E05-A2K1:
+
+@verbatim
+No size specified (using byte-data access)
+     0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f    0123456789abcdef
+00: XX ff ff ff ff ff ff 00 30 ae 43 40 00 00 00 00    X.......0?C@....
+10: 00 0f 01 03 80 1e 17 78 ea af 00 99 58 53 8c 2a    .??????x??.?XS?*
+20: 25 50 54 21 08 00 81 80 01 01 01 01 01 01 01 01    %PT!?.??????????
+30: 01 01 01 01 01 01 30 2a 78 20 51 1a 10 40 30 70    ??????0*x Q??@0p
+40: 13 00 31 e4 10 00 00 18 28 23 78 20 51 1a 10 40    ?.1??..?(#x Q??@
+50: 30 70 13 00 31 e4 10 00 00 18 00 00 00 0f 00 90    0p?.1??..?...?.?
+60: 43 32 90 43 28 14 06 00 32 0c 00 00 00 00 00 fe    C2?C(??.2?.....?
+70: 00 4c 50 31 35 30 45 30 35 2d 41 32 0a 20 00 9b    .LP150E05-A2? .?
+80: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+90: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+a0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+b0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+c0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+d0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+e0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+f0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+@end verbatim
+
+Working panel: EDID dump from Boe-Hydis HT14P12-100 FRU: 13N7061 (Inverter FRU: 41W1010)
+
+@verbatim
+     0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f    0123456789abcdef
+00: 00 ff ff ff ff ff ff 00 30 ae 22 40 00 00 00 00    ........0?"@....
+10: 00 0f 01 03 80 1c 15 78 ea af 40 95 56 4a 8f 25    .??????x??@?VJ?%
+20: 20 50 54 21 08 00 81 80 01 01 01 01 01 01 01 01     PT!?.??????????
+30: 01 01 01 01 01 01 30 2a 78 20 51 1a 10 40 30 70    ??????0*x Q??@0p
+40: 13 00 1d d6 10 00 00 19 25 23 78 20 51 1a 10 40    ?.???..?%#x Q??@
+50: 30 70 13 00 1d d6 10 00 00 19 00 00 00 0f 00 90    0p?.???..?...?.?
+60: 43 32 90 43 28 0f 01 00 09 e5 00 00 00 00 00 fe    C2?C(??.??.....?
+70: 00 48 54 31 34 50 31 32 2d 31 30 30 0a 20 00 3f    .HT14P12-100? .?
+80: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+90: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+a0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+b0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+c0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+d0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+e0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+f0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+@end verbatim
+
+LTN141XA-L01: revert to libreboot git commit c943281 to see this
+
+@strong{Non-}working panel: EDID dump from Samsung LTN150XG-L08:
+
+@verbatim
+     0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f    0123456789abcdef
+00: 00 ff ff ff ff ff ff 00 30 ae 40 40 00 00 00 00    ........0?@@....
+10: 00 0f 01 03 80 1f 17 78 ea 2d 05 97 57 51 8a 27    .??????x?-??WQ?'
+20: 23 50 54 21 08 00 01 01 01 01 01 01 01 01 01 01    #PT!?.??????????
+30: 01 01 01 01 01 01 64 19 00 40 41 00 26 30 18 88    ??????d?.@A.&0??
+40: 36 00 30 e4 10 00 00 19 28 15 00 40 41 00 26 30    6.0??..?(?.@A.&0
+50: 18 88 36 00 30 e4 10 00 00 19 00 00 00 0f 00 61    ??6.0??..?...?.a
+60: 43 32 61 43 28 14 01 00 4c a3 58 47 00 00 00 fe    C2aC(??.L?XG...?
+70: 00 4c 54 4e 31 35 30 58 47 2d 4c 30 38 0a 00 6d    .LTN150XG-L08?.m
+80: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+90: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+a0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+b0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+c0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+d0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+e0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+f0: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff    ................
+@end verbatim
+
+@ref{#pagetop,Back to top of page.}
+
+@node i945 gfx X60/T60 VBT implementation experimental testing
+@chapter i945 gfx: X60/T60 VBT implementation (experimental: testing)
+@anchor{#i945-gfx-x60t60-vbt-implementation-experimental-testing}
+intel_bios_dumper in intel-gpu-tools seems interesting.
+
+@strong{Use 'drm.debug=0x06' kernel parameter when booting in grub!}
+
+Before each test run, boot a live USB and delete the old logs in /var/log (kernel log, xorg log, dmesg and so on).
+
+Load (from the ROM) the runningvga.bin for each LCD panel on each system; do not execute it, only load it! (coreboot will have to be modified). Rename the ROM appropriately, based on the system name and the panel name. coreboot_nativegfx_5868_plusrunningvga_t60_14_LTD141ECMB.rom, for instance. Keep a copy for later use.
+
+You are supposed to:
+
+@itemize
+@item
+enable native graphics in menuconfig
+@item
+include the self-modified VGA ROM (load, but not execute) - for reverse engineering the correct VBT tables.
+@end itemize
+
+With each boot, make notes about what you see and get logs using the @ref{#standard_test,standard test}. You will need the files from @ref{#intelvbttool_results,#intelvbttool_results} for each system.
+
+Results (# means untested):
+
+@itemize
+@item
+@strong{X60/X60s:}
+@itemize
+@item
+TMD-Toshiba LTD121ECHB: #
+@item
+CMO N121X5-L06: #
+@item
+Samsung LTN121XJ-L07: #
+@item
+BOE-Hydis HT121X01-101: #
+@end itemize
+
+@item
+@strong{X60T XGA:}
+@itemize
+@item
+BOE-Hydis HV121X03-100: #
+@end itemize
+
+@item
+@strong{X60T SXGA+:}
+@itemize
+@item
+BOE-Hydis HV121P01-100: #
+@end itemize
+
+@item
+@strong{T60 14" XGA:}
+@itemize
+@item
+Samsung LTN141XA-L01: #
+@item
+CMO N141XC: #
+@item
+BOE-Hydis HT14X14: #
+@item
+TMD-Toshiba LTD141ECMB: #
+@end itemize
+
+@item
+@strong{T60 14" SXGA+}
+@itemize
+@item
+TMD-Toshiba LTD141EN9B: #
+@item
+Samsung LTN141P4-L02: #
+@item
+Boe-Hydis HT14P12: #
+@end itemize
+
+@item
+@strong{T60 15" XGA}
+@itemize
+@item
+Samsung LTN150XG-L08: #
+@item
+LG-Philips LP150X09: #
+@item
+13N7068 (IDtech): #
+@item
+13N7069 (CMO): #
+@end itemize
+
+@item
+@strong{T60 15" SXGA+}
+@itemize
+@item
+LG-Philips LP150E05-A2K1: #
+@item
+BOE-Hydis HV150P01-100: #
+@end itemize
+
+@item
+@strong{T60 15" UXGA}
+@itemize
+@item
+BOE-Hydis HV150UX1-100: #
+@item
+IDTech N150U3-L01: #
+@item
+BOE-Hydis HV150UX1-102: #
+@end itemize
+
+@item
+@strong{T50 15" QXGA}
+@itemize
+@item
+IDtech IAQX10N: #
+@item
+IDtech IAQX10S: #
+@end itemize
+
+@end itemize
+
+@ref{#pagetop,Back to top of page}
+
+@node intelvbttool test results VGA ROM dumps
+@chapter intelvbttool test results (VGA ROM dumps)
+@anchor{#intelvbttool-test-results-vga-rom-dumps}
+The VBIOS on i945 (intel gpu) platforms is self-modifying; that is, its contents change when you run it. intelvbttool takes a dump of the currently running vbios, and parses it.
+
+The idea is that we can extract the VBT tables using this knowledge, on the X60, X60 Tablet and T60 (Intel GPU).
+
+Here is an example of how VBT was implemented on the ThinkPad X230: @uref{http://review.coreboot.org/#/c/5396,http://review.coreboot.org/#/c/5396}.
+
+You'll need to build a T60 ROM with SeaBIOS and the VGA ROM (for Intel GPU). An X60 ROM is also needed (same configuration, using the VGA ROM for X60).
+
+T60 has DVI on its dock, make sure that the dock is attached when getting this output.
+
+Get intelvbttool here: @uref{http://review.coreboot.org/#/c/5842,http://review.coreboot.org/#/c/5842} (util/intelvbttool).
+
+Now dump a copy of the running VGA BIOS: @strong{$ sudo dd if=/dev/mem bs=64k of=runningvga.bin skip=12 count=1}@* Then do (and record the output):@* @strong{$ ./intelvbttool runningvga.bin > intelvbttool_out}
+
+Backup both files (runningvga.bin and intelvbttool_out), renaming them to match the system and LCD panel used. @uref{../misc/index.html#get_edid_panelname,../misc/index.html#get_edid_panelname} will show you how to get the name (model) of the LCD panel used.
+@menu
+* Test results # means untested and all had docks unless noted::
+@end menu
+
+@node Test results # means untested and all had docks unless noted
+@section Test results (# means untested and all had docks, unless noted).
+@anchor{#test-results-means-untested-and-all-had-docks-unless-noted.}
+@itemize
+@item
+@strong{X60/X60s:}
+@itemize
+@item
+TMD-Toshiba LTD121ECHB: #
+@item
+CMO N121X5-L06: #
+@item
+Samsung LTN121XJ-L07: #
+@item
+BOE-Hydis HT121X01-101: #
+@end itemize
+
+@item
+@strong{X60T XGA (1024x768):}
+@itemize
+@item
+BOE-Hydis HV121X03-100: #
+@end itemize
+
+@item
+@strong{X60T SXGA+ (1400x1050):}
+@itemize
+@item
+BOE-Hydis HV121P01-100: #
+@end itemize
+
+@item
+@strong{T60 14" XGA (1024x768):}
+@itemize
+@item
+Samsung LTN141XA-L01: #
+@item
+CMO N141XC: #
+@item
+BOE-Hydis HT14X14: #
+@item
+TMD-Toshiba LTD141ECMB: #
+@end itemize
+
+@item
+@strong{T60 14" SXGA+ (1400x1050):}
+@itemize
+@item
+TMD-Toshiba LTD141EN9B: #
+@item
+Samsung LTN141P4-L02: #
+@item
+Boe-Hydis HT14P12: #
+@end itemize
+
+@item
+@strong{T60 15" XGA (1024x768):}
+@itemize
+@item
+Samsung LTN150XG-L08: #
+@item
+LG-Philips LP150X09: #
+@item
+13N7068 (IDtech): #
+@item
+13N7069 (CMO): #
+@end itemize
+
+@item
+@strong{T60 15" SXGA+ (1400x1050):}
+@itemize
+@item
+LG-Philips LP150E05-A2K1: #
+@item
+BOE-Hydis HV150P01-100: #
+@end itemize
+
+@item
+@strong{T60 15" UXGA (1600x1200):}
+@itemize
+@item
+BOE-Hydis HV150UX1-100: #
+@item
+IDTech N150U3-L01: #
+@item
+BOE-Hydis HV150UX1-102: #
+@end itemize
+
+@item
+@strong{T60 15" QXGA (2048x1536):}
+@itemize
+@item
+IDtech IAQX10N: #
+@item
+IDtech IAQX10S: #
+@end itemize
+
+@end itemize
+
+@ref{#pagetop,Back to top of page.}
+
+@node Fallback patches
+@chapter Fallback patches
+@anchor{#fallback-patches}
+@itemize
+@item
+Todo: test gnutoo's fallback patches: @uref{http://www.coreboot.org/Fallback_mechanism,http://www.coreboot.org/Fallback_mechanism} (some parts use systemd. adapt for upstart, which is what trisquel uses)@* see @uref{gnutoo_fallback_patch,this IRC log} (warning, not cleaned up)
+@end itemize
+
+@ref{#pagetop,Back to top of page.}
+
+@node Other - unlisted low priority
+@chapter Other - unlisted (low priority)
+@anchor{#other---unlisted-low-priority}
+@itemize
+@item
+PTE errors still exist on i945 with 6718 (which is merged). @uref{http://review.coreboot.org/#/c/6718/,http://review.coreboot.org/#/c/6718/}
+@itemize
+@item
+@uref{../resources/misc/dumps/pte_x60_6718/dmesg,dmesg}
+@item
+@uref{../resources/misc/dumps/pte_x60_6718/kern.log,kern.log}
+@item
+This doesn't seem to cause any issues for general use.
+@end itemize
+
+@item
+Implement INT 10H support in i945 native graphics. (this will be a lot of work. SeaBIOS has code for some geode boards, to get a general idea).
+@item
+T60 15" QXGA (2048x1536): fixed issue where GRUB wouldn't show any graphics. (Not many people have this panel)
+@itemize
+@item
+It might be the same issue I ran into with Paul on the X60 (not enough memory being allocated) since the same code works on T60 SXGA+ and UXGA, where GRUB actually display graphics.
+@end itemize
+
+@end itemize
+
+@ref{#pagetop,Back to top of page.}
+
+Copyright © 2014, 2015 Francis Rowe <info@@gluglug.org.uk>@* 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
diff --git a/docs/src/future/old.texi b/docs/src/future/old.texi
new file mode 100644
index 00000000..e0f845fd
--- /dev/null
+++ b/docs/src/future/old.texi
@@ -0,0 +1,203 @@
+\input texinfo
+@documentencoding UTF-8
+
+@ifnottex
+@paragraphindent 0
+@end ifnottex
+@titlepage
+@title libreboot tutorials
+@end titlepage
+
+@node Top
+@top libreboot tutorials
+
+@menu
+* Development notes old/obsolete notes::
+* Table of contents::
+* X60 native graphics initialization with backlight controls::
+* T60 native graphics initialization with backlight controls::
+* i945 3D fix based on 5927 for kernel 312+ on 5320::
+* i945/X60 Coreboot 5927 testing 3D fix for kernel 312+ on replay code::
+@end menu
+
+@node Development notes old/obsolete notes
+@chapter Development notes (old/obsolete notes)
+@anchor{#development-notes-oldobsolete-notes}
+For current notes, see @uref{index.html,index.html}.
+
+These are old (obsolete) notes that mare kept because they might become useful again in the future.
+
+@node Table of contents
+@chapter Table of contents
+@anchor{#table-of-contents}
+@itemize
+@item
+@ref{#x60_native_notes,X60 native graphics initialization (backlight controls)}
+@item
+@ref{#t60_native_notes,T60 native graphics initialization (backlight controls)}
+@item
+@ref{#5320_kernel312fix,i945: 3D fix (based on 5927) for kernel 3.12+ on 5320}
+@item
+@ref{#x60_cb5927_testing,i945/x60: coreboot 5927 testing (3D fix for kernel 3.12+ on replay code)}
+@end itemize
+
+@node X60 native graphics initialization with backlight controls
+@chapter X60 native graphics initialization (with backlight controls)
+@anchor{#x60-native-graphics-initialization-with-backlight-controls}
+@strong{This is now obsolete. A better way was found (included in libreboot): @uref{http://review.coreboot.org/#/c/6731/,http://review.coreboot.org/#/c/6731/}}
+
+@strong{@emph{Also check @ref{#5320_kernel312fix,#5320_kernel312fix} (to fix 3D on kernel 3.12/higher)}}
+
+@strong{The fix below was done on 5320/6 (from review.coreboot.org) but should work just fine on later versions of 5320.}
+
+Native gpu init + backlight controls! (Fn keys). Also confirmed on X60 Tablet (1024x768) and X60 Tablet (1400x1050)
+
+@strong{Add backlight controls:} in @emph{src/mainboard/lenovo/x60/devicetree.cb}, change @strong{gpu_backlight} to @strong{0x879F879E}
+
+That's all! @strong{This has also been backported into libreboot 5th release (line 1233 in src/mainboard/lenovo/x60/i915io.c)}. GNUtoo (Denis Carikli) told me about the register @strong{BLC_PWM_CTL} and that you could set it to control backlight. I read that address using devmem2 while running the VBIOS:@* @strong{# devmem2 0xe4361254 w}
+
+The change is also included in libreboot 6.
+
+When doing this, it gave back that value. The same trick was used to get backlight controls for T60 (see @ref{#t60_native_notes,#t60_native_notes}).
+@menu
+* Further notes::
+@end menu
+
+@node Further notes
+@section Further notes
+@anchor{#further-notes}
+Reading @strong{0xe4361254} (address) in Lenovo BIOS always yields FFFFFFFF, even when writing to it (and writing to it doesn't affect brightness controls). 'mtjm' on IRC found that the buttons (Fn keys) control /sys/class/backlight/acpi_video0 which has no affect on 61254 (BLC_PWM_CTL). This person says intel_backlight has different values and uses the register. devmem2 works, needs checking @strong{lspci -vv} for where the memory is mapped, which is different than on coreboot; mtjm found that it was 0xec061254 on his system (X60 Tablet), and the register value is different too. @strong{This is relevant, because we still don't know how backlight controls are actually handled. We got it working by accident. We need to know more.}.
+
+Intel-gpu-tools may prove useful for further debugging: @uref{http://cgit.freedesktop.org/xorg/app/intel-gpu-tools/,http://cgit.freedesktop.org/xorg/app/intel-gpu-tools/}
+
+mtjm says 0xe4300000 is an MMIO region of the gpu (lspci -vv shows it), 0x61254 (BLC_PWM_CTL) is a documented register. Searching the kernel driver for backlight shows that in intel_panel.c this register is used (there is an XXX comment about finding the right value, where recent kernels get it from.
+
+What we want to do is calculate a good value, instead of setting it in devicetree.cb. mtjm says about backlight physics: it has a light source , uses pulse width modulation (PWM) to turn it on/off, dimming is done by spending less time on. @strong{Note: this may not be correct; this person says that their understanding is based on how the Lenote yeeloong works}.
+
+mtjm goes on to say, that the register specifies the frequency used for PWM in its depending on the GPU core frequency, so it might be possible to calculate it without hardcoded laptop-specific values. Therefore, I am supposed to find out the 'display core frequency' (mtjm says there might be a register for it; also, it might be in 5320 or the replay code) and the PWM modulation frequency. https://en.wikipedia.org/wiki/Backlight#Flicker_due_to_backlight_dimming
+
+phcoder (Vladimir Serbinenko) who is author of 5320 (review.coreboot.org) talks about 'duty cycle limit' and 'flickering frequency'.
+
+@ref{#pagetop,Back to top of page}
+
+@node T60 native graphics initialization with backlight controls
+@chapter T60 native graphics initialization (with backlight controls)
+@anchor{#t60-native-graphics-initialization-with-backlight-controls}
+@strong{This is now obsolete. A better way was found (included in libreboot): @uref{http://review.coreboot.org/#/c/6731/,http://review.coreboot.org/#/c/6731/}}
+
+@strong{@emph{Also check @ref{#5320_kernel312fix,#5320_kernel312fix} (to fix 3D on kernel 3.12/higher)}}
+
+@strong{The fix below was done on an earlier version of 5345 changeset (review.coreboot.org), but should work on the current version. it is included in libreboot 6}
+
+@strong{Add backlight controls:} in @emph{src/mainboard/lenovo/t60/devicetree.cb}, change @strong{gpu_backlight} to @strong{0x58BF58BE}
+
+Hold on! Check @uref{../misc/index.html#get_edid_panelname,../misc/index.html#get_edid_panelname} to know what LCD panel you have. This is important for the next step!
+@menu
+* Supported panels::
+@end menu
+
+@node Supported panels
+@section Supported panels
+@anchor{#supported-panels}
+@uref{../hcl/index.html#supported_t60_list,../hcl/index.html#supported_t60_list}.
+
+See @uref{index.html#lcd_i945_incompatibility,index.html#lcd_i945_incompatibility}.
+
+@ref{#pagetop,Back to top of page}
+
+@node i945 3D fix based on 5927 for kernel 312+ on 5320
+@chapter i945: 3D fix (based on 5927) for kernel 3.12+ on 5320
+@anchor{#i945-3d-fix-based-on-5927-for-kernel-3.12-on-5320}
+@strong{This is now obsolete. Merged in coreboot: @uref{http://review.coreboot.org/#/c/5927/,http://review.coreboot.org/#/c/5927/}}
+
+@strong{This needs to be rewritten (or better organized, or deleted?)}. This is also now included in libreboot 6 (using the proper way, not the 7c0000 method which was a hack)
+
+@strong{This was done on 5320/6 so far. The fix below is for 5320/6 which is now obsolete. This needs to be re-done for the latest version of 5320. The fix below is (in practise) only for reference, therefore.}
+
+See @ref{#x60_cb5927_testing,#x60_cb5927_testing} for the original (and current) fix, for the replay code. Now we want to implement that on top of @uref{http://review.coreboot.org/#/c/5320,http://review.coreboot.org/#/c/5320} which is the current code for native graphics initialization on i945.
+
+src/northbridge/intel/i945/gma.c (using the 7c0000 hack) on 5320: @uref{../resources/misc/dumps/5320_7c0000_gma.c,5320_7c0000_gma.c} (rename it to gma.c, replacing the current one).
+
+The above is a hack (as is the original). A better (more correct) method is implemented in later versions of 5927, so that should also be adapted for 5320. For now, you can use the above fix.
+
+The correct way to do it is to set gtt address to (end of stolen memory - gtt size), which is what later versions of 5927 do (successfully).
+
+Here is some debugging output using intel_gpu_tools v1.2-1 (from trisquel repositories) using tool "intel_gtt":
+
+@itemize
+@item
+Trisquel 6. kernel 3.14.4:
+@itemize
+@item
+with libreboot 5th release (using the 7c0000 gtt hack from 5927/3): @uref{http://paste.debian.net/104306,http://paste.debian.net/104306}
+@item
+with coreboot+vgarom: @uref{http://paste.debian.net/104309,http://paste.debian.net/104309}
+@end itemize
+
+@item
+Trisquel 6. kernel 3.2.0-60 (from Trisquel repositories):
+@itemize
+@item
+with coreboot (no vbios or native init): @uref{http://paste.debian.net/104341,http://paste.debian.net/104341}
+@end itemize
+
+@end itemize
+
+@ref{#pagetop,Back to top of page}
+
+@node i945/X60 Coreboot 5927 testing 3D fix for kernel 312+ on replay code
+@chapter i945/X60: Coreboot 5927 testing (3D fix for kernel 3.12+ on replay code)
+@anchor{#i945x60-coreboot-5927-testing-3d-fix-for-kernel-3.12-on-replay-code}
+@strong{This is now obsolete. Merged in coreboot: @uref{http://review.coreboot.org/#/c/5927/,http://review.coreboot.org/#/c/5927/}}
+
+@strong{The latest version as-is (5927/11) has not been tested by me yet. Always boot with 'drm.debug=0x06' kernel parameter when testing this.}
+
+This is the fix for 3D on kernel 3.12 and higher on i945 (ThinkPad X60 in this case). This is for the replay code. Libreboot 5th release has a version of this backported already (based on 5927/3 using the '7c0000' hack).
+
+@strong{The replay code is obsolete (see 5320 changeset on review.coreboot.org for better version which supports more systems/screens, and then 5345 for T60). Information here for reference since that is where the fix was first applied.}
+
+Read the information on @uref{http://review.coreboot.org/#/c/5927/,http://review.coreboot.org/#/c/5927/}.
+
+For historical purposes, here is a collection of IRC logs that once existed on this page, related to the issue: @uref{../resources/misc/dumps/kernel312_irc,kernel312_irc}.
+
+PGETBL_CTL differs between VBIOS (-) and native graphics init (+).@* - PGETBL_CTL: 0x3ffc0001@* + PGETBL_CTL: 0x3f800001
+
+GTT (graphics translation table) size is PGETBL_save, max 256 KiB. BSM (Base of Stolen Memory) is given by the bios.
+
+@itemize
+@item
+5927/7: @uref{../resources/misc/dumps/5927_7.tar.gz,5927_7.tar.gz} (GRUB graphics are correct now, and 3D still works)
+@item
+5927/6: @uref{../resources/misc/dumps/5927_6.tar.gz,5927_6.tar.gz} (GRUB graphics still corrupt, 3D/everything still works after GRUB)
+@item
+5927/5: @uref{../resources/misc/dumps/5927_5.tar.gz,5927_5.tar.gz} (GRUB graphics corrupt, 3D/everything still works after GRUB)
+@item
+5927/3: @uref{../resources/misc/dumps/5927_3.tar.gz,5927_3.tar.gz} (3D still works! kernel 3.14.4) - the '7c0000' hack
+@item
+5927/2: @uref{../resources/misc/dumps/5927_2.tar.gz,5927_2.tar.gz} (3D works! kernel 3.14.4) - the '7c0000' hack
+@item
+5927/1 (didn't fix the 3D issue):
+@itemize
+@item
+@uref{../resources/misc/dumps/5927_cbmemc,cbmem -c}
+@item
+@uref{../resources/misc/dumps/5927_crashdump,/sys/class/drm/card0/error}
+@item
+@uref{../resources/misc/dumps/5927_config,.config}
+@end itemize
+
+@end itemize
+
+@ref{#pagetop,Back to top of page}
+
+Copyright © 2014, 2015 Francis Rowe <info@@gluglug.org.uk>@* 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