* c-common.h: Fix comment formatting.

	* c-cppbuiltin.c: Likewise.
	* c-pragma.c: Likewise.
	* calls.c: Likewise.
	* collect2.c: Likewise.
	* cppcharset.c: Likewise.
	* cpptrad.c: Likewise.
	* dbxout.c: Likewise.
	* defaults.h: Likewise.
	* dwarf2out.c: Likewise.
	* fold-const.c: Likewise.
	* genautomata.c: Likewise.
	* genconditions.c: Likewise.
	* genflags.c: Likewise.
	* gengtype.c: Likewise.
	* integrate.c: Likewise.
	* loop.c: Likewise.
	* predict.c: Likewise.
	* sdbout.c: Likewise.


git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@75957 138bc75d-0d04-0410-961f-82ee72b054a4

20 files changed, 50 insertions, 27 deletions

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 4a2e9aaea12..2384ba92d0b 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,25 @@
+2004-01-15  Kazu Hirata  <kazu@cs.umass.edu>
+
+	* c-common.h: Fix comment formatting.
+	* c-cppbuiltin.c: Likewise.
+	* c-pragma.c: Likewise.
+	* calls.c: Likewise.
+	* collect2.c: Likewise.
+	* cppcharset.c: Likewise.
+	* cpptrad.c: Likewise.
+	* dbxout.c: Likewise.
+	* defaults.h: Likewise.
+	* dwarf2out.c: Likewise.
+	* fold-const.c: Likewise.
+	* genautomata.c: Likewise.
+	* genconditions.c: Likewise.
+	* genflags.c: Likewise.
+	* gengtype.c: Likewise.
+	* integrate.c: Likewise.
+	* loop.c: Likewise.
+	* predict.c: Likewise.
+	* sdbout.c: Likewise.
+
 2004-01-15  Zack Weinberg  <zack@codesourcery.com>
 
 	* config/ia64/ia64.md (*movti_internal): C output template
diff --git a/gcc/c-common.h b/gcc/c-common.h
index b87209e6ae0..2b33373126d 100644
--- a/gcc/c-common.h
+++ b/gcc/c-common.h
@@ -222,7 +222,8 @@ struct c_common_identifier GTY(())
 
 extern GTY(()) tree c_global_trees[CTI_MAX];
 
-/* In a RECORD_TYPE, a sorted array of the fields of the type, not a tree for size reasons.  */
+/* In a RECORD_TYPE, a sorted array of the fields of the type, not a
+   tree for size reasons.  */
 struct sorted_fields_type GTY(())
 {
   int len;
diff --git a/gcc/c-cppbuiltin.c b/gcc/c-cppbuiltin.c
index 739a34224b1..e02960e8532 100644
--- a/gcc/c-cppbuiltin.c
+++ b/gcc/c-cppbuiltin.c
@@ -308,7 +308,7 @@ c_cpp_builtins (cpp_reader *pfile)
   if (flag_exceptions)
     cpp_define (pfile, "__EXCEPTIONS");
 
-  /* represents the C++ ABI version, always defined so it can be used while
+  /* Represents the C++ ABI version, always defined so it can be used while
      preprocessing C and assembler.  */
   if (flag_abi_version == 0)
     /* Use a very large value so that:
@@ -324,7 +324,7 @@ c_cpp_builtins (cpp_reader *pfile)
        "102".  */
     builtin_define_with_int_value ("__GXX_ABI_VERSION", 102);
   else
-    /* Newer versions have values 1002, 1003, ... */
+    /* Newer versions have values 1002, 1003, ....  */
     builtin_define_with_int_value ("__GXX_ABI_VERSION", 
 				   1000 + flag_abi_version);
 
diff --git a/gcc/c-pragma.c b/gcc/c-pragma.c
index e233a5e35fd..00560459a47 100644
--- a/gcc/c-pragma.c
+++ b/gcc/c-pragma.c
@@ -273,7 +273,7 @@ apply_pragma_weak (tree decl, tree value)
     }
 
   if (SUPPORTS_WEAK && DECL_EXTERNAL (decl) && TREE_USED (decl)
-      && !DECL_WEAK (decl) /* don't complain about a redundant #pragma */
+      && !DECL_WEAK (decl) /* Don't complain about a redundant #pragma.  */
       && TREE_SYMBOL_REFERENCED (DECL_ASSEMBLER_NAME (decl)))
     warning ("%Japplying #pragma weak '%D' after first use results "
              "in unspecified behavior", decl, decl);
