Commit graph

117 commits

Author SHA1 Message Date
Jehan
30ced82bf4 Revert "INSTALL: Fix alignment of optional dependencies table"
This mostly reverts commit 987dc52160
(with some conflicts fixed as the file got further touched).

This table was already properly aligned as what matters is the generated
INSTALL file, which is what will end up in our source tarballs. This
file is also published on the developer website. The reverted commit was
completely breaking the formatting. 😅
2026-04-06 17:47:04 +02:00
Bruno Lopes
3e21884883 INSTALL: Remove webkit from optional dependencies list
It is already listed on the unmaintained dependencies
2026-04-02 11:00:51 -03:00
Bruno Lopes
987dc52160 INSTALL: Fix alignment of optional dependencies table 2026-04-02 10:59:45 -03:00
Bruno Lopes
2637492ef1 INSTALL: Mention requirement of GObject Introspection for Gexiv2 2026-04-02 10:53:21 -03:00
Jehan
daff399b4d meson, INSTALL: also document the required version for PyGObject. 2026-03-27 17:39:44 +01:00
Bruno Lopes
c039f82640 INSTALL: List Pycairo on required packages
Closes: https://gitlab.gnome.org/GNOME/gimp/-/issues/16115

Also know as python3-cairo or py-cairo, it is needed
to complete the Cairo override provided by 'gi' module.
See: #13105
2026-03-27 13:22:45 -03:00
Jehan
35dbcacee4 INSTALL: minor fixes. 2026-03-03 18:27:32 +01:00
Jehan
fa62fa72b5 INSTALL: add bash-completion in optional packages list.
(cherry picked from commit d09747589d)
2026-01-23 23:47:29 +01:00
Jehan
3136cbee38 INSTALL: add some notes about setting up the build for localization.
Since this is now a build breaker (on purpose), let's add some notes on
how to properly set your build system so that our list of GUI languages
are self-localized as we want them. I am guessing that if we don't add
this info, we may soon get reports by various distributions' packagers
about our build being broken.

This explains so much why I was regularly seeing screenshots of packaged
GIMP with a list of languages in English, in forums or tracker. Unlike
desktop machines, I am guessing that most build servers are just set as
C or POSIX locale and that would just break our pre-localization build
script.
2025-11-23 18:25:48 +01:00
Jehan
1ce91e9508 INSTALL: tweak a bit the instructions. 2025-11-22 17:05:14 +01:00
Jehan
4a648b6639 meson, INSTALL: add some note about max version for GEXiv2 in INSTALL. 2025-11-19 16:02:39 +01:00
luzpaz
91418131a0 app, libgimp*, pdb, themes: Fix description typos
This patch fixes minor typos in user-facing descriptions
and internal comments found by Codespell.
2025-09-24 16:50:15 +00:00
Joey Riches
8277817b62 app: Port from appstream-glib to appstream
From the horse's mouth:
"WARNING: appstream-glib is heavy maintenance mode, use appstream
instead"

Additionally, appstream-glib no longer conforms fully to the
appstream specification.

Some care is taken to taken to support both libappstream 1.0 as well
as libappstream 0.16.x to support stable distros.
2025-08-04 18:56:42 +00:00
Jehan
f4bdd69f73 meson, build, INSTALL: we now use mypaint-brushes-2.0 for all Windows platform.
Thanks to lazka and the whole MSYS2 project for adding this package to
their repository so that we don't need ugly special-casing anymore.

See: e515fe48bc
2025-07-25 01:19:12 +02:00
Jehan
619b321141 INSTALL: remove mentions of needing to install mypaint-brushes v1. 2025-07-23 19:18:34 +02:00
Bruno Lopes
1de46ae757
gitlab-ci, INSTALL: Install flex and bison for .map support on AppImage
See: #14145
2025-06-28 12:54:16 -03:00
Jehan
c6c00ddccc INSTALL: update.
This text should also be a bit more robust to future (more frequent now)
minor version bumps.
2025-06-15 17:43:59 +02:00
Jehan
23d4c6fda9 INSTALL: more info about HEIF support.
It looks like packagers have regular issues with this support. Also I
added info about the fact we also support JPEG2000-in-HEIF (HEJ2) now.
And I made clearer that there may be other encoders/decoders possible
for a given format (though for AV1, we have a clear AOM preference in
our code).

