From 4bc7bdfe7cd8ff127d32dd91037fdf261b870492 Mon Sep 17 00:00:00 2001
From: Dominik Riebeling <Dominik.Riebeling@gmail.com>
Date: Sun, 2 Apr 2006 22:18:22 +0000
Subject: Fix some typographic errors. First try for installation instructions.

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@9443 a1c6a512-1295-4272-9138-f99709370657
---
 manual/getting_started/main.tex | 39 ++++++++++++++++++++++++++++-----------
 1 file changed, 28 insertions(+), 11 deletions(-)

(limited to 'manual/getting_started/main.tex')

diff --git a/manual/getting_started/main.tex b/manual/getting_started/main.tex
index 1c1a1f14d1..96f8a389a7 100644
--- a/manual/getting_started/main.tex
+++ b/manual/getting_started/main.tex
@@ -14,20 +14,19 @@ customizable and configurable. We believe that you should never need to go
 through a series of menus for an action you perform frequently. We also believe
 that you should be able to configure almost anything about Rockbox you could
 want, pertaining to functionality. Another top priority of Rockbox is audio
-playback quality - Rockbox, for most models, includes a wider range of sound
+playback quality -- Rockbox, for most models, includes a wider range of sound
 settings than that device's original firmware. A lot of work has been put into
 making Rockbox sound the best it can, and improvements are constantly being made.
 All models have access to a large number of plugins, including many games,
-applications, and graphical "demos". You can load different configurations
+applications, and graphical ``demos''. You can load different configurations
 quickly for different purposes (e.g. a large font for in your car, different
-sound settings for at home).Rockbox features a very wide range of languages, and
-all supported models also have the ability to talk to you - menus can be voiced
+sound settings for at home). Rockbox features a very wide range of languages, and
+all supported models also have the ability to talk to you -- menus can be voiced
 and filenames spelled out or spoken.
 
 \section{Getting more help}
 This manual is intended to be a comprehensive introduction to the Rockbox
-software.
-  There is, however, more help available.  The Rockbox website at
+software. There is, however, more help available.  The Rockbox website at
 \url{http://www.rockbox.org/} contains very extensive documentation and guides
 written by members of the Rockbox community and this should be your first port
 of call when looking for further help.
@@ -39,7 +38,7 @@ of call when looking for further help.
 The latest release of the Rockbox software will always be available from
 \url{http://www.rockbox.org/download/}.
 \opt{MASCODEC}{
-  Windows users may wish to download the self{}-extracting Windows installer,
+  Windows users may wish to download the self-extracting Windows installer,
   which works for all Jukebox models, but those wishing to install manually or
   using a different operating system should choose the .zip archive containing
   the firmware for their model of the Jukebox.
@@ -47,17 +46,30 @@ The latest release of the Rockbox software will always be available from
 
 \section{Installing Rockbox}\label{sec:installing_rockbox}
 \opt{MASCODEC}{
+  \subsection{Using the windows installer}
   Using the Windows self installing executable to install Rockbox is the easiest
   method of installing the software on your Jukebox.  Simply follow the
-  on{}-screen instructions and select the appropriate drive letter and Jukebox
+  on-screen instructions and select the appropriate drive letter and Jukebox
   model when prompted.  You can use ``Add / Remove Programs'' to uninstall the
   software at a later date.
+
+  \subsection{Manual installation}
+  For non{}-Windows users and those wishing to install manually from the archive
+  the procedure is still fairly simple.
 }
 \opt{SWCODEC}{
-  \fixme{INCLUDE INSTALL INSTRUCTIONS FOR IRIVERS, IPODS, IAUDIO HERE.}
+  \subsection{Installing the bootloader}
+  Installing the bootloader is the trickiest part of the installation.
+  \fixme{add note for other OS as windows. Point to the appropriate wiki page}
+  Due to legal reasons the Rockbox project can not provide ready-to-use flash
+  images. Instead, you need to get an original firmware from your \dap s
+  manufacturer homepage and modify it to include the rockbox bootloader.
+  \fixme{include further bootloader install instructions: iriver, ipod, iaudio}
+  \fixme{add something about the bootloader, esp. the bootloader usb mode}
+  \subsection{Installing the firmware}
+  After installing the bootloader the installation becomes fairly easy.
 }
-For non{}-Windows users and those wishing to install manually from the archive
-the procedure is still fairly simple.  Connect your \playername\ to the
+  Connect your \playername\ to the
 computer via USB as described in the manual that came with your \playername. On
 Windows, the \playername\ drive will appear as a drive letter in your
 ``My Computer'' folder. Take the file that you downloaded above, and unpack
@@ -69,6 +81,10 @@ You will need to unpack all of the files in the archive onto your hard disk. If
 \fname{\firmwarefilename} in the main folder of your \playername\ drive, and
 also a folder called /\fname{.rockbox}, which contains a number of system files
 used by the software.
+\note{Please note that the firmware folder starts with a leading dot. You may
+experience problems when trying to create such folders when using Windows.
+Directly unzipping to your \dap's drive works flawlessly, only Windows'
+explorer is limited handling with such files.}
 
 \section{Enabling Speech Support (optional)}\label{sec:enabling_speech_support}
 If you wish to use speech support you will also need a language file, available
@@ -92,3 +108,4 @@ connect the \playername\ to your computer, and delete the
 \fname{\firmwarefilename} file. If you wish to clean up your disk, you may also
 wish to delete the \fname{.rockbox} folder and its contents. Turn the
 \playername\ off and on and the normal \playername\ software will load.
+
-- 
cgit v1.2.3

