contrib/binutils-2.17/README.DRAGONFLY

   1
   2                         BINUTILS-2.17 AS USED BY DRAGONFLY
   3
   4     This directory contains a selected set of files from the gnu
   5     binutils-2.17 distribution.  The entire distribution is 96MB 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.17 DISTRIBUTION.  All modifications are made in the
  12     DragonFly build wrapper, in /usr/src/gnu/usr.bin/binutils217, 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.17.tar.bz2
  18         MD5 (binutils-2.17.tar.bz2) = e26e2e06b6e4bf3acf1dc8688a94c0d1
  19
  20     UPGRADE PROCEDURE:
  21
  22         * download a new binutils > 2.17.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/binutils217.
  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.18, 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
  60     'xargs rm -rf < README.DELETED' to automate removal
  61