Fix comments.

13 files changed, 35 insertions, 31 deletions

diff --git a/gas/config/obj-vms.c b/gas/config/obj-vms.c
index 0f08f8e..2002136 100644
--- a/gas/config/obj-vms.c
+++ b/gas/config/obj-vms.c
@@ -2046,7 +2046,7 @@ VMS_local_stab_Parse (sp)
 		str1++;
 	      }
 	    if (*str1 == ':' && *pnt2 == ':')
-	      return;	/* they are the same!  lets skip this one */
+	      return;	/* They are the same!  Let's skip this one.  */
 	  }			/* for */
 	pnt++;			/* skip p in case no register */
       }			/* if */
diff --git a/gas/config/tc-a29k.c b/gas/config/tc-a29k.c
index 600fec5..b72e570 100644
--- a/gas/config/tc-a29k.c
+++ b/gas/config/tc-a29k.c
@@ -710,8 +710,8 @@ machine_ip (str)
    but I'm not sure.
 
    Turn a string in input_line_pointer into a floating point constant
-   of type type, and store the appropriate bytes in *litP.  The number
-   of LITTLENUMS emitted is stored in *sizeP .  An error message is
+   of type TYPE, and store the appropriate bytes in *LITP.  The number
+   of LITTLENUMS emitted is stored in *SIZEP.  An error message is
    returned, or NULL on OK.  */
 
 /* Equal to MAX_PRECISION in atof-ieee.c */
diff --git a/gas/config/tc-alpha.c b/gas/config/tc-alpha.c
index 0eed2e2..0fb3fff 100644
--- a/gas/config/tc-alpha.c
+++ b/gas/config/tc-alpha.c
@@ -971,8 +971,8 @@ md_section_align (seg, size)
 }
 
 /* Turn a string in input_line_pointer into a floating point constant
-   of type type, and store the appropriate bytes in *litP.  The number
-   of LITTLENUMS emitted is stored in *sizeP.  An error message is
+   of type TYPE, and store the appropriate bytes in *LITP.  The number
+   of LITTLENUMS emitted is stored in *SIZEP.  An error message is
    returned, or NULL on OK.  */
 
 /* Equal to MAX_PRECISION in atof-ieee.c */
diff --git a/gas/config/tc-h8300.c b/gas/config/tc-h8300.c
index 399cd0e..161337c 100644
--- a/gas/config/tc-h8300.c
+++ b/gas/config/tc-h8300.c
@@ -19,10 +19,7 @@
    Software Foundation, 59 Temple Place - Suite 330, Boston, MA
    02111-1307, USA.  */
 
-/*
-  Written By Steve Chamberlain
-  sac@cygnus.com
-  */
+/* Written By Steve Chamberlain <sac@cygnus.com>.  */
 
 #include <stdio.h>
 #include "as.h"
@@ -194,7 +191,8 @@ struct h8_op
   ccr
 */
 
-/* Try and parse a reg name, returns number of chars consumed.  */
+/* Try to parse a reg name.  Return the number of chars consumed.  */
+
 static int
 parse_reg (src, mode, reg, direction)
      char *src;
@@ -1329,8 +1327,9 @@ tc_headers_hook (headers)
 
 /* Turn a string in input_line_pointer into a floating point constant
    of type TYPE, and store the appropriate bytes in *LITP.  The number
-   of LITTLENUMS emitted is stored in *SIZEP .  An error message is
+   of LITTLENUMS emitted is stored in *SIZEP.  An error message is
    returned, or NULL on OK.  */
+
 char *
 md_atof (type, litP, sizeP)
      char type;
diff --git a/gas/config/tc-h8500.c b/gas/config/tc-h8500.c
index 67493c4..1ce0a17 100644
--- a/gas/config/tc-h8500.c
+++ b/gas/config/tc-h8500.c
@@ -180,7 +180,8 @@ typedef struct
 
 h8500_operand_info;
 
-/* try and parse a reg name, returns number of chars consumed */
+/* Try to parse a reg name.  Return the number of chars consumed.  */
+
 static int
 parse_reg (src, mode, reg)
      char *src;
@@ -1174,10 +1175,11 @@ tc_headers_hook (headers)
 /* Equal to MAX_PRECISION in atof-ieee.c */
 #define MAX_LITTLENUMS 6
 
-/* Turn a string in input_line_pointer into a floating point constant of type
-   type, and store the appropriate bytes in *LITP.  The number of LITTLENUMS
-   emitted is stored in *SIZEP .  An error message is returned, or NULL on OK.
-   */
+/* Turn a string in input_line_pointer into a floating point constant
+   of type type, and store the appropriate bytes in *LITP.  The number
+   of LITTLENUMS emitted is stored in *SIZEP.  An error message is
+   returned, or NULL on OK.  */
+
 char *
 md_atof (type, litP, sizeP)
      char type;
diff --git a/gas/config/tc-i370.c b/gas/config/tc-i370.c
index 2183273..1805a09 100644
--- a/gas/config/tc-i370.c
+++ b/gas/config/tc-i370.c
@@ -2585,8 +2585,8 @@ i370_tc (ignore)
 }
 
 /* Turn a string in input_line_pointer into a floating point constant
-   of type type, and store the appropriate bytes in *litp.  The number
-   of LITTLENUMS emitted is stored in *sizep .  An error message is
+   of type TYPE, and store the appropriate bytes in *LITP.  The number
+   of LITTLENUMS emitted is stored in *SIZEP.  An error message is
    returned, or NULL on OK.  */
 
 char *
