Go to file
Michael Natterer 894cf70dd5 Added infrastructure to make sure we don't write to the global brush,
2004-01-28  Michael Natterer  <mitch@gimp.org>

	Added infrastructure to make sure we don't write to the global
	brush, pattern etc. directories. Needed to make this configurable
	because we can't rely on the global directories being read-only,
	having certain names or being otherwise detectable at runtime in a
	sane way. Fixes bug #132214.

	* libgimpbase/gimpdatafiles.[ch]: added "const gchar *dirname" to
	the GimpDataFileData struct so callbacks don't need to call
	g_path_get_dirname() for each file.

	* libgimpwidgets/gimpfileentry.c: made it work with non UTF-8
	encoded filenames.

	* libgimpwidgets/gimppatheditor.[ch]: ditto. Added GUI and API for
	setting/getting a second "writable_path". The widget makes sure
	that the writable_path is always a subset of the path.

	* app/config/gimpconfig-utils.[ch]: added new function
	gimp_config_build_writable_path().

	* app/config/gimpcoreconfig.[ch]: added separate properties for
	the writable brush, pattern, gradient, palette and font paths.

	* app/config/gimprc-blurbs.h: added (still empty) blurbs for the
	new properties.

	* app/core/gimpdata.[ch] (gimp_data_set_filename): added parameter
	"gboolean writable". Set data->writable to FALSE by default. If
	"writable" is passed as TRUE, still check if we can write to the
	file before setting data->writable to TRUE.

	(gimp_data_create_filename): changed "data_path" parameter to
	"dest_dir" and assume dest_dir is writable.

	(gimp_data_duplicate): set data->dirty to TRUE to make sure
	duplicated things will be saved.

	* app/core/gimpbrush.c
	* app/core/gimpbrushgenerated.c
	* app/core/gimpbrushpipe.c
	* app/core/gimpgradient.c
	* app/core/gimppalette.c
	* app/core/gimppattern.c: don't set the data's filename and don't
	touch data->dirty in the _load() functions because that's done by
	the data factory now. Don't touch data->dirty in the _duplicate()
	functions because that's done by gimp_data_duplicate() itself now.

	* app/core/gimpdatafactory.[ch] (gimp_data_factory_new): added
	"writable_property_name" and remember it.
	Added utility function gimp_data_factory_get_save_dir() which
	determines the directory to save new datas to.
	Added public function gimp_data_factory_data_save_single() which
	saves a single data object.
	Make sure new things get saved to the first writable directory
	as specified in preferences.

	* app/core/gimp.c (gimp_real_initialize): pass the writable_paths'
	property names to gimp_data_factory_new().

	* app/widgets/gimpdataeditor.c (gimp_data_editor_save_dirty): use
	gimp_data_factory_data_save_single() instead of implementing
	saving here.

	* app/widgets/gimppropwidgets.[ch] (gimp_prop_path_editor_new):
	added "const gchar *writable_property_name" parameter (can be
	NULL).

	Added the needed callbacks to handle the writable_path and made
	the path_editor and file_entry code aware of non UTF-8 filename
	encodings. Some general cleanup.

	* app/gui/preferences-dialog.c: changed accordingly.
