summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMartin Arver <martin.arver@gmail.com>2006-03-13 13:29:27 +0000
committerMartin Arver <martin.arver@gmail.com>2006-03-13 13:29:27 +0000
commit784e0e13c9ad94ef81c442dfbd5b099909ae748a (patch)
treef7924390b9f06ceea4e4e978d2d4636fabd5a6a3
parent25efd331e82ef49da700bbd567195d80fffb33eb (diff)
downloadrockbox-784e0e13c9ad94ef81c442dfbd5b099909ae748a.tar.gz
rockbox-784e0e13c9ad94ef81c442dfbd5b099909ae748a.zip
Adds the appendix to the manual. Adds the FDL as a .tex document. Include some icon images from the 2.4 docs.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@9026 a1c6a512-1295-4272-9138-f99709370657
-rw-r--r--manual/appendix/appendix.tex961
-rw-r--r--manual/appendix/fdl.tex510
-rw-r--r--manual/appendix/images/icon-audio-file.pngbin0 -> 205 bytes
-rw-r--r--manual/appendix/images/icon-chip8.pngbin0 -> 121 bytes
-rw-r--r--manual/appendix/images/icon-config.pngbin0 -> 211 bytes
-rw-r--r--manual/appendix/images/icon-directory.pngbin0 -> 290 bytes
-rw-r--r--manual/appendix/images/icon-font.pngbin0 -> 260 bytes
-rw-r--r--manual/appendix/images/icon-image-file.pngbin0 -> 185 bytes
-rw-r--r--manual/appendix/images/icon-lang.pngbin0 -> 318 bytes
-rw-r--r--manual/appendix/images/icon-movie-file.pngbin0 -> 138 bytes
-rw-r--r--manual/appendix/images/icon-playlist.pngbin0 -> 168 bytes
-rw-r--r--manual/appendix/images/icon-rock.pngbin0 -> 1294 bytes
-rw-r--r--manual/appendix/images/icon-rolo.pngbin0 -> 299 bytes
-rw-r--r--manual/appendix/images/icon-text.pngbin0 -> 302 bytes
-rw-r--r--manual/appendix/images/icon-ucl.pngbin0 -> 1179 bytes
-rw-r--r--manual/appendix/images/icon-wps.pngbin0 -> 299 bytes
-rw-r--r--manual/rockbox.tex4
17 files changed, 574 insertions, 901 deletions
diff --git a/manual/appendix/appendix.tex b/manual/appendix/appendix.tex
index 1b421ea910..63165e823f 100644
--- a/manual/appendix/appendix.tex
+++ b/manual/appendix/appendix.tex
@@ -1,947 +1,110 @@
1\appendix 1\appendix
2\chapter{The appendix} 2\chapter{File formats}
3\section{Feature comparison chart}
4\begin{tabular}[c]{|p{10.382cm}|p{2.799cm}|p{2.411cm}|}
5\hline
6{\centering\bfseries\itshape
7FEATURE
8\par}
9&
10{\centering\bfseries\itshape
11ROCKBOX
12\par}
13&
14{\centering\bfseries\itshape
15ARCHOS
16\par}
17\\\hline
18\endhead
19ID3v1 and ID3v2 support
20&
21Yes
22&
23ID3v1
24\\\hline
25Background noise during playback
26&
27No
28&
29Yes
30\\\hline
31Mid{}-track resume
32&
33Yes
34&
35No
36\\\hline
37Mid{}-playlist resume
38&
39Yes
40&
41No
42\\\hline
43Resumed playlist order
44&
45Yes
46&
47No
48\\\hline
49Battery lifetime
50&
51Longer
52&
53Long
54\\\hline
55Battery time indicator
56&
57Yes
58&
59No
60\\\hline
61Customizable font (Recorder)
62&
63Yes
64&
65No
66\\\hline
67Customizable screen info when playing songs
68&
69Yes
70&
71No
72\\\hline
73USB attach/detach without reboot
74&
75Yes
76&
77No
78\\\hline
79Can load another firmware without rebooting
80&
81Yes
82&
83No
84\\\hline
85Playlist load speed, songs/sec
86&
873000 {}- 4000
88&
8915 {}- 20
90\\\hline
91Max number of songs in a playlist
92&
9320 000
94&
95999
96\\\hline
97Supports bad path prefixes in playlists
98&
99Yes
100&
101Yes
102\\\hline
103Open source/development process
104&
105Yes
106&
107No
108\\\hline
109Corrects reported bugs
110&
111Yes
112&
113No
114\\\hline
115Automatic Volume Control (Recorder)
116&
117Yes
118&
119No
120\\\hline
121Pitch control (Recorder)
122&
123Yes
124&
125No
126\\\hline
127Text File Reader
128&
129Yes
130&
131Yes
132\\\hline
133Games (Recorder)
134&
1358
136&
137No
138\\\hline
139Games (Player)
140&
1412
142&
143No
144\\\hline
145File Delete \& Rename
146&
147Yes
148&
149Yes
150\\\hline
151Playlist Building
152&
153Yes
154&
155Yes
156\\\hline
157Recording (Recorder)
158&
159Yes
160&
161Yes
162\\\hline
163Generates XING VBR header when recording
164&
165Yes
166&
167Yes
168\\\hline
169High Resolution Volume Control
170&
171Yes
172&
173No
174\\\hline
175Deep discharge option (Recorder)
176&
177Yes
178&
179No
180\\\hline
181Customizable backlight timeout
182&
183Yes
184&
185Yes
186\\\hline
187Backlight{}-on when charging option
188&
189Yes
190&
191No
192\\\hline
193Queue function
194&
195Yes
196&
197Yes
198\\\hline
199Supports the XING header
200&
201Yes
202&
203Yes
204\\\hline
205Supports the VBRI header
206&
207Partly
208&
209Yes
210\\\hline
211Max number of files in a directory
212&
21310 000
214&
215999
216\\\hline
217Adjustable scroll speed
218&
219Yes
220&
221No
222\\\hline
223Screensaver style demos (Recorder)
224&
225Yes
226&
227No
228\\\hline
229Variable step / accelerating ffwd and rwd
230&
231Yes
232&
233No
234\\\hline
235Visual Progress Bar
236&
237Yes
238&
239No
240\\\hline
241Select/Load configurations
242&
243Yes
244&
245No
246\\\hline
247Sleep timer
248&
249Yes
250&
251No
252\\\hline
253Easy User Interface
254&
255Yes
256&
257No
258\\\hline
259Remote Control Controllable
260&
261Yes
262&
263Yes
264\\\hline
265ISO8859{}-1 font support (Player)
266&
267Yes
268&
269No
270\\\hline
271Queue songs to play next
272&
273Yes
274&
275Yes
276\\\hline
277Bookmark positions in songs
278&
279Yes
280&
281No
282\\\hline
283Number of available languages
284&
28524
286&
2873
288\\\hline
289Accurate VBR bitrate display
290&
291Yes
292&
293No
294\\\hline
295FM Tuner support (FM Recorder)
296&
297Yes
298&
299Yes
300\\\hline
301FF/FR with sound
302&
303No
304&
305Yes
306\\\hline
307Pre{}-Recording (Recorders)
308&
309Yes
310&
311Yes
312\\\hline
313Video Playback with sound (Recorders)
314&
315Yes
316&
317No
318\\\hline
319Boot Time from Flash (in seconds)
320&
3214
322&
32312
324\\\hline
325Speaking Menus Support
326&
327Yes
328&
329No
330\\\hline
331\end{tabular}
332
333\section{Supported file formats} 3\section{Supported file formats}
334\begin{center}\begin{tabular}{|p{0.46100003cm}|p{3.296cm}|p{12.339cm}|}
335\hline
336&
337{\centering\bfseries\itshape
338FILE TYPE
339\par}
340&
341{\centering\bfseries\itshape
342ACTION
343\par}
344\\\hline
345 [Warning: Image ignored] % Unhandled or unsupported graphics:
346%\includegraphics[width=0.37cm,height=0.423cm]{images/rockbox-manual-img80.png}
347
348&
349Directory
350&
351The browser enters that directory
352\\\hline
353 [Warning: Image ignored] % Unhandled or unsupported graphics:
354%\includegraphics[width=0.45cm,height=0.385cm]{images/rockbox-manual-img81.png}
355
356&
357.mp3
358&
359Rockbox takes you to the WPS and starts playing the file
360\\\hline
361 [Warning: Image ignored]
362% Unhandled or unsupported graphics:
363%\includegraphics[width=0.019cm,height=0.041cm]{images/rockbox-manual-img82.jpg}
364 [Warning: Image ignored]
365% Unhandled or unsupported graphics:
366%\includegraphics[width=0.397cm,height=0.45cm]{images/rockbox-manual-img83.png}
367
368&
369.m3u
370&
371Rockbox loads the playlist and starts playing the first file
372\\\hline
373 [Warning: Image ignored] % Unhandled or unsupported graphics:
374%\includegraphics[width=0.448cm,height=0.51cm]{images/rockbox-manual-img84.png}
375
376&
377.ajz/ .mod
378&
379ROLO will load the new firmware
380\\\hline
381 [Warning: Image ignored] % Unhandled or unsupported graphics:
382%\includegraphics[width=0.467cm,height=0.513cm]{images/rockbox-manual-img85.png}
383
384&
385.wps
386&
387The new WPS display configuration will be loaded
388\\\hline
389 [Warning: Image ignored] % Unhandled or unsupported graphics:
390%\includegraphics[width=0.439cm,height=0.437cm]{images/rockbox-manual-img86.png}
391
392&
393.lng
394&
395That language will replace current one
396\\\hline
397 [Warning: Image ignored] % Unhandled or unsupported graphics:
398%\includegraphics[width=0.439cm,height=0.483cm]{images/rockbox-manual-img87.png}
399
400&
401.txt
402&
403This will display the text file using Rockbox text browser plugin
404\\\hline
405 [Warning: Image ignored] % Unhandled or unsupported graphics:
406%\includegraphics[width=0.445cm,height=0.487cm]{images/rockbox-manual-img88.png}
407
408&
409.cfg
410&
411The settings file will be loaded
412\\\hline
413 [Warning: Image ignored] % Unhandled or unsupported graphics:
414%\includegraphics[width=0.492cm,height=0.513cm]{images/rockbox-manual-img89.png}
415
416&
417.fnt
418&
419This font will replace the current one (Recorder only)
420\\\hline
421 [Warning: Image ignored] % Unhandled or unsupported graphics:
422%\includegraphics[width=0.413cm,height=0.45cm]{images/rockbox-manual-img90.png}
423
424&
425.rock
426&
427Starts a Rockbox plugin
428\\\hline
429 [Warning: Image ignored] % Unhandled or unsupported graphics:
430%\includegraphics[width=0.413cm,height=0.439cm]{images/rockbox-manual-img91.png}
431
432&
433.ucl
434&
435This Rockbox image will be flashed into the ROM
436\\\hline
437
438\begin{center}
439 [Warning: Image ignored] % Unhandled or unsupported graphics:
440%\includegraphics[width=0.318cm,height=0.423cm]{images/rockbox-manual-img92.png}
441
442\end{center}
443&
444.ch8
445&
446Play a Chip8 game
447\\\hline
448
449\begin{center} 4\begin{center}
450 [Warning: Image ignored] % Unhandled or unsupported graphics: 5\begin{tabular}{lll}\toprule
451%\includegraphics[width=0.318cm,height=0.423cm]{images/rockbox-manual-img93.png} 6\textbf{Icon} & \textbf{File Type} & \textbf{Action} \\\midrule
452 7\includegraphics[width=0.37cm]{appendix/images/icon-directory.png} & Directory & The browser enters that directory \\
453\end{center} 8\includegraphics[width=0.37cm]{appendix/images/icon-audio-file.png} & Audio file & Rockbox takes you to the WPS and starts playing the file \\
454& 9\includegraphics[width=0.37cm]{appendix/images/icon-playlist.png} & .m3u & Rockbox loads the playlist and starts playing the first file \\
455.jpg 10\includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} & Rockbox firmware file & ROLO will load the new firmware \\
456& 11\includegraphics[width=0.37cm]{appendix/images/icon-wps.png} & .wps & The new WPS display configuration will be loaded \\
457View a JPEG image 12\includegraphics[width=0.37cm]{appendix/images/icon-lang.png} & .lng & Loads a language file \\
458\\\hline 13\includegraphics[width=0.37cm]{appendix/images/icon-text.png} & .txt & This will display the text file using Rockbox text browser plugin\\
459 14\includegraphics[width=0.37cm]{appendix/images/icon-config.png} & .cfg & The settings file will be loaded\\
460\begin{center} 15\includegraphics[width=0.37cm]{appendix/images/icon-font.png} & .fnt & This font will replace the current one\\
461 [Warning: Image ignored] % Unhandled or unsupported graphics: 16\includegraphics[width=0.37cm]{appendix/images/icon-rock.png} & .rock & Starts a Rockbox plugin\\
462%\includegraphics[width=0.319cm,height=0.42cm]{images/rockbox-manual-img94.png} 17\includegraphics[width=0.37cm]{appendix/images/icon-ucl.png} & .ucl & This Rockbox image will be flashed into the ROM \\
463 18\includegraphics[width=0.37cm]{appendix/images/icon-chip8.png} & .ch8 & Play a Chip8 game \\
19\includegraphics[width=0.37cm]{appendix/images/icon-image-file.png} & .jpg & View a JPEG image \\
20\includegraphics[width=0.37cm]{appendix/images/icon-movie-file.png} & .rvf & View a movie (Rockbox format)\\\bottomrule
21\end{tabular}
464\end{center} 22\end{center}
465&
466.rvf
467&
468View a movie (Rockbox format)
469\\\hline
470\end{tabular}\end{center}
471 23
24\chapter{User feedback}
472\section{Bug reports} 25\section{Bug reports}
473If you experience inappropriate performance from any supported feature, 26If you experience inappropriate performance from any supported feature,
474please file a bug report on our web page. Do not report missing 27please file a bug report on our web page. Do not report missing
475features as bugs, instead file them as feature requests (see below). 28features as bugs, instead file them as feature requests (see below).
476 29
477For open bug reports refer to 30For open bug reports refer to
478\url{http://www.rockbox.org/bugs.shtml}{http://www.rockbox.org/bugs.shtml} 31\url{http://www.rockbox.org/bugs/index.php?type=2}
479 32
480{\bfseries 33\subsection{Rules for submitting new bug reports}
481Rules for submitting new bug reports:}
482 34
483\begin{enumerate} 35\begin{enumerate}
484\item Check that the bug hasn't already been reported 36\item Check that the bug hasn't already been reported
485\item Always include the following information in your bug report: 37\item Always include the following information in your bug report:
486\end{enumerate} 38\end{enumerate}
39
487\begin{itemize} 40\begin{itemize}
488\item \begin{itemize}
489\item Which exact model Jukebox you have (as printed on the unit) 41\item Which exact model Jukebox you have (as printed on the unit)
490\item Which exact ROM firmware version you have 42\item Which exact ROM firmware version you have
491\item Which exact Rockbox version you are using 43\item Which exact Rockbox version you are using
492(Menu{}-{\textgreater}Info {}-{\textgreater} Version) 44(Menu{}-{\textgreater}Info {}-{\textgreater} Version)
493\item A step{}-by{}-step description of what you did and what happened 45\item A step{}-by{}-step description of what you did and what happened
494\item Whether the problem is repeatable or a one{}-time 46\item Whether the problem is repeatable or a one{}-time occurrence
495\foreignlanguage{english}{occurrence}
496\item All relevant data regarding the problem, such as playlists, MP3 47\item All relevant data regarding the problem, such as playlists, MP3
497files etc. (IMPORTANT!) 48files etc. (IMPORTANT!)
498\end{itemize} 49\end{itemize}
499\end{itemize}
500\begin{enumerate}
501\item If you have a Sourceforge account, log
502in before you file the report.
503\item If you don't have a SF account, sign the report
504with your email.
505\end{enumerate}
506 50
507\section{Feature requests} 51\section{Feature requests}
508For open feature requests refer to 52For open feature requests refer to
509\url{http://www.rockbox.org/requests.shtml} 53\url{http://www.rockbox.org/bugs/index.php?type=1}
510 54
511{\bfseries 55\subsection{Rules for submitting a new feature request}
512Rules for submitting a new feature request:}
513 56
514\begin{enumerate} 57\begin{enumerate}
515\item Check that the feature hasn't already been 58\item Check that the feature hasn't already been requested. Duplicates are really boring!
516requested. Duplicates are really boring! 59\item Check that the feature hasn't already been implemented. Download the latest daily build and/or search the mail list archive.
517\item Check that the feature hasn't already been 60\item Check that the feature is possible to implement (see page \pageref{ref:NODO}).
518implemented. Download the latest daily build and/or search the mail
519list archive.
520\item Check that the feature is possible to implement (see page
521\pageref{ref:NODO}).
522\item You must be logged in with your Sourceforge account to submit a
523request. If you don't have an account, get one.
524\end{enumerate} 61\end{enumerate}
525 62
526
527\subsection{\label{ref:NODO}Features we will not implement} 63\subsection{\label{ref:NODO}Features we will not implement}
528This is a list of Feature Requests we get repeatedly that we simply 64This is a list of Feature Requests we get repeatedly that we simply
529cannot do. View it as the opposite of a TODO! 65cannot do. View it as the opposite of a TODO!
530 66
67\opt{player,recorder,recorderv2fm}{
531\begin{itemize} 68\begin{itemize}
532\item {\bfseries 69\item Record to WAV (uncompressed) or MP3pro format!\\
533Record to WAV (uncompressed) or MP3pro format!}
534
535The recording hardware (the MAS) does not allow us to do this 70The recording hardware (the MAS) does not allow us to do this
536\item {\bfseries 71\item Crossfade between tracks!\\
537Crossfade between tracks!} 72 Crossfading would require two mp3 decoders, and we only have one. This is not possible.
538Crossfading would require two mp3 decoders, 73\item Interfacing with other USB devices (like cameras) or 2 player games over USB\\
539and we only have one. This is not possible. 74The USB system demands that there is a master that talks to a slave. The Jukebox can only serve as a slave, as most other USB devices such as cameras can. Thus, without a master no communication between the slaves can take place. If that is not enough, we have no ways of actually controlling the communication performed over USB since the USB circuit in the Jukebox is strictly made for disk{}-access and does not allow us to play with it the way we'd need for any good communication to work.
540\item {\bfseries 75\item Support MP3pro, WMA or other sound format playback!\\
541Interfacing with other USB devices (like cameras) or 2 player games over 76The mp3{}-decoding hardware can only play MP3. We cannot make it play other sound formats.
542USB} 77\item Converting OGG{}-{\textgreater}MP3 \\
543 78The mp3{}-decoding hardware cannot decode OGG. It can be reprogrammed, but there is too little memory for OGG and we have no documentation on how to program the MAS' DSP. Doing the conversion with the CPU is impossible, since a 12MHz SH1 is far too slow for this daunting task.
544The USB system demands that there is a master that talks to a slave. The 79\item Archos Multimedia support!\\
545Jukebox can only serve as a slave, as most other USB devices such as 80The Archos Multimedia is a completely different beast. It is an entirely different architecture, different CPU and upgrading the software is done a completely different way. We do not wish to venture into this. Others may do so. We won't.
546cameras can. Thus, without a master no communication between the slaves 81\item Multi{}-band (or graphic) equaliser\\
547can take place. 82We cannot access information for that kind of visualisation from the MP3 decoding hardware.
548 83\item Support other filesystems than FAT32 (likeNTFS or ext2 or whatever)!\\
549If that is not enough, we have no ways of actually controlling the 84No. Rockbox needs to support FAT32 since it can only start off a FAT32 partition (since that is the only way the ROM can load it), and adding support for more file systems will just take away valuable ram for unnecessary features. You can partition your Jukebox fine, just make sure the first one is FAT32 and then make the other ones whatever file system you want. Just don't expect Rockbox to understand them.
550communication performed over USB since the USB circuit in the Jukebox 85\item Add scandisk{}-like features!\\
551is strictly made for disk{}-access and does not allow us to play with 86It would be a very slow operation that would drain the batteries and take a lot of useful ram for something that is much better and faster done when connected to a host computer.
552it the way we'd need for any good communication to 87\item CBR recording!\\
553work.
554\item {\bfseries
555Support MP3pro, WMA or other sound format playback!}
556
557The mp3{}-decoding hardware can only play MP3. We cannot make it play
558other sound formats.
559\item {\bfseries
560Converting OGG{}-{\textgreater}MP3}
561
562The mp3{}-decoding hardware cannot decode OGG. It can be reprogrammed,
563but there is too little memory for OGG and we have no documentation on
564how to program the MAS' DSP.
565
566Doing the conversion with the CPU is impossible, since a 12MHz SH1 is
567far too slow for this daunting task.
568\item {\bfseries
569Archos Multimedia support!}
570
571The Archos Multimedia is a completely different beast. It is an entirely
572different architecture, different CPU and upgrading the software is
573done a completely different way. We do not wish to venture into this.
574
575Others may do so. We won't.
576\item {\bfseries
577Multi{}-band (or graphic) equaliser!}
578
579We cannot access information for that kind of visualisation from the MP3
580decoding hardware.
581\item {\bfseries
582Support other filesystems than FAT32 (like
583NTFS or ext2 or whatever)!}
584
585No. Rockbox needs to support FAT32 since it can only start off a FAT32
586partition (since that is the only way the ROM can load it), and adding
587support for more file systems will just take away valuable ram for
588unnecessary features.
589
590You can partition your Jukebox fine, just make sure the first one is
591FAT32 and then make the other ones whatever file system you want. Just
592don't expect Rockbox to understand them.
593\item {\bfseries
594Add scandisk{}-like features!}
595
596It would be a very slow operation that would drain the batteries and
597take a lot of useful ram for something that is much better and faster
598done when connected to a host computer.
599\item {\bfseries
600CBR recording!}
601
602The MP3 encoding hardware does not allow this. 88The MP3 encoding hardware does not allow this.
603\item {\bfseries 89\item Change tempo of a song without changing pitch!\\
604Change tempo of a song without changing pitch!} 90 The MP3 decoding hardware does not allow this.
605 91\item Graphic frequency (spectrum analyser!)\\
606The MP3 decoding hardware does not allow this. 92We can't access the audio waveform from the MP3 decoder so we can't analyse it. Even if we had access to it, the CPU would probably be too slow to perform the analysis anyway.
607\end{itemize} 93\item Cool sound effects!\\
608\begin{itemize} 94 Adding new sound effects requires reprogramming the MAS chip, and wecan't do that. The MAS chip is programmable, but we have no access to the chip documentation.
609\item {\bfseries
610Graphic frequency (spectrum analyser!)}
611
612We can't access the audio waveform from the MP3 decoder
613so we can't analyse it. Even if we had access to it, the CPU would probably be too slow to perform the analysis anyway.
614\end{itemize} 95\end{itemize}
615\begin{itemize} 96}
616\item {\bfseries
617Cool sound effects!}
618
619Adding new sound effects requires reprogramming the MAS chip, and we
620can't do that. The MAS chip is programmable, but we
621have no access to the chip documentation.
622\end{itemize}
623
624 97
625 98
626\section{What's new since 2.0?} 99\chapter{Changelog}
627{\bfseries 100\section{What's new since v2.5?}
628Changes in version 2.4} 101Changes in version 2.5
629
630\begin{itemize}
631\item Improved shuffle
632\item Improved disk write performance
633\item Improved Ondio support
634\item Various bug fixes
635\item Added 74 and 80 minute recording time splits for convenient CD
636creation
637\end{itemize}
638{\bfseries
639Changes in version 2.3}
640
641\begin{itemize}
642\item {\bfseries
643General changes since 2.2}
644
645\begin{itemize}
646\item Spoken menus, filenames and directories
647\item Support for Archos Ondio
648\item File type associations and ``open with...'' plugin bindings
649\item Added ability to delete directories, even recursively
650\item New WPS tags for information about next song in playlist
651\item ON+PLAY menu can now also be accessed with a long press on PLAY
652\item New directory sort options: date and file type
653\item Clean shutdown which spins down the disk before cutting power
654\item Faster scrolling in file browser
655\item Easy{}-to{}-use installation program for windows
656\item New language: Bulgarian
657\item New plugins: Sort, euroconverter, search, chess clock, vbrfix,
658stopwatch, metronome
659\end{itemize}
660\item {\bfseries
661Recorder{}-specific changes since 2.2}
662
663\begin{itemize}
664\item During recording disk doesn't spin up until
665needed, allowing undisturbed use of internal mic for short recordings
666\item Optional button help bar at bottom of screen
667\item More detailed MDB (dynamic bass) settings
668\item ROMbox, optionally saving \~{}170KB RAM by running code from flash
669on Recorder v1 and Ondio SP
670\item Recording can pause
671\item Recorded files now get ID3 v2.3 tags instead of v2.4, since some
672tools have problems reading v2.4 tags
673\item Red LED behaviour changed during recording: On during recording
674and blinking when paused
675\item New font format. 2.3 requires new fonts, 2.2 fonts are not
676compatible.
677\item New plugins: Minesweeper, solitaire, mp3 split editor, snake2,
678pong, JPEG viewer, Mandelbrot
679\end{itemize}
680\end{itemize}
681{\bfseries
682Changes in version 2.2}
683
684\begin{itemize}
685\item Bookmarking functions added
686\item Improved playlist support
687\item WPS enhancements
688\item New plugins: greyscale, Mandelbrot,
689metronome
690\item Recording enhancements (recorder)
691\item Bug fixes
692\end{itemize}
693{\bfseries
694General changes since 2.0}
695
696\begin{itemize}
697\item Loadable plugins
698\item Dynamic playlist creation and manipulation
699\item Configurable max directory size (default: 400 files)
700\item Configurable max playlist size (default: 10000 files)
701\item Remote control now works while keys are locked
702\item Car mode: Pauses and resumes playback with charger power loss and
703restore
704\item Caption backlight: Briefly turns on backlight during track change
705\item Battery meter is more accurate during the first minutes after boot
706\item Automatically detects modified archos.mod/ ajbrec.ajz after
707exiting USB mode and asks if you want to run it
708\item Files and configurations in /.rockbox are now accessible from Menu
709\item Stopped playlists can be resumed from File Browser by pressing ON
710\item Never turns off/reboots while charger is connected
711\item .wps files now support comments
712\item Improved ID3v2 support
713\item Option of hiding icons in File Browser
714\end{itemize}
715{\bfseries
716Player{}-specific changes since 2.0}
717
718\begin{itemize}
719\item Games: Jackpot and NIM
720\item Jump scroll: Scrolls the entire screen width each step
721\item The Line In port is enabled
722\end{itemize}
723{\bfseries
724Recorder{}-specific changes since 2.0}
725
726\begin{itemize}
727\item Rockbox can now be stored in flash ROM, giving much quicker boot up
728\item Support for V2 recorders
729\item Radio support (FM Recorder only)
730\item Default contrast is now auto{}-detected, preventing unreadable
731display
732\item Option of using an inverted bar instead of cursor in File Browser
733and Menu
734\item Frame{}-accurate recording file splits set manually or preset by time
735\item Improved Xing header generation in recorded files
736\item New games: FlipIt, Snake, Star, Sliding Puzzle and Chip8 emulator
737\item A calendar application plugin
738\end{itemize}
739
740
741\section{Credits}
742People that have contributed to the project, one way or another.
743Friends!}
744
745\begin{center}
746\begin{minipage}{16.15cm}
747Bj\"orn Stenberg \newline
748Linus Nielsen Feltzing \newline
749Andy Choi \newline
750Andrew Jamieson \newline
751Paul Suade \newline
752Joachim Schiffer \newline
753Daniel Stenberg \newline
754Alan Korr \newline
755Gary Czvitkovicz \newline
756Stuart Martin \newline
757Felix Arends \newline
758Ulf Ralberg \newline
759David H\"ardeman \newline
760Thomas Saeys \newline
761Grant Wier \newline
762Julien Labruy\'ere \newline
763Nicolas Sauzede \newline
764Robert Hak \newline
765Dave Chapman \newline
766Stefan Meyer \newline
767Eric Linenberg \newline
768Tom Cvitan \newline
769Magnus \"Oman \newline
770Jerome Kuptz \newline
771Julien Boissinot \newline
772Nuutti Kotivuori \newline
773Heikki Hannikainen \newline
774Hardeep Sidhu \newline
775Markus Braun \newline
776Justin Heiner \newline
777Magnus Holmgren \newline
778Bill Napier \newline
779George Styles \newline
780Mats Lidell \newline
781Lee Marlow \newline
782Nate Nystrom \newline
783Nick Robinson \newline
784Chad Lockwood \newline
785John Pybus \newline
786Uwe Freese \newline
787Randy Wood \newline
788Gregory Haerr \newline
789Philipp Pertermann \newline
790Gilles Roux \newline
791Mark Hillebrand \newline
792Damien Teney \newline
793Andreas Zwirtes \newline
794Kjell Ericson \newline
795Jim Hagani \newline
796Ludovic Lange \newline
797Mike Holden \newline
798Simon El\'en \newline
799Matthew P. OReilly \newline
800Christian Sch\"onberger \newline
801Henrik Backe \newline
802Craig Sather \newline
803Jos\'e Maria Garcia{}-Valdecasas Bernal\newline
804Stevie Oh \newline
805J\"org Hohensohn \newline
806Dave Jones \newline
807Thomas Paul Diffenbach \newline
808Roland Kletzing \newline
809Itai Shaked \newline
810Keith Hubbard \newline
811Benjamin Metzler \newline
812Frederic Dang Ngoc \newline
813Pierre Delore \newline
814Huw Smith \newline
815Garrett Derner \newline
816Barry McIntosh \newline
817Leslie Donaldson \newline
818Lee Pilgrim \newline
819Zakk Roberts \newline
820Francois Boucher \newline
821Matthias Wientapper \newline
822Brent Coutts \newline
823Jens Arnold \newline
824Gerald Vanbaren \newline
825Christi Scarborough \newline
826Steve Cundari \newline
827Mat Holton \newline
828Jan Gajdos \newline
829Antoine Cellerier \newline
830Brian King \newline
831Jiri Jurecek \newline
832Jacob Erlbeck
833\end{minipage}\end{center}
834
835
836\section{GNU Free Documentation Licence}
837Version 1.2, November 2002
838 102
103\chapter{Credits}
104People that have contributed to the project, one way or another.Friends!
839\begin{verbatim} 105\begin{verbatim}
840Copyright (C) 2000,2001,2002 Free Software Foundation, Inc. 106/* Include the CREDITS file */
84151 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
842Everyone is permitted to copy and distribute verbatim copies
843of this license document, but changing it is not allowed.
844\end{verbatim} 107\end{verbatim}
845 108
846\textbf{0. PREAMBLE} 109\chapter{GNU Free Documentation Licence}
847The purpose of this License is to make a manual, textbook, or other functional and useful document "free" in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others. 110\input{appendix/fdl.tex}
848
849This License is a kind of "copyleft", which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software.
850
851We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference.
852
853\textbf{1. APPLICABILITY AND DEFINITIONS}
854This License applies to any manual or other work, in any medium, that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. Such a notice grants a world-wide, royalty-free license, unlimited in duration, to use that work under the conditions stated herein. The "Document", below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as "you". You accept the license if you copy, modify or distribute the work in a way requiring permission under copyright law.
855
856A "Modified Version" of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language.
857
858A "Secondary Section" is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (Thus, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.
859
860The "Invariant Sections" are certain Secondary Sections whose titles are designated, as being those of Invariant Sections, in the notice that says that the Document is released under this License. If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant. The Document may contain zero Invariant Sections. If the Document does not identify any Invariant Sections then there are none.
861
862The "Cover Texts" are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the Document is released under this License. A Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 words.
863
864A "Transparent" copy of the Document means a machine-readable copy, represented in a format whose specification is available to the general public, that is suitable for revising the document straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup, or absence of markup, has been arranged to thwart or discourage subsequent modification by readers is not Transparent. An image format is not Transparent if used for any substantial amount of text. A copy that is not "Transparent" is called "Opaque".
865
866Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML, PostScript or PDF designed for human modification. Examples of transparent image formats include PNG, XCF and JPG. Opaque formats include proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML, PostScript or PDF produced by some word processors for output purposes only.
867
868The "Title Page" means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, "Title Page" means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text.
869
870A section "Entitled XYZ" means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a specific section name mentioned below, such as "Acknowledgements", "Dedications", "Endorsements", or "History".) To "Preserve the Title" of such a section when you modify the Document means that it remains a section "Entitled XYZ" according to this definition.
871
872The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document. These Warranty Disclaimers are considered to be included by reference in this License, but only as regards disclaiming warranties: any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License.
873
874
875\textbf{2. VERBATIM COPYING}
876You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section 3.
877
878You may also lend copies, under the same conditions stated above, and you may publicly display copies.
879
880
881\textbf{3. COPYING IN QUANTITY}
882If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the Document's license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in other respects.
883
884If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages.
885
886If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state in or with each Opaque copy a computer-network location from which the general network-using public has access to download using public-standard network protocols a complete Transparent copy of the Document, free of added material. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.
887
888It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document.
889
890
891\textbf{4. MODIFICATIONS}
892
893You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version:
894
895 * A. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission.
896 * B. List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the Document (all of its principal authors, if it has fewer than five), unless they release you from this requirement.
897 * C. State on the Title page the name of the publisher of the Modified Version, as the publisher.
898 * D. Preserve all the copyright notices of the Document.
899 * E. Add an appropriate copyright notice for your modifications adjacent to the other copyright notices.
900 * F. Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below.
901 * G. Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document's license notice.
902 * H. Include an unaltered copy of this License.
903 * I. Preserve the section Entitled "History", Preserve its Title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section Entitled "History" in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.
904 * J. Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the "History" section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.
905 * K. For any section Entitled "Acknowledgements" or "Dedications", Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
906 * L. Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.
907 * M. Delete any section Entitled "Endorsements". Such a section may not be included in the Modified Version.
908 * N. Do not retitle any existing section to be Entitled "Endorsements" or to conflict in title with any Invariant Section.
909 * O. Preserve any Warranty Disclaimers.
910
911If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other section titles.
912
913You may add a section Entitled "Endorsements", provided it contains nothing but endorsements of your Modified Version by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.
914
915You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.
916
917The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version.
918
919\textbf{5. COMBINING DOCUMENTS}
920You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice, and that you preserve all their Warranty Disclaimers.
921
922The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work.
923
924In the combination, you must combine any sections Entitled "History" in the various original documents, forming one section Entitled "History"; likewise combine any sections Entitled "Acknowledgements", and any sections Entitled "Dedications". You must delete all sections Entitled "Endorsements."
925
926\textbf{6. COLLECTIONS OF DOCUMENTS}
927You may make a collection consisting of the Document and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects.
928
929You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document.
930
931\textbf{7. AGGREGATION WITH INDEPENDENT WORKS}
932A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, is called an "aggregate" if the copyright resulting from the compilation is not used to limit the legal rights of the compilation's users beyond what the individual works permit. When the Document is included in an aggregate, this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document.
933
934If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the Document is less than one half of the entire aggregate, the Document's Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate.
935
936\textbf{8. TRANSLATION}
937Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License, and all the license notices in the Document, and any Warranty Disclaimers, provided that you also include the original English version of this License and the original versions of those notices and disclaimers. In case of a disagreement between the translation and the original version of this License or a notice or disclaimer, the original version will prevail.
938
939If a section in the Document is Entitled "Acknowledgements", "Dedications", or "History", the requirement (section 4) to Preserve its Title (section 1) will typically require changing the actual title.
940
941\textbf{9. TERMINATION}
942You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.
943
944\textbf{10. FUTURE REVISIONS OF THIS LICENSE}
945The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See http://www.gnu.org/copyleft/.
946
947Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of this License "or any later version" applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation.
diff --git a/manual/appendix/fdl.tex b/manual/appendix/fdl.tex
new file mode 100644
index 0000000000..0f0bb0b62b
--- /dev/null
+++ b/manual/appendix/fdl.tex
@@ -0,0 +1,510 @@
1%% %---------The file header---------------------------------------------
2%% \documentclass[a4paper,12pt]{book} % possibilities : report book article , etc.
3
4%% \usepackage[english]{babel} %language selection
5%% \usepackage[T1]{fontenc}
6
7%% \pagenumbering{arabic}
8
9%% \usepackage{hyperref}
10%% \hypersetup{colorlinks,
11%% citecolor=black,
12%% filecolor=black,
13%% linkcolor=black,
14%% urlcolor=black,
15%% pdftex}
16
17
18%% \begin{document}
19%---------------------------------------------------------------------
20%% \chapter{GNU Free Documentation License}
21%\label{label_fdl}
22
23 \begin{center}
24
25 Version 1.2, November 2002
26
27
28 Copyright \copyright 2000,2001,2002 Free Software Foundation, Inc.
29
30 \bigskip
31
32 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
33
34 \bigskip
35
36 Everyone is permitted to copy and distribute verbatim copies
37 of this license document, but changing it is not allowed.
38\end{center}
39
40
41\begin{center}
42{\bf\large Preamble}
43\end{center}
44
45The purpose of this License is to make a manual, textbook, or other
46functional and useful document "free" in the sense of freedom: to
47assure everyone the effective freedom to copy and redistribute it,
48with or without modifying it, either commercially or noncommercially.
49Secondarily, this License preserves for the author and publisher a way
50to get credit for their work, while not being considered responsible
51for modifications made by others.
52
53This License is a kind of "copyleft", which means that derivative
54works of the document must themselves be free in the same sense. It
55complements the GNU General Public License, which is a copyleft
56license designed for free software.
57
58We have designed this License in order to use it for manuals for free
59software, because free software needs free documentation: a free
60program should come with manuals providing the same freedoms that the
61software does. But this License is not limited to software manuals;
62it can be used for any textual work, regardless of subject matter or
63whether it is published as a printed book. We recommend this License
64principally for works whose purpose is instruction or reference.
65
66
67\begin{center}
68{\Large\bf 1. APPLICABILITY AND DEFINITIONS}
69\addcontentsline{toc}{section}{1. APPLICABILITY AND DEFINITIONS}
70\end{center}
71
72This License applies to any manual or other work, in any medium, that
73contains a notice placed by the copyright holder saying it can be
74distributed under the terms of this License. Such a notice grants a
75world-wide, royalty-free license, unlimited in duration, to use that
76work under the conditions stated herein. The \textbf{"Document"}, below,
77refers to any such manual or work. Any member of the public is a
78licensee, and is addressed as \textbf{"you"}. You accept the license if you
79copy, modify or distribute the work in a way requiring permission
80under copyright law.
81
82A \textbf{"Modified Version"} of the Document means any work containing the
83Document or a portion of it, either copied verbatim, or with
84modifications and/or translated into another language.
85
86A \textbf{"Secondary Section"} is a named appendix or a front-matter section of
87the Document that deals exclusively with the relationship of the
88publishers or authors of the Document to the Document's overall subject
89(or to related matters) and contains nothing that could fall directly
90within that overall subject. (Thus, if the Document is in part a
91textbook of mathematics, a Secondary Section may not explain any
92mathematics.) The relationship could be a matter of historical
93connection with the subject or with related matters, or of legal,
94commercial, philosophical, ethical or political position regarding
95them.
96
97The \textbf{"Invariant Sections"} are certain Secondary Sections whose titles
98are designated, as being those of Invariant Sections, in the notice
99that says that the Document is released under this License. If a
100section does not fit the above definition of Secondary then it is not
101allowed to be designated as Invariant. The Document may contain zero
102Invariant Sections. If the Document does not identify any Invariant
103Sections then there are none.
104
105The \textbf{"Cover Texts"} are certain short passages of text that are listed,
106as Front-Cover Texts or Back-Cover Texts, in the notice that says that
107the Document is released under this License. A Front-Cover Text may
108be at most 5 words, and a Back-Cover Text may be at most 25 words.
109
110A \textbf{"Transparent"} copy of the Document means a machine-readable copy,
111represented in a format whose specification is available to the
112general public, that is suitable for revising the document
113straightforwardly with generic text editors or (for images composed of
114pixels) generic paint programs or (for drawings) some widely available
115drawing editor, and that is suitable for input to text formatters or
116for automatic translation to a variety of formats suitable for input
117to text formatters. A copy made in an otherwise Transparent file
118format whose markup, or absence of markup, has been arranged to thwart
119or discourage subsequent modification by readers is not Transparent.
120An image format is not Transparent if used for any substantial amount
121of text. A copy that is not "Transparent" is called \textbf{"Opaque"}.
122
123Examples of suitable formats for Transparent copies include plain
124ASCII without markup, Texinfo input format, LaTeX input format, SGML
125or XML using a publicly available DTD, and standard-conforming simple
126HTML, PostScript or PDF designed for human modification. Examples of
127transparent image formats include PNG, XCF and JPG. Opaque formats
128include proprietary formats that can be read and edited only by
129proprietary word processors, SGML or XML for which the DTD and/or
130processing tools are not generally available, and the
131machine-generated HTML, PostScript or PDF produced by some word
132processors for output purposes only.
133
134The \textbf{"Title Page"} means, for a printed book, the title page itself,
135plus such following pages as are needed to hold, legibly, the material
136this License requires to appear in the title page. For works in
137formats which do not have any title page as such, "Title Page" means
138the text near the most prominent appearance of the work's title,
139preceding the beginning of the body of the text.
140
141A section \textbf{"Entitled XYZ"} means a named subunit of the Document whose
142title either is precisely XYZ or contains XYZ in parentheses following
143text that translates XYZ in another language. (Here XYZ stands for a
144specific section name mentioned below, such as \textbf{"Acknowledgements"},
145\textbf{"Dedications"}, \textbf{"Endorsements"}, or \textbf{"History"}.)
146To \textbf{"Preserve the Title"}
147of such a section when you modify the Document means that it remains a
148section "Entitled XYZ" according to this definition.
149
150The Document may include Warranty Disclaimers next to the notice which
151states that this License applies to the Document. These Warranty
152Disclaimers are considered to be included by reference in this
153License, but only as regards disclaiming warranties: any other
154implication that these Warranty Disclaimers may have is void and has
155no effect on the meaning of this License.
156
157
158\begin{center}
159{\Large\bf 2. VERBATIM COPYING}
160\addcontentsline{toc}{section}{2. VERBATIM COPYING}
161\end{center}
162
163You may copy and distribute the Document in any medium, either
164commercially or noncommercially, provided that this License, the
165copyright notices, and the license notice saying this License applies
166to the Document are reproduced in all copies, and that you add no other
167conditions whatsoever to those of this License. You may not use
168technical measures to obstruct or control the reading or further
169copying of the copies you make or distribute. However, you may accept
170compensation in exchange for copies. If you distribute a large enough
171number of copies you must also follow the conditions in section 3.
172
173You may also lend copies, under the same conditions stated above, and
174you may publicly display copies.
175
176
177\begin{center}
178{\Large\bf 3. COPYING IN QUANTITY}
179\addcontentsline{toc}{section}{3. COPYING IN QUANTITY}
180\end{center}
181
182
183If you publish printed copies (or copies in media that commonly have
184printed covers) of the Document, numbering more than 100, and the
185Document's license notice requires Cover Texts, you must enclose the
186copies in covers that carry, clearly and legibly, all these Cover
187Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
188the back cover. Both covers must also clearly and legibly identify
189you as the publisher of these copies. The front cover must present
190the full title with all words of the title equally prominent and
191visible. You may add other material on the covers in addition.
192Copying with changes limited to the covers, as long as they preserve
193the title of the Document and satisfy these conditions, can be treated
194as verbatim copying in other respects.
195
196If the required texts for either cover are too voluminous to fit
197legibly, you should put the first ones listed (as many as fit
198reasonably) on the actual cover, and continue the rest onto adjacent
199pages.
200
201If you publish or distribute Opaque copies of the Document numbering
202more than 100, you must either include a machine-readable Transparent
203copy along with each Opaque copy, or state in or with each Opaque copy
204a computer-network location from which the general network-using
205public has access to download using public-standard network protocols
206a complete Transparent copy of the Document, free of added material.
207If you use the latter option, you must take reasonably prudent steps,
208when you begin distribution of Opaque copies in quantity, to ensure
209that this Transparent copy will remain thus accessible at the stated
210location until at least one year after the last time you distribute an
211Opaque copy (directly or through your agents or retailers) of that
212edition to the public.
213
214It is requested, but not required, that you contact the authors of the
215Document well before redistributing any large number of copies, to give
216them a chance to provide you with an updated version of the Document.
217
218
219\begin{center}
220{\Large\bf 4. MODIFICATIONS}
221\addcontentsline{toc}{section}{4. MODIFICATIONS}
222\end{center}
223
224You may copy and distribute a Modified Version of the Document under
225the conditions of sections 2 and 3 above, provided that you release
226the Modified Version under precisely this License, with the Modified
227Version filling the role of the Document, thus licensing distribution
228and modification of the Modified Version to whoever possesses a copy
229of it. In addition, you must do these things in the Modified Version:
230
231\begin{itemize}
232\item[A.]
233 Use in the Title Page (and on the covers, if any) a title distinct
234 from that of the Document, and from those of previous versions
235 (which should, if there were any, be listed in the History section
236 of the Document). You may use the same title as a previous version
237 if the original publisher of that version gives permission.
238
239\item[B.]
240 List on the Title Page, as authors, one or more persons or entities
241 responsible for authorship of the modifications in the Modified
242 Version, together with at least five of the principal authors of the
243 Document (all of its principal authors, if it has fewer than five),
244 unless they release you from this requirement.
245
246\item[C.]
247 State on the Title page the name of the publisher of the
248 Modified Version, as the publisher.
249
250\item[D.]
251 Preserve all the copyright notices of the Document.
252
253\item[E.]
254 Add an appropriate copyright notice for your modifications
255 adjacent to the other copyright notices.
256
257\item[F.]
258 Include, immediately after the copyright notices, a license notice
259 giving the public permission to use the Modified Version under the
260 terms of this License, in the form shown in the Addendum below.
261
262\item[G.]
263 Preserve in that license notice the full lists of Invariant Sections
264 and required Cover Texts given in the Document's license notice.
265
266\item[H.]
267 Include an unaltered copy of this License.
268
269\item[I.]
270 Preserve the section Entitled "History", Preserve its Title, and add
271 to it an item stating at least the title, year, new authors, and
272 publisher of the Modified Version as given on the Title Page. If
273 there is no section Entitled "History" in the Document, create one
274 stating the title, year, authors, and publisher of the Document as
275 given on its Title Page, then add an item describing the Modified
276 Version as stated in the previous sentence.
277
278\item[J.]
279 Preserve the network location, if any, given in the Document for
280 public access to a Transparent copy of the Document, and likewise
281 the network locations given in the Document for previous versions
282 it was based on. These may be placed in the "History" section.
283 You may omit a network location for a work that was published at
284 least four years before the Document itself, or if the original
285 publisher of the version it refers to gives permission.
286
287\item[K.]
288 For any section Entitled "Acknowledgements" or "Dedications",
289 Preserve the Title of the section, and preserve in the section all
290 the substance and tone of each of the contributor acknowledgements
291 and/or dedications given therein.
292
293\item[L.]
294 Preserve all the Invariant Sections of the Document,
295 unaltered in their text and in their titles. Section numbers
296 or the equivalent are not considered part of the section titles.
297
298\item[M.]
299 Delete any section Entitled "Endorsements". Such a section
300 may not be included in the Modified Version.
301
302\item[N.]
303 Do not retitle any existing section to be Entitled "Endorsements"
304 or to conflict in title with any Invariant Section.
305
306\item[O.]
307 Preserve any Warranty Disclaimers.
308\end{itemize}
309
310If the Modified Version includes new front-matter sections or
311appendices that qualify as Secondary Sections and contain no material
312copied from the Document, you may at your option designate some or all
313of these sections as invariant. To do this, add their titles to the
314list of Invariant Sections in the Modified Version's license notice.
315These titles must be distinct from any other section titles.
316
317You may add a section Entitled "Endorsements", provided it contains
318nothing but endorsements of your Modified Version by various
319parties--for example, statements of peer review or that the text has
320been approved by an organization as the authoritative definition of a
321standard.
322
323You may add a passage of up to five words as a Front-Cover Text, and a
324passage of up to 25 words as a Back-Cover Text, to the end of the list
325of Cover Texts in the Modified Version. Only one passage of
326Front-Cover Text and one of Back-Cover Text may be added by (or
327through arrangements made by) any one entity. If the Document already
328includes a cover text for the same cover, previously added by you or
329by arrangement made by the same entity you are acting on behalf of,
330you may not add another; but you may replace the old one, on explicit
331permission from the previous publisher that added the old one.
332
333The author(s) and publisher(s) of the Document do not by this License
334give permission to use their names for publicity for or to assert or
335imply endorsement of any Modified Version.
336
337
338\begin{center}
339{\Large\bf 5. COMBINING DOCUMENTS}
340\addcontentsline{toc}{section}{5. COMBINING DOCUMENTS}
341\end{center}
342
343
344You may combine the Document with other documents released under this
345License, under the terms defined in section 4 above for modified
346versions, provided that you include in the combination all of the
347Invariant Sections of all of the original documents, unmodified, and
348list them all as Invariant Sections of your combined work in its
349license notice, and that you preserve all their Warranty Disclaimers.
350
351The combined work need only contain one copy of this License, and
352multiple identical Invariant Sections may be replaced with a single
353copy. If there are multiple Invariant Sections with the same name but
354different contents, make the title of each such section unique by
355adding at the end of it, in parentheses, the name of the original
356author or publisher of that section if known, or else a unique number.
357Make the same adjustment to the section titles in the list of
358Invariant Sections in the license notice of the combined work.
359
360In the combination, you must combine any sections Entitled "History"
361in the various original documents, forming one section Entitled
362"History"; likewise combine any sections Entitled "Acknowledgements",
363and any sections Entitled "Dedications". You must delete all sections
364Entitled "Endorsements".
365
366\begin{center}
367{\Large\bf 6. COLLECTIONS OF DOCUMENTS}
368\addcontentsline{toc}{section}{6. COLLECTIONS OF DOCUMENTS}
369\end{center}
370
371You may make a collection consisting of the Document and other documents
372released under this License, and replace the individual copies of this
373License in the various documents with a single copy that is included in
374the collection, provided that you follow the rules of this License for
375verbatim copying of each of the documents in all other respects.
376
377You may extract a single document from such a collection, and distribute
378it individually under this License, provided you insert a copy of this
379License into the extracted document, and follow this License in all
380other respects regarding verbatim copying of that document.
381
382
383\begin{center}
384{\Large\bf 7. AGGREGATION WITH INDEPENDENT WORKS}
385\addcontentsline{toc}{section}{7. AGGREGATION WITH INDEPENDENT WORKS}
386\end{center}
387
388
389A compilation of the Document or its derivatives with other separate
390and independent documents or works, in or on a volume of a storage or
391distribution medium, is called an "aggregate" if the copyright
392resulting from the compilation is not used to limit the legal rights
393of the compilation's users beyond what the individual works permit.
394When the Document is included in an aggregate, this License does not
395apply to the other works in the aggregate which are not themselves
396derivative works of the Document.
397
398If the Cover Text requirement of section 3 is applicable to these
399copies of the Document, then if the Document is less than one half of
400the entire aggregate, the Document's Cover Texts may be placed on
401covers that bracket the Document within the aggregate, or the
402electronic equivalent of covers if the Document is in electronic form.
403Otherwise they must appear on printed covers that bracket the whole
404aggregate.
405
406
407\begin{center}
408{\Large\bf 8. TRANSLATION}
409\addcontentsline{toc}{section}{8. TRANSLATION}
410\end{center}
411
412
413Translation is considered a kind of modification, so you may
414distribute translations of the Document under the terms of section 4.
415Replacing Invariant Sections with translations requires special
416permission from their copyright holders, but you may include
417translations of some or all Invariant Sections in addition to the
418original versions of these Invariant Sections. You may include a
419translation of this License, and all the license notices in the
420Document, and any Warranty Disclaimers, provided that you also include
421the original English version of this License and the original versions
422of those notices and disclaimers. In case of a disagreement between
423the translation and the original version of this License or a notice
424or disclaimer, the original version will prevail.
425
426If a section in the Document is Entitled "Acknowledgements",
427"Dedications", or "History", the requirement (section 4) to Preserve
428its Title (section 1) will typically require changing the actual
429title.
430
431
432\begin{center}
433{\Large\bf 9. TERMINATION}
434\addcontentsline{toc}{section}{9. TERMINATION}
435\end{center}
436
437
438You may not copy, modify, sublicense, or distribute the Document except
439as expressly provided for under this License. Any other attempt to
440copy, modify, sublicense or distribute the Document is void, and will
441automatically terminate your rights under this License. However,
442parties who have received copies, or rights, from you under this
443License will not have their licenses terminated so long as such
444parties remain in full compliance.
445
446
447\begin{center}
448{\Large\bf 10. FUTURE REVISIONS OF THIS LICENSE}
449\addcontentsline{toc}{section}{10. FUTURE REVISIONS OF THIS LICENSE}
450\end{center}
451
452
453The Free Software Foundation may publish new, revised versions
454of the GNU Free Documentation License from time to time. Such new
455versions will be similar in spirit to the present version, but may
456differ in detail to address new problems or concerns. See
457http://www.gnu.org/copyleft/.
458
459Each version of the License is given a distinguishing version number.
460If the Document specifies that a particular numbered version of this
461License "or any later version" applies to it, you have the option of
462following the terms and conditions either of that specified version or
463of any later version that has been published (not as a draft) by the
464Free Software Foundation. If the Document does not specify a version
465number of this License, you may choose any version ever published (not
466as a draft) by the Free Software Foundation.
467
468
469\begin{center}
470{\Large\bf ADDENDUM: How to use this License for your documents}
471\addcontentsline{toc}{section}{ADDENDUM: How to use this License for your documents}
472\end{center}
473
474To use this License in a document you have written, include a copy of
475the License in the document and put the following copyright and
476license notices just after the title page:
477
478\bigskip
479\begin{quote}
480 Copyright \copyright YEAR YOUR NAME.
481 Permission is granted to copy, distribute and/or modify this document
482 under the terms of the GNU Free Documentation License, Version 1.2
483 or any later version published by the Free Software Foundation;
484 with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
485 A copy of the license is included in the section entitled "GNU
486 Free Documentation License".
487\end{quote}
488\bigskip
489
490If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
491replace the "with...Texts." line with this:
492
493\bigskip
494\begin{quote}
495 with the Invariant Sections being LIST THEIR TITLES, with the
496 Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
497\end{quote}
498\bigskip
499
500If you have Invariant Sections without Cover Texts, or some other
501combination of the three, merge those two alternatives to suit the
502situation.
503
504If your document contains nontrivial examples of program code, we
505recommend releasing these examples in parallel under your choice of
506free software license, such as the GNU General Public License,
507to permit their use in free software.
508
509%---------------------------------------------------------------------
510%% \end{document}
diff --git a/manual/appendix/images/icon-audio-file.png b/manual/appendix/images/icon-audio-file.png
new file mode 100644
index 0000000000..4ea0a41795
--- /dev/null
+++ b/manual/appendix/images/icon-audio-file.png
Binary files differ
diff --git a/manual/appendix/images/icon-chip8.png b/manual/appendix/images/icon-chip8.png
new file mode 100644
index 0000000000..347703f8ff
--- /dev/null
+++ b/manual/appendix/images/icon-chip8.png
Binary files differ
diff --git a/manual/appendix/images/icon-config.png b/manual/appendix/images/icon-config.png
new file mode 100644
index 0000000000..d260f6f8a5
--- /dev/null
+++ b/manual/appendix/images/icon-config.png
Binary files differ
diff --git a/manual/appendix/images/icon-directory.png b/manual/appendix/images/icon-directory.png
new file mode 100644
index 0000000000..a8eb07986f
--- /dev/null
+++ b/manual/appendix/images/icon-directory.png
Binary files differ
diff --git a/manual/appendix/images/icon-font.png b/manual/appendix/images/icon-font.png
new file mode 100644
index 0000000000..a84da29d82
--- /dev/null
+++ b/manual/appendix/images/icon-font.png
Binary files differ
diff --git a/manual/appendix/images/icon-image-file.png b/manual/appendix/images/icon-image-file.png
new file mode 100644
index 0000000000..0c14c7664e
--- /dev/null
+++ b/manual/appendix/images/icon-image-file.png
Binary files differ
diff --git a/manual/appendix/images/icon-lang.png b/manual/appendix/images/icon-lang.png
new file mode 100644
index 0000000000..de14795f97
--- /dev/null
+++ b/manual/appendix/images/icon-lang.png
Binary files differ
diff --git a/manual/appendix/images/icon-movie-file.png b/manual/appendix/images/icon-movie-file.png
new file mode 100644
index 0000000000..5b85ece48c
--- /dev/null
+++ b/manual/appendix/images/icon-movie-file.png
Binary files differ
diff --git a/manual/appendix/images/icon-playlist.png b/manual/appendix/images/icon-playlist.png
new file mode 100644
index 0000000000..b5065422c0
--- /dev/null
+++ b/manual/appendix/images/icon-playlist.png
Binary files differ
diff --git a/manual/appendix/images/icon-rock.png b/manual/appendix/images/icon-rock.png
new file mode 100644
index 0000000000..89c77f405f
--- /dev/null
+++ b/manual/appendix/images/icon-rock.png
Binary files differ
diff --git a/manual/appendix/images/icon-rolo.png b/manual/appendix/images/icon-rolo.png
new file mode 100644
index 0000000000..067c2b9797
--- /dev/null
+++ b/manual/appendix/images/icon-rolo.png
Binary files differ
diff --git a/manual/appendix/images/icon-text.png b/manual/appendix/images/icon-text.png
new file mode 100644
index 0000000000..5d1d735f45
--- /dev/null
+++ b/manual/appendix/images/icon-text.png
Binary files differ
diff --git a/manual/appendix/images/icon-ucl.png b/manual/appendix/images/icon-ucl.png
new file mode 100644
index 0000000000..9c51d1b254
--- /dev/null
+++ b/manual/appendix/images/icon-ucl.png
Binary files differ
diff --git a/manual/appendix/images/icon-wps.png b/manual/appendix/images/icon-wps.png
new file mode 100644
index 0000000000..3247225f37
--- /dev/null
+++ b/manual/appendix/images/icon-wps.png
Binary files differ
diff --git a/manual/rockbox.tex b/manual/rockbox.tex
index 941b5abee7..5f0414e1a5 100644
--- a/manual/rockbox.tex
+++ b/manual/rockbox.tex
@@ -18,8 +18,8 @@
18\input{configure_rockbox/main.tex} 18\input{configure_rockbox/main.tex}
19\input{plugins/main.tex} 19\input{plugins/main.tex}
20\input{advanced_topics/main.tex} 20\input{advanced_topics/main.tex}
21%\input{appendix.tex} 21\input{appendix/appendix.tex}
22%\appendix 22\appendix
23 23
24\raggedright 24\raggedright
25\end{document} 25\end{document}