From 9d080268eb9f9cac15d8bf92d37d430f6f017773 Mon Sep 17 00:00:00 2001
From: =?utf8?q?=C3=98yvind=20Kol=C3=A5s?= <pippin@gimp.org>
Date: Mon, 22 Jul 2019 17:20:37 +0200
Subject: [PATCH] extensions/CIE: add some documentation overrides

---
 extensions/CIE.c   |  4 ++++
 extensions/cairo.c | 10 ++++++++++
 2 files changed, 14 insertions(+)

diff --git a/extensions/CIE.c b/extensions/CIE.c
index 4b41894..85f8bc5 100644
--- a/extensions/CIE.c
+++ b/extensions/CIE.c
@@ -164,6 +164,7 @@ models (void)
 
   babl_model_new (
     "name", "CIE xyY",
+    "doc", "the coordinate system often used for drawing chromaticity diagrams. Y is luminance.",
     babl_component ("CIE x"),
     babl_component ("CIE y"),
     babl_component ("CIE Y"),
@@ -172,6 +173,7 @@ models (void)
 
   babl_model_new (
     "name", "CIE xyY alpha",
+    "doc", "the coordinate system often used for drawing chromaticity diagrams. Y is luminance, with separate alpha",
     babl_component ("CIE x"),
     babl_component ("CIE y"),
     babl_component ("CIE Y"),
@@ -183,6 +185,7 @@ models (void)
 /* CIE 1976 UCS */
   babl_model_new (
     "name", "CIE Yuv",
+    "doc", "A newer more perceptually uniform space than xyY for chromaticity diagrams.",
     babl_component ("CIE Y"),
     babl_component ("CIE u"),
     babl_component ("CIE v"),
@@ -190,6 +193,7 @@ models (void)
 
   babl_model_new (
     "name", "CIE Yuv alpha",
+    "doc", "A newer more perceptually uniform space than xyY for chromaticity diagrams, with separate alpha.",
     babl_component ("CIE Y"),
     babl_component ("CIE u"),
     babl_component ("CIE v"),
diff --git a/extensions/cairo.c b/extensions/cairo.c
index ada75aa..53e8329 100644
--- a/extensions/cairo.c
+++ b/extensions/cairo.c
@@ -478,6 +478,7 @@ init (void)
     {
       const Babl *f32 = babl_format_new (
         "name", "cairo-ARGB32",
+        "doc", "endianness adaptive native cairo format with alpha",
         babl_model ("R'aG'aB'aA"),
         babl_type ("u8"),
         babl_component ("B'a"),
@@ -489,6 +490,7 @@ init (void)
 
       const Babl *f24 = babl_format_new (
         "name", "cairo-RGB24",
+        "doc", "endianness adaptive native cairo format without alpha",
         babl_model ("R'G'B'"),
         babl_type ("u8"),
         babl_component ("B'"),
@@ -544,6 +546,7 @@ init (void)
     {
       babl_format_new (
         "name", "cairo-ARGB32",
+        "doc", "endianness adaptive native cairo format with alpha",
         babl_model ("R'aG'aB'aA"),
         babl_type ("u8"),
         babl_component ("A"),
@@ -554,6 +557,7 @@ init (void)
       );
       babl_format_new (
         "name", "cairo-RGB24",
+        "doc", "endianness adaptive native cairo format without alpha",
         babl_model ("R'G'B'"),
         babl_type ("u8"),
         babl_component ("PAD"),
@@ -582,6 +586,7 @@ init (void)
   if (littleendian)
   {
     babl_format_new ("name", "cairo-ACMK32",
+                     "doc", "3 component CMYK subset format, to be used to two-pass CMYK processing/rendering with cairo.",
                      babl_model ("camayakaA"),
                      babl_type ("u8"),
                      babl_component ("ka"),
@@ -590,6 +595,7 @@ init (void)
                      babl_component ("A"),
                      NULL);
     babl_format_new ("name", "cairo-ACYK32",
+                     "doc", "3 component CMYK subset format, to be used to two-pass CMYK processing/rendering with cairo.",
                      babl_model ("camayakaA"),
                      babl_type ("u8"),
                      babl_component ("ka"),
@@ -601,6 +607,7 @@ init (void)
   else
   {
     babl_format_new ("name", "cairo-ACMK32",
+                     "doc", "3 component CMYK subset format, to be used to two-pass CMYK processing/rendering with cairo.",
                      babl_model ("camayakaA"),
                      babl_type ("u8"),
                      babl_component ("A"),
@@ -609,6 +616,7 @@ init (void)
                      babl_component ("ka"),
                      NULL);
     babl_format_new ("name", "cairo-ACYK32",
+                     "doc", "3 component CMYK subset format, to be used to two-pass CMYK processing/rendering with cairo.",
                      babl_model ("camayakaA"),
                      babl_type ("u8"),
                      babl_component ("A"),
@@ -621,6 +629,7 @@ init (void)
   /* companion subset formats for setting pango u16 RGB color values from cmykA
    * */
   babl_format_new ("name", "cykA u16",
+                   "doc", "3 component CMYK subset format, to be used to two-pass CMYK processing/rendering with pango.",
                    babl_model ("cmykA"),
                    babl_type ("u16"),
                    babl_component ("cyan"),
@@ -629,6 +638,7 @@ init (void)
                    babl_component ("A"),
                    NULL);
   babl_format_new ("name", "cmkA u16",
+                   "doc", "3 component CMYK subset format, to be used to two-pass CMYK processing/rendering with pango.",
                    babl_model ("cmykA"),
                    babl_type ("u16"),
                    babl_component ("cyan"),
-- 
2.30.2