Manual: Add missing plugins

The text is usually only a short description taken from the wiki and
don't contain screenshots or keymaps, but should be better than nothing. :)

Added manual entries:
- Boomshine
- Dict
- FFT
- main_menu_config
- Matrix
- Maze (including keymap)
- PDbox
- Superdom
Additional changes/fixes:
- fix "Clix" alphabetical order
- add Frotz & ZXBox to games preamble

Change-Id: I169870420cbac8123695747ccfcbaaf3478c11cc

manual/advanced_topics/main.tex

@@ -32,8 +32,9 @@ for changing the settings (the latter will be added automatically).
 To reset the menu items to the default, use \config{root~menu~order:-} (i.e.
 use a hyphen instead of ``items'').
 
-This configuration entry can only be created and edited with a text editor. It is
+This configuration entry can only be created and edited with a text editor or
-not possible to change this setting via the settings menu.
+the Main Menu Config Plugin (see \reference{ref:main_menu_config}).
+It is not possible to change this setting via the settings menu.
 
 \opt{lcd_bitmap}{
 \subsection{\label{ref:GettingExtras}Getting Extras}

manual/plugins/boomshine.tex

@@ -0,0 +1,5 @@
+\subsection{Boomshine}
+
+This is a game coded in Lua that's a clone of \url{http://www.yvoschaap.com/chainrxn/}.
+It is a rather basic game, but probably a good way to show off some of Lua's features
+in Rockbox.

manual/plugins/dict.tex

@@ -0,0 +1,23 @@
+\subsection{Dict}
+
+\subsubsection{Prerequisites for using the plugin}
+To use the plugin, firstly you need to have the dictionary files which contain
+the words (index) and their description -- \fname{dict.index} and
+\fname{dict.desc}, respectively -- on \fname{/.rockbox/rocks/apps/} folder.
+
+The dictionary files can be created by yourself, or you can get them crafted
+from the web. More information can be found at \wikilink{PluginDict}.
+
+\subsubsection{Using the plugin}
+Now that you already have the two necessary files in place, you can launch the
+dict plugin (under Applications on the Browse plugins menu). The first thing
+you will see is the text input screen.
+
+Type part of a word (or the whole word) or anything the dict files have a
+definition to and accept the text input. The plugin will search for matching
+entries on the \fname{dict.index} file and display according description/meaning
+contained in the \fname{dict.desc} file.
+
+If no matches are found on the dictionary, a ``Not found'' message will be
+displayed and the plugin will exit. You can do another search by relaunching
+the plugin.

manual/plugins/fft.tex

@@ -0,0 +1,4 @@
+% $Id$ %
+\subsection{FFT}
+This plugin is a basic frequency analyzer with 3 different frequency-amplitude
+plots (lines, bars, and spectrogram).

manual/plugins/frotz.tex

@@ -1,5 +1,5 @@
 % $Id$ %
-\subsection{Frotz}
+\subsection{\label{ref:Frotz}Frotz}
 Frotz is a Z-Machine interpreter for playing Infocom's interactive fiction
 games, and newer games using the same format. To start a game open a
 \fname{.z1 - .z8} file in the \setting{File Browser}. Most modern games are

manual/plugins/main.tex

@@ -19,24 +19,28 @@ text files%
 
 \section{Games}
 \opt{lcd_bitmap}
-    {See also the Chip{}-8 emulator in \reference{ref:Chip8emulator}
+    {See also the Chip{}-8 emulator in \reference{ref:Chip8emulator},
+    Frotz in \reference{ref:Frotz},
     \opt{archosrecorder,archosfmrecorder,iriverh100,iaudiom5,lcd_color}
-    {and Rockboy in \reference{ref:Rockboy}}.}
+    {Rockboy in \reference{ref:Rockboy}}
+    and ZXBox in \reference{ref:ZXBox}.}
 
 \opt{lcd_bitmap}{\input{plugins/2048.tex}}
 
 \opt{lcd_bitmap}{\input{plugins/blackjack.tex}}
 
+\opt{large_plugin_buffer}{\input{plugins/boomshine.tex}}
+
 \opt{lcd_bitmap}{\input{plugins/brickmania.tex}}
 
 \opt{lcd_bitmap}{\input{plugins/bubbles.tex}}
 
 \opt{lcd_bitmap}{\input{plugins/chessbox.tex}}
 
-\opt{lcd_color}{\input{plugins/clix.tex}}
-
 \opt{lcd_bitmap}{\input{plugins/chopper.tex}}
 
+\opt{lcd_color}{\input{plugins/clix.tex}}
+
 \opt{lcd_color}{\input{plugins/codebuster.tex}}
 
 {\input{plugins/dice.tex}}
@@ -54,6 +58,8 @@ text files%
 
 \opt{lcd_bitmap}{\input{plugins/jewels.tex}}
 
+\opt{lcd_bitmap}{\input{plugins/maze.tex}}
+
 \opt{lcd_bitmap}{\input{plugins/mazezam.tex}}
 
 \opt{lcd_bitmap}{\input{plugins/minesweeper.tex}}
@@ -90,6 +96,9 @@ text files%
 
 \opt{lcd_bitmap}{\input{plugins/sudoku.tex}}
 
+\opt{lcd_non-mono}{\nopt{iriverh10_5gb,ipodmini1g,c200,c200v2,mpiohd200,clipzip,samsungyh820}{
+  \input{plugins/superdom.tex}}}
+
 \opt{lcd_bitmap}{\input{plugins/wormlet.tex}}
 
 \opt{lcd_bitmap}{\input{plugins/xobox.tex}}
@@ -106,12 +115,16 @@ text files%
 
 \opt{lcd_bitmap}{\input{plugins/demystify.tex}}
 
+\opt{swcodec}{\input{plugins/fft.tex}}
+
 \opt{lcd_bitmap}{\input{plugins/fire.tex}}
 
 \opt{lcd_bitmap}{\input{plugins/fractals.tex}}
 
 {\input{plugins/logo.tex}}
 
+\opt{lcd_bitmap}{\input{plugins/matrix.tex}}
+
 {\input{plugins/mosaic.tex}}
 
 \opt{lcd_bitmap}{\input{plugins/oscilloscope.tex}}
@@ -193,6 +206,9 @@ option from the \setting{Context Menu} (see \reference{ref:Contextmenu}).}
 
 \opt{swcodec}{\input{plugins/mp3_encoder.tex}}
 
