Update Beast installation instructions to use beastpatcher and remove instructions for fixing partition table as this will shortly be done on-the-fly by the bootloader. Download locations for beastpatcher still required.

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@20084 a1c6a512-1295-4272-9138-f99709370657

2 files changed, 96 insertions, 65 deletions

diff --git a/manual/getting_started/gigabeats_install.tex b/manual/getting_started/gigabeats_install.tex
index 2bc8e094c8..317e190fe0 100644
--- a/manual/getting_started/gigabeats_install.tex
+++ b/manual/getting_started/gigabeats_install.tex
@@ -22,57 +22,84 @@ bootloader) and executed when your \dap{} is powered on.
 \subsubsection{Bootloader installation from Windows}
 
 \begin{enumerate}
-\item Download \fname{sendfirm.exe} from \fixme{add download location}.
-\item Download the bootloader (\fname{nk.bin}) from \fixme{add download location}.
-\item From the command prompt, enter the directory into which you downloaded
-\fname{sendfirm.exe} and \fname{nk.bin} and run:
-\begin{code} 
-    sendfirm.exe nk.bin
-\end{code}
-\item After a successful installation, your \dap{} will immediately reboot
-and (because it is still connected to your PC) enter the Rockbox bootloader's
+
+\item Attach your \dap{} to your computer.
+
+\item Download \fname{beastpatcher.exe} from
+\fixme{add download location}
+and run it.
+
+\item You should see some information displayed about
+your \dap{} and a message asking you if you wish to install the Rockbox
+bootloader. Press i followed by ENTER, and beastpatcher will
+install the bootloader. After a short time you should see the message
+``[INFO] Bootloader installed successfully'' followed by some error
+messages that you can safely ignore. Press ENTER again to exit
+beastpatcher.
+
+\item After a successful installation, your \dap{} will immediately turn off.
+Turn it on again, and (because it is still connected to your PC)
+it will enter the Rockbox bootloader's
 ``USB Mass Storage'' mode, which exposes your \daps{} disk to your computer
 as a standard USB Mass Storage device.
 \end{enumerate}
 
-\subsubsection{Bootloader installation from Unix (Linux / Mac OS X)}
-
+\subsubsection{Bootloader installation from Mac OS X}
 \begin{enumerate}
-\item Download \fname{sendfirm} from \fixme{add download location}.
-\item Download the bootloader (\fname{nk.bin}) from \fixme{add download location}.
-\item From the terminal, enter the directory into which you downloaded
-\fname{sendfirm} and \fname{nk.bin} and run:
-\begin{code} 
-    chmod +x sendfirm 
-    ./sendfirm nk.bin
-\end{code}
-\item After a successful installation, your \dap{} will immediately reboot
-and (because it is still connected to your PC) enter the Rockbox bootloader's
+\item Attach your \dap{} to your computer.
+
+\item Download and open beastpatcher.dmg from 
+\fixme{add download location}
+and then double-click on the beastpatcher icon inside. You can also
+drag the beastpatcher icon to a location on your hard drive and launch
+it from the Terminal.
+
+\item If all has gone well, you should see some 
+information displayed about your \dap{} and a message asking you if you 
+wish to install the Rockbox bootloader. Press i followed by ENTER, and 
+beastpatcher will now install the bootloader. After a short time you 
+should see the message ``[INFO] Bootloader installed successfully''
+followed by some error messages that you can safely ignore. Press 
+ENTER again to exit beastpatcher and then quit the Terminal application.
+
+\item After a successful installation, your \dap{} will immediately turn off.
+Turn it on again, and (because it is still connected to your Mac)
+it will enter the Rockbox bootloader's
 ``USB Mass Storage'' mode, which exposes your \daps{} disk to your computer
 as a standard USB Mass Storage device.
 \end{enumerate}
 
-\subsubsection{Fixing the partition table}
-The factory-standard partition table on your \daps{} disk is technically
-invalid, and the Linux kernel (and maybe other operating systems) rejects it.
-To fix this, you need to use the fdisk utility to correctly set the ``bootable
-flag'' field to a valid value (it doesn't matter if this is true or false).\\
-
-\note{Windows does not seem to mind this, so if you only use your \dap{} with
-Windows the following steps are not necessary.\\}
-
-Assuming your \dap{} is appearing as /dev/sdz (the output of the dmesg
-command will show the log messages including the device node assigned to
-your \dap{}), type the following:
-
-\begin{code}
-    fdisk /dev/sdz
-    a
-    1
-    a
-    2
-    w
+\subsubsection{Bootloader installation from Linux}
+
+\begin{enumerate}
+
+\item Download beastpatcher from
+\fixme{add download location} (32-bit x86 
+binary) or \fixme{add download location} 
+(64-bit amd64 binary). You can save this anywhere you wish, but the next 
+steps will assume you have saved it in your home directory.
+
+\item Attach your \dap{} to your computer.
+
+\item Open up a terminal window and type the following commands:
+
+\begin{code} 
+    cd $HOME
+    chmod +x beastpatcher
+    ./beastpatcher
 \end{code}
 
-After exiting fdisk, you may need to unplug and then reattach your \dap{}
-in order for it to be recognised by your computer.
\ No newline at end of file
+\item If all has gone well, you should see some information displayed about
+your \dap{} and a message asking you if you wish to install the Rockbox
+bootloader. Press i followed by ENTER, and beastpatcher will now install the
+bootloader. After a short time you should see the message ``[INFO] Bootloader
+installed successfully'' followed by some error
+messages that you can safely ignore. Press ENTER again to exit beastpatcher.
+
+\item After a successful installation, your \dap{} will immediately turn off.
+Turn it on again, and (because it is still connected to your PC)
+it will enter the Rockbox bootloader's
+``USB Mass Storage'' mode, which exposes your \daps{} disk to your computer
+as a standard USB Mass Storage device.
+
+\end{enumerate}
\ No newline at end of file
diff --git a/manual/getting_started/installation.tex b/manual/getting_started/installation.tex
index 9299aefb8a..acffcaf590 100644
--- a/manual/getting_started/installation.tex
+++ b/manual/getting_started/installation.tex
@@ -341,14 +341,14 @@ data partiton.}}
 
 \item Take the \fname{.zip} file that you downloaded and use
  the ``Extract all'' command of your unzip program to extract 
