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