Some random general notes:

0. Default Theme
----------------

All the themes in this module inherit from the 'gnome' theme.
The 'gnome' theme is in the gnome-icon-theme module, and has to be built and installed separately.

1. Adding new icons
-------------------

The module is currently configured to make it easy to add or remove a stock icon from all themes at once, but not so easy to do so on a per-theme basis.  This works well for now but probably won't if we want to make this a more general theme repository.

So, to add a new gtk stock icon to all themes:

- Add the icon's filename to common/all-stock-items.data
- Add the line you want to appear in the themes' RC files to the appropriate common/*.rc file
- Add the icon files, each with the same filename, to all the <theme>/pixmaps/ directories.

GNOME icons that are themed via the icon theming mechanism (as specified on freedesktop.org) are currently still added individually in each <theme>/icons subdirectory. E.g. to add a new 48x48 application icon to all the themes, you have to modify each <theme>/icons/48x48/apps/Makefile.am individually, and add the appropriate icon file to each <theme>/icons/48x48/apps directory.


2. Changing icon sizes
----------------------

The icon sizes for ALL the LargePrint themes are defined in configure.in.  Changing them here will affect all LargePrint themes.


3.  Changing colours
--------------------

To change the colours in a particular theme, edit its <themename>/gtk-2.0/<themename>.makefile file.


4. Switching icon themes
------------------------
Unless you're running my patched theme switcher dialog (patch in bugzilla,
#93486), you'll need to switch icon themes by hand using GConf:

$ gconftool-2 -s /desktop/gnome/interface/icon_theme "<themename>" --type=string


5. To create low contrast icons in GIMP from the original coloured icon
------------------------------------------------------------------------

Use the low-contrast-preset.scm GIMP script in this directory to create a low
contrast icon from a regular-coloured icon.  (Read the comments in the script
for instructions on how to install and use it.)  Thanks to Guillermo for
providing this!
