From: Ian Lance Taylor Date: Fri, 3 Jan 1997 03:13:47 +0000 (+0000) Subject: * NOTES, NOTES.config: Removed. These are rarely, if ever, X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=0abdf2800c19fc4cb43e4e7464b837cd8a1b08ba;p=binutils-gdb.git * NOTES, NOTES.config: Removed. These are rarely, if ever, updated, and all the useful information is in doc/internals.texi. --- diff --git a/gas/.Sanitize b/gas/.Sanitize index 3eddc6a002c..f2503995450 100644 --- a/gas/.Sanitize +++ b/gas/.Sanitize @@ -29,8 +29,6 @@ ChangeLog ChangeLog.1 Makefile.in NEWS -NOTES -NOTES.config README README-vms acconfig.h diff --git a/gas/ChangeLog b/gas/ChangeLog index 349e17b04ea..90b0c583b60 100644 --- a/gas/ChangeLog +++ b/gas/ChangeLog @@ -1,5 +1,8 @@ Thu Jan 2 13:37:29 1997 Ian Lance Taylor + * NOTES, NOTES.config: Removed. These are rarely, if ever, + updated, and all the useful information is in doc/internals.texi. + Based on patch from Ronald F. Guilmette : * read.c (read_a_source_file): Check for conditional operators before doing an MRI pending alignment. diff --git a/gas/NOTES b/gas/NOTES deleted file mode 100644 index 18b29b81914..00000000000 --- a/gas/NOTES +++ /dev/null @@ -1,107 +0,0 @@ --*- text -*- - -PORTING: - -Sorry, no description of the interfaces is written up yet. Look at existing -back ends and work from there. - -New hosts: The configure script, which is generated by autoconf, -should handle all host specific configuration. - -New target formats: Look at the BFD_ASSEMBLER code. The a.out or ELF -code might be a fair example. There are no "good" examples yet, -unfortunately, nor any good documentation of the changes. - -New target processors: Check first to see if the BFD_ASSEMBLER interface is -supported by the file format code you need to use. - -DOCUMENTATION: - -The internals of gas need documenting. - -The documentation should also contain a "Trouble" section similar to gcc's -manual: real bugs, common problems, incompatibilities, etc. - -Anyone want to offer to maintain a man page? - -BFD CONVERSION: - -The "#ifdef BFD_ASSEMBLER" code is on its way in; the "#ifndef BFD_ASSEMBLER" -code is on its way out. The new code uses BFD data structures, and calls BFD -for anything that needs to be written to the output file. The old code did all -the writing itself, or in a couple of cases, used BFD as a slightly higher -level than stdio (i.e., bfd_seek, bfd_write -- these are not the preferred -interface). - -Because of this, some of this code is messy. Lots of ifdef's, and the -non-BFD_ASSEMBLER version often has multiple conditional tests inside it for -various processors or formats. As the various targets get converted over, -these will gradually go away. - -TO DO: - -Remove DONTDEF code, commented-out code. - -Eliminate, as much as possible, anything not in config that is conditionalized -on a CPU, format, or environment. - -Merge COFF support into one version, supporting all the pseudo-ops used in -either versions now, but using BFD for high-level operations. (See second -following item.) Currently there are two versions (plus the new BFD code), -which support different features, and are used on different targets. - -Convert remaining a.out/b.out targets to using the BFD_ASSEMBLER code by -default. - -Finish conversion to using BFD for all object file writing. (This is the -BFD_ASSEMBLER code, not BFD or BFD_HEADERS.) VMS might be the tough one here, -since there's no BFD support for it at all yet. Eliminate the old code. Some -of this can be done target by target, so doing a target where the CPU or -format already supports BFD_ASSEMBLER mode may be easiest. - -Fix lots of uses of empty strings to use null pointers. Will improve -efficiency, and should make code clearer too. - -Clean up comments; lots of 'em are one previous maintainer griping about -another previous maintainer, unrelated to the code. (And with no names, -they're not so fun to read. :-) - -For sparc: "call 0" becomes "jmpl %g0,%l7", and similarly for absolute -addresses in -4096...4095. (Solaris assembler does this. No -relocation required, no absolute symbol needed.) For addresses -outside the range, for COFF, keep generating an absolute symbol to use -for relocs. - -Get Steve to document H8/500 stuff (and others). - -Improve test suite. Incorporate more reported net bugs, and non-confidential -Cygnus customer bugs, and anything else. - -Add support for i386/i486 16-bit mode, so operating system initialization code -doesn't require a separate assembler nor lots of `.byte' directives. - -See if it's more maintainable (and not too much of a performance loss) to use -a yacc grammar for parsing input. The lexer will have to be flexible, and the -grammar will have to contain any construct used on any platform, but it may be -easier to maintain, instead of having code in most of the back ends. - -PIC support. - -Torbjorn Granlund writes, regarding alpha .align: - - Please make sure the .align directive works as in digital's assembler. - They fill the space with a sequence of "bis $31,$31,$31;ldq_u $31,0($30)" - since these two instructions can dual-issue. Since .align is ued a lot by - gcc, it is an important optimization. - -(From old "NOTES" file to-do list, not really reviewed:) - -fix relocation types for i860, perhaps by adding a ref pointer to fixS? - -remove the ifdef's from fx_callj tests? - -space tighten sparc alignment? - -md_ => tc_ - -share b.out with a.out. diff --git a/gas/NOTES.config b/gas/NOTES.config deleted file mode 100644 index bc473be6ba3..00000000000 --- a/gas/NOTES.config +++ /dev/null @@ -1,42 +0,0 @@ - - The GAS Configuration Plan - -Theory: - -The goal of the new configuration scheme is to bury all object format -and target processor dependancies in object and target specific files. -That is, to move all #ifdef's out of the gas common code. - -Here's how it works. There is a .h and a .c file for each object file -format and a .h and a .c file for each target processor. The -configure script creates symlinks in the current directory to the -appropriate files in the config directory. configure also serves as a -list of triplets {host, target, object-format} that have been tested -at one time or another. I also recommend that configure be used to -document triplet specific notes as to purpose of the triplet, etc. - -Implementation: - -obj-format.h is a {sym}link to .../config/obj-something.h. It is intended - -All gas .c files include as.h. - -as.h #define's "GAS", includes config.h, defines a number of gas -specific structures and types, and then includes tc.h, obj.h, and -targ-env.h. - -targ-env.h defines a target environment specific preprocessor flag, -eg, TE_SUN, and then includes obj-format.h. - -obj-format.h defines an object format specific preprocessor flag, eg, -OBJ_AOUT, OBJ_BOUT, OBJ_COFF, includes "targ-cpu.h", and then defines -the object specific macros, functions, types, and structures. - -targ-cpu.h - -targ-cpu.c - -Porting: - -There appear to be four major types of ports; new hosts, new target -processors, new object file formats, and new target environments.