diff options
author | Alexander Levin <al.le@gmx.de> | 2012-03-02 20:53:25 +0100 |
---|---|---|
committer | Alex Parker <rockbox@aeparker.com> | 2012-03-02 21:19:39 +0100 |
commit | fa452c1025c879867c28b39b045446e66f1eea83 (patch) | |
tree | 985271ca4c9288d5077ec07f8d605c254d7b9c03 /manual/advanced_topics/main.tex | |
parent | 5db58fcd0a96971ec5d783ff04c27b7e11dfa582 (diff) | |
download | rockbox-fa452c1025c879867c28b39b045446e66f1eea83.tar.gz rockbox-fa452c1025c879867c28b39b045446e66f1eea83.zip |
Manual: Describe more generally how to customise the main menu.
Change-Id: I1eda6d8b7785d1e2888860c8e461eb54b4f9abb7
Reviewed-on: http://gerrit.rockbox.org/164
Reviewed-by: Alex Parker <rockbox@aeparker.com>
Tested-by: Alex Parker <rockbox@aeparker.com>
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} |