4 files changed, 130 insertions, 0 deletions
diff --git a/build/templates/docstruct.ent b/build/templates/docstruct.ent
index 2c3a726eb..bc3cd38e6 100644
--- a/build/templates/docstruct.ent
+++ b/build/templates/docstruct.ent
@@ -85,6 +85,7 @@
   <!ENTITY boot-installer-intro-cd.xml     SYSTEM "##SRCPATH##/boot-installer/intro-cd.xml">
   <!ENTITY boot-installer-intro-hd.xml     SYSTEM "##SRCPATH##/boot-installer/intro-hd.xml">
   <!ENTITY boot-installer-intro-net.xml    SYSTEM "##SRCPATH##/boot-installer/intro-net.xml">
+  <!ENTITY boot-installer-intro-firmware.xml     SYSTEM "##SRCPATH##/boot-installer/intro-firmware.xml">
   <!ENTITY boot-installer-m68k.xml         SYSTEM "##SRCPATH##/boot-installer/m68k.xml">
   <!ENTITY boot-installer-mips.xml         SYSTEM "##SRCPATH##/boot-installer/mips.xml">
   <!ENTITY boot-installer-powerpc.xml      SYSTEM "##SRCPATH##/boot-installer/powerpc.xml">
diff --git a/debian/changelog b/debian/changelog
index f0e511200..9f73c9d30 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -48,6 +48,7 @@ installation-guide (2006XXXX) UNRELEASED; urgency=low
   * Improve the Netwinder TFTP boot instructions.
   * The Netwinder firmware is no longer available due to license problems.
   * Mention NSLU2 download location.
+  * Describe how to flash the installer image onto the NSLU2.
 
  -- Joey Hess <joeyh@debian.org>  Tue, 21 Feb 2006 16:46:06 -0500
 
diff --git a/en/boot-installer/arm.xml b/en/boot-installer/arm.xml
index 6cd45e302..d891ecbbb 100644
--- a/en/boot-installer/arm.xml
+++ b/en/boot-installer/arm.xml
@@ -119,3 +119,113 @@ To boot a CD-ROM from the Cyclone console prompt, use the command
 
 </para>
   </sect2>
+
+
+  <sect2 arch="arm" id="boot-firmware"><title>Booting from Firmware</title>
+
+&boot-installer-intro-firmware.xml;
+
+  <sect3 arch="arm" id="boot-firmware-nslu2"><title>Booting the NSLU2</title>
+
+<para>
+
+There are three ways how to put the installer firmware into flash:
+
+  <sect4 arch="arm"><title>Using the NSLU2 web interface</title>
+
+<para>
+
+Go to the administration section and choose the menu item
+<literal>Upgrade</literal>.  You can then browse your disk for the
+installer image you have previously downloaded.  Then press the
+<literal>Start Upgrade</literal> button, confirm, wait for a few minutes
+and confirm again.  The system will then boot straight into the installer.
+
+</para>
+
+   </sect4>
+
+  <sect4 arch="arm"><title>Via the network using Linux/Unix</title>
+
+<para>
+
+You can use <command>upslug2</command> from any Linux or Unix machine to
+upgrade the machine via the network.  This software is packaged for
+Debian.
+
+First, you have to put your NSLU2 in upgrade mode:
+
+<orderedlist>
+<listitem><para>
+
+Disconnect any disks and/or devices from the USB ports.
+
+</para></listitem>
+<listitem><para>
+
+Power off the NSLU2
+
+</para></listitem>
+<listitem><para>
+
+Press and hold the reset button (accessible through the small hole on the
+back just above the power input).
+
+</para></listitem>
+<listitem><para>
+
+Press and release the power button to power on the NSLU2.
+
+</para></listitem>
+<listitem><para>
+
+Wait for 10 seconds watching the ready/status LED. After 10 seconds it
+will change from amber to red. Immediately release the reset button.
+
+</para></listitem>
+<listitem><para>
+
+The NSLU2 ready/status LED will flash alternately red/green (there is a 1
+second delay before the first green). The NSLU2 is now in upgrade mode.
+
+</para></listitem>
+</orderedlist>
+
+See the <ulink url="NSLU2-Linux
+pages">http://www.nslu2-linux.org/wiki/OpenSlug/UsingTheBinary</ulink> if
+you have problems with this.
+
+Once your NSLU2 is in upgrade mode, you can flash the new image:
+
+<informalexample><screen>
+sudo upslug2 -i di-nslu2.bin
+</screen></informalexample>
+
+Note that the tool also shows the MAC address of your NSLU2, which may come
+in handy to configure your DHCP server.  After the whole image has been
+written and verified, the system will automatically reboot.  Make sure you
+connect your USB disk again now, otherwise the installer won't be able to
+find it.
+
+</para>
+
+   </sect4>
+
+  <sect4 arch="arm"><title>Via the network using Windows</title>
+
+<para>
+
+There is <ulink url =
+"http://www.everbesthk.com/8-download/sercomm/firmware/all_router_utility.zip">a
+tool</ulink> for Windows to upgrade the firmware via the network.
+
+</para>
+
+   </sect4>
+
+</para>
+
+   </sect3>
+
+  </sect2>
+
diff --git a/en/boot-installer/intro-firmware.xml b/en/boot-installer/intro-firmware.xml
new file mode 100644
index 000000000..454681b70
--- /dev/null
+++ b/en/boot-installer/intro-firmware.xml
@@ -0,0 +1,18 @@
+<!-- retain these comments for translator revision tracking -->
+<!-- $Id$ -->
+
+<para>
+
+There is an increasing number of consumer devices that directly boot from a
+flash chip on the device.  The installer can be written to flash so it will
+automatically start when you reboot your machines.
+
+</para><note><para>
+
+In many cases, changing the firmware of an embedded device voids your
+warranty.  Sometimes you are also not able to recover your device if there
+are problems during the flashing process.  Therefore, please take care and
+follow the steps precisely.
+
+</para></note>
+