callisto-debian/gimp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Issue #3990: make the status of the XCF docs a bit clearer (hopefully).

Browse Source 
Though it may have started as an unofficial document, it is clearly now
an official one (which should be obvious since it is in our source
repository, but apparently some people get misled by the historical
"Status" text to think this to be somehow unofficial).
So first of all, change the s/official/unofficial/ mention.

Secondly, add a small paragraph explicitly telling that the document is
complete (and meant to be), to the best of our knowledge. This document
is a detailed, full and exhaustive written "specification" of the XCF
format up to GIMP 2.10.x (even though the normative spec is still the
code itself). Now we are humans, we may have missed something, and if
so, this is just to be considered as any other bug, and reported to us
nicely to be fixed.

(cherry picked from commit 80e2e0a508)
This commit is contained in:
Jehan
2019-09-27 01:01:31 +02:00
parent 339b80aa15
commit 8a400e304f
1 changed files with 11 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
devel-docs/xcf.txt
View File

@ -20,7 +20,7 @@ License
------- -------
Copyright Henning Makholm <henning@makholm.net>, 2006-07-11 Copyright Henning Makholm <henning@makholm.net>, 2006-07-11
Copyright various GIMP developers (see git log), 2009-2018 Copyright various GIMP developers (see git log), 2009-2019
This is free documentation; you can modify and/or redistribute This is free documentation; you can modify and/or redistribute
it according to the terms of the GNU General Public License it according to the terms of the GNU General Public License
@ -124,16 +124,21 @@ https://web.archive.org/web/20161024115140/http://www.cinepaint.org/more/docs/xc
Status Status
------ ------
This specification is an unofficial condensation and extrapolation of This specification is an official condensation and extrapolation of
the XCF-writing and -reading code in version 2.10.0 of GIMP. Yet we the XCF-writing and -reading code in version 2.10.14 of GIMP, and
remind that the ultimate reference is the loading and saving code of the earlier versions. Yet we remind that the ultimate reference is the
XCF format. loading and saving code of the XCF format.
Some of the normative statements made below are enforced by the XCF Some of the normative statements made below are enforced by the XCF
code in GIMP; others are just the authors' informed guess about code in GIMP; others are just the authors' informed guess about
"best practices" that would be likely to maximize interoperability "best practices" that would be likely to maximize interoperability
with future versions of GIMP. with future versions of GIMP.
This document is complete, relatively to GIMP 2.10 features stored in
the XCF format, though if you discover any errors or missing features,
we would be thankful if you could report it as a bug:
https://gitlab.gnome.org/GNOME/gimp/issues
Version history Version history
--------------- ---------------
@ -170,6 +175,7 @@ Adds many layer modes, layer group masks, high-bit depth (precisions
other than 8-bit gamma), zlib compression and 64-bit offsets for XCF other than 8-bit gamma), zlib compression and 64-bit offsets for XCF
files bigger than 4GB. files bigger than 4GB.
1. BASIC CONCEPTS 1. BASIC CONCEPTS
================= =================