diff options
Diffstat (limited to 'manual/advanced_topics/main.tex')
-rw-r--r-- | manual/advanced_topics/main.tex | 32 |
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 | ||
8 | It is possible to customise the main menu, i.e. to reorder or to hide some | 8 | It is possible to customise the main menu, i.e. to reorder or to hide some |
9 | of its items. To accomplish this, the file \fname{/.rockbox/config.cfg} must | 9 | of its items (only the main menu can be customised, submenus can not). |
10 | be edited (presumably on the computer while the \dap{} is connected to it | 10 | To accomplish this, load a \fname{.cfg} file (as described in |
11 | via USB). There, the line starting with \config{root~menu~order:} must | 11 | \reference{ref:manage_settings}) containing the following line: |
12 | be 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 | |
14 | The line should look like \config{root~menu~order:items}, where ``items'' | 14 | words: \config{bookmarks}, \config{files}, \opt{tagcache}{\config{database}, }% |
15 | is a comma separated list (no spaces around the commas!) of the following | ||
16 | words: \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}. |
20 | Each of the words, if it occurs in the list, activates the appropriate item | 18 | Each of the words, if it occurs in the list, activates the appropriate item |
21 | in the main menu. The order of the items is given by the order of the words | 19 | in the main menu. The order of the items is given by the order of the words |
22 | in the list. The items whose words do not occur in the list will be hidden, | 20 | in the list. The items whose words do not occur in the list will be hidden, |
23 | with one exception: the menu item ``Settings'' will be shown even if its word | 21 | with one exception: the menu item \setting{Settings} will be shown even if |
24 | is not in the list (it is added as the last item then). | 22 | its word is not in the list (it is added as the last item then). |
25 | 23 | ||
26 | Use the line \config{root~menu~order:-} to reset the menu order | 24 | The following configuration example will change the main menu so that it will |
25 | contain only the items for the file browser, for resuming the playback, and | ||
26 | for changing the settings (the latter will be added automatically). | ||
27 | \begin{example} | ||
28 | \config{root menu order:files,wps} | ||
29 | \end{example} | ||
30 | |||
31 | |||
32 | To reset the menu items to the default, use \config{root~menu~order:-} (i.e. | ||
33 | use a hyphen instead of ``items''). | ||
27 | 34 | ||
28 | Only the main menu can be customised this way, submenus can not. | 35 | This configuration entry can only be created and edited with a text editor. It is |
36 | not 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} |