Index: src/debug.c
===================================================================
--- src/debug.c	(revision 18582)
+++ src/debug.c	(working copy)
@@ -46,20 +46,25 @@
 
 =item C<static char* nextarg(char* command)>
 
-Returns the position just past the current argument in a PASM
-instruction. This is not the same as C<na()>, above, which is intended
-for debugger commands. This function is used for C<eval>.
+Returns the position just past the current argument in the PASM
+instruction C<command>. This is not the same as C<na()>, above,
+which is intended for debugger commands. This function is used for C<eval>.
 
 =cut
 
 */
 
-static char*
-nextarg(char* command)
+static char const *
+nextarg(char const *command)
 {
+    /* as long as the character pointed to by command is not NULL,
+     * and it is either alphanumeric, a comma or a closing bracket,
+     * continue looking for the next argument.
+     */
     while (*command && (isalnum((int) *command) || *command == ',' ||
         *command == ']'))
             command++;
+    /* Try to eat as much space as we can */
     while (*command && isspace((int) *command))
         command++;
     return command;
@@ -75,11 +80,13 @@
 
 */
 
-static const char*
-skip_ws(const char* str)
+static const char *
+skip_ws(const char *str)
 {
+    /* as long as str is not NULL and it contains space, skip it */
     while (*str && isspace((int) *str))
         str++;
+
     return str;
 }
 
@@ -94,31 +101,37 @@
 
 */
 
-static const char*
-skip_command(const char* str)
+static const char *
+skip_command(const char * str)
 {
+    /* while str is not null and it contains a command (no spaces),
+     * skip the character
+     */
     while (*str && !isspace((int) *str))
         str++;
+    /* and eat all space after that */
     while (*str && isspace((int) *str))
         str++;
+
     return str;
 }
 
 /*
 
-=item C<static const char* parse_int(const char* str, int* intP)>
+=item C<static const char *parse_int(const char *str, int *intP)>
 
 Parse an C<int> out of a string and return a pointer to just after the
-C<int>.
+C<int>. The parameter C<intP> is an output parameter, and contains the
+value that is parsed.
 
 =cut
 
 */
 
-static const char*
-parse_int(const char* str, int* intP)
+static const char *
+parse_int(const char *str, int *intP)
 {
-    char* end;
+    char *end;
 
     *intP = strtol(str, &end, 0);