> I like the idea! I agree.
> To me it would be more logical to put .Tg above .Sh, but that is a minor > thing. I also think that it would better to place .Tg above .Sh . On Mon, Feb 17, 2020 at 11:20:34PM +0100, Remi Locherer wrote: > On Mon, Feb 17, 2020 at 05:19:27PM +0100, Klemens Nanni wrote: > > > > I'd like to commit this soon, it allows me to jump to the command I'm > > looking for, e.g. ":tx509<Enter>" shows me the synopsis right away. > > > > FWIW, some Linux distributions ship with separate manuals, e.g. x509(1SSL). > > > > Patch was done with a VIM macro by adding a new line after each `.Sh' > > line with the respective name but lowercased, so no typos in the added > > strings. > > > > Specifying it is required since the markup following the `.Tg' markup > > always starts with "openssl"; the tag must not include it (`.Tg' > > accepts at most one word anyway). > > > > I like the idea! > > To me it would be more logical to put .Tg above .Sh, but that is a minor > thing. > > > > > Index: openssl.1 > > =================================================================== > > RCS file: /cvs/src/usr.bin/openssl/openssl.1,v > > retrieving revision 1.119 > > diff -u -p -U1 -r1.119 openssl.1 > > --- openssl.1 16 Feb 2020 16:39:01 -0000 1.119 > > +++ openssl.1 17 Feb 2020 16:11:22 -0000 > > @@ -203,2 +203,3 @@ itself. > > .Sh ASN1PARSE > > +.Tg asn1parse > > .Bl -hang -width "openssl asn1parse" > > @@ -299,2 +300,3 @@ into a nested structure. > > .Sh CA > > +.Tg ca > > .Bl -hang -width "openssl ca" > > @@ -848,2 +850,3 @@ The same as > > .Sh CIPHERS > > +.Tg ciphers > > .Nm openssl ciphers > > @@ -880,2 +883,3 @@ but without cipher suite codes. > > .Sh CMS > > +.Tg cms > > .Bl -hang -width "openssl cms" > > @@ -1396,2 +1400,3 @@ is specified. > > .Sh CRL > > +.Tg crl > > .Bl -hang -width "openssl crl" > > @@ -1472,2 +1477,3 @@ Verify the signature on the CRL. > > .Sh CRL2PKCS7 > > +.Tg crl2pkcs7 > > .Bl -hang -width "openssl crl2pkcs7" > > @@ -1517,2 +1523,3 @@ The output format. > > .Sh DGST > > +.Tg dgst > > .Bl -hang -width "openssl dgst" > > @@ -1631,2 +1638,3 @@ If no files are specified then standard > > .Sh DHPARAM > > +.Tg dhparam > > .Bl -hang -width "openssl dhparam" > > @@ -1707,2 +1715,3 @@ parameters are generated instead. > > .Sh DSA > > +.Tg dsa > > .Bl -hang -width "openssl dsa" > > @@ -1795,2 +1804,3 @@ Print the public/private key in plain te > > .Sh DSAPARAM > > +.Tg dsaparam > > .Bl -hang -width "openssl dsaparam" > > @@ -1847,2 +1857,3 @@ If this option is included, the input fi > > .Sh EC > > +.Tg ec > > .Bl -hang -width "openssl ec" > > @@ -1959,2 +1970,3 @@ Print the public/private key in plain te > > .Sh ECPARAM > > +.Tg ecparam > > .Bl -hang -width "openssl ecparam" > > @@ -2054,2 +2066,3 @@ Print the EC parameters in plain text. > > .Sh ENC > > +.Tg enc > > .Bl -hang -width "openssl enc" > > @@ -2217,2 +2230,3 @@ Print extra details about the processing > > .Sh ERRSTR > > +.Tg errstr > > .Nm openssl errstr > > @@ -2247,2 +2261,3 @@ Print debugging statistics about various > > .Sh GENDSA > > +.Tg gendsa > > .Bl -hang -width "openssl gendsa" > > @@ -2293,2 +2308,3 @@ The parameters in this file determine th > > .Sh GENPKEY > > +.Tg genpkey > > .Bl -hang -width "openssl genpkey" > > @@ -2397,2 +2413,3 @@ Print the private/public key in plain te > > .Sh GENRSA > > +.Tg genrsa > > .Bl -hang -width "openssl genrsa" > > @@ -2454,2 +2471,3 @@ The default is 2048. > > .Sh NSEQ > > +.Tg nseq > > .Nm openssl nseq > > @@ -2484,2 +2502,3 @@ a Netscape certificate sequence is creat > > .Sh OCSP > > +.Tg ocsp > > .Bl -hang -width "openssl ocsp" > > @@ -2836,2 +2855,3 @@ option. > > .Sh PASSWD > > +.Tg passwd > > .Bl -hang -width "openssl passwd" > > @@ -2899,2 +2919,3 @@ to each password hash. > > .Sh PKCS7 > > +.Tg pkcs7 > > .Bl -hang -width "openssl pkcs7" > > @@ -2944,2 +2965,3 @@ Print certificate details in full rather > > .Sh PKCS8 > > +.Tg pkcs8 > > .Bl -hang -width "openssl pkcs8" > > @@ -3027,2 +3049,3 @@ It is recommended that des3 is used. > > .Sh PKCS12 > > +.Tg pkcs12 > > .Bl -hang -width "openssl pkcs12" > > @@ -3244,2 +3267,3 @@ is equivalent to > > .Sh PKEY > > +.Tg pkey > > .Bl -hang -width "openssl pkey" > > @@ -3307,2 +3331,3 @@ even if a private key is being processed > > .Sh PKEYPARAM > > +.Tg pkeyparam > > .Cm openssl pkeyparam > > @@ -3332,2 +3357,3 @@ Print the parameters in plain text. > > .Sh PKEYUTL > > +.Tg pkeyutl > > .Bl -hang -width "openssl pkeyutl" > > @@ -3484,2 +3510,3 @@ Verify the input data and output the rec > > .Sh PRIME > > +.Tg prime > > .Cm openssl prime > > @@ -3528,2 +3555,3 @@ is prime. > > .Sh RAND > > +.Tg rand > > .Bl -hang -width "openssl rand" > > @@ -3555,2 +3583,3 @@ or standard output if not specified. > > .Sh REQ > > +.Tg req > > .Bl -hang -width "openssl req" > > @@ -4004,2 +4033,3 @@ Any additional fields will be treated as > > .Sh RSA > > +.Tg rsa > > .Bl -hang -width "openssl rsa" > > @@ -4101,2 +4131,3 @@ Print the public/private key components > > .Sh RSAUTL > > +.Tg rsautl > > .Bl -hang -width "openssl rsautl" > > @@ -4175,2 +4206,3 @@ Verify the input data and output the rec > > .Sh S_CLIENT > > +.Tg s_client > > .Bl -hang -width "openssl s_client" > > @@ -4473,2 +4505,3 @@ will be used. > > .Sh S_SERVER > > +.Tg s_server > > .Bl -hang -width "openssl s_server" > > @@ -4778,2 +4811,3 @@ a certificate is requested but the clien > > .Sh S_TIME > > +.Tg s_time > > .Bl -hang -width "openssl s_time" > > @@ -4888,2 +4922,3 @@ but not transfer any payload data. > > .Sh SESS_ID > > +.Tg sess_id > > .Bl -hang -width "openssl sess_id" > > @@ -4980,2 +5015,3 @@ debugging purposes. > > .Sh SMIME > > +.Tg smime > > .Bl -hang -width "openssl smime" > > @@ -5276,2 +5312,3 @@ An error occurred writing certificates. > > .Sh SPEED > > +.Tg speed > > .Bl -hang -width "openssl speed" > > @@ -5313,2 +5350,3 @@ benchmarks in parallel. > > .Sh SPKAC > > +.Tg spkac > > .Bl -hang -width "openssl spkac" > > @@ -5374,2 +5412,3 @@ Verify the digital signature on the supp > > .Sh TS > > +.Tg ts > > .Bk -words > > @@ -5736,2 +5775,3 @@ The default is no. > > .Sh VERIFY > > +.Tg verify > > .Bl -hang -width "openssl verify" > > @@ -6063,2 +6103,3 @@ Unused. > > .Sh VERSION > > +.Tg version > > .Nm openssl version > > @@ -6094,2 +6135,3 @@ version. > > .Sh X509 > > +.Tg x509 > > .Bl -hang -width "openssl x509" > > >
