####################
INSTALLATION:      #
####################
This section refers only to the distributable packages. For theme creation, skip
to the next section.

To install, drag and drop the .tar.gz file into MATE's Appearance Preferences,
or extract it and copy the mate-* folders to /usr/share/icons as administrator
(i.e. sudo nautilus /usr/share/icons in Ubuntu). The mate-colors-common folder
included in the mate-colors package is a required dependency. You MUST install
it in order for any mate-colors icon set to work correctly. If you install in
this manner, it is VERY recommended to always remove any previous version before
installation.

You may also use the included Makefile for system-wide installation, just type
"make install" as administrator or "make user-install" for per-user
installation. For more options, type "make help". These commands should be run
within the extracted folder that contains the Makefile. To uninstall, you should
run "make uninstall" as administratior or "make user-uninstall" per-user.

MATE-Colors depends on the package "mate-icon-theme". This package is already
installed in almost all distributions with a MATE desktop environment, but you
may have to install this package if your distribution or desktop environment
does not have it by default.

If installed through the Appearance Preferences tool in Ubuntu (instead of
extracting /usr/share/icons), for icons to theme root/admin applications, you
must type in a terminal: sudo ln -s ~/.icons /root

Please read the "Authors" and "Copying" files!

####################
THEME CREATION:    #
####################
This section refers only to the sources package. The sources package can be
downloaded separately from the distributable package.

MATE-Colors supports complete, scripted recoloring and the creation of new
color variations automatically. To create a custom version of mate-colors, just
follow the following instructions:

1. You need Inkscape and ImageMagick. They are required dependencies for
   building mate-colors from source.
2. Browse to the /themes folder and make a copy of any of the existing files.
3. Rename the copied file to "custom" or anything you like (no spaces!).
4. Open said file in a text editor, and change the name/values to your liking.
5. Run "make install-custom" as administrator or "make user-install-custom" to
   install per-user, where "custom" is the name of the icon set and theme file.
6. That's it! You now have a complete, custom mate-colors variation installed
   into your system.

NOTE: The make process will take anywhere between a few minutes to a very long
      time depending on your system specs. If you own a dual-core PC, you can
      run "make install -j3" for the best performance. Tri-core processors would
      use "-j4" and so on...

* When releasing a custom version built from the sources package, the resulting
  package must be licensed under the GPL as well. In this case, the theme file
  with the color palette is the source. It is recommended not to name any of the
  resulting themes the same as any existing mate-colors variant or include a
  folder named "mate-colors-common", as it will break or change existing
  installations of MATE-Colors.
