home *** CD-ROM | disk | FTP | other *** search
/ Sams Teach Yourself C in 21 Days (6th Edition) / STYC216E.ISO / pc / DJGPP / v2gnu / bnu2951.README < prev    next >
Text File  |  2000-03-01  |  4KB  |  104 lines
  1. This is an updated version of readme.dos from the Binutils 2.9.5.1
  2. beta release. This version will provide updates on known problems as they
  3. are discovered.
  4.  
  5. This is a DOS/DJGPP port of GNU Binutils from the CVS repository
  6. as of February 27th, 2000.
  7.  
  8. Contents
  9. ========
  10.  
  11. * Installing the binary
  12. * DJGPP port notes
  13. * Building from sources
  14. * Bug reports & Known problems
  15. * Thanks
  16.  
  17. Installing the binary
  18. =====================
  19.  
  20. Unzip the binary package with the option to preserve directories 
  21. (the -d option in PKUNZIP, the -directories option in PKZIP 2.5 and above)
  22. from the top of your DJGPP directory tree.
  23.  
  24. DJGPP port notes
  25. ================
  26.  
  27. * This is a beta release, so do expect to find a few problems.
  28. * Weak symbols are now supported, along with the '.gnu.linkonce' feature
  29.   for C++ templates. DJGPP ports of gcc 2.95.2 and later can generate
  30.   weak symbols with the -mbnu210 command line switch.
  31. * General fixes are included for handling drive names and the
  32.   path separator not yet in the Binutils repository. See diffs.dos
  33. * Intel MMX and SSE instructions are now supported.
  34. * AMD 3dNow! instructions are now supported.
  35. * Long section names are now supported.
  36. * The .data and .text sections are now aligned at 16-bytes.
  37. * The binaries were built with DJGPP 2.03, so it understands the new
  38.   '/dev/env/FOO' syntax. This is important when building packages with
  39.   Bash 2.03 or later.
  40. * Please see the documentation for other new features in this beta release.
  41. * Due to the amount of space taken up by files not used by the DJGPP build,
  42.   the source has been split into two sections.
  43.     + bnu2951s.zip contains just the sources needed to build Binutils
  44.       for DJGPP.
  45.     + bnu2951x.zip contains the rest of the sources needed to build
  46.       Binutils for all other targets.
  47.  
  48. Building from sources
  49. =====================
  50.  
  51. You will need:
  52.  
  53. * bnu2951s.zip when building for DJGPP. Does not require a LFN environment.
  54.   However, certain files containing Changelog entries clash when unpacked
  55.   in plain DOS.
  56. * bnu2951x.zip in addition to bnu2951s.zip for a cross build. May require
  57.   a LFN environment for certain targets.
  58. * Bash 2.03 or later.
  59. * A GCC compiler and existing Binutils.
  60. * Make 3.78 or later.
  61. * Sed 3.02 or later.
  62. * Fileutils 3.16 or later.
  63. * DJGPP v2.03
  64. * and possibly more packages
  65.  
  66. Unzip the source archive with the option to preserve directories
  67. (the -d option in the old PKUNZIP, the -directories option in newer
  68. versions of PKZIP) from the top of your DJGPP directory tree. Install
  69. the Bash binary and required utilities if you haven't already done so.
  70.  
  71. The sources come ready to build, so all you need do is type 'make' and
  72. then find something else to do for a while.
  73.  
  74. Changes were made to ylwrap and Makefile.in to handle the default output
  75. filenames produced by DJGPP's Bison. See 'diffs.dos' for a patch that can
  76. be applied to the sources from the Binutils CVS or Binutils snapshots.
  77. Eli Zaretskii's changes for handling drive names and the path separator
  78. are also included.
  79.  
  80. To re-configure, you can run 'djconfig.bat'. It will set the proper variables
  81. before running 'configure'. Or at least view the file to see what variables
  82. you need to set before running 'configure' yourself.
  83.  
  84.  
  85. Bug reports & Known Problems
  86. ============================
  87.  
  88. Please send DJGPP-specific bug reports to the newsgroup comp.os.msdos.djgpp
  89. or to the e-mail gateway djgpp@delorie.com. All other bug reports should be
  90. sent to binutils@sourceware.cygnus.com .
  91.  
  92. Known problems in bnu2951s.zip and bnu2951x.zip:
  93. *  The '--enable-targets=all' option for 'configure' is broken.
  94.  
  95. Thanks
  96. ======
  97.  
  98. Thanks to Eli Zaretskii for his fixes for Binutils bugs not yet integrated
  99. into the Binutils repository.
  100.  
  101.  
  102. Mark E. <snowball3@bigfoot.com>
  103.  
  104.