diff --git a/gcc/calls.c b/gcc/calls.c
index f0a59bbf617..c16bdf10b95 100644
--- a/gcc/calls.c
+++ b/gcc/calls.c
@@ -4691,7 +4691,7 @@ store_one_arg (struct arg_data *arg, rtx argblock, int flags,
 	      if (XEXP (x, 0) != current_function_internal_arg_pointer)
 		i = INTVAL (XEXP (XEXP (x, 0), 1));
 
-	      /* expand_call should ensure this */
+	      /* expand_call should ensure this.  */
 	      if (arg->locate.offset.var || GET_CODE (size_rtx) != CONST_INT)
 		abort ();
 
diff --git a/gcc/collect2.c b/gcc/collect2.c
index a249e4c70b2..11858687ee4 100644
--- a/gcc/collect2.c
+++ b/gcc/collect2.c
@@ -2402,7 +2402,7 @@ scan_libraries (const char *prog_name)
   if (debug)
     fprintf (stderr, "\n");
 
-  /* now iterate through the library list adding their symbols to
+  /* Now iterate through the library list adding their symbols to
      the list.  */
   for (list = libraries.first; list; list = list->next)
     scan_prog_file (list->name, PASS_LIB);
@@ -2538,7 +2538,7 @@ scan_libraries (const char *prog_name)
   signal (SIGQUIT, quit_handler);
 #endif
 
-  /* now iterate through the library list adding their symbols to
+  /* Now iterate through the library list adding their symbols to
      the list.  */
   for (list = libraries.first; list; list = list->next)
     scan_prog_file (list->name, PASS_LIB);
@@ -2705,7 +2705,7 @@ scan_prog_file (const char *prog_name, enum pass which_pass)
 		      char *name;
 
 		      if ((name = ldgetname (ldptr, &symbol)) == NULL)
-			continue;		/* should never happen */
+			continue;		/* Should never happen.  */
 
 #ifdef XCOFF_DEBUGGING_INFO
 		      /* All AIX function names have a duplicate entry
diff --git a/gcc/cppcharset.c b/gcc/cppcharset.c
index 6b69fed639e..1b2d0b2a091 100644
--- a/gcc/cppcharset.c
+++ b/gcc/cppcharset.c
@@ -887,7 +887,7 @@ convert_ucn (cpp_reader *pfile, const uchar *from, const uchar *limit,
   struct cset_converter cvt
     = wide ? pfile->wide_cset_desc : pfile->narrow_cset_desc;
 
-  from++;  /* skip u/U */
+  from++;  /* Skip u/U.  */
   ucn = _cpp_valid_ucn (pfile, &from, limit, 0);
 
   rval = one_cppchar_to_utf8 (ucn, &bufp, &bytesleft);
@@ -966,7 +966,7 @@ convert_hex (cpp_reader *pfile, const uchar *from, const uchar *limit,
     cpp_error (pfile, CPP_DL_WARNING,
 	       "the meaning of '\\x' is different in traditional C");
 
-  from++;  /* skip 'x' */
+  from++;  /* Skip 'x'.  */
   while (from < limit)
     {
       c = *from;
@@ -1148,8 +1148,8 @@ cpp_interpret_string (cpp_reader *pfile, const cpp_string *from, size_t count,
     {
       p = from[i].text;
       if (*p == 'L') p++;
-      p++; /* skip leading quote */
-      limit = from[i].text + from[i].len - 1; /* skip trailing quote */
+      p++; /* Skip leading quote.  */
+      limit = from[i].text + from[i].len - 1; /* Skip trailing quote.  */
 
       for (;;)
 	{
diff --git a/gcc/cpptrad.c b/gcc/cpptrad.c
index 08636edb7a5..3d23cab1fe4 100644
--- a/gcc/cpptrad.c
+++ b/gcc/cpptrad.c
@@ -361,7 +361,7 @@ _cpp_scan_out_logical_line (cpp_reader *pfile, cpp_macro *macro)
   pfile->out.cur = pfile->out.base;
   pfile->out.first_line = pfile->line;
   /* start_of_input_line is needed to make sure that directives really,
-     really start at the first character of the line. */
+     really start at the first character of the line.  */
   start_of_input_line = pfile->buffer->cur;
  new_context:
   context = pfile->context;
diff --git a/gcc/dbxout.c b/gcc/dbxout.c
index 2c6ff7b56e2..46fc026482a 100644
--- a/gcc/dbxout.c
+++ b/gcc/dbxout.c
@@ -2349,7 +2349,7 @@ dbxout_symbol (tree decl, int local ATTRIBUTE_UNUSED)
 		}
 	      else if (TREE_CODE (TREE_TYPE (decl)) == REAL_TYPE)
 		{
-		  /* don't know how to do this yet.  */
+		  /* Don't know how to do this yet.  */
 		}
 	      break;
 	    }
diff --git a/gcc/defaults.h b/gcc/defaults.h
index 68ab0ab20b2..23539485f51 100644
--- a/gcc/defaults.h
+++ b/gcc/defaults.h
@@ -86,7 +86,7 @@ do { fputs (integer_asm_op (POINTER_SIZE / UNITS_PER_WORD, TRUE), FILE); \
    } while (0)
 #endif
 
-/* choose a reasonable default for ASM_OUTPUT_ASCII.  */
+/* Choose a reasonable default for ASM_OUTPUT_ASCII.  */
 
 #ifndef ASM_OUTPUT_ASCII
 #define ASM_OUTPUT_ASCII(MYFILE, MYSTRING, MYLENGTH) \
diff --git a/gcc/dwarf2out.c b/gcc/dwarf2out.c
index f1f977113d5..1ee8f9fcde1 100644
--- a/gcc/dwarf2out.c
+++ b/gcc/dwarf2out.c
@@ -11916,7 +11916,7 @@ gen_namespace_die (tree decl)
   dw_die_ref context_die = setup_namespace_context (decl, comp_unit_die);
 
   /* Namespace aliases have a DECL_ABSTRACT_ORIGIN of the namespace
-     they are an alias of. */
+     they are an alias of.  */
   if (DECL_ABSTRACT_ORIGIN (decl) == NULL)
     {
       /* Output a real namespace.  */
diff --git a/gcc/fold-const.c b/gcc/fold-const.c
index fb9f037a696..b226215e9b0 100644
--- a/gcc/fold-const.c
+++ b/gcc/fold-const.c
@@ -798,7 +798,7 @@ div_and_round_double (enum tree_code code, int uns,
       abort ();
     }
 
-  /* compute true remainder:  rem = num - (quo * den)  */
+  /* Compute true remainder:  rem = num - (quo * den)  */
   mul_double (*lquo, *hquo, lden_orig, hden_orig, lrem, hrem);
   neg_double (*lrem, *hrem, lrem, hrem);
   add_double (lnum_orig, hnum_orig, *lrem, *hrem, lrem, hrem);
diff --git a/gcc/genautomata.c b/gcc/genautomata.c
index 54d677e3290..179564ad052 100644
--- a/gcc/genautomata.c
+++ b/gcc/genautomata.c
@@ -8666,7 +8666,7 @@ output_internal_insn_latency_func (void)
       {
 	decl = description->decls[i];
 	if (DECL_INSN_RESERV (decl)->default_latency > UCHAR_MAX
-	    && tabletype[0] != 'i')  /* don't shrink it */
+	    && tabletype[0] != 'i')  /* Don't shrink it.  */
 	  tabletype = "unsigned short";
 	if (DECL_INSN_RESERV (decl)->default_latency > USHRT_MAX)
 	  tabletype = "int";
diff --git a/gcc/genconditions.c b/gcc/genconditions.c
index 32ac5aef475..86e3544a7bf 100644
--- a/gcc/genconditions.c
+++ b/gcc/genconditions.c
@@ -35,7 +35,7 @@
 #include "hashtab.h"
 #include "gensupport.h"
 
-/* so we can include except.h in the generated file */
+/* so we can include except.h in the generated file.  */
 static int saw_eh_return;
 
 static htab_t condition_table;
diff --git a/gcc/genflags.c b/gcc/genflags.c
index 268da76ee67..66e6bd1df01 100644
--- a/gcc/genflags.c
+++ b/gcc/genflags.c
@@ -209,7 +209,7 @@ gen_insn (rtx insn)
     max_id_len = len;
 
   if (truth == 0)
-    /* emit nothing */;
+    /* Emit nothing.  */;
   else if (truth == 1)
     printf ("#define HAVE_%s 1\n", name);
   else
diff --git a/gcc/gengtype.c b/gcc/gengtype.c
index 784d551fb8a..6655d3cc37d 100644
--- a/gcc/gengtype.c
+++ b/gcc/gengtype.c
@@ -1947,7 +1947,7 @@ write_func_for_structure  (type_p orig_s, type_p s, type_p *param,
   d.bitmap = s->u.s.bitmap;
   d.param = param;
   d.prev_val[0] = "*x";
-  d.prev_val[1] = "not valid postage";  /* guarantee an error */
+  d.prev_val[1] = "not valid postage";  /* Guarantee an error.  */
   d.prev_val[3] = "x";
   d.val = "(*x)";
 
@@ -2200,7 +2200,7 @@ write_local_func_for_structure (type_p orig_s, type_p s, type_p *param)
   d.bitmap = s->u.s.bitmap;
   d.param = param;
   d.prev_val[0] = d.prev_val[2] = "*x";
-  d.prev_val[1] = "not valid postage";  /* guarantee an error */
+  d.prev_val[1] = "not valid postage";  /* Guarantee an error.  */
   d.prev_val[3] = "x";
   d.val = "(*x)";
 
diff --git a/gcc/integrate.c b/gcc/integrate.c
index 47327de03b9..b5efc02b1a6 100644
--- a/gcc/integrate.c
+++ b/gcc/integrate.c
@@ -1421,7 +1421,7 @@ copy_insn_list (rtx insns, struct inline_remap *map, rtx static_chain_value)
 		  gen_rtx_MEM (GET_MODE (static_chain_incoming_rtx),
 			       SET_DEST (set));
 
-	      /* emit the instruction in case it is used for something
+	      /* Emit the instruction in case it is used for something
 		 other than setting the static chain; if it's not used,
 		 it can always be removed as dead code */
 	      copy = emit_insn (copy_rtx_and_substitute (pattern, map, 0));
diff --git a/gcc/loop.c b/gcc/loop.c
index 96f49998e69..0892724b4af 100644
--- a/gcc/loop.c
+++ b/gcc/loop.c
@@ -8105,7 +8105,7 @@ check_dbra_loop (struct loop *loop, int insn_count)
 	  && (INTVAL (bl->initial_value)
 	      % (-INTVAL (bl->biv->add_val))) == 0)
 	{
-	  /* register always nonnegative, add REG_NOTE to branch */
+	  /* Register always nonnegative, add REG_NOTE to branch.  */
 	  if (! find_reg_note (jump, REG_NONNEG, NULL_RTX))
 	    REG_NOTES (jump)
 	      = gen_rtx_EXPR_LIST (REG_NONNEG, bl->biv->dest_reg,
diff --git a/gcc/predict.c b/gcc/predict.c
index 5f7daea03d3..f2b4068df1a 100644
--- a/gcc/predict.c
+++ b/gcc/predict.c
@@ -468,7 +468,7 @@ estimate_probability (struct loops *loops_info)
 		   / exits);
 	}
       
-      /* Free basic blocks from get_loop_body. */
+      /* Free basic blocks from get_loop_body.  */
       free (bbs);
     }
 
diff --git a/gcc/sdbout.c b/gcc/sdbout.c
index 9175417a758..b6380ebb821 100644
--- a/gcc/sdbout.c
+++ b/gcc/sdbout.c
@@ -1159,7 +1159,7 @@ sdbout_one_type (tree type)
 	      }
 	  }
 
-	/* output the individual fields */
+	/* Output the individual fields.  */
 
 	if (TREE_CODE (type) == ENUMERAL_TYPE)
 	  {
@@ -1206,7 +1206,7 @@ sdbout_one_type (tree type)
 		  }
 		PUT_SDB_ENDEF;
 	      }
-	/* output end of a structure,union, or enumeral definition */
+	/* Output end of a structure,union, or enumeral definition.  */
 
 	PUT_SDB_PLAIN_DEF ("eos");
 	PUT_SDB_INT_VAL (size);