+\opt{iriverh300,iriverh100,SANSA_FUZE_PAD,SANSA_E200_PAD,IPOD_4G_PAD,IPOD_3G_PAD%
+    ,IPOD_1G2G_PAD,SAMSUNG_YPR0_PAD}{
+  \input{plugins/pdbox.tex}}
 
 \opt{archosrecorder,archosfmrecorder,ondio}{\input{plugins/rockbox_flash.tex}}
 
@@ -236,6 +252,8 @@ option from the \setting{Context Menu} (see \reference{ref:Contextmenu}).}
 
 \opt{rtc}{\input{plugins/clock.tex}}
 
+{\input{plugins/dict.tex}}
+
 {\input{plugins/disktidy.tex}}
 
 \opt{archosplayer}{\input{plugins/euro_converter.tex}}
@@ -248,6 +266,8 @@ option from the \setting{Context Menu} (see \reference{ref:Contextmenu}).}
 
 \opt{lcd_bitmap}{\input{plugins/lrcplayer.tex}}
 
+{\input{plugins/main_menu_config.tex}}
+
 {\input{plugins/md5sum.tex}}
 
 {\input{plugins/metronome.tex}}

manual/plugins/main_menu_config.tex

@@ -0,0 +1,17 @@
+\subsection{Main Menu Configuration}
+{\label{ref:main_menu_config}}
+
+This plugin helps you customizing the main menu (i.e. reorder or hide menu
+items). It changes the appropriate configuration file as described in
+\reference{ref:CustomisingTheMainMenu}.
+
+When you start the plugin, the available main menu items will be displayed.
+By pressing \ActionStdOk{} you open a menu with the following options:
+\begin{description}
+\item[Toggle Item] Hide the selected menu item or make it visible again
+\item[Move Item Up] Swap the selected menu item with the previous one
+\item[Move Item down] Swap the selected menu item with the next one
+\item[Load Default Configuration] Discards all customization
+\item[Exit] Save your changes to the configuration file and exit the plugin
+\end{description}
+You can leave the plugin without saving by pressing \ActionStdCancel{}.

manual/plugins/matrix.tex

