Add -O and -T to the SYNOPSIS.
[dragonfly.git] / contrib / binutils-2.15 / README.DRAGONFLY
1
2                         BINUTILS-2.15 AS USED BY DRAGONFLY
3
4     This directory contains a selected set of files from the gnu 
5     binutils-2.15 distribution.  The entire distribution is 71MB but
6     we really only need around 10MB of it.  No files have been moved
7     or modified from their extracted position.
8
9     DO NOT CREATE OR EDIT ANY FILES IN THIS DIRECTORY HIERARCHY!  THIS
10     HIERARCHY REPRESENTS AN EXACT COPY, MINUS UNNEEDED FILES, OF THE GNU
11     BINUTILS-2.15 DISTRIBUTION.  All modifications are made in the 
12     DragonFly build wrapper, in /usr/src/gnu/usr.bin/binutils214, by
13     creating overrides or performing surgery on the distribution.
14     The only additional files added to this directory are README.DRAGONFLY
15     and README.DELETED.  The base source was fetched from:
16
17         http://ftp.gnu.org/gnu/binutils/binutils-2.15.tar.gz
18         MD5 (binutils-2.15.tar.gz) = ba665d0ddcc88313384b79e293ecbbab
19
20     UPGRADE PROCEDURE:
21
22         * download a new binutils > 2.15.0 from a gnu download site.
23
24         * extract the archive into this directory, overlaying the
25           existing files.
26
27         * A 'cvs update' will show you what has changed ('M') relative 
28           to what we had before.  There will be hundreds of files marked
29           '?' which, if not needed, should be deleted and NOT COMMITTED.
30           If any new files are needed you can cvs add and commit them.
31
32         * Make sure that both buildworld and a crossbuilt buildworld
33           for supported architectures works before committing the upgrade,
34           making adjustments within /usr/src/gnu/usr.bin/binutils214.
35
36           DO NOT MAKE ANY EDITS TO THE BINUTILS DISTRIBUTION IN THIS CONTRIB
37           DIRECTORY!
38
39     binutils is designed to be backwards compatible.  When unpacking a
40     new major rev, e.g. 2.16, it should be placed in a NEW CONTRIB DIRECTORY,
41     and a new infrastructure in /usr/src/gnu/usr.bin/binutilsXXX should be
42     created.  Be sure to commit only those files that the DragonFly build
43     actually needs to avoid bloating the cvs repository.
44
45     Do not overlay major rev changes in the contrib directory or
46     build infrastructure directory for older major revs!  The binutils the 
47     compiler subsystem uses is selected in:
48
49         /usr/src/usr.bin/objformat/objformat.c
50
51     That is what you edit to change the system binutils defaults.  Eventually
52     the physical cvs hierarchy representing older major revs of binutils
53     will be physically removed from the contrib/ hierarchy.   Older binutils
54     can be recovered by manually unpacking older gnu binutils dists in
55     /usr/src/contrib, without CVS support.  Do not physically remove
56     the DragonFly build infrastructure for older binutils from
57     /usr/src/gnu/usr.bin/.  cvs delete, sure, but no physical removal.
58
59     The file README.DELETED contains a list of deleted files.  Simply 'cat
60     READEME.DELETED | xargs rm -rf' to automate removal
61