Manual: The c200v2 also needs to be set to MSC mode for installation.
[maemo-rb.git] / manual / appendix / appendix.tex
blob39a1f603e1a8bd57784473c748afc9fbea7ef752
1 % $Id$ %
2 \appendix
4 \input{appendix/file_formats.tex}
6 \opt{lcd_bitmap}{\input{appendix/album_art_info.tex}}
8 \input{appendix/wps_tags.tex}
10 \input{appendix/config_file_options.tex}
12 \input{appendix/menu_structure.tex}
14 \chapter{User feedback}\label{sec:feedback}
15 \section{Bug reports}
16 If you experience inappropriate performance from any supported feature,
17 please file a bug report on our web page. Do not report missing
18 features as bugs, instead file them as feature ideas (see below).
20 For open bug reports refer to
21 \url{http://www.rockbox.org/tracker/index.php?type=2}
23 \subsection{Rules for submitting new bug reports}
25 \begin{enumerate}
26 \item Check that the bug has not already been reported
27 \item Always include the following information in your bug report:
29 \begin{itemize}
30 \item Which exact \dap{} you have.
31 \item Which exact Rockbox version you are using
32 (Menu $\rightarrow$ System $\rightarrow$ Rockbox Info $\rightarrow$ Version)
33 \item A step{}-by{}-step description of what you did and what happened
34 \item Whether the problem is repeatable or a one{}-time occurrence
35 \item All relevant data regarding the problem, such as playlists, MP3
36 files etc. (IMPORTANT!)
37 \end{itemize}
38 \end{enumerate}
40 \section{Feature ideas}
41 To suggest an idea for a feature or to read those made by others, see
42 \url{http://forums.rockbox.org/index.php?board=49.0}. Please keep in
43 mind that this forum is for the discussion of feature ideas - they are not
44 requests and there is no guarantee they will be acted upon.
46 \subsection{Rules for submitting a new feature idea}
48 \begin{enumerate}
49 \item Check that the feature has not already been suggested.
50 Duplicates are really boring!
51 \item Check that the feature has not already been implemented.
52 Download the latest current/daily build and/or search the mail list archive.
53 \item Check that the feature is possible to implement (see \reference{ref:NODO}).
54 \end{enumerate}
56 \subsection{\label{ref:NODO}Features we will not implement}
57 This is a list of Feature Requests we get repeatedly that we simply
58 cannot do. View it as the opposite of a TODO!
60 \begin{itemize}
61 \opt{archos}{
62 \item Record to WAV (uncompressed) or MP3pro format.\\
63 The recording hardware (the MAS) does not allow us to do this
64 \item Crossfade between tracks.\\
65 Crossfading would require two mp3 decoders, and we only have one.
66 This is not possible.
67 \item Support MP3pro, WMA or other sound format playback.\\
68 The mp3{}-decoding hardware can only play MP3. We cannot make it play other
69 sound formats.
70 \item Converting OGG $\rightarrow$ MP3.\\
71 The mp3{}-decoding hardware cannot decode OGG. It can be reprogrammed, but
72 there is too little memory for OGG and we have no documentation on how to
73 program the MAS' DSP. Doing the conversion with the CPU is impossible, since
74 a 12~MHz SH1 is far too slow for this daunting task.
75 \item Archos Multimedia support.\\
76 The Archos Multimedia is a completely different beast. It is an entirely
77 different architecture, different CPU and upgrading the software is done
78 a completely different way. We do not wish to venture into this. Others
79 may do so. We will not.
80 \item Multi{}-band (or graphic) equaliser.\\
81 We cannot access information for that kind of visualisation from the MP3
82 decoding hardware.
83 \item CBR recording.\\
84 The MP3 encoding hardware does not allow this.
85 \item Change tempo of a song without changing pitch.\\
86 The MP3 decoding hardware does not allow this.
87 \item Graphic frequency (spectrum analyser).\\
88 We cannot access the audio waveform from the MP3 decoder so we cannot analyse
89 it. Even if we had access to it, the CPU would probably be too slow to
90 perform the analysis anyway.
91 \item Cool sound effects.\\
92 Adding new sound effects requires reprogramming the MAS chip, and we cannot
93 do that. The MAS chip is programmable, but we have no access to the chip
94 documentation.
96 \nopt{iriverh300,iaudiox5}{
97 \item Interfacing with other USB devices (like cameras) or 2 player games over USB.\\
98 The USB system demands that there is a master that talks to a slave. The
99 \dap{} can only serve as a slave, as most other USB devices such as
100 cameras can. Thus, without a master no communication between the slaves
101 can take place. If that is not enough, we have no way of actually
102 controlling the communication performed over USB since the USB circuit
103 in the \dap{} is strictly made for disk{}-access and does not allow us
104 to play with it the way we'd need for any good communication to work.
106 \item Support other file systems than FAT32 (like NTFS or ext2 etc.).\\
108 \opt{archos}{Rockbox needs to support FAT32 since it can only start off a FAT32
109 partition (since that is the only way the ROM can load it), and adding}%
110 support for more file systems will just take away valuable ram for
111 unnecessary features. You can partition your \dap{} fine, just make sure
112 the first one is FAT32 and then make the other ones whatever file system
113 you want. Just do not expect Rockbox to understand them.
114 \item Add scandisk{}-like features.\\
115 It would be a very slow operation that would drain the batteries and
116 take a lot of useful ram for something that is much better and faster
117 done when connected to a host computer.
118 \item Alphabetical list skipping.\\
119 Skipping around the lists by jumping letters (i.e skip all C's and go
120 straight to the first D). This isn't feasible with the current list
121 implementation, if you really want this you can get similar effects using
122 the database (see \reference{ref:database}).
123 \item Add support for non standard tag formats.\\
124 APE tags in MP3 files has been rejected a few times already. Its not something we want.
125 \item Implementing the ability to playback DRM files.\\
126 Firstly, this would be extremely difficult to implement legally - Rockbox
127 is not legal entity as such, and therefore is unable to enter into license
128 agreements with providers of DRM technology.
129 Secondly, Rockbox is open source, which would mean that any DRM technology we
130 incorporated into our codebase would suddenly become visible to the whole world,
131 completely defeating its purpose. Remember, DRM achieves part of its security
132 through obscurity, and publishing the keys necessary to decrypt DRM'd
133 media would essentially render it useless.
134 \end{itemize}
136 \chapter{Credits}
137 People that have contributed to the project, one way or another. Friends!
139 \begin{multicols}{2}
140 \noindent\caps{\small{\input{CREDITS.tex}}}
141 \end{multicols}
143 \chapter{Licenses}
145 \section{GNU Free Documentation License}
146 \input{appendix/fdl.tex}
147 \newpage
148 \section{The GNU General Public License}
149 \input{appendix/gpl-2.0.tex}