Remove COFF_NO_LONG_FILE_NAMES define, now gone.
authorJohn Gilmore <gnu@cygnus>
Fri, 5 Feb 1993 22:11:01 +0000 (22:11 +0000)
committerJohn Gilmore <gnu@cygnus>
Fri, 5 Feb 1993 22:11:01 +0000 (22:11 +0000)
gdb/doc/ChangeLog
gdb/doc/gdbint.texinfo

index ea810621fac53af45409dcd59ccb0389922206aa..ff77488c1c5edace28a4e64d440e2c11d6102cd4 100644 (file)
@@ -1,3 +1,7 @@
+Fri Feb  5 14:10:15 1993  John Gilmore  (gnu@cygnus.com)
+
+       * gdbint.texinfo:  Remove COFF_NO_LONG_FILE_NAMES define, now gone.
+
 Thu Feb  4 13:56:46 1993  Ian Lance Taylor  (ian@cygnus.com)
 
        * gdbint.texinfo: Slightly expand section on supporting a new
index 6e111c6ceb90882f4f569d93121e9eaa5333d714..84bfa3288b229d835ce5e627bb90381fb8ee4ad6 100644 (file)
@@ -540,12 +540,25 @@ If you are using an existing object file format (a.out or COFF),
 there is probably little to be done.  See @file{bfd/doc/bfd.texinfo}
 for more information on writing new a.out or COFF versions.
 
-If you need to add a new object file format, you are beyond the scope
-of this document right now.  Look at the structure of the a.out
-and COFF support, build a transfer vector (@code{xvec}) for your new format,
-and start populating it with routines.  Add it to the list in
+If you need to add a new object file format, you must first add it to
+BFD.  This is beyond the scope of this document right now.  Basically
+you must build a transfer vector (of type @code{bfd_target}), which will
+mean writing all the required routines, and add it to the list in
 @file{bfd/targets.c}.
 
+You must then arrange for the BFD code to provide access to the
+debugging symbols.  Generally GDB will have to call swapping routines
+from BFD and a few other BFD internal routines to locate the debugging
+information.  As much as possible, GDB should not depend on the BFD
+internal data structures.
+
+For some targets (e.g., COFF), there is a special transfer vector used
+to call swapping routines, since the external data structures on various
+platforms have different sizes and layouts.  Specialized routines that
+will only ever be implemented by one object file format may be called
+directly.  This interface should be described in a file
+@file{bfd/libxxx.h}, which is included by GDB.
+
 If you are adding a new operating system for an existing CPU chip, add a
 @file{tm-@var{xos}.h} file that describes the operating system
 facilities that are unusual (extra symbol table info; the breakpoint
@@ -1367,8 +1380,6 @@ objfiles.c
 hppabsd-tdep.c
 @item COFF_FORMAT
 symm-tdep.c
-@item COFF_NO_LONG_FILE_NAMES
-coffread.c
 @item CORE_NEEDS_RELOCATION
 stack.c
 @item CPLUS_MARKER
@@ -1974,8 +1985,6 @@ objfiles.c
 hppabsd-tdep.c
 @item COFF_FORMAT
 symm-tdep.c
-@item COFF_NO_LONG_FILE_NAMES
-coffread.c
 @item CORE_NEEDS_RELOCATION
 stack.c
 @item CPLUS_MARKER