From 93f6844c27c6b0c17cdfd79f5884d7e980f62f49 Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@gmail.com>
Date: Sun, 9 Aug 2026 23:24:33 +0300
Subject: [PATCH 1/7] sigmoidalcontrastimage.xml Amend parameter names

Integer values in the description are confusing, whereas numbers in the x.xx format seem to be perceived more easily, and the type remains consistent
---
 .../imagick/sigmoidalcontrastimage.xml        | 19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

diff --git a/reference/imagick/imagick/sigmoidalcontrastimage.xml b/reference/imagick/imagick/sigmoidalcontrastimage.xml
index c17490a45fc6..642adf494843 100644
--- a/reference/imagick/imagick/sigmoidalcontrastimage.xml
+++ b/reference/imagick/imagick/sigmoidalcontrastimage.xml
@@ -18,10 +18,10 @@
   <para>
    Adjusts the contrast of an image with a non-linear sigmoidal contrast
    algorithm. Increase the contrast of the image using a sigmoidal transfer
-   function without saturating highlights or shadows. Contrast indicates
-   how much to increase the contrast (0 is none; 3 is typical; 20 is
-   pushing it); mid-point indicates where midtones fall in the resultant
-   image (0 is white; 50 is middle-gray; 100 is black). Set sharpen to
+   function without saturating highlights or shadows. <parameter>alpha</parameter> indicates
+   how much to increase the contrast: 0.00 is none; 3.00 is typical; 20.00 is pushing it.
+   <parameter>beta</parameter> indicates where midtones fall in the resultant
+   image: 0.00 is white; 0.50 is middle-gray; 1.00 is black. Set <parameter>sharpen</parameter> to
    &true; to increase the image contrast otherwise the contrast is reduced.
   </para>
   <para>
@@ -46,7 +46,7 @@
      <term><parameter>alpha</parameter></term>
      <listitem>
       <para>
-       The amount of contrast to apply. 1 is very little, 5 is a significant amount, 20 is extreme.
+       The amount of contrast to apply. 1.00 is very little, 5.00 is a significant amount, 20.00 is extreme.
       </para>
      </listitem>
     </varlistentry>
@@ -91,22 +91,21 @@
     <title>
      Create a gradient image using <function>Imagick::sigmoidalContrastImage</function>
      suitable for blending two images together smoothly, with the blending
