README 4.61 KB
Newer Older
Sven Neumann's avatar
Sven Neumann committed
1 2 3
The GIMP: The GNU Image Manipulation Program
============================================

4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
This is version 1.3, the developers version of The GIMP. Only use it
if you are brave and curious and want to participate development
towards the next stable release version 1.4. This is a developers
version. We know it has bugs and it might not even compile. You have
been warned!

Some features that were present in GIMP 1.2 are disabled or not even
included in this release. The perl bindings as well as all the perl
scripts are not any longer included in this source tree. They have
been moved into its own module called gimp-perl and await being
porting to GIMP-1.3 and GTK+-2.0.

The new text tool is only halfway done and various other tools and
functions are broken. Almost everything is under construction. Don't
even think about using this for daily work. If you are a software
distributor, dont' dare to ship this package to innocent users.
Elliot Lee's avatar
Elliot Lee committed
20

21 22
For installation instructions, see the file INSTALL.

23

24 25 26 27 28 29
1. Web Resources
================

The GIMP's home page is at:

	http://www.gimp.org/
Elliot Lee's avatar
Elliot Lee committed
30

31 32
Please be sure to visit this site for information, documentation,
tutorials, news, etc.  All things GIMP-ish are available from there.
Elliot Lee's avatar
Elliot Lee committed
33

34
The automated plug-in registry is located at:
Elliot Lee's avatar
Elliot Lee committed
35

36
	http://registry.gimp.org/
Elliot Lee's avatar
Elliot Lee committed
37 38 39 40

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

41
The latest version of The GIMP can be found at:
Elliot Lee's avatar
Elliot Lee committed
42

43
	http://www.gimp.org/download/
Elliot Lee's avatar
Elliot Lee committed
44

45

46 47
2. Mailing Lists
================
Elliot Lee's avatar
Elliot Lee committed
48

49
We have several mailing lists dedicated to GIMP user and development
50
discussion.  There is more info at
Elliot Lee's avatar
Elliot Lee committed
51

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

54 55 56 57
substituting <listname> for "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.
Sven Neumann's avatar
Sven Neumann committed
58

59 60 61 62 63 64 65
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.
66

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

	gimpwin-users-subscribe@egroups.com
Sven Neumann's avatar
Sven Neumann committed
71

72 73 74 75 76
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.
77 78


79 80
3. IRC
======
Elliot Lee's avatar
Elliot Lee committed
81

82 83 84
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:
Elliot Lee's avatar
Elliot Lee committed
85

Manish Singh's avatar
Manish Singh committed
86
	irc.gimp.org:6667
Elliot Lee's avatar
Elliot Lee committed
87

Sven Neumann's avatar
Sven Neumann committed
88

89 90 91
4. Customizing
==============

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

98 99 100 101
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-1.3/menurc. You can also manually change the keybindings to
any of your choice by editing ~/.gimp-1.3/menurc.
Elliot Lee's avatar
Elliot Lee committed
102

103 104 105

5. Bugs
=======
Elliot Lee's avatar
Elliot Lee committed
106

107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122
Since this is a developers version, we are at the moment not really
interested in receiving too many bug-reports. Some parts of the code
are unfinished and under heavy development and we know that.
Bug-reports for incomplete or missing are features are therefore often
not helpful. Instead of filing a bug you should try to contact the
person who is working on this particular part of the program (see the
ChangeLog) or try to fix it yourself. You should report crashes and
other severe bugs at Bugzilla (http://bugzilla.gnome.org/). Your
bug-report needs to provide detailed instruction of how to reproduce
the problem. For reports on crashes, please also include a stack
trace.

If you experience crashes whenever you try to start gimp-1.3, you are
most probably using gdkxft or another LD_PRELOAD hack designed for
gtk+-1.2. These hacks will not work with GTK+-2.0 applications like
this version of The GIMP.
Sven Neumann's avatar
Sven Neumann committed
123

Elliot Lee's avatar
Elliot Lee committed
124 125 126

Have fun,

Manish Singh's avatar
Manish Singh committed
127 128 129 130
  Spencer Kimball
  Peter Mattis
  Federico Mena
  Manish Singh
Sven Neumann's avatar
Sven Neumann committed
131
  Sven Neumann
132
  Michael Natterer