···1+% $Id $ %
2+\subsection{\label{ref:ThemeRemove}Theme Remove}
3+This plugin offers a way to remove a theme. Open the \setting{Context Menu} (see \reference{ref:Contextmenu})
4+upon a theme\fname{.cfg} file and select \setting{Open With... $\rightarrow$ theme\_remove}.
5+Some files are not removed regardless of the \setting{Remove Options} such as
6+\fname{rockbox\_default.wps}\opt{lcd_bitmap}{ and the font file currently in use}.
7+8+\subsubsection{Theme Remove menu}
9+\begin{description}
10+ \item[Remove Theme.]
11+ Selecting this will delete the files specified in the \setting{Remove Options}.
12+ After a theme has been succesfully removed, a log message is displayed listing
13+ which items have been deleted and which are being kept. Exit this screen by
14+ pressing any key. A file called \fname{theme\_remove\_log.txt} is created in
15+ the root directory of your \dap{} listing all the changes.
16+17+ \item[Remove Options.]
18+ This menu specifies which items are removed if
19+ \setting{Remove Theme} is selected in the menu.
20+21+ One of the following options can be chosen for each setting.
22+ \begin{description}
23+ \item[Ask for Removal.]
24+ Selecting this option brings up a dialogue with two options:
25+ press \ActionYesNoAccept{} to confirm deletion or any other key to cancel.
26+ \item[Remove if not Used.]
27+ Selecting this option will remove the file automatically, if it is not
28+ used by another theme in the theme directory and not currently used.
29+ \item[Never Remove.]
30+ Selecting this option will always skip deleting the file.
31+ \item[Always Remove.]
32+ Selecting this option will remove the file with no regard to
33+ whether it's used by another theme or not.
34+ \end{description}
35+36+ \begin{description}
37+\opt{lcd_bitmap}{
38+ \item[Font.]
39+ Specifies how the \fname{.fnt} file belonging to a theme \fname{.cfg} file is handled.
40+ If this option is set to \setting{Remove if not Used}, the fonts came from rockbox-fonts.zip
41+ will not be removed as themes may depend on those fonts.
42+}%
43+ \item[WPS.]
44+ Specifies how the \fname{.wps} file belonging to a theme \fname{.cfg} file is handled.
45+\opt{HAVE_REMOTE_LCD}{
46+ \item[Remote WPS.]
47+ Specifies how the \fname{.rwps} file belonging to a theme \fname{.cfg} file is handled.
48+}%
49+\opt{lcd_non-mono}{
50+ \item[Backdrop.]
51+ Specifies how the backdrop \fname{.bmp} file belonging to a theme \fname{.cfg} file is handled.
52+}%
53+\opt{lcd_bitmap}{
54+ \item[Iconset.]
55+ Specifies how the iconset \fname{.bmp} file belonging to a theme \fname{.cfg} file is handled.
56+ \item[Viewers Iconset.]
57+ Specifies how the viewers iconset \fname{.bmp} file belonging to a theme \fname{.cfg} file is handled.
58+}%
59+\opt{HAVE_REMOTE_LCD}{
60+ \item[Remote Iconset.]
61+ Specifies how the remote iconset \fname{.bmp} file belonging to
62+ a theme \fname{.cfg} file is handled.
63+ \item[Remote Viewers Iconset.]
64+ Specifies how the remote viewers iconset \fname{.bmp} file belonging to
65+ a theme \fname{.cfg} file is handled.
66+}% HAVE_REMOTE_LCD
67+\opt{lcd_color}{
68+ \item[Filetype Colours.]
69+ Specifies how the colours \fname{.colours} file belonging to a theme \fname{.cfg} file is handled.
70+}%
71+72+ \item[Create Log File.]
73+ Setting this to \setting{No} prevents the log file from being created.
74+ \end{description}
75+ \item[Quit.]
76+ Exits this plugin.
77+\end{description}