manual/getting_started/main.tex

   1 % $Id$ %
   2 \chapter{Introduction}
   3 \section{Welcome}
   4 This is the manual for Rockbox. Rockbox is an open source firmware replacement
   5 for a growing number of digital audio players. Rockbox aims to be considerably
   6 more functional and efficient than your device's stock firmware while remaining
   7 easy to use and customisable. Rockbox is written by users, for users. Not only
   8 is it free to use, it is also released under the GNU General Public License
   9 (GPL), which means that it will always remain free both to use and to change.
  10
  11 Rockbox has been in development since 2001, and receives new features, tweaks
  12 and fixes each day to provide you with the best possible experience on your
  13 digital audio player. A major goal of Rockbox is to be simple and easy to use,
  14 yet remain very customisable and configurable. We believe that you should never
  15 need to go through a series of menus for an action you perform frequently. We
  16 also believe that you should be able to configure almost anything about Rockbox
  17 you could want, pertaining to functionality. Another top priority of Rockbox is
  18 audio playback quality -- Rockbox, for most models, includes a wider range of
  19 sound settings than the device's original firmware. A lot of work has been put
  20 into making Rockbox sound the best it can, and improvements are constantly being
  21 made. All models have access to a large number of plugins, including many games,
  22 applications, and graphical ``demos''. You can load different configurations
  23 quickly for different purposes (e.g. a large font for in your car, different
  24 sound settings for at home). Rockbox features a very wide range of languages, and
  25 all supported models also have the ability to talk to you -- menus can be voiced
  26 and filenames spelled out or spoken.
  27
  28 \section{Getting more help}
  29 This manual is intended to be a comprehensive introduction to the Rockbox
  30 firmware. There is, however, more help available. The Rockbox website at
  31 \url{http://www.rockbox.org/} contains very extensive documentation and guides
  32 written by members of the Rockbox community and this should be your first port
  33 of call when looking for further help.
  34
  35 If you cannot find the information you are searching for on the Rockbox
  36 website there are a number of support channels you should have a look at.
  37 You can try the Rockbox forums located at \url{http://forums.rockbox.org/}.
  38 The mailing lists are another option, and can be found at
  39 \url{http://www.rockbox.org/mail/}. From that page you can subscribe to the
  40 lists and browse the archives. To search the list archives simply use
  41 the search field that is located on the left side of the website.
  42 Furthermore,  you can ask on IRC. The main channel for Rockbox is
  43 \texttt{\#rockbox} on \url{irc://irc.freenode.net}. Many helpful developers
  44 and users are usually around. Just join and ask your question (don't ask to
  45 ask!) -- if someone knows the answer you'll
  46 usually get an answer pretty quickly. More information including IRC logs
  47 can be found at \url{http://www.rockbox.org/irc/}. We also have a web client
  48 so that you can join the Rockbox IRC channel without needing
  49 to install additional software onto your computer.
  50
  51 If you think you have found a bug please make sure it actually is a bug and is
  52 still present in the most recent version of Rockbox. You should try to
  53 confirm that by using the above mentioned support channels first. After that
  54 you can submit that issue to our tracker. Refer to \reference{sec:feedback}
  55 for details on how to use the tracker.
  56
  57
  58 \section{Naming conventions and marks}
  59 We have some conventions (especially for naming) that are intended to be
  60 consistent throughout this manual.
  61
  62 Manufacturer and product names are formatted in accordance with the standard
  63 rules of English grammar, e.g. ``\playerman{} playback is currently
  64 unsupported''. Manufacturer and model names are proper nouns, and
  65 thus are written beginning with a capital letter.
  66
  67 % write a bit more about names etc. here.
  68 \ifpdfoutput{
  69 This manual has some parts that are marked with icons on the margin to help
  70 you finding important parts or parts you could skip. The following icons
  71 are used:
  72 \\
  73 \note{This indicates a note. A note starts always with the text ``Note''.
  74   In order to make finding notes easier each one is accompanied by
  75   an icon in the margin as here. Notes are used to mark useful information
  76   that may help you to get the most out of Rockbox.
  77 \\
  78 }
  79 \warn{This is a warning. In contrast to notes mentioned above, a warning
  80   should be taken more seriously. Whereas ignoring notes will not cause any
  81   serious damage, ignoring warnings \emph{could} cause serious damage to
  82   your \dap{}. You really should read the warnings, especially if you are
  83   new to Rockbox.
  84 \\
  85 }
  86 \blind{This icon marks a section that is intended especially for the blind
  87   and visually impaired. As they cannot
  88   read the manual in the same way sighted people do we have added some
  89   additional descriptions. If you are not blind or visually impaired you
  90   can probably completely skip these blocks. To make this easier, there is an
  91   icon shown in the margin on the right.
  92 \\
  93 }
  94 }{}% end ifpdfoutput
  95
  96 Links to the wiki are abbreviated by the name of the wiki page. Those names
  97 are still linked so you can simply follow them like any other link in this
  98 manual. If you want to access a wiki page manually go to
  99 \wikiicon{} \href{\wikibaseurl}{\wikibaseurl}
 100 and type the page name in the ``Go'' box at the top of the page.
 101 \ifpdfoutput{Links to wiki pages are also indicated by the symbol \wikiicon{}
 102 in front of the page name.}{}
 103
 104 \input{getting_started/installation.tex}