Bring in a trimmed down gcc-3.4-20040618.
[dragonfly.git] / contrib / gcc-3.4 / README.DRAGONFLY
1
2                         GCC-3.3-20040126 AS USED BY DRAGONFLY
3
4     This directory contains a selected set of files from the gnu 
5     gcc-3.4-20040618 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-20040618.tar.bz2) = 6eb0e85c225250cc40b75496419d4250
18
19     UPGRADE PROCDURE:
20
21         * download a new gcc-3.4.X dist greater then 3.4-20040618
22           (the release after this snapshot would be gcc-3.4.1).
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/cc34.
35
36           DO NOT MAKE ANY EDITS TO THE GCC DISTRIBUTION IN THIS CONTRIB
37           DIRECTORY, OTHER THEN TO ADD OR DELETE FILES ASSOCIATED WITH THE
38           GNU DISTRIBUTION.
39
40     Do not overlay major rev changes in the contrib directory or
41     build infrastructure directory for older major revs!  Create a new
42     major rev directory as contrib/gcc-x.x.  The older major revs in
43     contrib/gcc-x.x can be physically removed from the CVS repository,
44     leaving only this file (README.DRAGONFLY) and README.DELETED in place.
45     Older gcc dists can be recovered by manually unpacking older gnu dists
46     in /usr/src/contrib, without CVS support.  Do not physically remove
47     the DFly build infrastructure for older GCCs from
48     /usr/src/gnu/usr.bin/.  cvs delete, sure, but no physical removal,
49     because then you won't be able to revert your cvs tree past a major
50     rev change.
51
52     The file README.DELETED contains a list of deleted files.