GraphicsMagick: Options Documentation: Remove #RRRRGGGGBBBBAAAA ...

GraphicsMagick Commits <[email protected]> Fri, 06 Sep 2024 16:55:25 -0500
Newsgroups gmane.comp.video.graphicsmagick.cvs
Message-ID <mailman.19567.1725659752.7833.graphicsmagick-commit@lists.sourceforge.net>
changeset 73860ffdefab in /hg/GraphicsMagick
details: http://hg.GraphicsMagick.org/hg/GraphicsMagick?cmd=changeset;node=73860ffdefab
summary: Options Documentation: Remove #RRRRGGGGBBBBAAAA from the list of supported color specification formats due to conflict.

diffstat:

 ChangeLog                              |   6 ++++++
 VisualMagick/installer/inc/version.isx |   4 ++--
 doc/options.imdoc                      |  11 +++++------
 magick/version.h                       |   4 ++--
 utilities/gm.1                         |  13 ++++++-------
 www/ChangeLog.html                     |   8 ++++++++
 www/GraphicsMagick.html                |  11 +++++------
 www/gm.html                            |  11 +++++------
 8 files changed, 39 insertions(+), 29 deletions(-)

diffs (202 lines):

diff -r b5d8b54ebaea -r 73860ffdefab ChangeLog
--- a/ChangeLog	Mon Sep 02 08:38:48 2024 -0500
+++ b/ChangeLog	Fri Sep 06 16:55:03 2024 -0500
@@ -1,3 +1,9 @@
+2024-09-06  Bob Friesenhahn  <[email protected]>
+
+	* doc/options.imdoc: Remove mention of RRRRGGGGBBBBAAAA, due to an
+	interpretation conflict.  Addresses SourceForge issue #747
+	"#RRRGGGBBBAAA and #RRRRGGGGBBBB color names conflict".
+
 2024-09-02  Bob Friesenhahn  <[email protected]>
 
 	* TclMagick/: White-space clean-up and consistent indentation.
diff -r b5d8b54ebaea -r 73860ffdefab VisualMagick/installer/inc/version.isx
--- a/VisualMagick/installer/inc/version.isx	Mon Sep 02 08:38:48 2024 -0500
+++ b/VisualMagick/installer/inc/version.isx	Fri Sep 06 16:55:03 2024 -0500
@@ -10,5 +10,5 @@
 
 #define public MagickPackageName "GraphicsMagick"
 #define public MagickPackageVersion "1.4"
-#define public MagickPackageVersionAddendum ".020240902"
-#define public MagickPackageReleaseDate "snapshot-20240902"
+#define public MagickPackageVersionAddendum ".020240906"
+#define public MagickPackageReleaseDate "snapshot-20240906"
diff -r b5d8b54ebaea -r 73860ffdefab doc/options.imdoc
--- a/doc/options.imdoc	Mon Sep 02 08:38:48 2024 -0500
+++ b/doc/options.imdoc	Fri Sep 06 16:55:03 2024 -0500
@@ -2231,7 +2231,7 @@
 <abs>color to use when filling a graphic primitive</abs>
 
 <pp>
-Colors are represented in GraphicsMagick in the same form used by SVG. Use "gm convert -list color" to list named colors:</pp>
+Colors are represented in GraphicsMagick in a form similar to SVG. Use "gm convert -list color" to list named colors:</pp>
 
 <pp><pre>
     name               (named color)
@@ -2242,9 +2242,8 @@
     #RGBA              (4 bits each)
     #RRGGBBAA          (8 bits each)
     #RRRGGGBBBAAA      (12 bits each)
-    #RRRRGGGGBBBBAAAA  (16 bits each)
-    rgb(r,g,b)         (r,g,b are decimal numbers)
-    rgba(r,g,b,a)      (r,g,b,a are decimal numbers)
+    rgb(r,g,b)         (r,g,b are decimal numbers, range 0 to 255)
+    rgba(r,g,b,a)      (r,g,b,a are decimal numbers, range 0 to 255)
 </pre></pp>
 <pp>
 Enclose the color specification in quotation marks to prevent the "#"
@@ -2258,8 +2257,8 @@
 </pre></pp>
 
 <pp>
-The shorter forms are scaled up, if necessary by replication.  For example, 
-#3af, #33aaff, and #3333aaaaffff are all equivalent.</pp>
+The shorter forms are scaled up, if necessary by replication.  For example,
+ #3af, #33aaff, and #3333aaaaffff are all equivalent.</pp>
 
 <pp>
 See <s>-draw</s> for further details.</pp>
diff -r b5d8b54ebaea -r 73860ffdefab magick/version.h
--- a/magick/version.h	Mon Sep 02 08:38:48 2024 -0500
+++ b/magick/version.h	Fri Sep 06 16:55:03 2024 -0500
@@ -38,8 +38,8 @@
 #define MagickLibVersion  0x282502
 #define MagickLibVersionText  "1.4"
 #define MagickLibVersionNumber 28,25,2
