]> git.ipfire.org Git - thirdparty/openssl.git/commitdiff
DOCS: Use "command" not "tool" or "utility"
authorRich Salz <rsalz@akamai.com>
Tue, 18 Feb 2020 16:52:12 +0000 (11:52 -0500)
committerRichard Levitte <levitte@openssl.org>
Wed, 11 Mar 2020 05:17:17 +0000 (06:17 +0100)
Reviewed-by: Paul Yang <kaishen.yy@antfin.com>
Reviewed-by: Richard Levitte <levitte@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/11123)

24 files changed:
doc/man1/openssl-asn1parse.pod.in
doc/man1/openssl-ca.pod.in
doc/man1/openssl-ciphers.pod.in
doc/man1/openssl-cms.pod.in
doc/man1/openssl-crl.pod.in
doc/man1/openssl-ocsp.pod.in
doc/man1/openssl-pkcs12.pod.in
doc/man1/openssl-pkcs7.pod.in
doc/man1/openssl-pkcs8.pod.in
doc/man1/openssl-pkey.pod.in
doc/man1/openssl-pkeyparam.pod.in
doc/man1/openssl-pkeyutl.pod.in
doc/man1/openssl-req.pod.in
doc/man1/openssl-rsa.pod.in
doc/man1/openssl-rsautl.pod.in
doc/man1/openssl-sess_id.pod.in
doc/man1/openssl-smime.pod.in
doc/man1/openssl-spkac.pod.in
doc/man1/openssl-storeutl.pod.in
doc/man1/openssl-ts.pod.in
doc/man1/openssl-verify.pod.in
doc/man1/openssl-x509.pod.in
doc/man1/openssl.pod
util/find-doc-nits

index 9b9596644070746f7e943ccd6f18526232faca15..e1c7f261a53ddf5aff6010134264d00f8f70420e 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-asn1parse - ASN.1 parsing tool
+openssl-asn1parse - ASN.1 parsing command
 
 =head1 SYNOPSIS
 
index a3c83d807639e4218656410661218d3c05a095a8..5192b25fa50c9c41efd245c135108d31ff78b66a 100644 (file)
@@ -155,8 +155,9 @@ Names and values of these options are algorithm-specific.
 =for openssl foreign manual ps(1)
 
 The password used to encrypt the private key. Since on some
-systems the command line arguments are visible (e.g. Unix with
-the L<ps(1)> utility) this option should be used with caution.
+systems the command line arguments are visible (e.g., when using
+L<ps(1)> on Unix),
+this option should be used with caution.
 
 =item B<-selfsign>
 
@@ -712,8 +713,8 @@ numbers of certificates are present because, as the name implies
 the database has to be kept in memory.
 
 This command really needs rewriting or the required functionality
-exposed at either a command or interface level so a more friendly utility
-(perl script or GUI) can handle things properly. The script
+exposed at either a command or interface level so that a more user-friendly
+replacement could handle things properly. The script
 B<CA.pl> helps a little but not very much.
 
 Any fields in a request that are not present in a policy are silently
index 6e6b150d241064682b01eee9822da8314fc86367..690c28705c651c706763f83d1eb7a717eeaec8ac 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-ciphers - SSL cipher display and cipher list tool
+openssl-ciphers - SSL cipher display and cipher list command
 
 =head1 SYNOPSIS
 
@@ -31,7 +31,7 @@ B<openssl> B<ciphers>
 =head1 DESCRIPTION
 
 This command converts textual OpenSSL cipher lists into
-ordered SSL cipher preference lists. It can be used as a test tool to
+ordered SSL cipher preference lists. It can be used to
 determine the appropriate cipherlist.
 
 =head1 OPTIONS
index 944135bbedcc677cc77975ccbd4f0175775d264c..5cf8172f2c052eacf92cba6b996d9c8d397cbaa1 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-cms - CMS utility
+openssl-cms - CMS command
 
 =head1 SYNOPSIS
 
index c1bd31a4a253a5c0cf7d1bef92084aac4f555c69..fd50602bc7d5586d84f2841fa0a7e019707213cd 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-crl - CRL utility
+openssl-crl - CRL command
 
 =head1 SYNOPSIS
 
index efa627b8a99885cdcddcfcf34cf33cc446375a45..2edbfc88878d4ac270060ef3031590b72c271d5e 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-ocsp - Online Certificate Status Protocol utility
+openssl-ocsp - Online Certificate Status Protocol command
 
 =head1 SYNOPSIS
 
index 631eec72825899ab9073d56a0aaa5e96427c9442..655f7180014c611092e6ddb4d40543b3cfd213eb 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-pkcs12 - PKCS#12 file utility
+openssl-pkcs12 - PKCS#12 file command
 
 =head1 SYNOPSIS
 
