[gimp/gimp-2-10] Issue #3990: make the status of the XCF docs a bit clearer (hopefully).
- From: Jehan <jehanp src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp/gimp-2-10] Issue #3990: make the status of the XCF docs a bit clearer (hopefully).
- Date: Thu, 26 Sep 2019 23:22:48 +0000 (UTC)
commit 8a400e304f646b678bc3378f0dd9c2ac7f7cf9bc
Author: Jehan <jehan girinstud io>
Date: Fri Sep 27 01:01:31 2019 +0200
Issue #3990: make the status of the XCF docs a bit clearer (hopefully).
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 80e2e0a50815cc643709ccbd7a7258b908ceac86)
devel-docs/xcf.txt | 16 +++++++++++-----
1 file changed, 11 insertions(+), 5 deletions(-)
---
diff --git a/devel-docs/xcf.txt b/devel-docs/xcf.txt
index a54764b821..f68a99428f 100644
--- a/devel-docs/xcf.txt
+++ b/devel-docs/xcf.txt
@@ -20,7 +20,7 @@ License
-------
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
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
------
-This specification is an unofficial condensation and extrapolation of
-the XCF-writing and -reading code in version 2.10.0 of GIMP. Yet we
-remind that the ultimate reference is the loading and saving code of the
-XCF format.
+This specification is an official condensation and extrapolation of
+the XCF-writing and -reading code in version 2.10.14 of GIMP, and
+earlier versions. Yet we remind that the ultimate reference is the
+loading and saving code of the XCF format.
Some of the normative statements made below are enforced by the XCF
code in GIMP; others are just the authors' informed guess about
"best practices" that would be likely to maximize interoperability
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
---------------
@@ -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
files bigger than 4GB.
+
1. BASIC CONCEPTS
=================
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]