@@ -0,0 +1,4 @@
+\subsection{Matrix}
+
+This plugin is a visual demo resembling the scrolling code from ``The Matrix''
+(\url{https://en.wikipedia.org/wiki/The_Matrix}).

manual/plugins/maze.tex

@@ -0,0 +1,39 @@
+\subsection{Maze}
+
+This is a simple maze generator that creates perfect mazes that have only
+one solution.
+
+\begin{btnmap}
+    \opt{IPOD_3G_PAD}{\ButtonScrollBack/\ButtonScrollFwd/\ButtonLeft/\ButtonRight}
+    \nopt{IPOD_3G_PAD}{\PluginUp/\PluginDown/\PluginLeft/\PluginRight}
+        &
+    \opt{HAVEREMOTEKEYMAP}{
+        \PluginRCUp, \PluginRCDown, \PluginRCLeft, \PluginRCRight
+        &}
+    Navigate maze
+    \\
+
+    \opt{IPOD_3G_PAD}{\ButtonMenu}
+    \nopt{IPOD_3G_PAD}{\PluginCancel}
+        &
+    \opt{HAVEREMOTEKEYMAP}{\PluginRCCancel
+        &}
+    Exit plugin
+    \\
+
+    \opt{IPOD_3G_PAD}{Long \ButtonSelect}
+    \nopt{IPOD_3G_PAD}{\PluginSelectRepeat}
+        &
+    \opt{HAVEREMOTEKEYMAP}{\PluginRCSelectRepeat
+        &}
+    New Maze
+    \\
+
+    \opt{IPOD_3G_PAD}{\ButtonSelect}
+    \nopt{IPOD_3G_PAD}{\PluginSelect}
+        &
+    \opt{HAVEREMOTEKEYMAP}{\PluginRCSelect
+        &}
+    Display solution (toggle)
+    \\
+\end{btnmap}

manual/plugins/pdbox.tex

@@ -0,0 +1,11 @@
+\subsection{PDBox}
+
+PDBox is a Pure Data audio environment with small-size GUI. Those who do not know
+what Pure Data is are advised to look at the book \href{http://aspress.co.uk/ds/}
+{``Designing Sound''}, both at the abridged text and at the sample chapters.
+Another good Pure Data tutorial can be found at \url{http://www.pd-tutorial.com/}.
+
+\subsubsection{Prerequisites for using the plugin}
+To test the abilities of PDBox get the file
+\href{http://www.rockbox.org/wiki/pub/Main/PureDataOnRockbox/PureData.zip}
+{\fname{PureData.zip}}. See \wikilink{PluginPdbox} for more information.

manual/plugins/superdom.tex

@@ -0,0 +1,53 @@
+\subsection{Superdom}
+
+Superdom is a turn based strategy game, where the aim is to defeat the computer
+player by overpowering them using your army.
+
+When the game starts the player is given roughly 50% of the tiles on the map,
+two farms, and two factories. To overpower the enemy, you must place resources
+in adjacent tiles (diagonals do not count), such that your strength is greater
+than the computers, then attack the square.
+
+Each ``year'' is broken up into three phases: purchasing, movement, and war.
+During the purchasing phase you are allocated money and food, may purchase
+units/buildings, and may access the bank.
+
+During the movement phase you can move your units only to adjacent squares
+(except planes, which may move anywhere), at a cost of 1 move per unit you move.
+(Men are considered to be one unit, no matter how many you move). You can change
+the number of moves you receive by default in the settings, and you may purchase
+additional moves for \$100 each. You may also launch nuclear weapons if you have
+purchased any.
+
+During the war phase you can attack the enemy. This is where the strengths come
+into play. Each tile has its own strength for both the computer, and the human
+player. If you attack a square owned by the computer player where your strength
+is greater than the computer's, you will win the tile - and take control of any
+building that were on it. If the strengths are equal, a victor is chosen at
+random.
+
+The bank (in the purchasing phase) is a place where you can store your money
+and earn interest (usually about 10% p.a.), however, while the money is in the
+bank, it is not accessible until the next purchasing phase.
+
+\subsubsection{Notes on food}
+Each year you are allocated an amount of food based on the number of farms you
+control. Food is used to feed your men, but if you do not have enough food to
+feed your population of men, some will die of starvation.
+
+\subsubsection{Summary of units}
+\begin{table}
+    \begin{rbtabular}{\textwidth}{lccX}%
+        {\textbf{Unit} & \textbf{Cost} & \textbf{Individual strength}%
+         & \textbf{Special abilities}}{}{}
+        Men       & \$1 each & 1.33 per 100 & No square population limit, however %
+                                              require 1 food each per year\\
+        Tanks     & \$300    & 3 & None\\
+        Planes    & \$600    & 4 & Can move to any human controlled point on the map\\
+        Farms     & \$1150   & 3 & Generates additional food at start of year\\
+        Factories & \$1300   & 3 & Generates additional food at start of year\\
+        Nukes     & \$2000   & 2 & During the movement phase you may lauch a nuke %
+                                   to destroy all units on a given tile\\
+    \end{rbtabular}
+\end{table}
+Also note that the colour of the adjacent tiles also count towards your strength.