- the files onto your \dap{}.
+ the files onto \opt{gigabeats}{the main data partition of }your \dap{}.
 \end{enumerate}
 
 \note{The entire contents of the \fname{.zip} file should be extracted 
 directly to the root of your \daps{} drive. Do not try to
 create a separate directory on your \dap{} for the Rockbox
 files! The \fname{.zip} file already contains the internal
-structure that Rockbox needs.}
+structure that Rockbox needs.\\}
 
 \opt{archos}{
  If the contents of the \fname{.zip} file are extracted correctly, you will
@@ -427,6 +427,9 @@ structure that Rockbox needs.}
 \end{itemize}
 }
 
+\opt{e200}{Your e200 will automatically reboot and Rockbox should load.}
+
+
 
 \subsection{Enabling Speech Support (optional)}\label{sec:enabling_speech_support}
 \index{Speech}\index{Installation!Optional Steps}
@@ -443,24 +446,22 @@ Rockbox Utility can also aid in the production of talk files, which allow Rockbo
 to speak file and folder names.
 
 \section{Running Rockbox}
-\nopt{ipod,e200,gigabeats}{Unplug any connected power supply and turn the unit off. When
-you next turn the unit on, Rockbox should load.}%
-\opt{ipod}{Hard resetting the Ipod by holding
+\nopt{ipod,gigabeats}{When
+you turn the unit on, Rockbox should load.}
+\opt{ipod}{Hard reset the Ipod by holding
   \opt{IPOD_4G_PAD}{\ButtonMenu{}+\ButtonSelect{}}%
   \opt{IPOD_3G_PAD}{\ButtonMenu{}+\ButtonPlay{}}
   for a couple of seconds until the \dap{} resets. Now Rockbox should load.
-} %
-\opt{e200}{Your e200 will automatically reboot and Rockbox should load. }%
-When you see the Rockbox splash screen, Rockbox is loaded and ready for
-use.
+}
+
+\opt{gigabeats}{Rockbox should automatically load when you turn on your player.\\
 
-\opt{gigabeats}{Rockbox should automatically load when you unplug the USB
-cable.
   \note{
-    If you have loaded music onto your \dap{} using the \playerman{} firmaware, 
-    you will not be able to see your music properly in the \setting{File Browser}. 
-    Files placed on your \dap{} using the \playerman{} can be viewed by
-    initialising and using Rockbox's database.
+    If you have loaded music onto your \dap{} using the \playerman{}
+    firmware, you will not be able to see your music properly in the
+    \setting{File Browser} as MTP mode changes the location and file names. 
+    Files placed on your \dap{} using the \playerman{} firmware can be
+    viewed by initialising and using Rockbox's database.
     See \reference{ref:database} for more information.}
 }
 
@@ -588,6 +589,10 @@ completely follow the manual uninstallation instructions below.}}
 }
 
 \opt{gigabeats}{
+  If you wish to clean up your disk by deleting the
+  \fname{.rockbox} directory and its contents, this must be done
+  before uninstalling the bootloader in the next step.
+
   Before installation you should have downloaded a copy of the \playerman{}
   firmware from
   \url{http://www.tacp.toshiba.com/tacpassets-images/firmware/MESV12US.zip}.
@@ -597,16 +602,15 @@ completely follow the manual uninstallation instructions below.}}
   \fname{Autorun.inf} and \fname{gbs\_update\_1\_2\_us.exe}.  Extract them with
   your favourite unzipping utility e.g. 7zip.
   \item Connect your \dap{} to your computer.
-  \item From Windows, you can run \fname{gbs\_update\_1\_2\_us.exe} to restore
-  your \dap{}
-  \warn{This will format your \dap{}, removing all files}
-  \item From Linux, extract \fname{nk.bin} from within
+  \item Extract \fname{nk.bin} from within
   \fname{gbs\_update\_1\_2\_us.exe} using e.g. 7zip and copy it to the 150 MB
-  firmware partition of your \dap{}.  If you wish to clean up your disk,
-  you may also wish to delete the \fname{.rockbox} directory and its contents
-  from the main partition.
+  firmware partition of your \dap{}.
   \item Safely eject / unmount the USB drive, unplug the cable and restart.
   \end{itemize}
+
+  \note{From Windows, you can also run \fname{gbs\_update\_1\_2\_us.exe}
+  directly to restore your \dap{}. This will format your \dap{}, 
+  removing all files.}
 }
 
 \section{Troubleshooting}