Comment cleanups only.


git-svn-id: svn://svn.valgrind.org/valgrind/trunk@2849 a5019735-40e9-0310-863c-91ae7b9d1cf9
diff --git a/include/valgrind.h.in b/include/valgrind.h.in
index 2b9ae20..03fdb7f 100644
--- a/include/valgrind.h.in
+++ b/include/valgrind.h.in
@@ -80,36 +80,28 @@
 
 #ifndef NVALGRIND
 
-/* The following defines the magic code sequence which the JITter spots and
-   handles magically.  Don't look too closely at this; it will rot
+/* The following defines the magic code sequences which the JITter spots and
+   handles magically.  Don't look too closely at them; they will rot
    your brain.  We must ensure that the default value gets put in the return
    slot, so that everything works when this is executed not under Valgrind.
    Args are passed in a memory block, and so there's no intrinsic limit to
    the number that could be passed, but it's currently four.
    
+   The macro args are: 
+      _zzq_rlval    result lvalue
+      _zzq_default  default value (result returned when running on real CPU)
+      _zzq_request  request code
+      _zzq_arg1..4  request params
+
    Nb: we put the assembly code sequences for all architectures in this one
    file.  This is because this file must be stand-alone, so we can't rely on
    eg. x86/ subdirectories like we do within the rest of Valgrind.
 */
 
 #ifdef __x86__
-/* This defines the magic code sequence which the JITter spots and
-   handles magically.  Don't look too closely at this; it will rot
-   your brain.  Valgrind dumps the result value in %EDX, so we first
-   copy the default value there, so that it is returned when not
-   running on Valgrind.  Since %EAX points to a block of mem
-   containing the args, you can pass as many args as you want like
-   this.  Currently this is set up to deal with 4 args since that's
-   the max that we appear to need (pthread_create).  
-*/
 #define VALGRIND_MAGIC_SEQUENCE(                                        \
-        _zzq_rlval,   /* result lvalue */                               \
-        _zzq_default, /* result returned when running on real CPU */    \
-        _zzq_request, /* request code */                                \
-        _zzq_arg1,    /* request first param */                         \
-        _zzq_arg2,    /* request second param */                        \
-        _zzq_arg3,    /* request third param */                         \
-        _zzq_arg4     /* request fourth param */ )                      \
+        _zzq_rlval, _zzq_default, _zzq_request,                         \
+        _zzq_arg1, _zzq_arg2, _zzq_arg3, _zzq_arg4)                     \
                                                                         \
   { volatile unsigned int _zzq_args[5];                                 \
     _zzq_args[0] = (volatile unsigned int)(_zzq_request);               \