From: Richard Foley <richard.foley@rfi.net>
Date: Wed, 10 Oct 2007 15:29:39 +0000 (+0200)
Subject: add calling hints to perldebug.pod
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=9311160e8e005d634474952ba2e0841d81d67460;p=p5sagit%2Fp5-mst-13.2.git

add calling hints to perldebug.pod
Message-Id: <200710101529.39895.Richard.Foley@rfi.net>

p4raw-id: //depot/perl@32096
---

diff --git a/pod/perldebug.pod b/pod/perldebug.pod
index 8c6e940..2529901 100644
--- a/pod/perldebug.pod
+++ b/pod/perldebug.pod
@@ -54,9 +54,33 @@ function with something that doesn't look like a debugger command, such
 as a leading C<;> or perhaps a C<+>, or by wrapping it with parentheses
 or braces.
 
+=head2 Calling the debugger
+
+There are several ways to call the debugger:
+
+=over 4
+
+=item perl -d program_name
+
+On the given program identified by C<program_name>.
+
+=item perl -d -e 0 
+
+Interactively supply an arbitrary C<expression> using C<-e>.
+
+=item perl -d:Ptkdb program_name
+
+Debug a given program via the C<Devel::Ptkdb> GUI.
+
+=item perl -dt threaded_program_name
+
+Debug a given program using threads (experimental).
+
+=back
+
 =head2 Debugger Commands
 
-The debugger understands the following commands:
+The interactive debugger understands the following commands:
 
 =over 12