projects / deliverable / binutils-gdb.git / blame
| Commit | Line | Data |
|---|---|---|
| 07c788ce | 1 | -*- text -*- |
| 0e39a8bb | 2 | |
| 07c788ce | 3 | PORTING: |
| 542e1629 | 4 | |
| 07c788ce KR |
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? | |
| c6cfc5b5 | 73 | |
| 0e39a8bb | 74 | remove the ifdef's from fx_callj tests? |
| 0e39a8bb | 75 | |
| 07c788ce | 76 | space tighten sparc alignment? |
| 542e1629 | 77 | |
| 07c788ce | 78 | md_ => tc_ |
| 0e39a8bb | 79 | |
| 07c788ce | 80 | share b.out with a.out. |