From 3a0a9915eb802d558c0399d17a5ac045934d6be1 Mon Sep 17 00:00:00 2001 From: Alex Parker Date: Sun, 10 May 2009 18:53:34 +0000 Subject: Properly capitalise "Rockbox", and rewrite a couple of small sections. Some of this is taken from FS#9880 by Johannes Linke. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@20900 a1c6a512-1295-4272-9138-f99709370657 --- manual/advanced_topics/archos-flashing.tex | 4 ++-- manual/getting_started/installation.tex | 12 ++++------ manual/getting_started/main.tex | 37 +++++++++++++++--------------- 3 files changed, 25 insertions(+), 28 deletions(-) (limited to 'manual') diff --git a/manual/advanced_topics/archos-flashing.tex b/manual/advanced_topics/archos-flashing.tex index e2e1f4f2ce..4f6c622cd4 100644 --- a/manual/advanced_topics/archos-flashing.tex +++ b/manual/advanced_topics/archos-flashing.tex @@ -152,7 +152,7 @@ a safe place. \note{There are no separate flash packages for {\dap}s modified to have 8MB of RAM. You need to use the corresponding package for non-modified - \playertype. You should then install a rockbox image that makes use of all + \playertype. You should then install a Rockbox image that makes use of all available RAM as described in the following section. } @@ -166,7 +166,7 @@ the image in the flash. This is a simple and safe procedure: \begin{enumerate} \item Download (or build) the Rockbox build you want to use, and unzip it to the root of your \dap. Safely disconnect USB. -\item ROLO into the new rockbox version. +\item ROLO into the new Rockbox version. \item Go to the file browser, and enter the \fname{.rockbox} directory (you might need to set the \setting{File View} option to \setting{All}.) \item Play the file \fname{rockbox.ucl}\opt{rombox}{, or preferably diff --git a/manual/getting_started/installation.tex b/manual/getting_started/installation.tex index d61f51ff7f..337ed5825a 100644 --- a/manual/getting_started/installation.tex +++ b/manual/getting_started/installation.tex @@ -77,10 +77,6 @@ follow the instructions at and hold the \ButtonSelect{} and \ButtonPlay{} buttons simultaneously. Your \dap{} should enter disk mode and you can try reconnecting to the computer. } - \opt{ipod3g,ipod4g,ipodcolor,ipodmini}{ - \index{Firewire}Firewire detection is not supported in Rockbox at - the moment. Please use USB only. - } \opt{x5}{ When instructed to connect/disconnect the USB cable, always use the USB port through the subpack, not the side 'USB Host' port. The side port @@ -263,9 +259,9 @@ filesystem.\\* patched to be used with the bootloader. If you wish to install Rockbox on a US \playername{}, you must first install a non-US version of the original firmware and then install one of the supported versions patched - with the Rockbox bootloader. - \warn{Installing non-US firmware on a US \playername{} will - permanently remove DRM support from the player.}}} + with the Rockbox bootloader.} + \warn{Installing a non-US firmware on a US \playername{} will + \emph{permanently} remove DRM support from the player.}} If the file that you downloaded is a \fname{.zip} file, use an unzip utility like mentioned in the prerequisites section to extract @@ -553,7 +549,7 @@ completely follow the manual uninstallation instructions below.}} connect the \dap{} to your computer, and follow the instructions to install the bootloader, but when prompted by sansapatcher, enter \texttt{u} for uninstall, instead of \texttt{i} for install. As in the installation, it may be necessary to - first put your device into MSC mode. + first put your \dap{} into MSC mode. } \optv{ipod}{ diff --git a/manual/getting_started/main.tex b/manual/getting_started/main.tex index 9b68312723..f5eba1fae8 100644 --- a/manual/getting_started/main.tex +++ b/manual/getting_started/main.tex @@ -35,27 +35,28 @@ of call when looking for further help. If you cannot find the information you are searching for on the Rockbox website there are a number of support channels you should have a look at. You can try the Rockbox forums located at \url{http://forums.rockbox.org/}. -Another option are the mailing lists which can be found at +The mailing lists are another option, and can be found at \url{http://www.rockbox.org/mail/}. From that page you can subscribe to the -lists and browse the archives. For searching the list archives simply use +lists and browse the archives. To search the list archives simply use the search field that is located on the left side of the website. -Also you can ask on IRC. The main channel for Rockbox is \texttt{\#rockbox} -on \url{irc://irc.freenode.net}. A bunch of helpful developers and users -are usually around. Just join and ask -- if someone knows the answer you'll +Furthermore, you can ask on IRC. The main channel for Rockbox is +\texttt{\#rockbox} on \url{irc://irc.freenode.net}. Many helpful developers +and users are usually around. Just join and ask your question (don't ask to +ask!) -- if someone knows the answer you'll usually get an answer pretty quickly. More information including IRC logs can be found at \url{http://www.rockbox.org/irc/}. We also have a web client -for joining the rockbox IRC channel so there is no need for you -to install additional software to your computer. +so that you can join the Rockbox IRC channel without needing +to install additional software onto your computer. If you think you have found a bug please make sure it actually is a bug and is -still present in the most recent version of rockbox. You should try to +still present in the most recent version of Rockbox. You should try to confirm that by using the above mentioned support channels first. After that you can submit that issue to our tracker. Refer to \reference{sec:feedback} for details on how to use the tracker. \section{Naming conventions and marks} -We have some conventions especially on naming that are intended to be +We have some conventions (especially for naming) that are intended to be consistent throughout this manual. Manufacturer and product names are formatted in accordance with the standard @@ -70,23 +71,23 @@ you finding important parts or parts you could skip. The following icons are used: \\ \note{This indicates a note. A note starts always with the text ``Note''. - For easier finding of notes we have put this an icon in the margin like - here. Notes are used to mark information that could help you - or indicate a possible ``weirdness'' in rockbox that would be explained. + In order to make finding notes easier each one is accompanied by + an icon in the margin as here. Notes are used to mark useful information + that may help you to get the most out of Rockbox. \\ } \warn{This is a warning. In contrast to notes mentioned above, a warning - should be taken more seriously. While ignoring notes will not cause any serious - damage ignoring warnings \emph{could} cause serious damage. If you are new to - rockbox you should really read the warnings before doing anything that is - warned about. + should be taken more seriously. Whereas ignoring notes will not cause any + serious damage, ignoring warnings \emph{could} cause serious damage to + your \dap{}. You really should read the warnings, especially if you are + new to Rockbox. \\ } \blind{This icon marks a section that is intended especially for the blind and visually impaired. As they cannot read the manual in the same way sighted people do we have added some - additional descriptions. If you are not blind or visually impaired you most - likely can completely skip these blocks. To make this easier, there is an + additional descriptions. If you are not blind or visually impaired you + can probably completely skip these blocks. To make this easier, there is an icon shown in the margin on the right. \\ } -- cgit v1.2.3