diff --git a/doc/ChangeLog b/doc/ChangeLog
index ae669cd19..087ca44a6 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -3,6 +3,10 @@
 	* gpg.sgml: Document delsig.  Clarify that --refresh-keys
 	arguments are optional.  Document --bzip2-decompress-lowmem.
 
+2004-04-05  Werner Koch  <wk@gnupg.org>
+
+	* DETAILS (NEWSIG): Documented.
+
 2004-02-25  David Shaw  <dshaw@jabberwocky.com>
 
 	* gpg.sgml: Document --ask-cert-level, --max-output, and
diff --git a/doc/DETAILS b/doc/DETAILS
index 17ee998e2..398da507c 100644
--- a/doc/DETAILS
+++ b/doc/DETAILS
@@ -163,6 +163,11 @@ type (maybe none); an application should always be prepared to see
 more arguments in future versions.
 
 
+    NEWSIG
+        May be issued right before a signature verification starts.  This
+        is useful to define a context for parsing ERROR status
+        messages.  No arguments are currently defined.
+
     GOODSIG	<long keyid>  <username>
 	The signature with the keyid is good.  For each signature only
         one of the three codes GOODSIG, BADSIG or ERRSIG will be
@@ -396,7 +401,21 @@ more arguments in future versions.
 	done and "total" is amount to be done; a "total" of 0 indicates that
 	the total amount is not known.	100/100 may be used to detect the
 	end of operation.
+        Well known values for WHAT:
+             "pk_dsa"   - DSA key generation
+             "pk_elg"   - Elgamal key generation
+             "primegen" - Prime generation
+             "need_entropy" - Waiting for new entropy in the RNG
+             "file:XXX" - processing file XXX
+                          (note that current gpg versions leave out the
+                           "file:" prefix).
+             "tick"     - generic tick without any special meaning - useful
+                          for letting clients know that the server is
+                          still working.
+             "starting_agent" - A gpg-agent was started because it is not
+                          running as a daemon.
 
+        
     SIG_CREATED <type> <pubkey algo> <hash algo> <class> <timestamp> <key fpr>
 	A signature has been created using these parameters.
 	    type:  'D' = detached