Merge one sentence and the references from dsa(3) to DSA_new(3) and

discard the rest of the text.  There is no value in documenting
some of the fields of a structure and then going on to say that the
structure is intended as opaque.  Besides, i doubt that we want
such strong marketing of ENGINE support.

1 files changed, 0 insertions, 74 deletions

diff --git a/src/lib/libcrypto/man/dsa.3 b/src/lib/libcrypto/man/dsa.3
deleted file mode 100644
index 78493635fb..0000000000
--- a/src/lib/libcrypto/man/dsa.3
+++ /dev/null
@@ -1,74 +0,0 @@
-.\"     $OpenBSD: dsa.3,v 1.5 2016/12/10 22:22:59 schwarze Exp $
-.\"
-.Dd $Mdocdate: December 10 2016 $
-.Dt DSA 3
-.Os
-.Sh NAME
-.Nm dsa
-.Nd Digital Signature Algorithm
-.Sh SYNOPSIS
-.In openssl/dsa.h
-.Sh DESCRIPTION
-These functions implement the Digital Signature Algorithm (DSA).
-The generation of shared DSA parameters is described in
-.Xr DSA_generate_parameters 3 ;
-.Xr DSA_generate_key 3
-describes how to generate a signature key.
-Signature generation and verification are described in
-.Xr DSA_sign 3 .
-.Pp
-The
-.Vt DSA
-structure consists of several BIGNUM components.
-.Bd -literal
-typedef struct {
-        BIGNUM *p;              // prime number (public)
-        BIGNUM *q;              // 160-bit subprime, q | p-1 (public)
-        BIGNUM *g;              // generator of subgroup (public)
-        BIGNUM *priv_key;       // private key x
-        BIGNUM *pub_key;        // public key y = g^x
-        // ...
-} DSA;
-.Ed
-.Pp
-In public keys,
-.Fa priv_key
-is
-.Dv NULL .
-.Pp
-Note that DSA keys may use non-standard
-.Vt DSA_METHOD
-implementations, either directly or by the use of
-.Vt ENGINE
-modules.
-In some cases (e.g. an
-.Vt ENGINE
-providing support for hardware-embedded keys), these
-.Vt BIGNUM
-values will not be used by the implementation or may be used for
-alternative data storage.
-For this reason, applications should generally avoid using
-.Vt DSA
-structure elements directly and instead use API functions to query
-or modify keys.
-.Sh SEE ALSO
-.Xr BN_new 3 ,
-.Xr d2i_DSAPublicKey 3 ,
-.Xr DH_new 3 ,
-.Xr DSA_do_sign 3 ,
-.Xr DSA_dup_DH 3 ,
-.Xr DSA_generate_key 3 ,
-.Xr DSA_generate_parameters 3 ,
-.Xr DSA_get_ex_new_index 3 ,
-.Xr DSA_new 3 ,
-.Xr DSA_print 3 ,
-.Xr DSA_set_method 3 ,
-.Xr DSA_SIG_new 3 ,
-.Xr DSA_sign 3 ,
-.Xr DSA_size 3 ,
-.Xr engine 3 ,
-.Xr ERR 3 ,
-.Xr rsa 3
-.Sh STANDARDS
-US Federal Information Processing Standard FIPS 186 (Digital Signature
-Standard, DSS), ANSI X9.30