Finally I add info about an environment variable which may be useful
probably in cases when the run prefix differs from the build prefix.
Cf. a case which was recently happening in the Snap package.
See: https://github.com/snapcrafters/gimp/issues/390
2025-04-11 11:25:05 +02:00
Jehan
50a248d54e INSTALL, meson: update a bit installation docs. 2025-01-27 22:10:35 +01:00
Jehan
26a079bd57 devel-docs: get rid of g-ir-doc.
Per the (quite off-topic) discussion in #12772, the fact it's quite
broken on Windows, apparently not too maintained anymore and its syntax
clashes with gi-docgen syntax…
2025-01-23 13:07:03 +01:00
Jehan
a1e346b3a3 Issue #12671: 'libarchive' dependency is undeclared on INSTALL file. 2025-01-07 19:27:59 +01:00
Jehan
5b07268c24 Issue 12672: 'json-glib' is undeclared in INSTALL file. 2025-01-07 19:24:55 +01:00
Daniele Forsi
994137a82e Fix spelling errors found with codespell 2025-01-04 15:11:03 +00:00
Jehan
2076541011 INSTALL: update.
* Don't mention 2.99 anymore.
* GIMP_PKGCONFIG_VERSION was actually the version of libgimp regarding
  our .pc file, not our pkg-config requirement (per the commit removing
  autotools scripts). Now it looks like our pkg-config minimum
  requirement used to be version 0.16, but I didn't add this check back.
  Let's assume just saying "a recent version" in the INSTALL file is
  enough, without hard-check in meson.
* Simplify the end part about failed configuration or optional features,
  with a link to our build tutorial online instead of getting into
  details and advices to set LDFLAGS or CPPFLAGS (which to be fair, am
  not sure are very good advices at all in fact!).
* Fix a few more details.
2024-10-29 13:01:07 +01:00
Jehan
78665ca372 extensions: the lua binding (and its example plug-in) is now marked as experimental.
We have too many issues with the lua binding, so until someone finds a
solution, mark it officially as experimental.

See discussion in: https://gitlab.gnome.org/GNOME/gimp/-/issues/11895#note_2225885
2024-09-18 22:54:02 +02:00
Jehan
57f52ebf9a INSTALL: Python and PyGObject are mandatory dependencies now.
There are needed at build time because we run various Python scripts
through GIMP, and we made the Python 3 plug-ins non-optional now.

Thanks to Bruno for noticing this needed to be updated in INSTALL.
2024-08-19 11:39:27 +02:00
Jehan
d38362c9a0 meson, INSTALL: update optional packages list. 2024-08-17 21:16:00 +02:00
Bruno
7c64f26caa build/windows, meson: Complete 93cc81281c 2024-08-10 00:59:53 +00:00
Bruno
7037297526 meson: Prevent broken lua plug-ins
See: https://gitlab.gnome.org/GNOME/gimp/-/issues/11876

For 3.0 we will support only Lua 5.1, since we need to figure out how
much of the Lua 5.1 API is compatible with newer versions (Lua minor
versions aren't like Python minor versions, there is API breakage so
plug-ins would be completely unreliable, this commit prevent this).

Also, change some files to not force luajit since it isn't mandatory.
2024-08-09 12:26:26 +00:00
Jehan
25701f6c1b Issue #11760: explain why poppler-data is a hard dependency. 2024-07-04 21:50:11 +02:00
Jehan
4e274be6f3 Update INSTALL file and gimp-data submodule. 2024-03-28 00:19:10 +01:00
Jehan
bd9eb1d8ff meson: requires Pango >= 1.50.
New code uses pango_attribute_as_font_desc() which appeared with Pango 1.50.
Since it's currently present in Debian stable, I don't bother too much and bump
this dependency.

