From: Rich Salz Date: Mon, 17 Aug 2015 19:21:33 +0000 (-0400) Subject: Fix L<> content in manpages X-Git-Tag: OpenSSL_1_1_0-pre1~793 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9b86974e0c705ea321ddbc9a9d8562c894809e5b;p=thirdparty%2Fopenssl.git Fix L<> content in manpages L is sub-optimal If the xref is the same as the title, which is what we do, then you only need L. This fixes all 1457 occurrences in 349 files. Approximately. (And pod used to need both.) Reviewed-by: Richard Levitte --- diff --git a/doc/apps/CA.pl.pod b/doc/apps/CA.pl.pod index 92ae288748d..35a40aae9d8 100644 --- a/doc/apps/CA.pl.pod +++ b/doc/apps/CA.pl.pod @@ -128,7 +128,7 @@ the request and finally create a PKCS#12 file containing it. =head1 DSA CERTIFICATES Although the B creates RSA CAs and requests it is still possible to -use it with DSA certificates and requests using the L command +use it with DSA certificates and requests using the L command directly. The following example shows the steps that would typically be taken. Create some DSA parameters: @@ -184,7 +184,7 @@ configuration file, not just its directory. =head1 SEE ALSO -L, L, L, L, -L +L, L, L, L, +L =cut diff --git a/doc/apps/asn1parse.pod b/doc/apps/asn1parse.pod index b44fb9fd3de..afe94b09d8c 100644 --- a/doc/apps/asn1parse.pod +++ b/doc/apps/asn1parse.pod @@ -83,7 +83,7 @@ option can be used multiple times to "drill down" into a nested structure. =item B<-genstr string>, B<-genconf file> generate encoded data based on B, B or both using -L format. If B only is +L format. If B only is present then the string is obtained from the default section using the name B. The encoded data is passed through the ASN1 parser and printed out as though it came from a file, the contents can thus be examined and written to a @@ -189,6 +189,6 @@ ASN.1 types is not well handled (if at all). =head1 SEE ALSO -L +L =cut diff --git a/doc/apps/c_rehash.pod b/doc/apps/c_rehash.pod index c3d98b678ea..e0a3d1995b8 100644 --- a/doc/apps/c_rehash.pod +++ b/doc/apps/c_rehash.pod @@ -109,6 +109,6 @@ Ignored if directories are listed on the command line. =head1 SEE ALSO -L, -L. -L. +L, +L. +L. diff --git a/doc/apps/ca.pod b/doc/apps/ca.pod index 1d180706cc7..be0153a4b0d 100644 --- a/doc/apps/ca.pod +++ b/doc/apps/ca.pod @@ -141,7 +141,7 @@ self-signed certificate. =item B<-passin arg> the key password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-verbose> @@ -214,7 +214,7 @@ to be added when a certificate is issued (defaults to B unless the B<-extfile> option is used). If no extension section is present then, a V1 certificate is created. If the extension section is present (even if it is empty), then a V3 certificate is created. See the:w -L manual page for details of the +L manual page for details of the extension section format. =item B<-extfile file> @@ -319,7 +319,7 @@ created, if the CRL extension section is present (even if it is empty) then a V2 CRL is created. The CRL extensions specified are CRL extensions and B CRL entry extensions. It should be noted that some software (for example Netscape) can't handle V2 CRLs. See -L manual page for details of the +L manual page for details of the extension section format. =back @@ -380,7 +380,7 @@ CA private key. Mandatory. =item B a file used to read and write random number seed information, or -an EGD socket (see L). +an EGD socket (see L). =item B @@ -690,7 +690,7 @@ then even if a certificate is issued with CA:TRUE it will not be valid. =head1 SEE ALSO -L, L, L, L, -L, L +L, L, L, L, +L, L =cut diff --git a/doc/apps/ciphers.pod b/doc/apps/ciphers.pod index 3f146e8893c..64f122ffed0 100644 --- a/doc/apps/ciphers.pod +++ b/doc/apps/ciphers.pod @@ -721,7 +721,7 @@ Set security level to 2 and display all ciphers consistent with level 2: =head1 SEE ALSO -L, L, L +L, L, L =head1 HISTORY diff --git a/doc/apps/cms.pod b/doc/apps/cms.pod index 9001371a635..6b4beb4c277 100644 --- a/doc/apps/cms.pod +++ b/doc/apps/cms.pod @@ -434,12 +434,12 @@ or to modify default parameters for ECDH. =item B<-passin arg> the private key password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-rand file(s)> a file or files containing random data used to seed the random number -generator, or an EGD socket (see L). +generator, or an EGD socket (see L). Multiple files can be specified separated by a OS-dependent character. The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for all others. @@ -465,7 +465,7 @@ B<-use_deltas>, B<-verify_depth>, B<-verify_email>, B<-verify_hostname>, B<-verify_ip>, B<-verify_name>, B<-x509_strict> Set various certificate chain validation options. See the -L|verify(1)> manual page for details. +L manual page for details. =back @@ -515,7 +515,7 @@ tried whether they succeed or not and if no recipients match the message is "decrypted" using a random key which will typically output garbage. The B<-debug_decrypt> option can be used to disable the MMA attack protection and return an error if no recipient can be found: this option should be used -with caution. For a fuller description see L). +with caution. For a fuller description see L). =head1 EXIT CODES diff --git a/doc/apps/config.pod b/doc/apps/config.pod index e12591528c0..22bb6c50a8c 100644 --- a/doc/apps/config.pod +++ b/doc/apps/config.pod @@ -345,6 +345,6 @@ file. =head1 SEE ALSO -L, L, L +L, L, L =cut diff --git a/doc/apps/crl.pod b/doc/apps/crl.pod index 044a9da9154..7dccbcc67ff 100644 --- a/doc/apps/crl.pod +++ b/doc/apps/crl.pod @@ -57,7 +57,7 @@ print out the CRL in text form. =item B<-nameopt option> option which determines how the subject or issuer names are displayed. See -the description of B<-nameopt> in L. +the description of B<-nameopt> in L. =item B<-noout> @@ -123,6 +123,6 @@ and files too. =head1 SEE ALSO -L, L, L +L, L, L =cut diff --git a/doc/apps/crl2pkcs7.pod b/doc/apps/crl2pkcs7.pod index 3797bc0df4e..1a6e362c6a2 100644 --- a/doc/apps/crl2pkcs7.pod +++ b/doc/apps/crl2pkcs7.pod @@ -86,6 +86,6 @@ install user certificates and CAs in MSIE using the Xenroll control. =head1 SEE ALSO -L +L =cut diff --git a/doc/apps/dgst.pod b/doc/apps/dgst.pod index 236e1b783a6..8c416f26aa3 100644 --- a/doc/apps/dgst.pod +++ b/doc/apps/dgst.pod @@ -101,7 +101,7 @@ Names and values of these options are algorithm-specific. =item B<-passin arg> the private key password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-verify filename> @@ -152,7 +152,7 @@ for example exactly 32 chars for gost-mac. =item B<-rand file(s)> a file or files containing random data used to seed the random number -generator, or an EGD socket (see L). +generator, or an EGD socket (see L). Multiple files can be specified separated by a OS-dependent character. The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for all others. diff --git a/doc/apps/dhparam.pod b/doc/apps/dhparam.pod index 1cd4c76663c..8bb196dea49 100644 --- a/doc/apps/dhparam.pod +++ b/doc/apps/dhparam.pod @@ -79,7 +79,7 @@ default generator 2. =item B<-rand> I a file or files containing random data used to seed the random number -generator, or an EGD socket (see L). +generator, or an EGD socket (see L). Multiple files can be specified separated by a OS-dependent character. The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for all others. @@ -139,7 +139,7 @@ There should be a way to generate and manipulate DH keys. =head1 SEE ALSO -L +L =head1 HISTORY diff --git a/doc/apps/dsa.pod b/doc/apps/dsa.pod index 8bf6cc9dcad..4331cc379e8 100644 --- a/doc/apps/dsa.pod +++ b/doc/apps/dsa.pod @@ -66,7 +66,7 @@ prompted for. =item B<-passin arg> the input file password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-out filename> @@ -78,7 +78,7 @@ filename. =item B<-passout arg> the output file password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-aes128|-aes192|-aes256|-camellia128|-camellia192|-camellia256|-des|-des3|-idea> @@ -158,7 +158,7 @@ To just output the public part of a private key: =head1 SEE ALSO -L, L, L, -L +L, L, L, +L =cut diff --git a/doc/apps/dsaparam.pod b/doc/apps/dsaparam.pod index ba5ec4d72cd..1933857b6f2 100644 --- a/doc/apps/dsaparam.pod +++ b/doc/apps/dsaparam.pod @@ -72,7 +72,7 @@ parameters. =item B<-rand file(s)> a file or files containing random data used to seed the random number -generator, or an EGD socket (see L). +generator, or an EGD socket (see L). Multiple files can be specified separated by a OS-dependent character. The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for all others. @@ -104,7 +104,7 @@ DSA parameters is often used to generate several distinct keys. =head1 SEE ALSO -L, L, L, -L +L, L, L, +L =cut diff --git a/doc/apps/ec.pod b/doc/apps/ec.pod index 5c7b45d4e75..ebc49ea0923 100644 --- a/doc/apps/ec.pod +++ b/doc/apps/ec.pod @@ -60,7 +60,7 @@ prompted for. =item B<-passin arg> the input file password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-out filename> @@ -72,7 +72,7 @@ filename. =item B<-passout arg> the output file password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-des|-des3|-idea> @@ -177,7 +177,7 @@ To change the point conversion form to B: =head1 SEE ALSO -L, L, L +L, L, L =head1 HISTORY diff --git a/doc/apps/ecparam.pod b/doc/apps/ecparam.pod index 88e9d1e83d0..bfb155a82aa 100644 --- a/doc/apps/ecparam.pod +++ b/doc/apps/ecparam.pod @@ -114,7 +114,7 @@ This option will generate a EC private key using the specified parameters. =item B<-rand file(s)> a file or files containing random data used to seed the random number -generator, or an EGD socket (see L). +generator, or an EGD socket (see L). Multiple files can be specified separated by a OS-dependent character. The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for all others. @@ -166,7 +166,7 @@ To print out the EC parameters to standard output: =head1 SEE ALSO -L, L +L, L =head1 HISTORY diff --git a/doc/apps/enc.pod b/doc/apps/enc.pod index 8f4ef999b4e..1d25cf3dfc8 100644 --- a/doc/apps/enc.pod +++ b/doc/apps/enc.pod @@ -53,7 +53,7 @@ the output filename, standard output by default. =item B<-pass arg> the password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-salt> diff --git a/doc/apps/errstr.pod b/doc/apps/errstr.pod index b3c6ccfc9cb..02bd3dcd7b3 100644 --- a/doc/apps/errstr.pod +++ b/doc/apps/errstr.pod @@ -31,9 +31,9 @@ to produce the error message: =head1 SEE ALSO -L, -L, -L +L, +L, +L =cut diff --git a/doc/apps/gendsa.pod b/doc/apps/gendsa.pod index d9f56be890f..9a8278fdbd8 100644 --- a/doc/apps/gendsa.pod +++ b/doc/apps/gendsa.pod @@ -39,7 +39,7 @@ If none of these options is specified no encryption is used. =item B<-rand file(s)> a file or files containing random data used to seed the random number -generator, or an EGD socket (see L). +generator, or an EGD socket (see L). Multiple files can be specified separated by a OS-dependent character. The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for all others. @@ -66,7 +66,7 @@ much quicker that RSA key generation for example. =head1 SEE ALSO -L, L, L, -L +L, L, L, +L =cut diff --git a/doc/apps/genpkey.pod b/doc/apps/genpkey.pod index 0bce0b520f3..d574caa867b 100644 --- a/doc/apps/genpkey.pod +++ b/doc/apps/genpkey.pod @@ -38,7 +38,7 @@ This specifies the output format DER or PEM. =item B<-pass arg> the output file password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-cipher> diff --git a/doc/apps/genrsa.pod b/doc/apps/genrsa.pod index cb03d09b95e..c27f773b363 100644 --- a/doc/apps/genrsa.pod +++ b/doc/apps/genrsa.pod @@ -46,7 +46,7 @@ used. =item B<-passout arg> the output file password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-aes128|-aes192|-aes256|-camellia128|-camellia192|-camellia256|-des|-des3|-idea> @@ -62,7 +62,7 @@ the public exponent to use, either 65537 or 3. The default is 65537. =item B<-rand file(s)> a file or files containing random data used to seed the random number -generator, or an EGD socket (see L). +generator, or an EGD socket (see L). Multiple files can be specified separated by a OS-dependent character. The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for all others. @@ -102,7 +102,7 @@ be much larger (typically 1024 bits). =head1 SEE ALSO -L +L =cut diff --git a/doc/apps/openssl.pod b/doc/apps/openssl.pod index 3e651b89d69..d996edaed85 100644 --- a/doc/apps/openssl.pod +++ b/doc/apps/openssl.pod @@ -396,19 +396,19 @@ read the password from standard input. =head1 SEE ALSO -L, L, L, -L, L, L, -L, L, L, -L, L, L, -L, L, L, -L, -L, L, L, -L, L, L, -L, L, -L, L, -L, L, -L, L, L, -L, L, L +L, L, L, +L, L, L, +L, L, L, +L, L, L, +L, L, L, +L, +L, L, L, +L, L, L, +L, L, +L, L, +L, L, +L, L, L, +L, L, L =head1 HISTORY diff --git a/doc/apps/pkcs12.pod b/doc/apps/pkcs12.pod index 744984838dc..f956c8ed646 100644 --- a/doc/apps/pkcs12.pod +++ b/doc/apps/pkcs12.pod @@ -71,13 +71,13 @@ default. They are all written in PEM format. the PKCS#12 file (i.e. input file) password source. For more information about the format of B see the B section in -L. +L. =item B<-passout arg> pass phrase source to encrypt any outputted private keys with. For more information about the format of B see the B section -in L. +in L. =item B<-password arg> @@ -192,13 +192,13 @@ displays them. the PKCS#12 file (i.e. output file) password source. For more information about the format of B see the B section in -L. +L. =item B<-passin password> pass phrase source to decrypt any input private keys with. For more information about the format of B see the B section in -L. +L. =item B<-chain> @@ -266,7 +266,7 @@ don't attempt to provide the MAC integrity. =item B<-rand file(s)> a file or files containing random data used to seed the random number -generator, or an EGD socket (see L). +generator, or an EGD socket (see L). Multiple files can be specified separated by a OS-dependent character. The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for all others. @@ -364,5 +364,5 @@ file from the keys and certificates using a newer version of OpenSSL. For exampl =head1 SEE ALSO -L +L diff --git a/doc/apps/pkcs7.pod b/doc/apps/pkcs7.pod index acfb8100f07..024175e1cbe 100644 --- a/doc/apps/pkcs7.pod +++ b/doc/apps/pkcs7.pod @@ -100,6 +100,6 @@ cannot currently parse, for example, the new CMS as described in RFC2630. =head1 SEE ALSO -L +L =cut diff --git a/doc/apps/pkcs8.pod b/doc/apps/pkcs8.pod index 433e55c6fd4..ed8c4ade62c 100644 --- a/doc/apps/pkcs8.pod +++ b/doc/apps/pkcs8.pod @@ -67,7 +67,7 @@ prompted for. =item B<-passin arg> the input file password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-out filename> @@ -79,7 +79,7 @@ filename. =item B<-passout arg> the output file password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-iter count> @@ -276,8 +276,8 @@ the old format at present. =head1 SEE ALSO -L, L, L, -L +L, L, L, +L =head1 HISTORY diff --git a/doc/apps/pkey.pod b/doc/apps/pkey.pod index 4851223f3fc..68f94099913 100644 --- a/doc/apps/pkey.pod +++ b/doc/apps/pkey.pod @@ -49,7 +49,7 @@ prompted for. =item B<-passin arg> the input file password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-out filename> @@ -61,7 +61,7 @@ filename. =item B<-passout password> the output file password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-cipher> @@ -129,7 +129,7 @@ To just output the public part of a private key: =head1 SEE ALSO -L, L, L, -L, L, L +L, L, L, +L, L, L =cut diff --git a/doc/apps/pkeyparam.pod b/doc/apps/pkeyparam.pod index 154f6721af4..acfe9f9eeaf 100644 --- a/doc/apps/pkeyparam.pod +++ b/doc/apps/pkeyparam.pod @@ -63,7 +63,7 @@ PEM format is supported because the key type is determined by the PEM headers. =head1 SEE ALSO -L, L, L, -L, L, L +L, L, L, +L, L, L =cut diff --git a/doc/apps/pkeyutl.pod b/doc/apps/pkeyutl.pod index 1f7596da173..b43763554e1 100644 --- a/doc/apps/pkeyutl.pod +++ b/doc/apps/pkeyutl.pod @@ -59,7 +59,7 @@ the key format PEM, DER or ENGINE. =item B<-passin arg> the input key password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-peerkey file> @@ -218,5 +218,5 @@ Derive a shared secret value: =head1 SEE ALSO -L, L, L -L, L, L +L, L, L +L, L, L diff --git a/doc/apps/rand.pod b/doc/apps/rand.pod index d1d213ef43c..3679e6bef0e 100644 --- a/doc/apps/rand.pod +++ b/doc/apps/rand.pod @@ -32,7 +32,7 @@ Write to I instead of standard output. =item B<-rand> I -Use specified file or files or EGD socket (see L) +Use specified file or files or EGD socket (see L) for seeding the random number generator. Multiple files can be specified separated by a OS-dependent character. The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for @@ -50,6 +50,6 @@ Show the output as a hex string. =head1 SEE ALSO -L +L =cut diff --git a/doc/apps/req.pod b/doc/apps/req.pod index 2ce2bca2c31..ae884a209b8 100644 --- a/doc/apps/req.pod +++ b/doc/apps/req.pod @@ -79,7 +79,7 @@ options (B<-new> and B<-newkey>) are not specified. =item B<-passin arg> the input file password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-out filename> @@ -89,7 +89,7 @@ default. =item B<-passout arg> the output file password source. For more information about the format of B -see the B section in L. +see the B section in L. =item B<-text> @@ -137,7 +137,7 @@ characters may be escaped by \ (backslash), no spaces are skipped. =item B<-rand file(s)> a file or files containing random data used to seed the random number -generator, or an EGD socket (see L). +generator, or an EGD socket (see L). Multiple files can be specified separated by a OS-dependent character. The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for all others. @@ -270,14 +270,14 @@ configuration file, must be valid UTF8 strings. option which determines how the subject or issuer names are displayed. The B