Go to file
Jehan 81b569cb8c Issue #8124: plug-in localization now totally moved plug-in side.
Plug-in localization was always partially plug-in side, especially for
things like custom GUI. But labels or blurb in GIMP (such as in menus or
action search) were localizing GIMP side.

It had many drawbacks:

- To get menu localization, a plug-in had to set up gettext, even though
  they might want to use something else for their GUI (after all, giving
  facilities for gettext is a good idea, but there is no reason to force
  using this system).
- There was a complex internal system passing the localization domain
  name, as well as the catalog file system path to core, then through
  various classes which we can now get rid of.
- There could be domain name clashes, if 2 plug-ins were to use the same
  i18n domain name. This was handled in now removed functions
  gimp_plug_in_manager_get_locale_domains() by simply keeping a unique
  one (and gimp_plug_in_manager_bind_text_domains() would just bind the
  domain to the kept directory). In other words, one of the duplicate
  plug-ins would use the wrong catalog. We could try to make the whole
  thing more complicated or try to forbid plug-ins to use any random
  name (in particular made easier with the new extension wrapper). But
  anyway this whole issue doesn't happen anymore if localization is
  fully made plug-in side, so why bother?

I tried to evaluate the advantages of the core-side localization of
plug-in labels/blurbs and could only find one theoretical: if we wanted
to keep access to the original English text. This could be useful
(theoretically) if we wanted to search (e.g. in the action search) in
both localized and English text; or if we wanted to be able to swap
easily en/l10n text in a UI without reload. But even if we were to ever
do this, it would only be possible for plug-ins (GEGL operations in
particular are localized GEGL-side), so it lacks consistency. And it's
unsure why special-casing English should really make sense for other
language natives who want text in their lang, and search in their lang.
They don't necessarily care about original.

So in the end, I decided to simplify the whole thing, make localization
of plug-ins a plug-in side thing. Core will only receive translated text
and that's it. It cuts a lot of code out of the core, simplify runtime
processing and make plug-in creation simpler to understand.

