len0rd/rockbox
1
0
Fork 1
mirror of https://github.com/Rockbox/rockbox.git synced 2025-10-13 18:17:39 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Manual: Describe more generally how to customise the main menu.

Browse source 
Change-Id: I1eda6d8b7785d1e2888860c8e461eb54b4f9abb7
Reviewed-on: http://gerrit.rockbox.org/164
Reviewed-by: Alex Parker <rockbox@aeparker.com>
Tested-by: Alex Parker <rockbox@aeparker.com>
This commit is contained in:
Alexander Levin 2012-03-02 20:53:25 +01:00 • committed by Alex Parker
parent 5db58fcd0a
commit fa452c1025
1 changed files with 20 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

32
manual/advanced_topics/main.tex
View file

@ -6,26 +6,34 @@
\subsection{\label{ref:CustomisingTheMainMenu}Customising The Main Menu}
It is possible to customise the main menu, i.e. to reorder or to hide some
of its items. To accomplish this, the file \fname{/.rockbox/config.cfg} must
be edited (presumably on the computer while the \dap{} is connected to it
via USB). There, the line starting with \config{root~menu~order:} must
be edited (or created if it is not present yet).
The line should look like \config{root~menu~order:items}, where ``items''
is a comma separated list (no spaces around the commas!) of the following
words: \config{bookmarks}, \config{files}, \opt{database}{\config{database}, }%
of its items (only the main menu can be customised, submenus can not).
To accomplish this, load a \fname{.cfg} file (as described in
\reference{ref:manage_settings}) containing the following line:
\config{root~menu~order:items}, where ``items'' is a comma separated list
(no spaces around the commas!) of the following
words: \config{bookmarks}, \config{files}, \opt{tagcache}{\config{database}, }%
\config{wps}, \config{settings}, \opt{recording}{\config{recording}, }%
\opt{radio}{\config{radio}, }\config{playlists}, \config{plugins},
\config{system\_menu}, \opt{PLAYER_PAD}{\config{shutdown}, }\config{shortcuts}.
Each of the words, if it occurs in the list, activates the appropriate item
in the main menu. The order of the items is given by the order of the words
in the list. The items whose words do not occur in the list will be hidden,
with one exception: the menu item ``Settings'' will be shown even if its word
is not in the list (it is added as the last item then).
with one exception: the menu item \setting{Settings} will be shown even if
its word is not in the list (it is added as the last item then).
Use the line \config{root~menu~order:-} to reset the menu order
The following configuration example will change the main menu so that it will
contain only the items for the file browser, for resuming the playback, and
for changing the settings (the latter will be added automatically).
\begin{example}
\config{root menu order:files,wps}
\end{example}
Only the main menu can be customised this way, submenus can not.
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
not possible to change this setting via the settings menu.
\opt{lcd_bitmap}{
\subsection{\label{ref:GettingExtras}Getting Extras}