[patch] h8300.c: Put a comment for every function.

[Kazu Hirata]

Hi,

Committed.

Kazu Hirata

2004-03-04  Kazu Hirata  <kazu@cs.umass.edu>

	* config/h8300/h8300.c: Put a comment for every function.

Index: h8300.c
===================================================================
RCS file: /cvs/gcc/gcc/gcc/config/h8300/h8300.c,v
retrieving revision 1.286
diff -u -r1.286 h8300.c
--- h8300.c	2 Mar 2004 02:20:20 -0000	1.286
+++ h8300.c	4 Mar 2004 18:48:23 -0000
@@ -330,6 +330,10 @@
     }
 }
 
+/* Return the byte register name for a register rtx X.  B should be 0
+   if you want a lower byte register.  B should be 1 if you want an
+   upper byte register.  */
+
 static const char *
 byte_reg (rtx x, int b)
 {
@@ -568,6 +572,9 @@
   h8300_emit_stack_adjustment (-1, round_frame_size (get_frame_size ()));
 }
 
+/* Return nonzero if we can use "rts" for the function currently being
+   compiled.  */
+
 int
 h8300_can_use_return_insn_p (void)
 {
@@ -913,6 +920,8 @@
 	  && EXTRA_CONSTRAINT (op, 'U'));
 }
 
+/* Return nonzero if OP is a MEM suitable for bit manipulation insns.  */
+
 int
 bit_memory_operand (rtx op, enum machine_mode mode ATTRIBUTE_UNUSED)
 {
@@ -1014,6 +1023,8 @@
   return result;
 }
 
+/* Compute the cost of an and insn.  */
+
 static int
 h8300_and_costs (rtx x)
 {
@@ -1033,6 +1044,8 @@
   return compute_logical_op_length (GET_MODE (x), operands) / 2;
 }
 
+/* Compute the cost of a shift insn.  */
+
 static int
 h8300_shift_costs (rtx x)
 {
@@ -1050,6 +1063,8 @@
   return compute_a_shift_length (NULL, operands) / 2;
 }
 
+/* Worker function for TARGET_RTX_COSTS.  */
+
 static bool
 h8300_rtx_costs (rtx x, int code, int outer_code, int *total)
 {
@@ -1642,6 +1657,8 @@
     abort ();
 }
 
+/* Worker function for RETURN_ADDR_RTX.  */
+
 rtx
 h8300_return_addr_rtx (int count, rtx frame)
 {
@@ -2089,6 +2106,8 @@
     }
 }
 
+/* Output an addition insn.  */
+
 const char *
 output_plussi (rtx *operands)
 {
@@ -2162,6 +2181,8 @@
     }
 }
 
+/* Compute the length of an addition insn.  */
+
 unsigned int
 compute_plussi_length (rtx *operands)
 {
@@ -2230,6 +2251,8 @@
     }
 }
 
+/* Compute which flag bits are valid after an addition insn.  */
+
 int
 compute_plussi_cc (rtx *operands)
 {
@@ -2283,6 +2306,8 @@
     }
 }
 
+/* Output a logical insn.  */
+
 const char *
 output_logical_op (enum machine_mode mode, rtx *operands)
 {
@@ -2457,6 +2482,8 @@
   return "";
 }
 
+/* Compute the length of a logical insn.  */
+
 unsigned int
 compute_logical_op_length (enum machine_mode mode, rtx *operands)
 {
@@ -2600,6 +2627,8 @@
   return length;
 }
 
+/* Compute which flag bits are valid after a logical insn.  */
+
 int
 compute_logical_op_cc (enum machine_mode mode, rtx *operands)
 {
@@ -3457,7 +3486,7 @@
 	  || (TARGET_H8300H && mode == SImode && count == 8));
 }
 
-/* Emit the assembler code for doing shifts.  */
+/* Output the assembler code for doing shifts.  */
 
 const char *
 output_a_shift (rtx *operands)
@@ -3611,6 +3640,8 @@
     }
 }
 
+/* Count the number of assembly instructions in a string TEMPLATE.  */
+
 static unsigned int
 h8300_asm_insn_count (const char *template)
 {
@@ -3623,6 +3654,8 @@
   return count;
 }
 
+/* Compute the length of a shift insn.  */
+
 unsigned int
 compute_a_shift_length (rtx insn ATTRIBUTE_UNUSED, rtx *operands)
 {
@@ -3771,6 +3804,8 @@
     }
 }
 
+/* Compute which flag bits are valid after a shift insn.  */
+
 int
 compute_a_shift_cc (rtx insn ATTRIBUTE_UNUSED, rtx *operands)
 {
@@ -3943,7 +3978,7 @@
   return 1;
 }
 
-/* Output rotate insns.  */
+/* Output a rotate insn.  */
 
 const char *
 output_a_rotate (enum rtx_code code, rtx *operands)
@@ -4052,6 +4087,8 @@
   return "";
 }
 
+/* Compute the length of a rotate insn.  */
+
 unsigned int
 compute_a_rotate_length (rtx *operands)
 {
@@ -4416,6 +4453,8 @@
     SYMBOL_REF_FLAGS (XEXP (rtl, 0)) |= extra_flags;
 }
 
+/* Output a single-bit extraction.  */
+
 const char *
 output_simode_bld (int bild, rtx operands[])
 {
@@ -4543,6 +4582,9 @@
 
 }
 
+/* Return nonzero if ADDR1 and ADDR2 point to consecutive memory
+   locations that can be accessed as a 16-bit word.  */
+
 int
 byte_accesses_mergeable_p (rtx addr1, rtx addr2)
 {
@@ -4758,6 +4800,8 @@
   set_optab_libfunc (umod_optab, HImode, "__umodhi3");
 }
 
+/* Worker function for TARGET_RETURN_IN_MEMORY.  */
+
 static bool
 h8300_return_in_memory (tree type, tree fntype ATTRIBUTE_UNUSED)
 {