summaryrefslogtreecommitdiff
path: root/gnu/usr.bin/binutils/gas/NOTES.config
diff options
context:
space:
mode:
Diffstat (limited to 'gnu/usr.bin/binutils/gas/NOTES.config')
-rw-r--r--gnu/usr.bin/binutils/gas/NOTES.config28
1 files changed, 9 insertions, 19 deletions
diff --git a/gnu/usr.bin/binutils/gas/NOTES.config b/gnu/usr.bin/binutils/gas/NOTES.config
index e12797d51c1..79832e64d7a 100644
--- a/gnu/usr.bin/binutils/gas/NOTES.config
+++ b/gnu/usr.bin/binutils/gas/NOTES.config
@@ -3,30 +3,20 @@
Theory:
-The goal of the new configuration scheme is to bury all object format,
-target processor, and host machine dependancies in object, target, and
-host specific files. That is, to move all #ifdef's out of the gas
-common code.
+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, a .h and a .c file for each target processor, and a .h for
-each host. config.gas creates {sym}links in the current directory to
-the appropriate files in the config directory. config.gas also serves
-as a list of triplets {host, target, object-format} that have been
-tested at one time or another. I also recommend that config.gas be
-used to document triplet specific notes as to purpose of the triplet,
-etc.
+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:
-host.h is a {sym}link to .../config/xm-yourhost.h. It is intended to
-be used to hide host compiler, system header file, and system library
-differences between host machines. If your host needs actual c source
-files, then either: these are generally useful functions, in which
-case you should probably build a local library outside of the gas
-source tree, or someone, perhaps me, is confused about what is needed
-by different hosts.
-
obj-format.h is a {sym}link to .../config/obj-something.h. It is intended
All gas .c files include as.h.