index 0a12d2379a87317ad9b78cdff950a603c0fbdba6..d31ae2a0a7f2a623ebaa4a23903acc3f63df021e 100644 (file)
@@ -7,7 +7,7 @@
 
 =head1 NAME
 
-openssl-pkcs7 - PKCS#7 utility
+openssl-pkcs7 - PKCS#7 command
 
 =head1 SYNOPSIS
 
index f9e5fb1dcb8ad1696a1b03f0d65c858d4b993f7f..38b50a6d14c9f4b5ea659acf8b23509c1cf4bccc 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-pkcs8 - PKCS#8 format private key conversion tool
+openssl-pkcs8 - PKCS#8 format private key conversion command
 
 =head1 SYNOPSIS
 
index 8460aed1fa3f9282fdc6d8456377431747c262b3..2785f298576ed173cd2a518da85a948969e615e3 100644 (file)
@@ -7,7 +7,7 @@
 
 =head1 NAME
 
-openssl-pkey - public or private key processing tool
+openssl-pkey - public or private key processing command
 
 =head1 SYNOPSIS
 
index 7f9d351ac2435a6ba400acea7905dedcf81dbb86..d5ea4012b42600c2a60b3186ec9b234a56978900 100644 (file)
@@ -7,7 +7,7 @@
 
 =head1 NAME
 
-openssl-pkeyparam - public key algorithm parameter processing tool
+openssl-pkeyparam - public key algorithm parameter processing command
 
 =head1 SYNOPSIS
 
index 0bca483871206ee885dc77d54fb9c8562ae411f2..583ea68734235f609c5dab15eea251f237263faf 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-pkeyutl - public key algorithm utility
+openssl-pkeyutl - public key algorithm command
 
 =head1 SYNOPSIS
 
index 7587cb5a71556a812d54341cd11c29904e74daae..ca3416e79996de0bb7f79d00ee756f9be917c4eb 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-req - PKCS#10 certificate request and certificate generating utility
+openssl-req - PKCS#10 certificate request and certificate generating command
 
 =head1 SYNOPSIS
 
index e2c0b24a1a0943f711f2241324b38d2af6c42f87..fa1a20ea45bd7990636cd5acc1591e74f83209a7 100644 (file)
@@ -7,7 +7,7 @@
 
 =head1 NAME
 
-openssl-rsa - RSA key processing tool
+openssl-rsa - RSA key processing command
 
 =head1 SYNOPSIS
 
index d28e672817f67da92c3dfbb520e22f9f7bd097e0..0bb0a136d3a333e31bc469e745bc88a9d88e6ce7 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-rsautl - RSA utility
+openssl-rsautl - RSA command
 
 =head1 SYNOPSIS
 
@@ -167,7 +167,7 @@ encrypt and decrypt the block would have been of type 2 (the second byte)
 and random padding data visible instead of the 0xff bytes.
 
 It is possible to analyse the signature of certificates using this
-utility in conjunction with L<openssl-asn1parse(1)>. Consider the self signed
+command in conjunction with L<openssl-asn1parse(1)>. Consider the self signed
 example in F<certs/pca-cert.pem>. Running L<openssl-asn1parse(1)> as follows
 yields:
 
index f68f1807391087719defc0444dd244fb2e34a96a..e18ef6f9c2026e1862b93a932c833823817fc802 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-sess_id - SSL/TLS session handling utility
+openssl-sess_id - SSL/TLS session handling command
 
 =head1 SYNOPSIS
 
index c6775505a97c6d7e3c2efd9c9d8dc907c487f1db..69bf9187435168e443afa9014eb8d853adb9414d 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-smime - S/MIME utility
+openssl-smime - S/MIME command
 
 =head1 SYNOPSIS
 
index 4ea15fa57ad3b012134a42b73979fe45c9bedb94..77e4d7ce08917b1d1a1d2d0d398a68d0be78ac04 100644 (file)
@@ -7,7 +7,7 @@
 
 =head1 NAME
 
-openssl-spkac - SPKAC printing and generating utility
+openssl-spkac - SPKAC printing and generating command
 
 =head1 SYNOPSIS
 
index 75c30651fcb64293d42d9f2b9b5f832d74bc4bf7..3de2059e0ceb254bda04d367ca123a4925cf9e46 100644 (file)
@@ -7,7 +7,7 @@
 
 =head1 NAME
 
-openssl-storeutl - STORE utility
+openssl-storeutl - STORE command
 
 =head1 SYNOPSIS
 
