No description
Find a file
Jehan d636e72530 docs: improve man page.
- Add missing options in the top usage line.
- Add a usage line for gimp-console too, since this same man is used for
  both binaries! I only removed -i / --no-interface from the
  gimp-console usage.
- Reuse the top paragraph of the AppStream description as the top
  paragraph of the man description. This is basically our current
  "project vision". I've hesitated rewriting some of the rest in the
  description, or reusing more from the AppStream file, but I'm not sure
  if package metadata's and CLI man page's descriptions should really be
  alike. Also such rewording may be better discussed with others from
  the team first.
- Add descriptions for missing options: --quit, --show-playground,
  --show-debug-menu and --g-fatal-warnings.
- Add descriptions for environment variables XDG_CONFIG_HOME,
  GIMP_DEBUG_FONTS and GIMP_BATCH_INTERPRETER. I didn't list on purpose
  a bunch of other environment variables when they are clearly meant to
  be for internal use (testing, developer use, etc.).
- Made clear that GIMP3_DIRECTORY is legacy and should not be used if
  possible, in favor of XDG_CONFIG_HOME. In particular, config file
  format migration won't work across updates with GIMP3_DIRECTORY as we
  don't control anymore the relative path format.
- Latest GTK libs are not shipped on our download server anymore.
2025-12-16 17:00:02 +01:00
.gitlab .gitlab: let's ban AI-generated reports. 2025-11-10 14:47:23 +01:00
.vscode Add .vscode/settings.json compliant with Coding Style 2024-01-19 16:06:06 -03:00
app Issue #15501: g_close failed with EBADF. This is not a valid file descriptor. 2025-12-16 15:22:16 +01:00
app-tools app, app-tools: Fix WinMain definition on some executables 2025-11-29 18:19:07 -03:00
build build/windows: Fix ForegroundColor 2025-12-14 22:30:00 -03:00
data app, build, plug-ins: Run interpreters conditionally on Windows console 2025-11-09 15:56:32 -03:00
desktop desktop: we'll release on Sunday. 2025-12-14 02:33:27 +01:00
devel-docs devel-docs: Use API version not app version for install location 2025-12-15 11:05:23 +00:00
docs docs: improve man page. 2025-12-16 17:00:02 +01:00
etc app, etc: do not hide --show-debug-menu. 2025-12-13 00:10:57 +01:00
extensions build, extensions, plug-ins: Add support to MSVC's resource compiler too 2025-11-29 18:18:57 -03:00
gimp-data@f97ac6e455 gimp-data: update. 2025-12-16 00:28:41 +01:00
libgimp libgimpwidgets: make GimpBrowser emit "stop-search" signal 2025-12-07 19:46:03 +01:00
libgimpbase Issue #13991: Show real GIMP3_DIRECTORY on MSIX 2025-12-10 17:29:53 -03:00
libgimpcolor libgimpcolor: add some note to gimp_color_is_perceptually_identical() docs. 2025-11-21 19:33:09 +01:00
libgimpconfig libgimpconfig: better error message when a GObject property tries to… 2025-10-24 02:24:53 +02:00
libgimpmath Revert "libgimpmath: #pragma once" 2025-08-14 00:54:50 +02:00
libgimpmodule Declare gexiv2 dependency on many targets (due to gimpmetadata.h) 2025-10-03 18:31:53 -03:00
libgimpthumb Declare gexiv2 dependency on many targets (due to gimpmetadata.h) 2025-10-03 18:31:53 -03:00
libgimpwidgets libgimpwidgets: make GimpBrowser emit "stop-search" signal 2025-12-07 19:46:03 +01:00
menus tools: implement restore option for on-canvas text editor ... 2025-10-31 15:39:10 +01:00
modules app, modules: Resolve unused Windows variable warnings 2025-10-12 14:06:04 +00:00
pdb app, pdb: initialize the "config" object for custom GIMP operations. 2025-12-10 01:05:16 +01:00
plug-ins libgimpwidgets: make GimpBrowser emit "stop-search" signal 2025-12-07 19:46:03 +01:00
po Updated Greek translation 2025-12-11 14:53:52 +02:00
po-libgimp Update Thai translation 2025-12-07 14:41:07 +00:00
po-plug-ins Updated Greek translation 2025-12-12 14:48:59 +02:00
po-python Update Turkish translation 2025-11-29 15:29:45 +00:00
po-script-fu Update Turkish translation 2025-11-29 15:29:16 +00:00
po-tags Update Chinese (Taiwan) translation 2024-08-20 13:23:23 +00:00
po-tips Update Chinese (China) translation 2025-09-23 00:31:05 +00:00
po-windows-installer po-windows-installer: fix building the pot file. 2025-09-23 12:13:48 +02:00
themes themes: reimplementing previous reverted commit as CSS. 2025-12-04 20:08:09 +01:00
tools tools: remove generate_changelog.sh. 2025-12-15 13:17:28 +01:00
.clang-format clang-format: uncomment rule not usable yet. 2025-04-30 23:36:15 +02:00
.dir-locals.el .dir-locals.el: configure emacs to show trailing whitespace 2016-08-24 17:46:57 +02:00
.gitlab-ci.yml gitlab-ci: fix dev-docs job. 2025-12-16 00:46:46 +01:00
.gitmodules .gitmodules: Specify gimp-data branch as 'main' 2025-10-06 13:49:22 -03:00
.kateconfig
AUTHORS AUTHORS: update. 2025-08-14 01:15:04 +02:00
authors.dtd
authors.xml authors: update list. 2025-12-16 12:42:16 +01:00
authors.xsl
authors4gimp-web.xsl authors4gimp-web: "artist" section clearly also contains splash artists. 2025-12-16 12:43:28 +01:00
ChangeLog.pre-1-0
ChangeLog.pre-1-2
ChangeLog.pre-2-0
ChangeLog.pre-2-2
ChangeLog.pre-2-4
ChangeLog.pre-2-6
ChangeLog.pre-git
COPYING Change a bazillion URLs to https:// 2018-07-14 14:19:27 +02:00
gimp.doap DOAP: Replace defunct mailing list 2023-12-13 10:16:27 +03:00
INSTALL.in INSTALL: add some notes about setting up the build for localization. 2025-11-23 18:25:48 +01:00
LICENSE LICENSE: add a note about data/ licensing for future added data. 2023-03-16 23:20:44 +01:00
MAINTAINERS MAINTAINERS: update. 2021-04-04 16:01:48 +02:00
meson.build tools: remove generate_changelog.sh. 2025-12-15 13:17:28 +01:00
meson_dist_script.py meson: Port meson_dist_script.sh to Python 2025-04-17 11:18:30 -03:00
meson_options.txt libgimp: Output CLI messages to the parent console like Linux and macOS 2025-10-31 17:28:22 -03:00
NEWS NEWS: start the next section (still named RC3 for now, but we'll see…). 2025-12-16 00:56:25 +01:00
NEWS.pre-2-0 Misc. typos 2018-10-19 15:30:27 +00:00
NEWS.pre-2-2 Misc. typos 2018-10-19 15:30:27 +00:00
NEWS.pre-2-4 Misc. typos 2018-10-19 15:30:27 +00:00
NEWS.pre-2-6 Misc. typos 2018-10-19 15:30:27 +00:00
NEWS.pre-2-8
NEWS.pre-2-10 Misc. typos 2018-10-19 15:30:27 +00:00
NEWS.pre-3-0 NEWS: move to NEWS.pre-3-0 and prepare for the new stable series. 2025-03-17 23:43:19 +01:00
README README: small fixes. 2025-11-15 11:18:24 +01:00
README.i18n desktop: change gimp20 to gimp30 for gettext 2024-08-29 09:09:29 +00:00

                   ------------------------------
                   GNU Image Manipulation Program
                       3.2 Release Candidate
                   ------------------------------

This is a release candidate for upcoming version 3.2.0 of GIMP.
This is not considered stable yet, unless testing tells us it is.
Therefore save your work early and often. If you want a stable
version, please use GIMP 3.0 instead.

If you think you found a bug in this version, please make sure that it
hasn't been reported earlier and report it! We are at the verge of
releasing the next minor version of GIMP, so any report helps.

If you want to hack on GIMP, please read the file devel-docs/README.md.
For detailed installation instructions, see the file INSTALL.


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

GIMP's home page is at:

	https://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 latest version of GIMP can be found at:

	https://www.gimp.org/downloads/

We also have a website dedicated to documentation at:

        https://docs.gimp.org/


2. Contributing
===============

GIMP source code can be found at:

	https://gitlab.gnome.org/GNOME/gimp/

Resources for contributors:

        https://developer.gimp.org/

In particular, you may want to look in the "Core Development" section. Some
articles of particular interest for newcomers could be:

* Setting up your developer environment: https://developer.gimp.org/core/setup/
* GIMP Coding Style: https://developer.gimp.org/core/coding_style/
* Submit your first patch: https://developer.gimp.org/core/submit-patch/


3. Discussion Channels
======================

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

        https://www.gimp.org/discuss.html

For the real junkies, there are IRC channels (e.g. #gimp or #gimp-user)
devoted to GIMP on GIMPNet (a private free software oriented network).
Many of the developers hang out there. Some of the GIMPNet servers are:

	irc.gimp.org:6667
	irc.us.gimp.org:6667
	irc.eu.gimp.org:6667

More discussion channels, such as forums, will be listed on the above
"discuss" page when they are moderated by a team member.
Links to archives of former discussion methods (e.g. mailing lists) are
also included in that page.

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

The look of GIMP's interface can be customized like any other GTK app
by editing files in `${XDG_CONFIG_HOME}/gtk-3.0/` (settings.ini and
gtk.css in particular) or by using "themes" (ready-made customizations).
Additionally, GIMP reads `${XDG_CONFIG_HOME}/GIMP/3.2/gimp.css` so you
can have settings that only apply to GIMP.

You can also manually change the keybindings to any of your choice by
editing: `${XDG_CONFIG_HOME}/GIMP/3.2/shortcutsrc`.


Have fun,

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