update .phpdbginit with more info/example

diff --git a/.phpdbginit b/.phpdbginit
index 5de88c7ba00b09115a84d682116e7c3e8dda98bd..10c831b0329daca65bf11f343fdcbbb1f6ea9a08 100644 (file)
--- a/.phpdbginit
+++ b/.phpdbginit
@@ -1,26 +1,59 @@
-##############################################
+##########################################################
 # .phpdbginit
 #
 # Lines starting with # are ignored
 # Code must start and end with <: and :> respectively
-##############################################
+##########################################################
 # Place initialization commands one per line
-##############################################
+##########################################################
 # exec sapi/phpdbg/test.php
 
-##############################################
+##########################################################
 # Embedding code in .phpdbginit
-##############################################
+##########################################################
 <:
 /*
 * This embedded PHP is executed at init time
 */
 
+/*
+* Functions defined and registered by init
+* will persist across cleans
+*/
+
+/*
+function my_debugging_function() 
+{
+       var_dump(func_get_args());
+}
+*/
+
 /* phpdbg_break(PHPDBG_METHOD, "phpdbg::method"); */
 /* phpdbg_break(PHPDBG_FUNC, "my_global_function"); */
 /* phpdbg_break(PHPDBG_FILE, "/path/to/file.php:10"); */
 :>
-
-##############################################
+##########################################################
 # Now carry on initializing phpdbg ...
-##############################################
+##########################################################
+# R my_debugging_function
+
+##########################################################
+# PHP has many functions that might be useful
+# ... you choose ...
+##########################################################
+# R touch
+# R unlink
+# R scandir
+# R glob
+
+##########################################################
+# Remember: *you have access to the shell*
+##########################################################
+# The output of registered function calls is not,
+# by default, very pretty (unless you implement
+# and register a new implementation for phpdbg)
+# The output of shell commands will usually be more
+# readable on the console
+##########################################################
+# TLDR; if you have a good shell, use it ...
+##########################################################