From 997f8b50a1d4e17b74d014377c9caaaddf367da0 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Mon, 31 Aug 2026 13:17:48 +0200
Subject: [PATCH] openssl: document the padding constants for openssl_sign()
 and openssl_verify()

---
 reference/openssl/functions/openssl-sign.xml   | 12 +++++++++---
 reference/openssl/functions/openssl-verify.xml | 10 ++++++++--
 2 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/reference/openssl/functions/openssl-sign.xml b/reference/openssl/functions/openssl-sign.xml
index e355f0a08a..76feb86990 100644
--- a/reference/openssl/functions/openssl-sign.xml
+++ b/reference/openssl/functions/openssl-sign.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9a8c593c09cf7d84085989e42f3b2b23536279db Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: ddcd63907372580151daf69458d6a8268232b703 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.openssl-sign" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -13,7 +13,7 @@
    <type>bool</type><methodname>openssl_sign</methodname>
    <methodparam><type>string</type><parameter>data</parameter></methodparam>
    <methodparam><type>string</type><parameter role="reference">signature</parameter></methodparam>
-   <methodparam><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type></type><parameter>private_key</parameter></methodparam>
+   <methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type></type><parameter>private_key</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>string</type><type>int</type></type><parameter>algorithm</parameter><initializer><constant>OPENSSL_ALGO_SHA1</constant></initializer></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>padding</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
@@ -73,7 +73,13 @@
     <varlistentry>
      <term><parameter>padding</parameter></term>
      <listitem>
-      <simpara>Схема дополнения PSS (англ. Probabilistic Signature Scheme — вероятностная схема подписи) алгоритма RSA.</simpara>
+      <simpara>
+       Схема дополнения RSA-PSS (англ. Probabilistic Signature Scheme —
+       вероятностная схема подписи), которую требуется применить. Значением
+       выступает либо константа <constant>OPENSSL_PKCS1_PADDING</constant>,
+       либо константа <constant>OPENSSL_PKCS1_PSS_PADDING</constant>,
+       либо <literal>0</literal>.
+      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>
diff --git a/reference/openssl/functions/openssl-verify.xml b/reference/openssl/functions/openssl-verify.xml
index 009f2a5a80..65203358dd 100644
--- a/reference/openssl/functions/openssl-verify.xml
+++ b/reference/openssl/functions/openssl-verify.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9a8c593c09cf7d84085989e42f3b2b23536279db Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: ddcd63907372580151daf69458d6a8268232b703 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.openssl-verify" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -74,7 +74,13 @@
     <varlistentry>
      <term><parameter>padding</parameter></term>
      <listitem>
-      <simpara>Схема дополнения PSS (англ. Probabilistic Signature Scheme — вероятностная схема подписи) алгоритма RSA.</simpara>
+      <simpara>
+       Схема дополнения RSA-PSS (англ. Probabilistic Signature Scheme —
+       вероятностная схема подписи), которую требуется применить. Значением
+       выступает либо константа <constant>OPENSSL_PKCS1_PADDING</constant>,
+       либо константа <constant>OPENSSL_PKCS1_PSS_PADDING</constant>,
+       либо <literal>0</literal>.
+      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>