···11+% $Id $ %
22+\subsection{\label{ref:ThemeRemove}Theme Remove}
33+This plugin offers a way to remove a theme. Open the \setting{Context Menu} (see \reference{ref:Contextmenu})
44+upon a theme\fname{.cfg} file and select \setting{Open With... $\rightarrow$ theme\_remove}.
55+Some files are not removed regardless of the \setting{Remove Options} such as
66+\fname{rockbox\_default.wps}\opt{lcd_bitmap}{ and the font file currently in use}.
77+88+\subsubsection{Theme Remove menu}
99+\begin{description}
1010+ \item[Remove Theme.]
1111+ Selecting this will delete the files specified in the \setting{Remove Options}.
1212+ After a theme has been succesfully removed, a log message is displayed listing
1313+ which items have been deleted and which are being kept. Exit this screen by
1414+ pressing any key. A file called \fname{theme\_remove\_log.txt} is created in
1515+ the root directory of your \dap{} listing all the changes.
1616+1717+ \item[Remove Options.]
1818+ This menu specifies which items are removed if
1919+ \setting{Remove Theme} is selected in the menu.
2020+2121+ One of the following options can be chosen for each setting.
2222+ \begin{description}
2323+ \item[Ask for Removal.]
2424+ Selecting this option brings up a dialogue with two options:
2525+ press \ActionYesNoAccept{} to confirm deletion or any other key to cancel.
2626+ \item[Remove if not Used.]
2727+ Selecting this option will remove the file automatically, if it is not
2828+ used by another theme in the theme directory and not currently used.
2929+ \item[Never Remove.]
3030+ Selecting this option will always skip deleting the file.
3131+ \item[Always Remove.]
3232+ Selecting this option will remove the file with no regard to
3333+ whether it's used by another theme or not.
3434+ \end{description}
3535+3636+ \begin{description}
3737+\opt{lcd_bitmap}{
3838+ \item[Font.]
3939+ Specifies how the \fname{.fnt} file belonging to a theme \fname{.cfg} file is handled.
4040+ If this option is set to \setting{Remove if not Used}, the fonts came from rockbox-fonts.zip
4141+ will not be removed as themes may depend on those fonts.
4242+}%
4343+ \item[WPS.]
4444+ Specifies how the \fname{.wps} file belonging to a theme \fname{.cfg} file is handled.
4545+\opt{HAVE_REMOTE_LCD}{
4646+ \item[Remote WPS.]
4747+ Specifies how the \fname{.rwps} file belonging to a theme \fname{.cfg} file is handled.
4848+}%
4949+\opt{lcd_non-mono}{
5050+ \item[Backdrop.]
5151+ Specifies how the backdrop \fname{.bmp} file belonging to a theme \fname{.cfg} file is handled.
5252+}%
5353+\opt{lcd_bitmap}{
5454+ \item[Iconset.]
5555+ Specifies how the iconset \fname{.bmp} file belonging to a theme \fname{.cfg} file is handled.
5656+ \item[Viewers Iconset.]
5757+ Specifies how the viewers iconset \fname{.bmp} file belonging to a theme \fname{.cfg} file is handled.
5858+}%
5959+\opt{HAVE_REMOTE_LCD}{
6060+ \item[Remote Iconset.]
6161+ Specifies how the remote iconset \fname{.bmp} file belonging to
6262+ a theme \fname{.cfg} file is handled.
6363+ \item[Remote Viewers Iconset.]
6464+ Specifies how the remote viewers iconset \fname{.bmp} file belonging to
6565+ a theme \fname{.cfg} file is handled.
6666+}% HAVE_REMOTE_LCD
6767+\opt{lcd_color}{
6868+ \item[Filetype Colours.]
6969+ Specifies how the colours \fname{.colours} file belonging to a theme \fname{.cfg} file is handled.
7070+}%
7171+7272+ \item[Create Log File.]
7373+ Setting this to \setting{No} prevents the log file from being created.
7474+ \end{description}
7575+ \item[Quit.]
7676+ Exits this plugin.
7777+\end{description}