On Sun, Feb 24, 2019 at 10:09:43PM +0100, Matthias Schmidt wrote: > Hi, > > while looking at signify's man page I noticed that the names of the > arguments in the EXAMPLES section change (newkey.sec vs key.sec, etc). > The diff harmonizes the examples. It makes it easier to follow the examples. > > Cheers > > Matthias > > diff --git signify.1 signify.1 > index de3b433e3b0..9f7335352a2 100644 > --- signify.1 > +++ signify.1 > @@ -153,13 +153,13 @@ The message file is too large. > .El > .Sh EXAMPLES > Create a new key pair: > -.Dl $ signify -G -p newkey.pub -s newkey.sec > +.Dl $ signify -G -p key.pub -s key.sec > .Pp > Sign a file, specifying a signature name: > -.Dl $ signify -S -s key.sec -m message.txt -x msg.sig > +.Dl $ signify -S -s key.sec -m message -x message.sig
Your mileage may vary, but this makes things harder to follow for me. Obviously visually differentiating between creating new keys and using existing ones makes a lot of sense for me. Especially since the examples are not meant to be chained together, at all. This is a reference manual, not a tutorial.