-#define MagickChangeDate   "20240902"
-#define MagickReleaseDate  "snapshot-20240902"
+#define MagickChangeDate   "20240906"
+#define MagickReleaseDate  "snapshot-20240906"
 
 /*
   The MagickLibInterfaceNewest and MagickLibInterfaceOldest defines
diff -r b5d8b54ebaea -r 73860ffdefab utilities/gm.1
--- a/utilities/gm.1	Mon Sep 02 08:38:48 2024 -0500
+++ b/utilities/gm.1	Fri Sep 06 16:55:03 2024 -0500
@@ -1,4 +1,4 @@
-.TH gm 1 "2024/08/04" "GraphicsMagick"
+.TH gm 1 "2024/09/06" "GraphicsMagick"
 .TP
 .in 15
 .in 15
@@ -2385,7 +2385,7 @@
 .B "-fill \fI<color>"\fP
 \fRcolor to use when filling a graphic primitive
 
-Colors are represented in GraphicsMagick in the same form used by SVG. Use "gm convert -list color" to list named colors:
+Colors are represented in GraphicsMagick in a form similar to SVG. Use "gm convert -list color" to list named colors:
 
 .nf
     name               (named color)
@@ -2396,9 +2396,8 @@
     #RGBA              (4 bits each)
     #RRGGBBAA          (8 bits each)
     #RRRGGGBBBAAA      (12 bits each)
-    #RRRRGGGGBBBBAAAA  (16 bits each)
-    rgb(r,g,b)         (r,g,b are decimal numbers)
-    rgba(r,g,b,a)      (r,g,b,a are decimal numbers)
+    rgb(r,g,b)         (r,g,b are decimal numbers, range 0 to 255)
+    rgba(r,g,b,a)      (r,g,b,a are decimal numbers, range 0 to 255)
 .fi
 
 Enclose the color specification in quotation marks to prevent the "#"
@@ -2412,8 +2411,8 @@
     gm convert -fill "rgb(65000,65000,65535)" ...
 .fi
 
-The shorter forms are scaled up, if necessary by replication.  For example, 
-#3af, #33aaff, and #3333aaaaffff are all equivalent.
+The shorter forms are scaled up, if necessary by replication.  For example,
+ #3af, #33aaff, and #3333aaaaffff are all equivalent.
 
 See \fB-draw\fP for further details.
 .TP
diff -r b5d8b54ebaea -r 73860ffdefab www/ChangeLog.html
--- a/www/ChangeLog.html	Mon Sep 02 08:38:48 2024 -0500
+++ b/www/ChangeLog.html	Fri Sep 06 16:55:03 2024 -0500
@@ -38,6 +38,14 @@
 
 <main id="graphicsmagick-changelog">
 <h1 class="title">GraphicsMagick ChangeLog</h1>
+<p>2024-09-06  Bob Friesenhahn  &lt;<a class="reference external" href="mailto:bfriesen&#37;&#52;&#48;simple&#46;dallas&#46;tx&#46;us">bfriesen<span>&#64;</span>simple<span>&#46;</span>dallas<span>&#46;</span>tx<span>&#46;</span>us</a>&gt;</p>
+<blockquote>
+<ul class="simple">
+<li><p>doc/options.imdoc: Remove mention of RRRRGGGGBBBBAAAA, due to an
+interpretation conflict.  Addresses SourceForge issue #747
+&quot;#RRRGGGBBBAAA and #RRRRGGGGBBBB color names conflict&quot;.</p></li>
+</ul>
+</blockquote>
 <p>2024-09-02  Bob Friesenhahn  &lt;<a class="reference external" href="mailto:bfriesen&#37;&#52;&#48;simple&#46;dallas&#46;tx&#46;us">bfriesen<span>&#64;</span>simple<span>&#46;</span>dallas<span>&#46;</span>tx<span>&#46;</span>us</a>&gt;</p>
 <blockquote>
 <ul class="simple">
diff -r b5d8b54ebaea -r 73860ffdefab www/GraphicsMagick.html
--- a/www/GraphicsMagick.html	Mon Sep 02 08:38:48 2024 -0500
+++ b/www/GraphicsMagick.html	Fri Sep 06 16:55:03 2024 -0500
@@ -2455,7 +2455,7 @@
 </font></font></font></b></td></tr></table>
 <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>color to use when filling a graphic primitive</td></tr></table>
 <table width="90%" border="0" cellspacing="0"             cellpadding="8">             <tr><td width="6%"><br></td><td><font size="-1">
-Colors are represented in GraphicsMagick in the same form used by SVG. Use "gm convert -list color" to list named colors:</font></td></tr></table>
+Colors are represented in GraphicsMagick in a form similar to SVG. Use "gm convert -list color" to list named colors:</font></td></tr></table>
 <table width="90%" border="0" cellspacing="0"             cellpadding="8">             <tr><td width="6%"><br></td><td><font size="-1"><pre>
     name               (named color)
     #RGB               (hex numbers, 4 bits each)
@@ -2465,9 +2465,8 @@
     #RGBA              (4 bits each)
     #RRGGBBAA          (8 bits each)
     #RRRGGGBBBAAA      (12 bits each)
-    #RRRRGGGGBBBBAAAA  (16 bits each)
-    rgb(r,g,b)         (r,g,b are decimal numbers)
-    rgba(r,g,b,a)      (r,g,b,a are decimal numbers)
+    rgb(r,g,b)         (r,g,b are decimal numbers, range 0 to 255)
+    rgba(r,g,b,a)      (r,g,b,a are decimal numbers, range 0 to 255)
 </pre></font></td></tr></table>
 <table width="90%" border="0" cellspacing="0"             cellpadding="8">             <tr><td width="6%"><br></td><td><font size="-1">
 Enclose the color specification in quotation marks to prevent the "#"
@@ -2480,8 +2479,8 @@
     gm convert -fill "rgb(65000,65000,65535)" ...
 </pre></font></td></tr></table>
 <table width="90%" border="0" cellspacing="0"             cellpadding="8">             <tr><td width="6%"><br></td><td><font size="-1">
-The shorter forms are scaled up, if necessary by replication.  For example, 
-#3af, #33aaff, and #3333aaaaffff are all equivalent.</font></td></tr></table>
+The shorter forms are scaled up, if necessary by replication.  For example,
+ #3af, #33aaff, and #3333aaaaffff are all equivalent.</font></td></tr></table>
 <table width="90%" border="0" cellspacing="0"             cellpadding="8">             <tr><td width="6%"><br></td><td><font size="-1">
 See <strong>-draw</strong> for further details.</font></td></tr></table>
 <table BORDER=0 WIDTH="94%">
diff -r b5d8b54ebaea -r 73860ffdefab www/gm.html
--- a/www/gm.html	Mon Sep 02 08:38:48 2024 -0500
+++ b/www/gm.html	Fri Sep 06 16:55:03 2024 -0500
@@ -2418,7 +2418,7 @@
 </font></font></font></b></td></tr></table>
 <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>color to use when filling a graphic primitive</td></tr></table>
 <table width="90%" border="0" cellspacing="0"             cellpadding="8">             <tr><td width="6%"><br></td><td><font size="-1">
-Colors are represented in GraphicsMagick in the same form used by SVG. Use "gm convert -list color" to list named colors:</font></td></tr></table>
+Colors are represented in GraphicsMagick in a form similar to SVG. Use "gm convert -list color" to list named colors:</font></td></tr></table>
 <table width="90%" border="0" cellspacing="0"             cellpadding="8">             <tr><td width="6%"><br></td><td><font size="-1"><pre>
     name               (named color)
     #RGB               (hex numbers, 4 bits each)
@@ -2428,9 +2428,8 @@
     #RGBA              (4 bits each)
     #RRGGBBAA          (8 bits each)
     #RRRGGGBBBAAA      (12 bits each)
-    #RRRRGGGGBBBBAAAA  (16 bits each)
-    rgb(r,g,b)         (r,g,b are decimal numbers)
-    rgba(r,g,b,a)      (r,g,b,a are decimal numbers)
+    rgb(r,g,b)         (r,g,b are decimal numbers, range 0 to 255)
+    rgba(r,g,b,a)      (r,g,b,a are decimal numbers, range 0 to 255)
 </pre></font></td></tr></table>
 <table width="90%" border="0" cellspacing="0"             cellpadding="8">             <tr><td width="6%"><br></td><td><font size="-1">
 Enclose the color specification in quotation marks to prevent the "#"
@@ -2443,8 +2442,8 @@
     gm convert -fill "rgb(65000,65000,65535)" ...
 </pre></font></td></tr></table>
 <table width="90%" border="0" cellspacing="0"             cellpadding="8">             <tr><td width="6%"><br></td><td><font size="-1">
-The shorter forms are scaled up, if necessary by replication.  For example, 
-#3af, #33aaff, and #3333aaaaffff are all equivalent.</font></td></tr></table>
+The shorter forms are scaled up, if necessary by replication.  For example,
+ #3af, #33aaff, and #3333aaaaffff are all equivalent.</font></td></tr></table>
 <table width="90%" border="0" cellspacing="0"             cellpadding="8">             <tr><td width="6%"><br></td><td><font size="-1">
 See <strong>-draw</strong> for further details.</font></td></tr></table>
 <table BORDER=0 WIDTH="94%">