Added help

1 files changed, 32 insertions, 2 deletions

diff --git a/phpdbg_help.c b/phpdbg_help.c
index 72038dc0fd..757dc769b3 100644
--- a/phpdbg_help.c
+++ b/phpdbg_help.c
@@ -334,6 +334,7 @@ phpdbg_help_text_t phpdbg_help_text[] = {
 "  **finish**   continue up to end of the current execution frame" CR
 "  **leave**    continue up to end of the current execution frame and halt after the calling instruction" CR
 "  **break**    set a breakpoint at the specified target" CR
+"  **watch""    set a watchpoint on $variable" CR
 "  **ev**       evaluate some code" CR
 "  **clear**    clear one or all breakpoints" CR
 "  **clean**    clean the execution environment" CR CR
@@ -838,8 +839,8 @@ phpdbg_help_text_t phpdbg_help_text[] = {
 "     Set the prompt to a bold >" CR CR
 
 "     $P S c error red-bold" CR
-"     Use red bold for errors" CR
-"     " CR
+"     Use red bold for errors" CR CR
+
 "     $P S b 4 off" CR
 "     Temporarily disable breakpoint 4.  This can be subsequently reenabled by a **s b 4 on**." CR
 //*********** check oplog syntax
@@ -904,5 +905,34 @@ phpdbg_help_text_t phpdbg_help_text[] = {
 "Note **until** will trigger a \"not executing\" error if not executing."
 
 },
+{"watch",
+"Sets watchpoints on variables as long as they are defined" CR
+"Passing no parameter to **watch**, lists all actually active watchpoints" CR
+"Subcommands of **watch**:" CR CR
+
+"   **Type**     **Alias**      **Purpose**" CR
+"   **array**       **a**       Sets watchpoint on array/object to observe if an entry is added or removed" CR
+"   **recursive**   **r**       Watches variable recursively and automatically adds watchpoints if some entry is added to an array/object" CR
+"   **delete**      **d**       Removes watchpoint" CR CR
+
+"Note when **recursive** watchpoints are removed, watchpoints on all the children are removed too"
+
+"**Examples**" CR CR
+"     $P watch $array" CR
+"     Set watchpoint on $array" CR CR
+
+"     $P watch" CR
+"     $array" CR CR
+
+"     $P w r $obj" CR
+"     Set recursive watchpoint on $obj" CR CR
+
+"     $P w d $obj" CR
+"     Removed watchpoint $obj" CR CR
+
+"Technical note: If using this feature with a debugger, you will get many segmentation faults, each time when a memory page containing a watched address is hit." CR
+"                You then you can continue, phpdbg will remove the write protection, so that the program can continue." CR
+"                If phpdbg could not handle that segfault, the same segfault is triggered again and this time phpdbg will abort."
+},
 {NULL, NULL /* end of table marker */}
 };  /* }}} */