index 8d5e66e6d6dfc2b097e6372445fdc14e98cb4175..38fcf530fe808083c04757880f1306649ce7104e 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-ts - Time Stamping Authority tool (client/server)
+openssl-ts - Time Stamping Authority command
 
 =head1 SYNOPSIS
 
index fd41bbeb37dd49636f251a454aabf541ec6a7d10..7a15e73721ee25931faa6d0ed983ae57b80ad003 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-verify - Utility to verify certificates
+openssl-verify - certificate verification command
 
 =head1 SYNOPSIS
 
index 8cf03d937ef6a636a929afefd67641815b92cd26..98b4e71231f1e6a03c68283a3c2524343d5da2da 100644 (file)
@@ -3,7 +3,7 @@
 
 =head1 NAME
 
-openssl-x509 - Certificate display and signing utility
+openssl-x509 - Certificate display and signing command
 
 =head1 SYNOPSIS
 
@@ -81,7 +81,7 @@ B<openssl> B<x509>
 
 =head1 DESCRIPTION
 
-This command is a multi purpose certificate utility. It can
+This command is a multi-purposes certificate command. It can
 be used to display certificate information, convert certificates to
 various forms, sign certificate requests like a "mini CA" or edit
 certificate trust settings.
index ff66846337ac24ba1b775e7de9d4822a2eef71da..c05fc29f67bae49ade716bc92e019ba283f5e7db 100644 (file)
@@ -2,7 +2,7 @@
 
 =head1 NAME
 
-openssl - OpenSSL command line tool
+openssl - OpenSSL command line program
 
 =head1 SYNOPSIS
 
@@ -29,7 +29,7 @@ OpenSSL is a cryptography toolkit implementing the Secure Sockets Layer (SSL
 v2/v3) and Transport Layer Security (TLS v1) network protocols and related
 cryptography standards required by them.
 
-The B<openssl> program is a command line tool for using the various
+The B<openssl> program is a command line program for using the various
 cryptography functions of OpenSSL's B<crypto> library from the shell.
 It can be used for
 
@@ -104,7 +104,7 @@ Cipher Suite Description Determination.
 
 =item B<cms>
 
-CMS (Cryptographic Message Syntax) utility.
+CMS (Cryptographic Message Syntax) command.
 
 =item B<crl>
 
@@ -196,7 +196,7 @@ Create or examine a Netscape certificate sequence.
 
 =item B<ocsp>
 
-Online Certificate Status Protocol utility.
+Online Certificate Status Protocol command.
 
 =item B<passwd>
 
@@ -212,7 +212,7 @@ PKCS#7 Data Management.
 
 =item B<pkcs8>
 
-PKCS#8 format private key conversion tool.
+PKCS#8 format private key conversion command.
 
 =item B<pkey>
 
@@ -224,7 +224,7 @@ Public key algorithm parameter management.
 
 =item B<pkeyutl>
 
-Public key algorithm cryptographic operation utility.
+Public key algorithm cryptographic operation command.
 
 =item B<prime>
 
@@ -252,7 +252,7 @@ RSA key management.
 
 =item B<rsautl>
 
-RSA utility for signing, verification, encryption, and decryption. Superseded
+RSA command for signing, verification, encryption, and decryption. Superseded
 by  L<openssl-pkeyutl(1)>.
 
 =item B<s_client>
@@ -289,7 +289,7 @@ Algorithm Speed Measurement.
 
 =item B<spkac>
 
-SPKAC printing and generating utility.
+SPKAC printing and generating command.
 
 =item B<srp>
 
@@ -297,11 +297,11 @@ Maintain SRP password file.
 
 =item B<storeutl>
 
-Utility to list and display certificates, keys, CRLs, etc.
+Command to list and display certificates, keys, CRLs, etc.
 
 =item B<ts>
 
-Time Stamping Authority tool (client/server).
+Time Stamping Authority command.
 
 =item B<verify>
 
index f02edabcef18101a86e40088c2c798d3d785beec..c508e242fe8cde9f79ec3cf935c7573d177a32cf 100755 (executable)
@@ -601,6 +601,13 @@ sub wording {
     }
     err($id, "found 'epoch' should use 'Epoch'")
         if $contents =~ /\bepoch\b/;
+    if ( $id =~ m@man1/@ ) {
+        err($id, "found 'tool' in NAME, should use 'command'")
+            if $contents =~ /=head1 NAME.*\btool\b.*=head1 SYNOPSIS/s;
+        err($id, "found 'utility' in NAME, should use 'command'")
+            if $contents =~ /NAME.*\butility\b.*=head1 SYNOPSIS/s;
+
+    }
 }
 
 # Perform all sorts of nit/error checks on a manpage