summaryrefslogtreecommitdiff
path: root/manual/advanced_topics
diff options
context:
space:
mode:
Diffstat (limited to 'manual/advanced_topics')
-rw-r--r--manual/advanced_topics/main.tex32
1 files changed, 20 insertions, 12 deletions
diff --git a/manual/advanced_topics/main.tex b/manual/advanced_topics/main.tex
index 25eff05827..e341ceaccc 100644
--- a/manual/advanced_topics/main.tex
+++ b/manual/advanced_topics/main.tex
@@ -6,26 +6,34 @@
6\subsection{\label{ref:CustomisingTheMainMenu}Customising The Main Menu} 6\subsection{\label{ref:CustomisingTheMainMenu}Customising The Main Menu}
7 7
8It is possible to customise the main menu, i.e. to reorder or to hide some 8It is possible to customise the main menu, i.e. to reorder or to hide some
9of its items. To accomplish this, the file \fname{/.rockbox/config.cfg} must 9of its items (only the main menu can be customised, submenus can not).
10be edited (presumably on the computer while the \dap{} is connected to it 10To accomplish this, load a \fname{.cfg} file (as described in
11via USB). There, the line starting with \config{root~menu~order:} must 11\reference{ref:manage_settings}) containing the following line:
12be edited (or created if it is not present yet). 12\config{root~menu~order:items}, where ``items'' is a comma separated list
13 13(no spaces around the commas!) of the following
14The line should look like \config{root~menu~order:items}, where ``items'' 14words: \config{bookmarks}, \config{files}, \opt{tagcache}{\config{database}, }%
15is a comma separated list (no spaces around the commas!) of the following
16words: \config{bookmarks}, \config{files}, \opt{database}{\config{database}, }%
17\config{wps}, \config{settings}, \opt{recording}{\config{recording}, }% 15\config{wps}, \config{settings}, \opt{recording}{\config{recording}, }%
18\opt{radio}{\config{radio}, }\config{playlists}, \config{plugins}, 16\opt{radio}{\config{radio}, }\config{playlists}, \config{plugins},
19\config{system\_menu}, \opt{PLAYER_PAD}{\config{shutdown}, }\config{shortcuts}. 17\config{system\_menu}, \opt{PLAYER_PAD}{\config{shutdown}, }\config{shortcuts}.
20Each of the words, if it occurs in the list, activates the appropriate item 18Each of the words, if it occurs in the list, activates the appropriate item
21in the main menu. The order of the items is given by the order of the words 19in the main menu. The order of the items is given by the order of the words
22in the list. The items whose words do not occur in the list will be hidden, 20in the list. The items whose words do not occur in the list will be hidden,
23with one exception: the menu item ``Settings'' will be shown even if its word 21with one exception: the menu item \setting{Settings} will be shown even if
24is not in the list (it is added as the last item then). 22its word is not in the list (it is added as the last item then).
25 23
26Use the line \config{root~menu~order:-} to reset the menu order 24The following configuration example will change the main menu so that it will
25contain only the items for the file browser, for resuming the playback, and
26for changing the settings (the latter will be added automatically).
27\begin{example}
28 \config{root menu order:files,wps}
29\end{example}
30
31
32To reset the menu items to the default, use \config{root~menu~order:-} (i.e.
33use a hyphen instead of ``items'').
27 34
28Only the main menu can be customised this way, submenus can not. 35This configuration entry can only be created and edited with a text editor. It is
36not possible to change this setting via the settings menu.
29 37
30\opt{lcd_bitmap}{ 38\opt{lcd_bitmap}{
31\subsection{\label{ref:GettingExtras}Getting Extras} 39\subsection{\label{ref:GettingExtras}Getting Extras}