code review from Josh and Robert

@@ -15,34 +15,34 @@
 
 INTERFACE LEVEL
      illumos DDI specific
 
 PARAMETERS
-     vmp     The vmem arena to walk
+     vmp     The vmem arena to walk.
 
      typemask
-             A bitmask indicating the types of segment to operate on
+             A bitmask indicating the types of segment to operate on.
 
              VMEM_ALLOC
-                     Allocated segments
+                     Allocated segments.
 
              VMEM_FREE
-                     Free segments
+                     Free segments.
 
      func    The function to apply to each segment matching typemask.  func
-             should be of 3 values and return void:
+             should accept 3 arguments and return void:
 
              void *arg
-                     The arg passed to vmem_walk()
+                     The arg passed to vmem_walk().
 
              void *vaddr
-                     The base address of the segment
+                     The base address of the segment.
 
              size_t size
-                     The size of the segment
+                     The size of the segment.
 
-     arg     An arbitrary argument passed to each call to func()
+     arg     An arbitrary argument passed to each call to func().
 
 DESCRIPTION
      vmem_walk() walks each segment in the arena vmp and applies func to each
      which matches typemask.