2004-01-28 21:53:50 +00:00
app Added infrastructure to make sure we don't write to the global brush, 2004-01-28 21:53:50 +00:00
cursors cursors/dropper.xbm moved the dropper cursor some pixels to the bottom 2003-11-04 10:18:13 +00:00
data add m4_defines for gimp_unstable and gimp_full_name, and define a 2004-01-27 03:45:01 +00:00
devel-docs libgimpwidgets/libgimpwidgets-sections.txt added the new icons. 2004-01-27 15:31:33 +00:00
docs modernized, made a lot of things m4 macros, and made versioning a lot more 2004-01-22 03:51:46 +00:00
etc Made 2.0pre2 release. 2004-01-19 03:59:04 +00:00
libgimp app/app_procs.c app/errors.c app/main.c app/config/gimpconfigwriter.c 2004-01-23 17:24:44 +00:00
libgimpbase Added infrastructure to make sure we don't write to the global brush, 2004-01-28 21:53:50 +00:00
libgimpcolor modernized, made a lot of things m4 macros, and made versioning a lot more 2004-01-22 03:51:46 +00:00
libgimpconfig Added infrastructure to make sure we don't write to the global brush, 2004-01-28 21:53:50 +00:00
libgimpmath modernized, made a lot of things m4 macros, and made versioning a lot more 2004-01-22 03:51:46 +00:00
libgimpmodule app/app_procs.c app/errors.c app/main.c app/config/gimpconfigwriter.c 2004-01-23 17:24:44 +00:00
libgimpthumb modernized, made a lot of things m4 macros, and made versioning a lot more 2004-01-22 03:51:46 +00:00
libgimpwidgets Added infrastructure to make sure we don't write to the global brush, 2004-01-28 21:53:50 +00:00
m4macros quote AM_PATH_GIMP_2_O properly so automake 1.8 won't whine at us. 2004-01-22 04:27:15 +00:00
modules modernized, made a lot of things m4 macros, and made versioning a lot more 2004-01-22 03:51:46 +00:00
plug-ins Removed duplicate TIFF entry from save dialog, and made the save handler 2004-01-28 12:30:00 +00:00
po Updated Spanish translation. 2004-01-27 19:12:46 +00:00
po-libgimp Updated Danish translation. 2004-01-22 17:51:09 +00:00
po-plug-ins Updated Spanish translation. 2004-01-27 19:13:07 +00:00
po-script-fu Updated Spanish translation. 2004-01-27 19:13:25 +00:00
regexrepl [ I've postponed my reservations against pangoft2/fontconfig/freetype2 2003-12-13 01:35:19 +00:00
themes themes/Default/images/stock-channel-indexed-16.png 2004-01-27 16:52:50 +00:00
tips Updated Spanish translation. 2004-01-27 19:13:33 +00:00
tools removed gimp_image_owns_item() again. 2004-01-26 16:18:16 +00:00
.cvsignore bumped version number to 1.3.25, interface_age 1, binary age 1. 2004-01-09 00:09:51 +00:00
AUTHORS Fixed/Added some UTF-8 encoded names. Please speak up if I did mess up 2003-10-25 23:39:51 +00:00
COPYING *** empty log message *** 1999-11-17 21:13:50 +00:00
ChangeLog Added infrastructure to make sure we don't write to the global brush, 2004-01-28 21:53:50 +00:00
ChangeLog.pre-1-0 changelog split up 1998-06-07 13:54:00 +00:00
ChangeLog.pre-1-2 roll changelog for 1.2 2000-12-25 22:09:39 +00:00
HACKING don't update the fields here... 2004-01-25 13:53:23 +00:00
INSTALL set GIMP_VERSION to 2.0pre1. 2004-01-07 00:43:53 +00:00
LICENSE cosmetics. 2003-08-15 10:41:31 +00:00
MAINTAINERS Cursor keys now move the currently active anchors, SHIFT and CTRL increase 2003-09-18 00:42:26 +00:00
Makefile.am modernized, made a lot of things m4 macros, and made versioning a lot more 2004-01-22 03:51:46 +00:00
NEWS Correct typo. 2004-01-28 16:12:27 +00:00
PLUGIN_MAINTAINERS Entered Jens Christian Restemeier as maintainer as wished. 2001-01-17 20:29:42 +00:00
README set GIMP_VERSION to 2.0pre1. 2004-01-07 00:43:53 +00:00
README.i18n Makefile.am removed this file. 2003-02-23 16:29:30 +00:00
README.win32 Update. 2003-09-01 00:13:08 +00:00
TODO.xml updated states 2003-02-06 16:09:35 +00:00
acinclude.m4 use AM_PATH_GIMPPRINT to get some additional sanity checks. 2004-01-28 02:35:08 +00:00
autogen.sh prefer automake-1.7 over 1.8 since there are issues with the latter. 2004-01-26 11:24:11 +00:00
config.h.in grr 2002-06-04 19:31:27 +00:00
config.h.win32 Add comment that the file is outdated. 2003-09-10 02:46:31 +00:00
configure.in according to the automake docs, we need to add $(EXEEXT) explicitely for 2004-01-28 15:52:08 +00:00
gimp-2.0.pc.in modernized, made a lot of things m4 macros, and made versioning a lot more 2004-01-22 03:51:46 +00:00
gimp-zip.in use new versioning defines. 2004-01-27 03:58:39 +00:00
gimp.pc.in modernized, made a lot of things m4 macros, and made versioning a lot more 2004-01-22 03:51:46 +00:00
gimp.spec.in Added a depedency for libexif 2004-01-22 15:30:53 +00:00
gimpthumb-2.0.pc.in modernized, made a lot of things m4 macros, and made versioning a lot more 2004-01-22 03:51:46 +00:00
gimpthumb.pc.in modernized, made a lot of things m4 macros, and made versioning a lot more 2004-01-22 03:51:46 +00:00
gimptool-2.0.in build the version number from just like it is done for the pkg-config 2004-01-12 07:48:48 +00:00
gimptool-win32.c.in Use GIMP_APP_VERSION. 2004-01-22 08:34:37 +00:00
gimpui-2.0.pc.in modernized, made a lot of things m4 macros, and made versioning a lot more 2004-01-22 03:51:46 +00:00
gimpui.pc.in modernized, made a lot of things m4 macros, and made versioning a lot more 2004-01-22 03:51:46 +00:00
makefile.msc [ I've postponed my reservations against pangoft2/fontconfig/freetype2 2003-12-13 01:35:19 +00:00

README

The GIMP: The GNU Image Manipulation Program
============================================

This is a pre-release of GIMP version 2.0. Actually it still is GIMP-1.3,
the developers version of The GIMP. But we got pretty close to the final
2.0 release, the plug-in API has settled and you are encouraged to try
this software. Your feedback can help to make the 2.0 release a success.
If you encounter any problems, please report them to our bug-tracker at
bugzilla.gnome.org. There are still a number of known problems, so please
check first if your problem has already been reported.

GIMP-2.0 installs side-by-side with GIMP-1.2 so there's no need to
uninstall GIMP-1.2 (but sooner or later you will not be using it any
longer...).

Some features that were present in GIMP 1.2 are not 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. Sooner or later there will be a gimp-perl
release for GIMP-2.0. GAP, a set of plug-ins that used to live in the
Video submenu has also become a separate package. Expect a preview
release of this software for GIMP-2.0 soon.

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/download/


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>

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.

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 dedicated to users of the Win32 port
"gimpwin-users".  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-1.3/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-1.3/menurc. You can also manually change the keybindings to
any of your choice by editing ~/.gimp-1.3/menurc.


Have fun,

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