From 3d841ba87ff41f9cab0d1623c1fa36f7b8bf2cd9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Veronika=20Hanul=C3=ADkov=C3=A1?= <vhanulik@redhat.com>
Date: Thu, 5 Oct 2023 13:48:07 +0200
Subject: [PATCH] Add base documentation for evp_test tool

---
 doc/build.info        |   6 +++
 doc/man1/evp_test.pod | 100 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 106 insertions(+)
 create mode 100644 doc/man1/evp_test.pod

diff --git a/doc/build.info b/doc/build.info
index aec4ae616fb407..ac0cd2d5f91d78 100644
--- a/doc/build.info
+++ b/doc/build.info
@@ -4,6 +4,10 @@ DEPEND[html/man1/CA.pl.html]=man1/CA.pl.pod
 GENERATE[html/man1/CA.pl.html]=man1/CA.pl.pod
 DEPEND[man/man1/CA.pl.1]=man1/CA.pl.pod
 GENERATE[man/man1/CA.pl.1]=man1/CA.pl.pod
+DEPEND[html/man1/evp_test.html]=man1/evp_test.pod
+GENERATE[html/man1/evp_test.html]=man1/evp_test.pod
+DEPEND[man/man1/evp_test.1]=man1/evp_test.pod
+GENERATE[man/man1/evp_test.1]=man1/evp_test.pod
 DEPEND[html/man1/openssl-asn1parse.html]=man1/openssl-asn1parse.pod
 GENERATE[html/man1/openssl-asn1parse.html]=man1/openssl-asn1parse.pod
 DEPEND[man/man1/openssl-asn1parse.1]=man1/openssl-asn1parse.pod
@@ -348,6 +352,7 @@ DEPEND[man/man1/tsget.1]=man1/tsget.pod
 GENERATE[man/man1/tsget.1]=man1/tsget.pod
 IMAGEDOCS[man1]=
 HTMLDOCS[man1]=html/man1/CA.pl.html \
+html/man1/evp_test.html \
 html/man1/openssl-asn1parse.html \
 html/man1/openssl-ca.html \
 html/man1/openssl-ciphers.html \
@@ -408,6 +413,7 @@ html/man1/openssl-x509.html \
 html/man1/openssl.html \
 html/man1/tsget.html
 MANDOCS[man1]=man/man1/CA.pl.1 \
+man/man1/evp_test.1 \
 man/man1/openssl-asn1parse.1 \
 man/man1/openssl-ca.1 \
 man/man1/openssl-ciphers.1 \
diff --git a/doc/man1/evp_test.pod b/doc/man1/evp_test.pod
new file mode 100644
index 00000000000000..4db292369efd3b
--- /dev/null
+++ b/doc/man1/evp_test.pod
@@ -0,0 +1,100 @@
+=pod
+
+=head1 NAME
+
+evp_test - OpenSSL EVP test command line program
+
+=head1 SYNOPSIS
+
+B<evp_test>
+I<command>
+[ I<options> ... ]
+[ I<test file> ]
+
+B<evp_test> B<-help> | B<-version>
+
+=head1 DESCRIPTION
+
+Test tool for various implementations of crypto algorithms.
+
+=head1 COMMAND SUMMARY
+
+=head2 Configuration Option
+
+The B<-config> option to specify configuration file.
+
+=head1 OPTIONS
+
+This section describes some available options.
+
+=head2 Test Options
+
+=over 4
+
+=item B<-help>
+
+Provides a terse summary of all options.
+For more detailed information, each command supports a B<-help> option.
+Accepts B<--help> as well.
+
+=item B<-version>
+
+Provides a terse summary of the B<openssl> program version.
+For more detailed information see L<openssl-version(1)>.
+Accepts B<--version> as well.
+
+=back
+
+=head2 Common Options
+
+=over 4
+
+=item B<-help>
+
+If an option takes an argument, the "type" of argument is also given.
+
+=item B<-->
+
+This terminates the list of options. It is mostly useful if any filename
+parameters start with a minus sign:
+
+ openssl verify [flags...] -- -cert1.pem...
+
+=back
+
+=head2 Provider Options
+
+=over 4
+
+=item B<-provider> I<name>
+
+Load and initialize the provider identified by I<name>. The I<name>
+can be also a path to the provider module. In that case the provider name
+will be the specified path and not just the provider module name.
+Interpretation of relative paths is platform specific. The configured
+"MODULESDIR" path, B<OPENSSL_MODULES> environment variable, or the path
+specified by B<-provider-path> is prepended to relative paths.
+See L<provider(7)> for a more detailed description.
+
+=item B<-propquery> I<propq>
+
+Specifies the I<property query clause> to be used when fetching algorithms
+from the loaded providers.
+See L<property(7)> for a more detailed description.
+
+=back
+
+=head1 SEE ALSO
+
+L<openssl(1)>
+
+=head1 COPYRIGHT
+
+Copyright 2000-2023 The OpenSSL Project Authors. All Rights Reserved.
+
+Licensed under the Apache License 2.0 (the "License").  You may not use
+this file except in compliance with the License.  You can obtain a copy
+in the file LICENSE in the source distribution or at
+L<https://www.openssl.org/source/license.html>.
+
+=cut