better debugging support (-d option)

1 files changed, 15 insertions, 6 deletions

diff --git a/ltrace.1 b/ltrace.1
index 04a1503..e24b16c 100644
--- a/ltrace.1
+++ b/ltrace.1
@@ -6,7 +6,7 @@ ltrace \- A library call tracer
 
 .SH SYNOPSIS
 .B ltrace
-.I "[-CdfhiLrStttV] [-a column] [-A maxelts] [-e expr] [-l filename] [-n nr] [-o filename] [-p pid] ... [-s strsize] [-u username] [-X extern] [-x extern] ... [--align=column] [--debug] [--demangle] [--help] [--indent=nr] [--library=filename] [--output=filename] [--version] [command [arg ...]]"
+.I "[-CfhiLrStttV] [-a column] [-A maxelts] [-d level] [-e expr] [-l filename] [-n nr] [-o filename] [-p pid] ... [-s strsize] [-u username] [-X extern] [-x extern] ... [--align=column] [--debug=level] [--demangle] [--help] [--indent=nr] [--library=filename] [--output=filename] [--version] [command [arg ...]]"
 
 .SH DESCRIPTION
 .B ltrace
@@ -36,11 +36,20 @@ Decode (demangle) low-level symbol names into user-level names.
 Besides removing any initial underscore prefix used by the system,
 this makes C++ function names readable.
 .TP
-.I \-d, \-\-debug
-Increase the debugging level.
-Use more (ie.
-.I \-dd
-) for greater debugging information.
+.I \-d, \-\-debug level
+Show debugging output of
+.B ltrace
+itself.
+.I level
+must be a sum of some of the following numbers:
+.RS
+.TP
+.B 0x10
+DEBUG_EVENT.  Shows every event received by a traced program
+.TP
+.B 0x20
+DEBUG_PROCESS.  Shows every action carried out in a traced program
+.RE
 .TP
 .I \-e expr
 A qualifying expression which modifies which events to trace.