gas/NOTES

   1 -*- text -*-
   2
   3 PORTING:
   4
   5 Sorry, no description of the interfaces is written up yet.  Look at existing
   6 back ends and work from there.
   7
   8 New hosts: If your host system has a strange header file setup, create a
   9 config/ho-foo.h file for it and include the appropriate header files or
  10 definitions there.  If your host has a broken compiler, or some broken macros
  11 in header files, create a host-specific file and repair the damage there.
  12 (See, for example, ho-rs6000.h.  The "assert" macro on that system doesn't work
  13 right, and a flag is set to rewrite an expression in tc-m68k.c that the native
  14 compiler mis-compiles.)
  15
  16 New target formats: Look at the BFD_ASSEMBLER code.  The a.out code might be a
  17 fair example.  There are no "good" examples yet, unfortunately, nor any good
  18 documentation of the changes.
  19
  20 New target processors: Check first to see if the BFD_ASSEMBLER interface is
  21 supported by the file format code you need to use.
  22
  23 New environments: ???
  24
  25 DOCUMENTATION:
  26
  27 The internals of gas need documenting.  (Actually, there is some documentation
  28 in doc/as.texinfo, but it's *way* out of date.)
  29
  30 The documentation should also contain a "Trouble" section similar to gcc's
  31 manual: real bugs, common problems, incompatibilities, etc.
  32
  33 Anyone want to offer to maintain a man page?
  34
  35 BFD CONVERSION:
  36
  37 The "#ifdef BFD_ASSEMBLER" code is on its way in; the "#ifndef BFD_ASSEMBLER"
  38 code is on its way out.  The new code uses BFD data structures, and calls BFD
  39 for anything that needs to be written to the output file.  The old code did all
  40 the writing itself, or in a couple of cases, used BFD as a slightly higher
  41 level than stdio (i.e., bfd_seek, bfd_write -- these are not the preferred
  42 interface).
  43
  44 Because of this, some of this code is messy.  Lots of ifdef's, and the
  45 non-BFD_ASSEMBLER version often has multiple conditional tests inside it for
  46 various processors or formats.  As the various targets get converted over,
  47 these will gradually go away.
  48
  49 As of the moment I'm editing this file, only the "sun4" and "decstation-bsd"
  50 targets can really use the BFD code.  Other back ends still need merging or
  51 touching up.
  52
  53 TO DO:
  54
  55 Remove DONTDEF code, commented-out code.
  56
  57 Eliminate, as much as possible, anything not in config that is conditionalized
  58 on a CPU, format, or environment.
  59
  60 Finish conversion to using BFD for all object file writing.  (This is the
  61 BFD_ASSEMBLER code, not BFD or BFD_HEADERS.)  VMS might be the tough one here,
  62 since there's no BFD support for it at all yet.  Eliminate the old code.
  63
  64 Fix lots of uses of empty strings to use null pointers.  Will improve
  65 efficiency, and should make code clearer too.
  66
  67 Clean up comments; lots of 'em are one previous maintainer griping about
  68 another previous maintainer, unrelated to the code.  (And with no names,
  69 they're not so fun to read. :-)
  70
  71 Lots of documentation.
  72
  73 Get Steve to document H8/500 stuff.
  74
  75 Put together a test suite, using DejaGnu.
  76
  77 (From old "NOTES" file to-do list, not really reviewed:)
  78
  79 fix relocation types for i860, perhaps by adding a ref pointer to fixS?
  80
  81 remove the ifdef's from fx_callj tests?
  82
  83 space tighten sparc alignment?
  84
  85 md_ => tc_
  86
  87 share b.out with a.out.