diff --git a/include/cdio/cdda.h b/include/cdio/cdda.h
index 775d25e8..7cb2b6d6 100644
--- a/include/cdio/cdda.h
+++ b/include/cdio/cdda.h
@@ -1,5 +1,5 @@
 /*
-  $Id: cdda.h,v 1.28 2006/05/03 00:29:40 rocky Exp $
+  $Id: cdda.h,v 1.29 2006/10/27 10:38:41 rocky Exp $
 
   Copyright (C) 2004, 2005, 2006 Rocky Bernstein <rocky@gnu.org>
   Copyright (C) 2001 Xiph.org
@@ -49,7 +49,7 @@ extern "C" {
      Flags for simulating jitter used in testing.
 
      The enumeration type one probably wouldn't really use in a program.
-     It is here instead of #defines to give symbolic names that can be
+     It is here instead of defines to give symbolic names that can be
      helpful in debuggers where wants just to say refer to
      CDDA_TEST_JITTER_SMALL and get the correct value.
   */
@@ -144,7 +144,7 @@ struct cdrom_drive_s {
      Flags for simulating jitter used in testing.
 
      The enumeration type one probably wouldn't really use in a program.
-     It is here instead of #defines to give symbolic names that can be
+     It is here instead of defines to give symbolic names that can be
      helpful in debuggers where wants just to say refer to
      CDDA_TEST_JITTER_SMALL and get the correct value.
   */
diff --git a/include/cdio/iso9660.h b/include/cdio/iso9660.h
index eb8586fa..ea15d949 100644
--- a/include/cdio/iso9660.h
+++ b/include/cdio/iso9660.h
@@ -1,5 +1,5 @@
 /*
-    $Id: iso9660.h,v 1.94 2006/06/02 21:54:21 gmerlin Exp $
+    $Id: iso9660.h,v 1.95 2006/10/27 10:38:41 rocky Exp $
 
     Copyright (C) 2000 Herbert Valerio Riedel <hvr@gnu.org>
     Copyright (C) 2003, 2004, 2005, 2006 Rocky Bernstein <rocky@gnu.org>
@@ -624,7 +624,7 @@ typedef struct _iso9660_s iso9660_t;
 
     @param start location to start reading from
 
-    @i_size number of blocks to read. Each block is ISO_BLOCKSIZE bytes
+    @param i_size number of blocks to read. Each block is ISO_BLOCKSIZE bytes
     long.
 
     @return number of bytes (not blocks) read
diff --git a/include/cdio/mmc.h b/include/cdio/mmc.h
index b6167d18..767596cc 100644
--- a/include/cdio/mmc.h
+++ b/include/cdio/mmc.h
@@ -1,5 +1,5 @@
 /*
-    $Id: mmc.h,v 1.28 2006/10/11 12:38:18 rocky Exp $
+    $Id: mmc.h,v 1.29 2006/10/27 10:38:41 rocky Exp $
 
     Copyright (C) 2003, 2004, 2005, 2006 Rocky Bernstein <rocky@cpan.org>
 
@@ -546,6 +546,7 @@ mmc_audio_read_subchannel (CdIo_t *p_cdio,
   /*! 
     Return results of media status
     @param p_cdio the CD object to be acted upon.
+    @param out_buf media status code from operation
     @return DRIVER_OP_SUCCESS (0) if we got the status.
     return codes are the same as driver_return_code_t
    */
diff --git a/include/cdio/paranoia.h b/include/cdio/paranoia.h
index b7645e0d..5f96c271 100644
--- a/include/cdio/paranoia.h
+++ b/include/cdio/paranoia.h
@@ -1,5 +1,5 @@
 /*
-  $Id: paranoia.h,v 1.12 2006/03/18 18:37:56 rocky Exp $
+  $Id: paranoia.h,v 1.13 2006/10/27 10:38:41 rocky Exp $
 
   Copyright (C) 2004, 2005, 2006 Rocky Bernstein <rocky@panix.com>
   Copyright (C) 1998 Monty xiphmont@mit.edu
@@ -41,7 +41,7 @@
   Flags used in paranoia_modeset. 
 
   The enumeration type one probably wouldn't really use in a program.
-  It is here instead of #defines to give symbolic names that can be
+  It is here instead of defines to give symbolic names that can be
   helpful in debuggers where wants just to say refer to
   PARANOIA_MODE_DISABLE and get the correct value.
 */
@@ -64,7 +64,7 @@ typedef enum  {
    Flags set in a callback.
 
   The enumeration type one probably wouldn't really use in a program.
-  It is here instead of #defines to give symbolic names that can be
+  It is here instead of defines to give symbolic names that can be
   helpful in debuggers where wants just to say refer to
   PARANOIA_CB_READ and get the correct value.
 */
@@ -112,10 +112,10 @@ extern "C" {
     Set the kind of repair you want to on for reading. 
     The modes are listed above
 
-    @param p       paranoia type
-    @mode  mode    paranoia mode flags built from values in 
-                   paranoia_mode_t, e.g. 
-		   PARANOIA_MODE_FULL^PARANOIA_MODE_NEVERSKIP
+    @param p             paranoia type
+    @param mode_flags    paranoia mode flags built from values in 
+                         paranoia_mode_t, e.g. 
+		         PARANOIA_MODE_FULL^PARANOIA_MODE_NEVERSKIP
    */
   extern void cdio_paranoia_modeset(cdrom_paranoia_t *p, int mode_flags);