doc: Update description of --debug

--

Signed-off-by: Werner Koch <wk@gnupg.org>

doc/dirmngr.texi

@@ -198,11 +198,11 @@ however carefully selected to best aid in debugging.
 
 @item --debug @var{flags}
 @opindex debug
-Set debugging flags.  This option is only useful for debugging and its
+Set debug flags.  All flags are or-ed and @var{flags} may be given in
-behavior may change with a new release.  All flags are or-ed and may
+C syntax (e.g. 0x0042) or as a comma separated list of flag names.  To
-be given in C syntax (e.g. 0x0042) or as a comma separated list of
+get a list of all supported flags the single word "help" can be used.
-flag names.  To get a list of all supported flags the single word
+This option is only useful for debugging and the behavior may change
-"help" can be used.
+at any time without notice.
 
 @item --debug-all
 @opindex debug-all

doc/gpg-agent.texi

@@ -256,30 +256,11 @@ however carefully selected to best aid in debugging.
 
 @item --debug @var{flags}
 @opindex debug
-This option is only useful for debugging and the behavior may change at
+Set debug flags.  All flags are or-ed and @var{flags} may be given
-any time without notice.  FLAGS are bit encoded and may be given in
+in C syntax (e.g. 0x0042) or as a comma separated list of flag names.
-usual C-Syntax. The currently defined bits are:
+To get a list of all supported flags the single word "help" can be
-
+used. This option is only useful for debugging and the behavior may
-@table @code
+change at any time without notice.
-@item 0  (1)
-X.509 or OpenPGP protocol related data
-@item 1  (2)
-values of big number integers
-@item 2  (4)
-low level crypto operations
-@item 5  (32)
-memory allocation
-@item 6  (64)
-caching
-@item 7  (128)
-show memory statistics
-@item 9  (512)
-write hashed data to files named @code{dbgmd-000*}
-@item 10 (1024)
-trace Assuan protocol
-@item 12 (4096)
-bypass all certificate validation
-@end table
 
 @item --debug-all
 @opindex debug-all

doc/gpg.texi

@@ -2894,10 +2894,11 @@ however carefully selected to best aid in debugging.
 
 @item --debug @var{flags}
 @opindex debug
-Set debugging flags. All flags are or-ed and @var{flags} may be given
+Set debug flags.  All flags are or-ed and @var{flags} may be given
 in C syntax (e.g. 0x0042) or as a comma separated list of flag names.
 To get a list of all supported flags the single word "help" can be
-used.
+used. This option is only useful for debugging and the behavior may
+change at any time without notice.
 
 @item --debug-all
 @opindex debug-all

doc/gpgsm.texi

@@ -688,29 +688,11 @@ however carefully selected to best aid in debugging.
 
 @item --debug @var{flags}
 @opindex debug
-This option is only useful for debugging and the behaviour may change
+Set debug flags.  All flags are or-ed and @var{flags} may be given
-at any time without notice; using @code{--debug-levels} is the
+in C syntax (e.g. 0x0042) or as a comma separated list of flag names.
-preferred method to select the debug verbosity.  FLAGS are bit encoded
+To get a list of all supported flags the single word "help" can be
-and may be given in usual C-Syntax. The currently defined bits are:
+used. This option is only useful for debugging and the behavior may
-
+change at any time without notice.
-@table @code
-@item 0  (1)
-X.509 or OpenPGP protocol related data
-@item 1  (2)
-values of big number integers
-@item 2  (4)
-low level crypto operations
-@item 5  (32)
-memory allocation
-@item 6  (64)
-caching
-@item 7  (128)
-show memory statistics
-@item 9  (512)
-write hashed data to files named @code{dbgmd-000*}
-@item 10 (1024)
-trace Assuan protocol
-@end table
 
 Note, that all flags set using this option may get overridden by
 @code{--debug-level}.

doc/scdaemon.texi

@@ -160,33 +160,11 @@ helpers to debug problems.
 
 @item --debug @var{flags}
 @opindex debug
-This option is only useful for debugging and the behavior may change at
+Set debug flags.  All flags are or-ed and @var{flags} may be given
-any time without notice.  FLAGS are bit encoded and may be given in
+in C syntax (e.g. 0x0042) or as a comma separated list of flag names.
-usual C-Syntax. The currently defined bits are:
+To get a list of all supported flags the single word "help" can be
-
+used. This option is only useful for debugging and the behavior may
-@table @code
+change at any time without notice.
-@item 0  (1)
-command I/O
-@item 1  (2)
-values of big number integers
-@item 2  (4)
-low level crypto operations
-@item 5  (32)
-memory allocation
-@item 6  (64)
-caching
-@item 7  (128)
-show memory statistics
-@item 9  (512)
-write hashed data to files named @code{dbgmd-000*}
-@item 10 (1024)
-trace Assuan protocol.
-See also option @option{--debug-assuan-log-cats}.
-@item 11 (2048)
-trace APDU I/O to the card.  This may reveal sensitive data.
-@item 12 (4096)
-trace some card reader related function calls.
-@end table
 
 @item --debug-all
 @opindex debug-all