The only think I still want to look at is how exactly menu paths are
translated right now. Note that it still works, but it's possible that
some things may be worth improving/simplifying on this side too.
2022-07-05 12:22:32 +02:00
.gitlab .gitlab: search common git ancestor with `mr-origin` remote. 2022-01-19 22:22:40 +01:00
app Issue #8124: plug-in localization now totally moved plug-in side. 2022-07-05 12:22:32 +02:00
app-tools Update Makefile.am 2021-04-21 01:35:26 +02:00
build ScriptFu: Add script-fu-interpreter akin to other interpreters 2022-06-30 13:39:45 +00:00
cursors cursors: make the "single dot" cursor actually slightly bigger and B&W. 2022-03-13 16:04:40 +01:00
data po-tips: Fix gettext translation 2022-06-27 15:48:26 +00:00
desktop Migrate from intltool to gettext 2022-06-25 10:25:49 +02:00
devel-docs devel-docs: document how to add interpreter and .interp file 2022-06-26 10:37:12 -04:00
docs app, docs: fix GIMP's version in --dump-gimprc-manpage and update… 2021-10-21 22:10:31 +02:00
etc docs, etc: regenerate the default gimprc and its manpage. 2021-10-13 00:51:03 +02:00
extensions extensions: fix builds after MR !653 (migrating to gettext). 2022-06-25 12:41:21 +02:00
icons themes: Issue #2000. Make Color theme H/V chain icons... 2022-03-21 23:17:35 +06:00
libgimp Issue #8124: plug-in localization now totally moved plug-in side. 2022-07-05 12:22:32 +02:00
libgimpbase libgimpbase: fix crash caused by the previous commit 2022-06-02 17:45:13 -04:00
libgimpcolor core: Add softproof profile to GimpImage 2022-07-02 15:26:19 +02:00
libgimpconfig libgimpconfig: fix small typo. 2022-03-04 16:09:09 +01:00
libgimpmath libgimpmath: Fix some vector gi-docgen annotations 2021-12-28 23:54:31 +01:00
libgimpmodule docs: Migrate some gtk-doc comments to gi-docgen 2021-12-29 11:21:19 +01:00
libgimpthumb libgimp*, plug-ins: fix some warnings 2021-05-24 20:36:31 +00:00
libgimpwidgets core: Add softproof profile to GimpImage 2022-07-02 15:26:19 +02:00
m4macros Migrate from intltool to gettext 2022-06-25 10:25:49 +02:00
menus core: Add softproof profile to GimpImage 2022-07-02 15:26:19 +02:00
modules core: Add softproof profile to GimpImage 2022-07-02 15:26:19 +02:00
pdb Issue #8124: plug-in localization now totally moved plug-in side. 2022-07-05 12:22:32 +02:00
plug-ins ScriptFu: Extract informal class SFArg from script-fu-script.c 2022-07-04 08:28:19 +00:00
po Update Spanish translation 2022-07-03 12:46:08 +00:00
po-libgimp Migrate from intltool to gettext 2022-06-25 10:25:49 +02:00
po-plug-ins Update Spanish translation 2022-07-01 12:12:03 +00:00
po-python Update Spanish translation 2022-07-01 11:41:59 +00:00
po-script-fu po-script-fu: skip test files from translated sources. 2022-07-01 21:33:36 +02:00
po-tags Migrate from intltool to gettext 2022-06-25 10:25:49 +02:00
po-tips Update Spanish translation 2022-07-01 11:48:06 +00:00
po-windows-installer Update Spanish translation 2022-07-01 12:28:43 +00:00
themes libgimpwidgets, themes: more compact GimpSpinScale. 2022-02-17 23:13:42 +01:00
tools configure, tools: colorsvg2png must be built as native build executable. 2022-04-01 18:11:55 +02:00
.clang-format clang-format: update. 2022-03-14 18:16:14 +01:00
.dir-locals.el .dir-locals.el: configure emacs to show trailing whitespace 2016-08-24 17:46:57 +02:00
.gitignore Migrate from intltool to gettext 2022-06-25 10:25:49 +02:00
.gitlab-ci.yml Migrate from intltool to gettext 2022-06-25 10:25:49 +02:00
.kateconfig Add .kateconfig with modelines for Kate 2016-08-23 14:53:38 +02:00
AUTHORS AUTHORS: update. 2022-02-25 21:06:17 +01:00
COPYING Change a bazillion URLs to https:// 2018-07-14 14:19:27 +02:00
ChangeLog.pre-1-0
ChangeLog.pre-1-2 converted to utf-8 2004-05-10 17:45:17 +00:00
ChangeLog.pre-2-0 vte sucks 2004-05-20 02:36:11 +00:00
ChangeLog.pre-2-2 Copied current ChangeLog away and truncated it. 2004-12-19 02:55:34 +00:00
ChangeLog.pre-2-4 renamed the pre-2.4 ChangeLog 2007-10-23 23:36:17 +00:00
ChangeLog.pre-2-6 Applied changes based on official version of TinyScheme (CVS commit dated 2009-08-04 14:23:55 -04:00
ChangeLog.pre-git Applied changes based on official version of TinyScheme (CVS commit dated 2009-08-04 14:23:55 -04:00
INSTALL.in Migrate from intltool to gettext 2022-06-25 10:25:49 +02:00
LICENSE icons: add COPYING files for icon themes. 2022-02-09 16:31:22 +01:00
MAINTAINERS MAINTAINERS: update. 2021-04-04 16:01:48 +02:00
Makefile.am devel-docs: move HACKING from root EXTRA_DIR to devel-docs one. 2022-02-08 23:45:22 +01:00
NEWS NEWS: update. 2022-07-02 17:50:34 +02: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-8: new file preserving the history that lead to 2.8 2015-11-22 17:30:15 +01:00
NEWS.pre-2-10 Misc. typos 2018-10-19 15:30:27 +00:00
README README, devel-docs: reorganize a bit the main README and devel docs. 2022-02-07 15:45:28 +01:00
README.i18n Change a bazillion URLs to https:// 2018-07-14 14:19:27 +02:00
acinclude.m4 Allow building vala plugins 2020-05-26 17:52:52 +00:00
authors.dtd authors.dtd: Update 2011-01-28 07:55:55 +01:00
authors.xml authors.xml: update. 2022-02-19 16:02:48 +01:00
authors.xsl Also put maintainers separately in AUTHORS 2011-01-27 22:04:05 +01:00
authors4gimp-web.xsl Bug 734981 - Update maintainers and authors. 2017-10-23 23:55:22 +02:00
autogen.sh Migrate from intltool to gettext 2022-06-25 10:25:49 +02:00
config.h.win32 updated msvc build add ENABLE_TOOLBOX_MENU, it should only vanish on Mac 2007-10-27 12:41:43 +00:00
configure.ac ScriptFu: Add script-fu-interpreter akin to other interpreters 2022-06-30 13:39:45 +00:00
gimp-zip.in Drop the timestamp from the zip file names. Add the .pc files to the 2007-11-13 09:54:59 +00:00
gimp.doap gimp.doap: adding myself as maintainer in the doap file. 2021-03-28 23:46:04 +02:00
gimp.pc.in configure, gimp.pc: do no hardcode the major.minor version of GEGL. 2018-04-28 01:30:19 +02:00
gimpthumb.pc.in use GCheckSum instead of the MD5 routine from libgimpmath. 2008-03-28 16:47:38 +00:00
gimpui.pc.in Require gtk+-3.0 in gimpui-3.0.pc 2018-05-25 21:55:45 +02:00
meson.build Migrate from intltool to gettext 2022-06-25 10:25:49 +02:00
meson.make meson.make: Don't use backend-specific calls 2021-09-30 16:13:35 +02:00
meson_dist_script.sh meson: Fix dist script 2022-03-18 16:05:58 +00:00
meson_options.txt meson: rename -Dvec-icons to -Dvector-icons. 2022-01-26 02:55:27 +01:00

README

                   ------------------------------
                   GNU Image Manipulation Program
                      2.99 Development Branch
                   ------------------------------

This is an unstable development release, an intermediate state on the
way to the next stable release: GIMP 3. GIMP 2.99 may or may not do what
you expect. Save your work early and often. If you want a stable
version, please use GIMP 2.10 instead.

If you think you found a bug in this version, please make sure that it
hasn't been reported earlier and that it is not just new stuff that is
still being worked on and obviously not quite finished yet.

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.

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

The latest version of GIMP can be found at:

	https://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://www.gimp.org/mail_lists.html

Links to several archives of the mailing lists are included in that page.

Gimp-user-list is a mailing list dedicated to user problems, hints and
tips, discussion of cool effects, etc.  Gimp-developer-list is oriented
to GIMP core and plug-in developers.  Gimp-gui-list is for discussing
about GIMP interface to improve user experience. Most people will only
want to be subscribed to gimp-user-list. If you want to help develop
GIMP, the gimp-developer mailing list is a good starting point; if you
want to help with GUI design, the gimp-gui list is where you want to
subscribe.


3. IRC
======

And finally, for the real junkies, there is an IRC channel devoted to
GIMP. On GIMPNet (a private free software oriented network) there is
#gimp.  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


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/2.99/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/2.99/menurc`.


Have fun,

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