-     defined by $contrast and $the midpoint
+     defined by $alpha and $beta
     </title>
     <programlisting role="php">
 <![CDATA[
 <?php
 
-function generateBlendImage($width, $height, $contrast = 10, $midpoint = 0.5) {
+function generateBlendImage($width, $height, $alpha = 10, $beta = 0.5)
+{
     $imagick = new Imagick();
     $imagick->newPseudoImage($width, $height, 'gradient:black-white');
     $quanta = $imagick->getQuantumRange();
-    $imagick->sigmoidalContrastImage(true, $contrast, $midpoint * $quanta["quantumRangeLong"]);
+    $imagick->sigmoidalContrastImage(true, $alpha, $beta * $quanta["quantumRangeLong"]);
 
     return $imagick; 
 }
-
-?>
 ]]>
     </programlisting>
    </example>

From 55703aeb3ea6f8853d607dcb80229e7eb06e576e Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@gmail.com>
Date: Sun, 9 Aug 2026 23:34:01 +0300
Subject: [PATCH 2/7] Update sigmoidalcontrastimage.xml

---
 reference/imagick/imagick/sigmoidalcontrastimage.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/imagick/imagick/sigmoidalcontrastimage.xml b/reference/imagick/imagick/sigmoidalcontrastimage.xml
index 642adf494843..fedebf898627 100644
--- a/reference/imagick/imagick/sigmoidalcontrastimage.xml
+++ b/reference/imagick/imagick/sigmoidalcontrastimage.xml
@@ -15,7 +15,7 @@
    <methodparam><type>float</type><parameter>beta</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>channel</parameter><initializer>Imagick::CHANNEL_DEFAULT</initializer></methodparam>
   </methodsynopsis>
-  <para>
+  <simpara>
    Adjusts the contrast of an image with a non-linear sigmoidal contrast
    algorithm. Increase the contrast of the image using a sigmoidal transfer
    function without saturating highlights or shadows. <parameter>alpha</parameter> indicates
@@ -23,7 +23,7 @@
    <parameter>beta</parameter> indicates where midtones fall in the resultant
    image: 0.00 is white; 0.50 is middle-gray; 1.00 is black. Set <parameter>sharpen</parameter> to
    &true; to increase the image contrast otherwise the contrast is reduced.
-  </para>
+  </simpara>
   <para>
    See also <link xlink:href="&url.imagemagick.usage.color_mods.sigmoidal;">ImageMagick
    v6 Examples - Image Transformations — Sigmoidal Non-linearity Contrast</link>
@@ -45,9 +45,9 @@
     <varlistentry>
      <term><parameter>alpha</parameter></term>
      <listitem>
-      <para>
+      <simpara>
        The amount of contrast to apply. 1.00 is very little, 5.00 is a significant amount, 20.00 is extreme.
-      </para>
+      </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>

From bd1472f9b5202598767c176af2eb35275996c4bb Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@gmail.com>
Date: Sun, 9 Aug 2026 23:42:05 +0300
Subject: [PATCH 3/7] Update sigmoidalcontrastimage.xml

---
 reference/imagick/imagick/sigmoidalcontrastimage.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/imagick/imagick/sigmoidalcontrastimage.xml b/reference/imagick/imagick/sigmoidalcontrastimage.xml
index fedebf898627..340ca23e84c5 100644
--- a/reference/imagick/imagick/sigmoidalcontrastimage.xml
+++ b/reference/imagick/imagick/sigmoidalcontrastimage.xml
@@ -26,7 +26,7 @@
   </simpara>
   <para>
    See also <link xlink:href="&url.imagemagick.usage.color_mods.sigmoidal;">ImageMagick
-   v6 Examples - Image Transformations — Sigmoidal Non-linearity Contrast</link>
+    Examples -- Color Modifications — Sigmoidal Non-linearity Contrast</link>
   </para>
  </refsect1>
 

From 343ad672ca04791f3ff41deba7f7da35c6d115cf Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@gmail.com>
Date: Mon, 10 Aug 2026 00:24:40 +0300
Subject: [PATCH 4/7] Update sigmoidalcontrastimage.xml

---
 reference/imagick/imagick/sigmoidalcontrastimage.xml | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/reference/imagick/imagick/sigmoidalcontrastimage.xml b/reference/imagick/imagick/sigmoidalcontrastimage.xml
index 340ca23e84c5..6cd4f9175e96 100644
--- a/reference/imagick/imagick/sigmoidalcontrastimage.xml
+++ b/reference/imagick/imagick/sigmoidalcontrastimage.xml
@@ -38,7 +38,7 @@
      <term><parameter>sharpen</parameter></term>
      <listitem>
       <para>
-       If true increase the contrast, if false decrease the contrast.
+       If &true; increase the contrast, if &false; decrease the contrast.
       </para>
      </listitem>
     </varlistentry>
@@ -54,7 +54,8 @@
      <term><parameter>beta</parameter></term>
      <listitem>
       <simpara>
-       Where the midpoint of the gradient will be. This value should be in the range 0 to 1 - multiplied by the quantum value for ImageMagick.
+       Where the midpoint of the gradient will be. This value should be in the range <literal>0.00</literal>
+       to <literal>1.00</literal> - multiplied by the quantum value for ImageMagick.
       </simpara>
      </listitem>
     </varlistentry>

From 7f498e7d044456eff67026efc101f3254df4d98e Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@gmail.com>
Date: Mon, 10 Aug 2026 00:50:39 +0300
Subject: [PATCH 5/7] Update sigmoidalcontrastimage.xml

---
 .../imagick/imagick/sigmoidalcontrastimage.xml    | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/reference/imagick/imagick/sigmoidalcontrastimage.xml b/reference/imagick/imagick/sigmoidalcontrastimage.xml
index 6cd4f9175e96..58b152e73d10 100644
--- a/reference/imagick/imagick/sigmoidalcontrastimage.xml
+++ b/reference/imagick/imagick/sigmoidalcontrastimage.xml
@@ -19,15 +19,17 @@
    Adjusts the contrast of an image with a non-linear sigmoidal contrast
    algorithm. Increase the contrast of the image using a sigmoidal transfer
    function without saturating highlights or shadows. <parameter>alpha</parameter> indicates
-   how much to increase the contrast: 0.00 is none; 3.00 is typical; 20.00 is pushing it.
+   how much to increase the contrast: <literal>0.00</literal> is none; <literal>3.00</literal> is
+   typical; <literal>20.00</literal> is pushing it.
    <parameter>beta</parameter> indicates where midtones fall in the resultant
-   image: 0.00 is white; 0.50 is middle-gray; 1.00 is black. Set <parameter>sharpen</parameter> to
+   image: <literal>0.00</literal> is white; <literal>0.50</literal> is
+   middle-gray; <literal>1.00</literal> is black. Set <parameter>sharpen</parameter> to
    &true; to increase the image contrast otherwise the contrast is reduced.
   </simpara>
-  <para>
+  <simpara>
    See also <link xlink:href="&url.imagemagick.usage.color_mods.sigmoidal;">ImageMagick
-    Examples -- Color Modifications — Sigmoidal Non-linearity Contrast</link>
-  </para>
+    Examples -- Color Modifications — Sigmoidal Non-linearity Contrast</link>.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -46,7 +48,8 @@
      <term><parameter>alpha</parameter></term>
      <listitem>
       <simpara>
-       The amount of contrast to apply. 1.00 is very little, 5.00 is a significant amount, 20.00 is extreme.
+       The amount of contrast to apply. <literal>1.00</literal> is very little, <literal>5.00</literal>
+       is a significant amount, <literal>20.00</literal> is extreme.
       </simpara>
      </listitem>
     </varlistentry>

From 3c953e260990390d03f85904249eee2dd3c783ec Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@gmail.com>
Date: Mon, 10 Aug 2026 01:04:48 +0300
Subject: [PATCH 6/7] Update sigmoidalcontrastimage.xml

---
 .../imagick/sigmoidalcontrastimage.xml        | 28 +++++++++----------
 1 file changed, 13 insertions(+), 15 deletions(-)

diff --git a/reference/imagick/imagick/sigmoidalcontrastimage.xml b/reference/imagick/imagick/sigmoidalcontrastimage.xml
index 58b152e73d10..8e738b1aa349 100644
--- a/reference/imagick/imagick/sigmoidalcontrastimage.xml
+++ b/reference/imagick/imagick/sigmoidalcontrastimage.xml
@@ -39,9 +39,9 @@
     <varlistentry>
      <term><parameter>sharpen</parameter></term>
      <listitem>
-      <para>
+      <simpara>
        If &true; increase the contrast, if &false; decrease the contrast.
-      </para>
+      </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
@@ -65,9 +65,9 @@
     <varlistentry>
      <term><parameter>channel</parameter></term>
      <listitem>
-      <para>
+      <simpara>
        Which color channels the contrast will be applied to.
-      </para>
+      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -90,14 +90,13 @@
  
  <refsect1 role="examples">
   &reftitle.examples;
-  <para>
-   <example>
-    <title>
-     Create a gradient image using <function>Imagick::sigmoidalContrastImage</function>
-     suitable for blending two images together smoothly, with the blending
-     defined by $alpha and $beta
-    </title>
-    <programlisting role="php">
+  <example>
+   <title>
+    Create a gradient image using <function>Imagick::sigmoidalContrastImage</function>
+    suitable for blending two images together smoothly, with the blending
+    defined by $alpha and $beta
+   </title>
+   <programlisting role="php">
 <![CDATA[
 <?php
 
@@ -111,9 +110,8 @@ function generateBlendImage($width, $height, $alpha = 10, $beta = 0.5)
     return $imagick; 
 }
 ]]>
-    </programlisting>
-   </example>
-  </para>
+   </programlisting>
+  </example>
  </refsect1>
 
 </refentry>

From 9acf08ec3cbd1a483528ef5159fdc8f33c806d9a Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@gmail.com>
Date: Tue, 11 Aug 2026 02:03:01 +0300
Subject: [PATCH 7/7] Apply suggestions from code review

Co-authored-by: Kamil Tekiela <tekiela246@gmail.com>
---
 reference/imagick/imagick/sigmoidalcontrastimage.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/imagick/imagick/sigmoidalcontrastimage.xml b/reference/imagick/imagick/sigmoidalcontrastimage.xml
index 8e738b1aa349..8f094f64570f 100644
--- a/reference/imagick/imagick/sigmoidalcontrastimage.xml
+++ b/reference/imagick/imagick/sigmoidalcontrastimage.xml
@@ -94,7 +94,7 @@
    <title>
     Create a gradient image using <function>Imagick::sigmoidalContrastImage</function>
     suitable for blending two images together smoothly, with the blending
-    defined by $alpha and $beta
+    defined by <parameter>alpha</parameter> and <parameter>beta</parameter>
    </title>
    <programlisting role="php">
 <![CDATA[