Merge from vendor branch DHCP:
[dragonfly.git] / contrib / gcc-3.4 / README.DRAGONFLY
1
2                         GCC-3.4.3 AS USED BY DRAGONFLY
3
4     This directory contains a selected set of files from the gnu 
5     gcc-3.4.3 distribution.  The entire distribution is 188MB but
6     we really only need around 31MB 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     GCC DISTRIBUTION.  All modifications are made in the 
12     DragonFly build wrapper, in /usr/src/gnu/usr.bin/cc34 and
13     /usr/src/gnu/lib/gcc34, by creating overrides or performing surgery
14     on the distribution.  The only additional files added to this directory
15     are README.DRAGONFLY and README.DELETED. 
16
17         MD5 (gcc-3.4.3.tar.bz2) = e744b30c834360fccac41eb7269a3011
18
19     UPGRADE PROCDURE:
20
21         * download a new gcc-3.4.X dist greater then 3.4.3.
22
23         * extract the archive into this directory, overlaying the
24           existing files.
25
26         * A 'cvs update' will show you what has changed ('M') relative 
27           to what we had before.  There will be hundreds of files marked
28           '?' which, if not needed, should be deleted and NOT COMMITTED.
29           If any new files are needed you can cvs add and commit them.
30
31         * Make sure that both buildworld and a crossbuilt buildworld
32           for supported architectures works before committing the upgrade,
33           making adjustments within /usr/src/gnu/usr.bin/cc34.
34
35           DO NOT MAKE ANY EDITS TO THE GCC DISTRIBUTION IN THIS CONTRIB
36           DIRECTORY, OTHER THEN TO ADD OR DELETE FILES ASSOCIATED WITH THE
37           GNU DISTRIBUTION.
38
39     Do not overlay major rev changes in the contrib directory or
40     build infrastructure directory for older major revs!  Create a new
41     major rev directory as contrib/gcc-x.x.  The older major revs in
42     contrib/gcc-x.x can be physically removed from the CVS repository,
43     leaving only this file (README.DRAGONFLY) and README.DELETED in place.
44     Older gcc dists can be recovered by manually unpacking older gnu dists
45     in /usr/src/contrib, without CVS support.  Do not physically remove
46     the DFly build infrastructure for older GCCs from
47     /usr/src/gnu/usr.bin/.  cvs delete, sure, but no physical removal,
48     because then you won't be able to revert your cvs tree past a major
49     rev change.
50
51     The file README.DELETED contains a list of deleted files.