From d5337b4c1301ee68aa243ffbb0acc1ba25686d33 Mon Sep 17 00:00:00 2001
From: Tim Wall <twall@redhat.com>
Date: Sat, 8 Apr 2000 17:26:16 +0000
Subject: [PATCH] Fix copyright comments and file comments.

---
 include/coff/ti.h     | 20 +++++++++++++-------
 include/coff/tic54x.h |  7 +++++--
 2 files changed, 18 insertions(+), 9 deletions(-)

diff --git a/include/coff/ti.h b/include/coff/ti.h
index 06a315b8a..6a9378136 100644
--- a/include/coff/ti.h
+++ b/include/coff/ti.h
@@ -1,4 +1,8 @@
-/*** COFF information for generic Texas Instruments COFF flavour */
+/* COFF information for TI COFF support.  Definitions in this file should be
+   customized in a target-specific file, and then this file included (see
+   tic54x.h for an example). */
+#ifndef COFF_TI_H
+#define COFF_TI_H
 
 /********************** FILE HEADER **********************/
 
@@ -155,8 +159,6 @@ struct external_scnhdr {
 
 /*
  * Special section flags
- * TI COFF puts the section alignment power of two in the section flags
- * e.g. 2**N is alignment, flags |= (N & 0xF) << 8
  */
 /* recognized load pages */
 #define PG_PROG         0x0         /* PROG page */
@@ -167,6 +169,8 @@ struct external_scnhdr {
    linker output if there are no references found to any symbol in the section
    STYP_BLOCK: the section should be blocked, i.e. if the section would cross
    a page boundary, it is started at a page boundary instead.
+   TI COFF puts the section alignment power of two in the section flags
+   e.g. 2**N is alignment, flags |= (N & 0xF) << 8
 */ 
 #define STYP_CLINK      (0x4000)
 #define STYP_BLOCK      (0x1000)
@@ -238,7 +242,8 @@ PUT_SCNHDR_PAGE(ABFD,((struct internal_scnhdr *)(INT))->s_page, \
 
    c2x, c5x and most c54x devices have 16-bit addresses, but the c548 has
    23-bit program addresses.  make sure the page flags don't interfere 
-
+   These flags are used by GDB to identify the destination page for
+   addresses. 
 */
 
 #define LONG_ADDRESSES  1
@@ -393,8 +398,8 @@ if(src->n_sclass == C_MOU || src->n_sclass == C_MOS) \
 bfd_h_put_32(abfd,src->n_value * 8,(bfd_byte *)dst->e_value); \
 } while (0)
 
-/* detect section-relative absolute symbols so they get flagged with a sym
-   index of -1 
+/* Detect section-relative absolute symbols so they get flagged with a sym
+   index of -1.
 */
 #define SECTION_RELATIVE_ABSOLUTE_SYMBOL_P(RELOC,SECT) \
 ((*(RELOC)->sym_ptr_ptr)->section->output_section == (SECT) \
@@ -428,4 +433,5 @@ struct external_reloc {
 #define R_EXTWORD 0x002B            /* 23-bit direct reference */
 #define R_EXTWORD16 0x002C          /* 16-bit direct reference to 23-bit addr*/
 #define R_EXTWORDMS7 0x002D         /* upper 7 bits of 23-bit address */
-/*EOF*/
+
+#endif /* COFF_TI_H */
diff --git a/include/coff/tic54x.h b/include/coff/tic54x.h
index a2e45f226..433a42a8b 100644
--- a/include/coff/tic54x.h
+++ b/include/coff/tic54x.h
@@ -1,4 +1,7 @@
-/*** COFF information for Texas Instruments TMS320C54X */
+/* TI COFF information for Texas Instruments TMS320C54X.  This file customizes 
+   the settings in coff/ti.h. */
+#ifndef COFF_TIC54X_H
+#define COFF_TIC54X_H
 #define TIC54X_TARGET_ID 0x98
 #define TIC54XALGMAGIC  0x009B  /* c54x algebraic assembler output */
 #define TIC5X_TARGET_ID  0x92
@@ -8,4 +11,4 @@
 #define TICOFF_TARGET_ARCH bfd_arch_tic54x
 #define TICOFF_DEFAULT_MAGIC TICOFF1MAGIC /* we use COFF1 for compatibility */
 #include "coff/ti.h"
-/*EOF*/
+#endif /* COFF_TIC54X_H */