Document the recently added WITHOUT_SRCS variable.
[dragonfly.git] / contrib / gcc-4.0 / README.DRAGONFLY
1
2                         GCC-4.0.1 AS USED BY DRAGONFLY
3
4     This directory contains a selected set of files from the gnu 
5     gcc-4.0.1 distribution.  The basis are the `core' and `g++' parts,
6     which are 110MB together, but we really only need 33MB of those.
7     No files have been moved 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/cc40 and
13     /usr/src/gnu/lib/gcc40, 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 SHA1 (gcc-core-4.0.1.tar.bz2) = 6d7a1b8a7af9bfd0b8325af9723e0ae78b38ce74
18 SHA1 (gcc-g++-4.0.1.tar.bz2) = 9248682ad592e5c98303b90463c87993c0e7829a
19
20     UPGRADE PROCEDURE:
21
22         * download a new gcc-4.0.X dist greater then 4.0.1, notably the
23           `core' and `g++' sets.  The complete set is not needed!
24
25         * extract the archive into this directory, overlaying the
26           existing files.
27
28         * A 'cvs update' will show you what has changed ('M') relative 
29           to what we had before.  There will be hundreds of files marked
30           '?' which, if not needed, should be deleted and NOT COMMITTED.
31           If any new files are needed you can cvs add and commit them.
32
33         * Make sure that both buildworld and a crossbuilt buildworld
34           for supported architectures works before committing the upgrade,
35           making adjustments within /usr/src/gnu/usr.bin/cc40.
36
37           DO NOT MAKE ANY EDITS TO THE GCC DISTRIBUTION IN THIS CONTRIB
38           DIRECTORY, OTHER THEN TO ADD OR DELETE FILES ASSOCIATED WITH THE
39           GNU DISTRIBUTION.
40
41     Do not overlay major rev changes in the contrib directory or
42     build infrastructure directory for older major revs!  Create a new
43     major rev directory as contrib/gcc-x.x.  The older major revs in
44     contrib/gcc-x.x can be physically removed from the CVS repository,
45     leaving only this file (README.DRAGONFLY) and README.DELETED in place.
46     Older gcc dists can be recovered by manually unpacking older gnu dists
47     in /usr/src/contrib, without CVS support.  Do not physically remove
48     the DFly build infrastructure for older GCCs from
49     /usr/src/gnu/usr.bin/.  cvs delete, sure, but no physical removal,
50     because then you won't be able to revert your cvs tree past a major
51     rev change.
52
53     The file README.DELETED contains a list of deleted files.