Merge branch '2.3.x'

[catacomb] / progs / catsign.1

diff --git a/progs/catsign.1 b/progs/catsign.1
index 190c631..d4add88 100644 (file)
--- a/progs/catsign.1
+++ b/progs/catsign.1
@@ -62,7 +62,7 @@ is one of:
 .RB [ \-t
 .IR time ]
 .br
 .RB [ \-t
 .IR time ]
 .br

-
+\h'8n'

 .RB [ \-o
 .IR output ]
 .RI [ file
 .RB [ \-o
 .IR output ]
 .RI [ file


@@ -81,7 +81,7 @@ is one of:
 .RB [ \-F
 .IR format ]
 .br
 .RB [ \-F
 .IR format ]
 .br

-
+\h'8n'

 .RB [ \-m
 .IR file ]
 .RB [ \-o
 .RB [ \-m
 .IR file ]
 .RB [ \-o


@@ -246,6 +246,22 @@ command (see
 .BR key (1))
 to generate the key.
 .TP
 .BR key (1))
 to generate the key.
 .TP

+.B ed25519
+This is Bernstein, Duif, Lange, Schwabe, and Yang's Ed25519 algorithm.
+More specifically, this is HashEd25519
+using the selected
+.B hash
+algorithm \(en by default
+.BR sha512 .
+Use the
+.B ed25519
+algorithm of the
+.B key add
+command
+(see
+.BR key (1))
+to generate the key.
+.TP

 .B mac
 This uses a symmetric message-authentication algorithm rather than a
 digital signature.  The precise message-authentication scheme used is
 .B mac
 This uses a symmetric message-authentication algorithm rather than a
 digital signature.  The precise message-authentication scheme used is


@@ -539,8 +555,16 @@ No output.  Watch the exit status.
 All messages.
 .PP
 .B Warning!
 All messages.
 .PP
 .B Warning!

-All output written has been checked for authenticity.  However, output
-can fail madway through for many reasons, and the resulting message may
+Unless the
+.B \-b
+option is set (which happens automatically if writing to standard
+output),
+.BR catsign 's
+output is
+.I not
+checked for authenticity until it has all been written.  Even with
+.BR \-b ,
+output can fail midway for many reasons, and the resulting message may

 therefore be truncated.  Don't rely on the output being complete until
 .B OK
 is printed or
 therefore be truncated.  Don't rely on the output being complete until
 .B OK
 is printed or