From: Eugene Syromiatnikov <esyr@openssl.org>
Date: Mon, 14 Jul 2025 07:53:51 +0000 (+0200)
Subject: doc/man7/openssl-env: sort OPENSSL_TRACE categories lexicographically
X-Git-Tag: openssl-3.6.0-alpha1~368
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=30740298b6ceb9d37604ef13cb5f0389b00074b8;p=thirdparty%2Fopenssl.git

doc/man7/openssl-env: sort OPENSSL_TRACE categories lexicographically

There is little reason to preserve the declaration order for the reader.

Signed-off-by: Eugene Syromiatnikov <esyr@openssl.org>

Reviewed-by: Neil Horman <nhorman@openssl.org>
Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Dmitry Belyavskiy <beldmit@gmail.com>
(Merged from https://github.com/openssl/openssl/pull/28025)
---

diff --git a/doc/man7/openssl-env.pod b/doc/man7/openssl-env.pod
index 1dd9da1249a..828554a9557 100644
--- a/doc/man7/openssl-env.pod
+++ b/doc/man7/openssl-env.pod
@@ -122,73 +122,72 @@ with the following available:
 
 =over 4
 
-=item B<TRACE>
-
-Traces the OpenSSL trace API itself.
+=item B<ALL>
 
-=item B<INIT>
-
-Traces OpenSSL library initialization and cleanup.
+Traces everything.
 
-=item B<TLS>
+=item B<BN_CTX>
 
-Traces the TLS/SSL protocol.
+Traces BIGNUM context operations.
 
-=item B<TLS_CIPHER>
+=item B<CMP>
 
-Traces the ciphers used by the TLS/SSL protocol.
+Traces CMP client and server activity.
 
 =item B<CONF>
 
 Show details about provider and engine configuration.
 
-=item B<ENGINE_TABLE>
+=item B<DECODER>
 
-The function that is used by RSA, DSA (etc) code to select registered
-ENGINEs, cache defaults and functional references (etc), will generate
-debugging summaries.
+Traces decoder operations.
+
+=item B<ENCODER>
+
+Traces encoder operations.
 
 =item B<ENGINE_REF_COUNT>
 
 Reference counts in the ENGINE structure will be monitored with a line
 of generated for each change.
 
-=item B<PKCS5V2>
-
-Traces PKCS#5 v2 key generation.
-
-=item B<PKCS12_KEYGEN>
+=item B<ENGINE_TABLE>
 
-Traces PKCS#12 key generation.
+The function that is used by RSA, DSA (etc) code to select registered
+ENGINEs, cache defaults and functional references (etc), will generate
+debugging summaries.
 
-=item B<PKCS12_DECRYPT>
+=item B<HTTP>
 
-Traces PKCS#12 decryption.
+Traces the HTTP client and server, such as messages being sent and received.
 
-=item B<X509V3_POLICY>
+=item B<INIT>
 
-Generates the complete policy tree at various points during X.509 v3
-policy evaluation.
+Traces OpenSSL library initialization and cleanup.
 
-=item B<BN_CTX>
+=item B<PKCS12_DECRYPT>
 
-Traces BIGNUM context operations.
+Traces PKCS#12 decryption.
 
-=item B<CMP>
+=item B<PKCS12_KEYGEN>
 
-Traces CMP client and server activity.
+Traces PKCS#12 key generation.
 
-=item B<STORE>
+=item B<PKCS5V2>
 
-Traces STORE operations.
+Traces PKCS#5 v2 key generation.
 
-=item B<DECODER>
+=item B<PROVIDER>
 
-Traces decoder operations.
+Traces various operations that are performed on OpenSSL providers during their
+handling by the library (see L<provider(7)>), such as initialisation, tear down,
+parameter and capability retrieval, self-test, and so on.
 
-=item B<ENCODER>
+=item B<QUERY>
 
-Traces encoder operations.
+Traces operation related to addition, removal, and fetching of methods
+in the so-called method store, that holds pointers to functions provided
+by various providers.
 
 =item B<REF_COUNT>
 
@@ -197,21 +196,26 @@ including C<BIO>, C<DH>, C<DSA>, C<EC_KEY>, C<ECX_KEY>,
 C<EVP_PKEY>, C<EVP_SKEY>, C<RSA>, C<SSL>, C<SSL_CTX>, C<SSL_SESSION>,
 C<X509_CRL>, C<X509_STORE>, C<X509>, and some others.
 
-=item B<HTTP>
+=item B<STORE>
 
-Traces the HTTP client and server, such as messages being sent and received.
+Traces STORE operations.
 
-=item B<PROVIDER>
+=item B<TLS>
 
-Traces various operations that are performed on OpenSSL providers during their
-handling by the library (see L<provider(7)>), such as initialisation, tear down,
-parameter and capability retrieval, self-test, and so on.
+Traces the TLS/SSL protocol.
 
-=item B<QUERY>
+=item B<TLS_CIPHER>
 
-Traces operation related to addition, removal, and fetching of methods
-in the so-called method store, that holds pointers to functions provided
-by various providers.
+Traces the ciphers used by the TLS/SSL protocol.
+
+=item B<TRACE>
+
+Traces the OpenSSL trace API itself.
+
+=item B<X509V3_POLICY>
+
+Generates the complete policy tree at various points during X.509 v3
+policy evaluation.
 
 =back