Also let's use the same version for pango, pangocairo and pangoft2. They all
come from the same project/repository, so we must likely expect them to be equal
(if they are not, there is likely a problem).
2023-09-12 14:23:40 +00:00
Jacob Boerema
18408ce966 app, libgimp, libgimpwidgets, plug-ins, etc: rename behaviour to behavior
We use US English which uses behavior. So we replace all occurrences of
behaviour.

Most notable is File Open behavior in preferences. Besides that several
mentions in function documentation and a few in comments.
2023-07-21 15:35:23 -04:00
Jehan
760e912d20 INSTALL: add some packages in the optional packages list. 2023-07-09 13:32:51 +02:00
Jehan
ebe63c215f INSTALL, meson: remove references to autotools and warning. 2023-05-27 00:33:17 +02:00
Jehan
6a2908ed0b Issue #9151: link to the "Building GIMP" page of dev website in INSTALL. 2023-02-15 12:13:24 +01:00
Jehan
caebbe4603 INSTALL: fixing copy-paste bugs.
Thanks to Tobias (@Tobias on Gitlab) for noticing.
2022-08-09 11:49:56 +02:00
Jehan
e7faae1dc3 INSTALL: update the build instructions to target meson.
If we want to encourage meson usage in GIMP 2.99.12 as a test run, our
INSTALL file should target meson commands and options.

Also I took the opportunity fix a bit some parts which were outdated.
2022-08-08 19:19:21 +02:00
Anders Jonsson
e601a6c7de Change GTK+ to GTK
GTK got rid of the + in 2019:
https://lwn.net/Articles/779305/
2022-07-07 14:02:36 +00:00
Niels De Graef
f663d26ab5 Migrate from intltool to gettext
intltool has long been dead upstream. Let's not poke the dead corpse,
please.

This commit is quite large, but that's mostly since trying to support a
hybrid of both gettext and intltool with both Meson and Autotools was
really hard, so I stopped trying.

Due to gettext relying on quite some things being at the exactly right
place in the autotools build (like `ABOUT-NLS` and `config.rpath`) we
really needed to cleanup the `autogen.sh` to only call `aclocal` and
`autoreconf`. No more strange magic; I tried to do it without changing
too much in the file, and things just broke. If people want to do
something more custom, they can just change the script directly. This
change also uncovered some problems in our `configure.ac`, like using
deprecated macros.

The following major changes happened:

* meson: Changed `custom_target()` to `i18n.merge_file()` for all
  supported file types
* Added `.its` and `.loc`  files for the GIMP-specific XML formats, so
  that gettext understands them
* For the `.isl` (Window installer stuff) file, there's no easy way to
  do this in gettext, so instead we start from an XML file (again with
  its own ITS rules etc), translate that with gettext, and then use
  `xsltproc` with a bit of magic to output the .isl file for each
  language
* the `po*/Makefile.in.in` files are migrated to `Makevars` files,
  which gettext natively understands.

Fixes: https://gitlab.gnome.org/GNOME/gimp/-/issues/8028
2022-06-25 10:25:49 +02:00
Jehan
1ccdf467fb INSTALL, NEWS: the macOS build is now officially using meson too.
See MR gimp-macos-build!97.
2022-04-17 15:06:16 +02:00
Jehan
588d11dc5c INSTALL: update with new recommendation of meson for Windows. 2022-04-01 18:11:55 +02:00
Jehan
83434f7223 Issue #8005: GIMP depends on gvfs, but it is not listed in INSTALL.in.
It's not a direct dependency and doesn't prevent GIMP from any of its
core logics, but HTTP is a used enough format nowadays that we want to
consider it as mandatory nowadays.

From what I know, `gvfs` might be for Windows only though. This would
explain issues we have with remote URL on other platforms.
2022-03-24 23:49:06 +01:00
Jehan
871796a126 Issue #7956: Add full BigTiff open/export support to GIMP.
Recent libtiff supports loading BigTiff automatically so we didn't have
anything to do there (as long as a recent libtiff was used). For
creating a BigTIFF though, we simply needed to add a "8" flag to
TIFFOpen/TIFFClientOpen when creating a new image (i.e. using "w8"
mode) as explained here in the "Implementation Strategy" section:
http://www.simplesystems.org/libtiff/BigTIFFProposal.html

