[DOC-CVS] [doc-en] master: rnp: fix XML to remove useless wrapping para tags via script
[email protected] (Gina Peter Banyard)
| Newsgroups | php.doc.cvs |
|---|---|
| Message-ID | <[email protected]> |
Author: Gina Peter Banyard (Girgias)
Date: 2026-01-25T15:52:31Z
Commit: https://github.com/php/doc-en/commit/8e27a460226d3bf8f9ab700089b80536d9f9359a
Raw diff: https://github.com/php/doc-en/commit/8e27a460226d3bf8f9ab700089b80536d9f9359a.diff
rnp: fix XML to remove useless wrapping para tags via script
Changed paths:
M reference/rnp/constants.xml
M reference/rnp/functions/rnp-ffi-set-pass-provider.xml
Diff:
diff --git a/reference/rnp/constants.xml b/reference/rnp/constants.xml
index cef49d9788d4..86d84e17d09d 100644
--- a/reference/rnp/constants.xml
+++ b/reference/rnp/constants.xml
@@ -1,345 +1,343 @@
<?xml version="1.0" encoding="utf-8"?>
-<appendix xml:id="rnp.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="rnp.constants">
&reftitle.constants;
&extension.constants;
- <para>
- <variablelist>
- <varlistentry xml:id="constant.rnp-keystore-gpg">
- <term>
- <constant>RNP_KEYSTORE_GPG</constant>
- (<type>string</type>)
- </term>
- <listitem>
- <simpara>
- Keystore format "GPG".
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-keystore-kbx">
- <term>
- <constant>RNP_KEYSTORE_KBX</constant>
- (<type>string</type>)
- </term>
- <listitem>
- <simpara>
- Keystore format "KBX". For public keys only.
- A keybox is a file format used to store public keys along with meta information and indices.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-keystore-g10">
- <term>
- <constant>RNP_KEYSTORE_G10</constant>
- (<type>string</type>)
- </term>
- <listitem>
- <simpara>
- Keystore format "G10". For private keys.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-load-save-public-keys">
- <term>
- <constant>RNP_LOAD_SAVE_PUBLIC_KEYS</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Load or save public keys only. Can be OR-ed with <constant>RNP_LOAD_SAVE_SECRET_KEYS</constant>
- to load both public and private keys to the FFI context or save them from the context.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-load-save-secret-keys">
- <term>
- <constant>RNP_LOAD_SAVE_SECRET_KEYS</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Load or save secret keys only. Can be OR-ed with <constant>RNP_LOAD_SAVE_PUBLIC_KEYS</constant>
- to load both public and private keys to the FFI context or save them from the context.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-load-save-permissive">
- <term>
- <constant>RNP_LOAD_SAVE_PERMISSIVE</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Allows to ignore bad signature/key/subkey packets during key import.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-load-save-single">
- <term>
- <constant>RNP_LOAD_SAVE_SINGLE</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- If set, only the first key will be loaded.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-load-save-base64">
- <term>
- <constant>RNP_LOAD_SAVE_BASE64</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Allow import of base64-encoded keys (autocrypt ones).
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-feature-symm-alg">
- <term>
- <constant>RNP_FEATURE_SYMM_ALG</constant>
- (<type>string</type>)
- </term>
- <listitem>
- <simpara>
- List available symmetric encryption algorithms.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-feature-aead-alg">
- <term>
- <constant>RNP_FEATURE_AEAD_ALG</constant>
- (<type>string</type>)
- </term>
- <listitem>
- <simpara>
- List available AEAD algorithms.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-feature-prot-mode">
- <term>
- <constant>RNP_FEATURE_PROT_MODE</constant>
- (<type>string</type>)
- </term>
- <listitem>
- <simpara>
- List available protection modes.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-feature-pk-alg">
- <term>
- <constant>RNP_FEATURE_PK_ALG</constant>
- (<type>string</type>)
- </term>
- <listitem>
- <simpara>
- List available public key algorithms.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-feature-hash-alg">
- <term>
- <constant>RNP_FEATURE_HASH_ALG</constant>
- (<type>string</type>)
- </term>
- <listitem>
- <simpara>
- List available hash algorithms.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-feature-comp-alg">
- <term>
- <constant>RNP_FEATURE_COMP_ALG</constant>
- (<type>string</type>)
- </term>
- <listitem>
- <simpara>
- List available compression algorithms.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-feature-curve">
- <term>
- <constant>RNP_FEATURE_CURVE</constant>
- (<type>string</type>)
- </term>
- <listitem>
- <simpara>
- List available elliptic curves.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-dump-mpi">
- <term>
- <constant>RNP_DUMP_MPI</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Dump MPI (Multi-precision integer) values.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-dump-raw">
- <term>
- <constant>RNP_DUMP_RAW</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Dump raw packet contents as well.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-dump-grip">
- <term>
- <constant>RNP_DUMP_GRIP</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Dump key fingerprints and grips.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-json-dump-mpi">
- <term>
- <constant>RNP_JSON_DUMP_MPI</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Dump MPI (Multi-precision integer) values.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-json-dump-raw">
- <term>
- <constant>RNP_JSON_DUMP_RAW</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Dump raw packet contents as well.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-json-dump-grip">
- <term>
- <constant>RNP_JSON_DUMP_GRIP</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Dump key fingerprints and grips.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-encrypt-nowrap">
- <term>
- <constant>RNP_ENCRYPT_NOWRAP</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Allows encryption of signed message. Message is not wrapped
- into literal data packet.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-key-export-armored">
- <term>
- <constant>RNP_KEY_EXPORT_ARMORED</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Enable ASCII-armoring of exported data.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-key-export-public">
- <term>
- <constant>RNP_KEY_EXPORT_PUBLIC</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Export public key.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-key-export-secret">
- <term>
- <constant>RNP_KEY_EXPORT_SECRET</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Export secret key.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-key-export-subkeys">
- <term>
- <constant>RNP_KEY_EXPORT_SUBKEYS</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- If primary key is being exported, all subkeys will be exported too.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-key-export-base64">
- <term>
- <constant>RNP_KEY_EXPORT_BASE64</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Export base64-encoded autocrypt key instead of binary.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-key-remove-public">
- <term>
- <constant>RNP_KEY_REMOVE_PUBLIC</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Remove public key.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-key-remove-secret">
- <term>
- <constant>RNP_KEY_REMOVE_SECRET</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Remove secret key.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.rnp-key-remove-subkeys">
- <term>
- <constant>RNP_KEY_REMOVE_SUBKEYS</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- If primary key is being deleted, all of its subkeys will be removed too.
- </simpara>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
+ <variablelist>
+ <varlistentry xml:id="constant.rnp-keystore-gpg">
+ <term>
+ <constant>RNP_KEYSTORE_GPG</constant>
+ (<type>string</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Keystore format "GPG".
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-keystore-kbx">
+ <term>
+ <constant>RNP_KEYSTORE_KBX</constant>
+ (<type>string</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Keystore format "KBX". For public keys only.
+ A keybox is a file format used to store public keys along with meta information and indices.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-keystore-g10">
+ <term>
+ <constant>RNP_KEYSTORE_G10</constant>
+ (<type>string</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Keystore format "G10". For private keys.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-load-save-public-keys">
+ <term>
+ <constant>RNP_LOAD_SAVE_PUBLIC_KEYS</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Load or save public keys only. Can be OR-ed with <constant>RNP_LOAD_SAVE_SECRET_KEYS</constant>
+ to load both public and private keys to the FFI context or save them from the context.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-load-save-secret-keys">
+ <term>
+ <constant>RNP_LOAD_SAVE_SECRET_KEYS</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Load or save secret keys only. Can be OR-ed with <constant>RNP_LOAD_SAVE_PUBLIC_KEYS</constant>
+ to load both public and private keys to the FFI context or save them from the context.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-load-save-permissive">
+ <term>
+ <constant>RNP_LOAD_SAVE_PERMISSIVE</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Allows to ignore bad signature/key/subkey packets during key import.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-load-save-single">
+ <term>
+ <constant>RNP_LOAD_SAVE_SINGLE</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ If set, only the first key will be loaded.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-load-save-base64">
+ <term>
+ <constant>RNP_LOAD_SAVE_BASE64</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Allow import of base64-encoded keys (autocrypt ones).
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-feature-symm-alg">
+ <term>
+ <constant>RNP_FEATURE_SYMM_ALG</constant>
+ (<type>string</type>)
+ </term>
+ <listitem>
+ <simpara>
+ List available symmetric encryption algorithms.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-feature-aead-alg">
+ <term>
+ <constant>RNP_FEATURE_AEAD_ALG</constant>
+ (<type>string</type>)
+ </term>
+ <listitem>
+ <simpara>
+ List available AEAD algorithms.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-feature-prot-mode">
+ <term>
+ <constant>RNP_FEATURE_PROT_MODE</constant>
+ (<type>string</type>)
+ </term>
+ <listitem>
+ <simpara>
+ List available protection modes.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-feature-pk-alg">
+ <term>
+ <constant>RNP_FEATURE_PK_ALG</constant>
+ (<type>string</type>)
+ </term>
+ <listitem>
+ <simpara>
+ List available public key algorithms.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-feature-hash-alg">
+ <term>
+ <constant>RNP_FEATURE_HASH_ALG</constant>
+ (<type>string</type>)
+ </term>
+ <listitem>
+ <simpara>
+ List available hash algorithms.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-feature-comp-alg">
+ <term>
+ <constant>RNP_FEATURE_COMP_ALG</constant>
+ (<type>string</type>)
+ </term>
+ <listitem>
+ <simpara>
+ List available compression algorithms.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-feature-curve">
+ <term>
+ <constant>RNP_FEATURE_CURVE</constant>
+ (<type>string</type>)
+ </term>
+ <listitem>
+ <simpara>
+ List available elliptic curves.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-dump-mpi">
+ <term>
+ <constant>RNP_DUMP_MPI</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Dump MPI (Multi-precision integer) values.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-dump-raw">
+ <term>
+ <constant>RNP_DUMP_RAW</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Dump raw packet contents as well.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-dump-grip">
+ <term>
+ <constant>RNP_DUMP_GRIP</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Dump key fingerprints and grips.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-json-dump-mpi">
+ <term>
+ <constant>RNP_JSON_DUMP_MPI</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Dump MPI (Multi-precision integer) values.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-json-dump-raw">
+ <term>
+ <constant>RNP_JSON_DUMP_RAW</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Dump raw packet contents as well.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-json-dump-grip">
+ <term>
+ <constant>RNP_JSON_DUMP_GRIP</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Dump key fingerprints and grips.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-encrypt-nowrap">
+ <term>
+ <constant>RNP_ENCRYPT_NOWRAP</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Allows encryption of signed message. Message is not wrapped
+ into literal data packet.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-key-export-armored">
+ <term>
+ <constant>RNP_KEY_EXPORT_ARMORED</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Enable ASCII-armoring of exported data.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-key-export-public">
+ <term>
+ <constant>RNP_KEY_EXPORT_PUBLIC</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Export public key.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-key-export-secret">
+ <term>
+ <constant>RNP_KEY_EXPORT_SECRET</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Export secret key.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-key-export-subkeys">
+ <term>
+ <constant>RNP_KEY_EXPORT_SUBKEYS</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ If primary key is being exported, all subkeys will be exported too.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-key-export-base64">
+ <term>
+ <constant>RNP_KEY_EXPORT_BASE64</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Export base64-encoded autocrypt key instead of binary.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-key-remove-public">
+ <term>
+ <constant>RNP_KEY_REMOVE_PUBLIC</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Remove public key.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-key-remove-secret">
+ <term>
+ <constant>RNP_KEY_REMOVE_SECRET</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Remove secret key.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.rnp-key-remove-subkeys">
+ <term>
+ <constant>RNP_KEY_REMOVE_SUBKEYS</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ If primary key is being deleted, all of its subkeys will be removed too.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
diff --git a/reference/rnp/functions/rnp-ffi-set-pass-provider.xml b/reference/rnp/functions/rnp-ffi-set-pass-provider.xml
index df6eefae20e0..7e7f623a144e 100644
--- a/reference/rnp/functions/rnp-ffi-set-pass-provider.xml
+++ b/reference/rnp/functions/rnp-ffi-set-pass-provider.xml
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<refentry xml:id="function.rnp-ffi-set-pass-provider" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.rnp-ffi-set-pass-provider">
<refnamediv>
<refname>rnp_ffi_set_pass_provider</refname>
<refpurpose>Set password provider callback function</refpurpose>
@@ -64,10 +64,9 @@
<refsect1 role="examples">
&reftitle.examples;
- <para>
- <example>
- <title>simple callback function example</title>
- <programlisting role="php">
+ <example>
+ <title>simple callback function example</title>
+ <programlisting role="php">
<![CDATA[
<?php
function password_callback(string $key_fp, string $pgp_context, string &$password)
@@ -81,9 +80,8 @@ $ffi = rnp_ffi_create('GPG', 'GPG');
rnp_ffi_set_pass_provider($ffi, 'password_callback');
]]>
- </programlisting>
- </example>
- </para>
+ </programlisting>
+ </example>
</refsect1>
</refentry>