gimp/README

THIS IS AN UNSTABLE DEVELOPMENT VERSION! DO NOT USE!
====================================================

This is the development branch of The GIMP. Here's where new features
are being added. Somewhen this summer the next stable GIMP release,
GIMP 2.2, will emerge out of this. This is an early development
snapshot, there are bugs and quite some loose ends.

Since the plug-in API of GIMP 2.2 will be compatible with GIMP 2.0,
2.2 is supposed to install itself into the gimp-2.0 directories. It is
thus not possible to install this development version into the same
prefix with GIMP 2.0. A number of files will clash, so please use a
separate prefix to install this development version.

Please do not distribute binary packages of gimp-2.1!

If you want to hack on The GIMP, please read the file HACKING. For
detailed installation instructions, see the file INSTALL.


1. Web Resources
================

The GIMP's home page is at:

	http://www.gimp.org/

Please be sure to visit this site for information, documentation,
tutorials, news, etc.  All things GIMP-ish are available from there.

The automated plug-in registry is located at:

	http://registry.gimp.org/

There you can get the latest versions of plug-ins, using a convenient
forms-based interface.

The latest version of The GIMP can be found at:

	http://www.gimp.org/downloads/


2. Mailing Lists
================

We have several mailing lists dedicated to GIMP user and development
discussion.  There is more info at

	https://lists.xcf.berkeley.edu/mailman/listinfo/<listname>

with <listname> replaced by "gimp-announce", "gimp-user", "gimp-win-users"
or "gimp-developer" (without the quotes, of course) depending on the list
you want to subscribe to.  Links to the mailing list archives can be
found at the same addresses as given above.

Gimp-announce is a low-traffic list with announcements about new
releases of GIMP and plug-ins. Gimp-user is a mailing list dedicated
to user problems, hints and tips, discussion of cool effects, etc.
Gimp-developer is oriented to GIMP core and plug-in developers.  Most
people will only want to be subscribed to gimp-user. If you want to
help develop The GIMP, the gimp-developer mailing list is a good
starting point.

There is also a mailing list, "gimpwin-users", dedicated to users of the Win32 port.  To subscribe, send an empty message to

	gimpwin-users-subscribe@egroups.com

You can also use the web interface at
http://www.egroups.com/group/gimpwin-users/. Note that as this mailing
list is hosted on egroups.com, the messages from the list contain
relatively unintrusive and easily ignored advertisements at the
end. But if you are absolutely allergic to ads, don't subscribe.


3. IRC
======

And finally, for the real junkies, there is an IRC channel devoted to
the GIMP. On Byxnet (a private mostly-GIMP network) there is #gimp.
Many of the developers hang out there.  One of the Byxnet servers are:

	irc.gimp.org:6667


4. Customizing
==============

The look of GIMP's interface can be customized like any other GTK app
by editing the ~/.gtkrc-2.0 file or by using "themes" (ready-made
customizations).  For downloadable themes and further details, see
http://gtk.themes.org.  Additionally, GIMP reads ~/.gimp-2.0/gtkrc so
you can have settings that only apply to The GIMP.

Included is a set of keybindings similar to those in Adobe Photoshop.
You can find them in the ps-menurc file.  To use them, copy this file
to ~/.gimp-2.0/menurc. You can also manually change the keybindings to
any of your choice by editing ~/.gimp-2.0/menurc.


Have fun,

  Spencer Kimball
  Peter Mattis
  Federico Mena
  Manish Singh
  Sven Neumann
  Michael Natterer
  Dave Neary