What this commit does:

- Explicitly bump our libtiff requirement to version 4.0.0 or higher
  (which is where BigTiff support appeared).
  libtiff 4.0.0 was apparently released on 2011-12-22 and is available
  on all current distributions, so it's probably not a problem.
- Switch to detect libtiff with a pkg-config test (added in libtiff
  commit faf5f3eb before 4.0.0 release, so it's fine) instead of
  function checks.
  (Note: meson was already detecting for libtiff-4 with pkg-config,
  which was obviously wrong since it should have mimicked autotools, but
  well… then changes were minimal on meson)
- Add a new "bigtiff" boolean argument to the "file-tiff-save" PDB
  procedure, FALSE by default. I set this as the first argument as I
  figure that choosing the format you want is quite a major choice.
  Unless I misunderstood something, since BigTIFF is really designed to
  be an evolution of TIFF with a "minimum change strategy", i.e. mostly
  using 64-bit instead of 32-bit offsets, everything which is possible
  in TIFF will be in BigTIFF (and oppositely as well, except of course
  having huge files) so there is no need to have 2 separate procedures.
- Adding this new argument to the GUI dialog as a checkbox.
- Tweak the load and export procedures' documentation strings to make
  clear we support both TIFF and BigTIFF.
  Note: interestingly there doesn't seem to be a separate mimetype for
  BigTIFF so nothing to update on this side.
- Tweak the procedure labels too to mention BigTIFF. Since BigTIFF is
  still a different format (though very closely resembling) from TIFF,
  unlike some others which are just extensions embedded in a TIFF file
  (like GeoTIFF we recently added), I figure it deserves to be
  explicitly cited.
2022-03-11 11:31:53 +01:00
Jehan
82899764a3 app, INSTALL: remove our Windows-only trick to add user-installed fonts.
This was added in commit 88f97aedef and only expected to last until
fontconfig had a fix **and** it got into a released version.
This is now done.

I could verify in the git repo that fontconfig's commit 55eb1ef is
included since their tagged release 2.13.95 which is now on MSYS2
(2.13.96 there even), so we will use it for our next release.

Thanks to frogonia (long time no see! \O) for following up on this!

See also fontconfig report:
https://gitlab.freedesktop.org/fontconfig/fontconfig/issues/144
2022-02-07 14:24:52 +01:00
Jehan
26f9bcb3b5 INSTALL: explaining a bit more the deal with librsvg.
Rust dependencies are not really making everyone happy apparently. We
don't want to make SVG support optional anymore because it is too
important, and unfortunately there doesn't seem to be any suitable
replacement SVG libs so far (or we haven't found them).

We explain this in the INSTALL file and also explain a bit how to bypass
the SVG parts for packagers really needing to do so, allowing GIMP to be
as portable as possible.

See also issue #6821.
2022-01-31 23:02:33 +01:00
Jehan
a08224f7b3 INSTALL: update the install instructions regarding librsvg.
Currently it's a mandatory option (and it has been the case for years,
ever since commit 43e218859b) so let's update the info.

Note that there are still discussions going on about this dependency and
it being hard or impossible to build on many platforms (which are stuck
on old C version, before the move to Rust). See #6821.
We'll see how it goes.
2022-01-25 01:33:34 +01:00
Jehan
56d6cf6aa1 INSTALL, libgimp: document a bit better the GIR cross-tool exception. 2022-01-06 19:24:32 +01:00
Jehan
bea0618883 INSTALL: add xdg-desktop-portal in the runtime dependencies.
Cf. #1074 for color-picking, as well as the screenshot plug-in.
2022-01-02 19:48:32 +01:00
Jehan
2494a06df5 INSTALL: remove --without-libtiff.
It's not optional anymore, for quite some time now.
Reported in #7450.
2021-10-31 21:06:46 +01:00