manual/plugins/theme_remove.tex

   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}