diff --git a/gas/config/tc-ia64.c b/gas/config/tc-ia64.c
index 9b2eaf4..abcfe63 100644
--- a/gas/config/tc-ia64.c
+++ b/gas/config/tc-ia64.c
@@ -9138,8 +9138,8 @@ tc_gen_reloc (sec, fixp)
 }
 
 /* Turn a string in input_line_pointer into a floating point constant
-   of type type, and store the appropriate bytes in *lit.  The number
-   of LITTLENUMS emitted is stored in *size.  An error message is
+   of type TYPE, and store the appropriate bytes in *LIT.  The number
+   of LITTLENUMS emitted is stored in *SIZE.  An error message is
    returned, or NULL on OK.  */
 
 #define MAX_LITTLENUMS 5
diff --git a/gas/config/tc-m68hc11.c b/gas/config/tc-m68hc11.c
index e773420..83ec55e 100644
--- a/gas/config/tc-m68hc11.c
+++ b/gas/config/tc-m68hc11.c
@@ -440,8 +440,8 @@ md_undefined_symbol (name)
 #define MAX_LITTLENUMS 6
 
 /* Turn a string in input_line_pointer into a floating point constant
-   of type type, and store the appropriate bytes in *litP.  The number
-   of LITTLENUMS emitted is stored in *sizeP .  An error message is
+   of type TYPE, and store the appropriate bytes in *LITP.  The number
+   of LITTLENUMS emitted is stored in *SIZEP.  An error message is
    returned, or NULL on OK.  */
 
 char *
diff --git a/gas/config/tc-m68k.c b/gas/config/tc-m68k.c
index da78310..0badf70 100644
--- a/gas/config/tc-m68k.c
+++ b/gas/config/tc-m68k.c
@@ -4079,8 +4079,8 @@ m68k_mri_mode_change (on)
 #define MAX_LITTLENUMS 6
 
 /* Turn a string in input_line_pointer into a floating point constant
-   of type type, and store the appropriate bytes in *litP.  The number
-   of LITTLENUMS emitted is stored in *sizeP .  An error message is
+   of type TYPE, and store the appropriate bytes in *LITP.  The number
+   of LITTLENUMS emitted is stored in *SIZEP.  An error message is
    returned, or NULL on OK.  */
 
 char *
diff --git a/gas/config/tc-mips.c b/gas/config/tc-mips.c
index d8f593f..2836d84 100644
--- a/gas/config/tc-mips.c
+++ b/gas/config/tc-mips.c
@@ -8742,8 +8742,8 @@ my_getExpression (ep, str)
 }
 
 /* Turn a string in input_line_pointer into a floating point constant
-   of type type, and store the appropriate bytes in *litP.  The number
-   of LITTLENUMS emitted is stored in *sizeP .  An error message is
+   of type TYPE, and store the appropriate bytes in *LITP.  The number
+   of LITTLENUMS emitted is stored in *SIZEP.  An error message is
    returned, or NULL on OK.  */
 
 char *
diff --git a/gas/config/tc-ns32k.c b/gas/config/tc-ns32k.c
index c81a387..97f66e6 100644
--- a/gas/config/tc-ns32k.c
+++ b/gas/config/tc-ns32k.c
@@ -1561,9 +1561,10 @@ md_begin ()
 #define MAX_LITTLENUMS 6
 
 /* Turn the string pointed to by litP into a floating point constant
-   of type type, and emit the appropriate bytes.  The number of
-   LITTLENUMS emitted is stored in *sizeP .  An error message is
+   of type TYPE, and emit the appropriate bytes.  The number of
+   LITTLENUMS emitted is stored in *SIZEP.  An error message is
    returned, or NULL on OK.  */
+
 char *
 md_atof (type, litP, sizeP)
      char type;
diff --git a/gas/config/tc-ppc.c b/gas/config/tc-ppc.c
index 417c632..509503e 100644
--- a/gas/config/tc-ppc.c
+++ b/gas/config/tc-ppc.c
@@ -4480,8 +4480,8 @@ ppc_frob_section (sec)
 #endif /* OBJ_XCOFF */
 
 /* Turn a string in input_line_pointer into a floating point constant
-   of type type, and store the appropriate bytes in *litp.  The number
-   of LITTLENUMS emitted is stored in *sizep .  An error message is
+   of type TYPE, and store the appropriate bytes in *LITP.  The number
+   of LITTLENUMS emitted is stored in *SIZEP.  An error message is
    returned, or NULL on OK.  */
 
 char *
diff --git a/gas/config/tc-z8k.c b/gas/config/tc-z8k.c
index b66bd50..bed16cf 100644
--- a/gas/config/tc-z8k.c
+++ b/gas/config/tc-z8k.c
@@ -253,7 +253,9 @@ whatreg (reg, src)
 
   */
 
-/* try and parse a reg name, returns number of chars consumed */
+/* Try to parse a reg name.  Return a pointer to the first character
+   in SRC after the reg name.  */
+
 char *
 parse_reg (src, mode, reg)
      char *src;