home *** CD-ROM | disk | FTP | other *** search
/ Solo Programadores 22 / SOLO_22.iso / gnat / readme < prev   
Encoding:
Internet Message Format  |  1996-04-29  |  24.7 KB

  1. Subject: GNAT README
  2. Last Updated Mar 04, 1996 15:45 EST
  3.  
  4.    +----------------------------------------------------------------------+
  5.    | GNAT is a complete Ada95 compilation system, maintained and          |
  6.    | distributed under the Gnu Public Licence by Ada Core Technologies.   |
  7.    | ACT and ACT-Europe offer commercial support for industrial           |
  8.    | and academic users of GNAT.                                          |
  9.    |                                                                      |
  10.    | For more info:                                                       |
  11.    |   - web site                        http://www.gnat.com              |
  12.    |   - for description of ACT services,                                 |
  13.    |     send empty e-mail to:           info@gnat.com                    |
  14.    |                                     info@act-europe.gnat.com         |
  15.    |                                                                      |
  16.    |   - detailed queries:               support@gnat.com                 |
  17.    |   - Telephone                       212-620-7300 Ext-117 (Nancy Cruz)|
  18.    |   - Fax                             212-807-0162                     |
  19.    +----------------------------------------------------------------------+
  20.  
  21. Bug reports should be sent to report@gnat.com. Please remember to
  22. place your ACT customer number in the subject line to insure high
  23. priority response. Bug reports from unsupported users are welcome
  24. although we cannot guarantee a response.
  25.  
  26. This is the README which is located on cs.nyu.edu
  27. in pub/gnat (via anonymous ftp).  It contains information about recent
  28. distributions of GNAT.  Followers of GNAT are encouraged to check this
  29. file often for news.  This file may be obtained by sending email to:
  30. "gnat-send-readme@cs.nyu.edu".
  31.  
  32. Checking this file is particularly important when encountering
  33. installation difficulties.  News, workarounds, etc. are put in here
  34. so that everyone can benefit most quickly from the discoveries made
  35. as new versions propagate.
  36.  
  37. The Installation Update News will always be near the top under UPDATE NEWS::
  38.  
  39. The pub/gnat directory contains recent releases of GNAT.  It's contents are
  40. described below under CONTENTS::
  41.  
  42. Information pertaining to unpacking the various distributions follow below
  43. under:
  44.  
  45. UNPACKING UNIX DISTRIBUTIONS::
  46. UNPACKING Windows 95 / Windows NT DISTRIBUTIONS::
  47. UNPACKING OS/2 DISTRIBUTIONS::
  48. UNPACKING DOS DISTRIBUTIONS::
  49.  
  50. =================================================================
  51.  
  52.  
  53. UPDATE NEWS::
  54.  
  55. Additional FTP sites which mirror the pub/gnat directory are listed later
  56. on under GNAT Mirror Sites. These sites are generally updated within 24
  57. hours of changes at cs.nyu.edu.
  58.  
  59. gnat 3.03 is now available
  60.  
  61. Version 3.03 release:
  62.    The binary distribution is now available for the following configurations:
  63.       alpha-dec-osf2.0 (will also run on osf3.0)
  64.       dos
  65.       linux (ELF)
  66.       mips-sgi-irix5.3
  67.       sparc-sun-solaris2.3 (will also run on solaris2.4)
  68.       sparc-sun-sunos4.1.3
  69.  
  70.    Other GNAT 3.03 configurations will appear in the near future and this file
  71.    will be updated to reflect that.
  72.  
  73. Latest features in GNAT version 3.02
  74. ====================================
  75.     Implement packing of multidimensional arrays
  76.  
  77.     Get_Immediate now follows the implementation advice and works as intended
  78.     (for SGI IRIX, Sparc SunOS/Solaris, Alpha OSF1, IBM OS/2 and Linux)
  79.  
  80.     The task attributes package is now fully functional
  81.  
  82.     Warnings for unset variables, and possible access before initialization
  83.  
  84.     pragma Warnings (On | Off) allows more detailed control of warnings
  85.     pragma Source_File_Name allows specifying non-standard file names
  86.     pragma No_Return allows specifying a procedure that never returns
  87.     pragma Attach_Handler    (implemented on Sparc SunOS and Sparc Solaris only)
  88.     pragma Interrupt_Handler (implemented on Sparc SunOS and Sparc Solaris only)
  89.  
  90. Distribution Update News: (version 3.03)
  91.     All binaries are built on top of GCC 2.7.2.
  92.  
  93. Source Distribution Update News (Version 3.03):
  94.     GNAT 3.03 must be built on top of GCC 2.7.2
  95.  
  96. Sparc Solaris 2.3 binary installation:
  97.     Feb 25, 1996 18:00 EST
  98.     The binary distribution for Sparc Solaris 2.3 (2.4) is now available in
  99.     the file gnat-3.03-sparc-sun-solaris2.3-bin.tar.gz. 
  100.  
  101. Sun OS binary installation:
  102.     Feb 28, 1996 18:00 EST
  103.     The binary distribution for Sparc SunOS 4.1.3 is now available in the file
  104.     gnat-3.03-sparc-sun-sunos.4.1.3-bin.tar.gz. 
  105.     The following warning message during installation (doconfig option 3)
  106.     should be ignored. 
  107.        ranlib: warning: libgthreads.a(io.o): no symbol table
  108.  
  109. Alpha binary installation:
  110.     Feb 28, 1996 18:00 EST
  111.     The binary distribution for Alpha OSF2.0 is now available in the file
  112.     gnat-3.03-alpha-dec-osf2.0-bin.tar.gz. This version WILL also run on
  113.     OSF3.0.
  114.  
  115.     March 3, 1996
  116.     One of the necessary files named mips-tfile was omitted from the original
  117.     GNAT Alpha distribution. A new distribution was created which includes
  118.     this file. If a distribution was picked prior to this date the mips-tfile
  119.     alone can be retrieved from gnat-3.03-alpha-dec-os2.0-bin-update.tar.gz.
  120.  
  121.     Note: When installed on top of an existing directory, tar may give peculiar
  122.     error messages so it is advisable to delete the old directory first.
  123.  
  124. SGI Irix 5.3 binary installation:
  125.     Feb 28, 1996 18:00 EST
  126.     The binary distribution for SGI Irix 5.3 is now available in the file
  127.     gnat-3.03-mips-sgi-irix5.3-bin.tar.gz. 
  128.  
  129.     Mar 3, 1996
  130.     In the installation Makefile the references to libpthreads.a should be
  131.     libpthread.a. It might be necessary to copy the libpthread.a file
  132.     to the lib/gcc-lib/mips-sgi-irix5.3/2.7.2 directory if there is a problem
  133.     when linking programs involving tasking. The 3.03 SGI binary has been
  134.     repackaged with the correction to the installation Makefile as of March 3.
  135.  
  136. Linux (ELF) binary installation:
  137.     Feb 28, 1996 18:00 EST
  138.     The GNAT 3.03 binary distribution for Linux elf format is now available
  139.     in the file gnat-3.03-linux-elf-bin.tar.gz. Its accompanying README is
  140.     now included in the distribution along with an installation script.
  141.  
  142. DOS binary installation:
  143.     Mar 3, 1996
  144.     The binary distribution for DOS is now available.  The following three
  145.     files make up the distribution: gnat-3.03-dos-bin-disk[123].zip.
  146.     If you have not previously retrieved and installed the file
  147.     djgpp-1.12m4-dos-bin.zip you will also have to install it. The utilities
  148.     strip.exe and rm.exe have now been added to the djgpp-1.12m4-dos-bin.zip.
  149.  
  150.     Mar 4, 1996
  151.     A nice development environment for GNAT under DOS including AdaCAPS and
  152.     a windows IDE is available in contrib/gwu/editors.zip.
  153.  
  154.     Note: gnatmake currently does not work under DOS since the memory
  155.     management of the current DJGPP port of GCC (Version 1) does not allow
  156.     for a large number of spawned processes which is necessary for a "make"
  157.     facility. When GNAT starts using Version 2 of the DJGPP system, gnatmake
  158.     should work just fine. GNAT will start using version 2 as soon as it
  159.     appears stable to do so which we hope to be in the near future.
  160.  
  161. General Installation notes for Unix installations:
  162.     Note to users trying to install using option 1 only:
  163.     Option 1 is a bit trickier now trying to graft GNAT onto GCC version 2.7.2.
  164.     Users trying to install with option 1, that it trying to install GNAT on
  165.     top of their existing GCC installation, on a system running SunOS 4.1
  166.     rather than 4.1.3 should make a link from sparc-sun-sunos4.1.3 to
  167.     sparc-sun-sunos4.1 in their gcc-lib directory. If trying to install on
  168.     top of a system running gcc 2.7.0 rather than 2.7.2 make a link running
  169.     from 2.7.0 to 2.7.2 followed by the doinstall.
  170.  
  171. Version 3.01 release:
  172.    The binary distribution is now available for the following configurations:
  173.       hppa
  174.       i386-sun-solaris2.4 (for x86)
  175.       linux (a.out)
  176.       mips-dec-ultrix4.3
  177.       netbsd1.0 (for x86)
  178.       os2
  179.       windows 95/windows NT (for x86)
  180.  
  181. Latest features in GNAT version 3.01
  182. ====================================
  183.     pragma Normalize_Scalars
  184.     Ada.Text_IO.Editing
  185.     Ada.Wide_Text_IO.Editing
  186.     Incomplete types declared in the private part that are
  187.      completed in the package body as unconstrained arrays.
  188.     Full implementation of stream attributes, including the
  189.      dispatching cases for class wide types.
  190.     Private protected operations
  191.     Pointers to unconstrained arrays may be double or single length. Double
  192.      ("fat") is the default size (e.g. 64 on SGI), but rep clauses or a
  193.      foreign convention will force them to single length.
  194.     Aggregates for composite Types with controlled components
  195.     Objects of type with unknown discriminants
  196.     pragma Queuing_Policy
  197.     pragma Source_File_Name (GNAT specific)
  198.     True multiprocessing on Sparc Solaris
  199.  
  200. Distribution Update News: (version 3.01)
  201.     All binaries are built on top of GCC 2.7.2.
  202.  
  203. Source Distribution Update News (Version 3.01):
  204.     GNAT 3.01 should be built on top of GCC 2.7.1 or GCC 2.7.2
  205.  
  206. Solaris x86 binary installation:
  207.     Jan 24, 1996 13:40 EST
  208.     The GNAT 3.01 binary distribution for Solaris x86 is now available. The
  209.     following two files make up the distribution:
  210.     gnat-3.01-i386-unknown-solaris2.4-bin.tar.gz
  211.     gnat-3.01-i386-unknown-solaris2.4-readme
  212.  
  213. Windows 95/Windows NT binary installation:
  214.     Jan 5, 1996 01:00 EST
  215.     The file setup-gnat-3.01a-win95-bin.exe and its accompanying readme file
  216.     setup-gnat-3.01a-win95.readme were added. This uses a self extracting
  217.     distribution format. See instructions below on unpacking the Windows 95.
  218.     This is the Labtek port of GNAT (labtek@cs.yale.edu).
  219.  
  220. Linux (a.out) binary installation:
  221.     Jan 5, 1996 00:30 EST
  222.     The GNAT 3.01 binary distribution for Linux (a.out) is now available.
  223.     The a.out version is available in the file gnat-3.01-linuxaout.tar.gz
  224.     with an accompanying README in gnat-3.01-linuxaout.README.
  225.  
  226. i386-netbsd1.0 binary installation:
  227.     Dec 18, 1995 16:30 EDT
  228.     The binary distribution for netbsd1.0 is now available. The following two
  229.     files make up the distribution: gnat-3.01-i386--netbsd1.0.README and
  230.     gnat-3.01-i386--netbsd1.0.tar.gz.
  231.  
  232. Decstation Ultrix binary installation:
  233.     Dec 17, 1995 19:30 EST
  234.     The binary distribution for Decstation Ultrix 4.3 is now available in the
  235.     file gnat-3.01-mips-dec-ultrix4.3-bin.tar.gz.
  236.  
  237. OS/2 binary installation:
  238.     Dec 12, 1995 11:56 EST
  239.     The binary distribution of GNAT 3.01 for OS/2 is now available. Please
  240.     note that GNAT OS/2 now uses five diskettes rather than four; three for
  241.     GNAT and two for EMX.  Please read the unpacking instructions given below
  242.     as well as the READ.ME and README.EMX files in the emx\gnat directory once
  243.     the files are unpacked.
  244.  
  245.     Previous OS/2 users of GNAT are also advised to briefly check the
  246.     unpacking instructions given below for any new details.
  247.  
  248. HP PA binary installation:
  249.     Dec 7, 1995 15:00 EST
  250.     The file gnat-3.01-hppa-bin.tar.gz representing the binary distribution
  251.     for the HP PA-RISC architecture is now available.
  252.  
  253. Distribution Update News: (version 2.06 all platforms)
  254.    July 3, 1995 18:00 EDT
  255.    The gnatinfo.txt and features file give contradictory information about
  256.    the proper insutrctions for enabling Inlining. The features file is
  257.    correct; to enable inlining use -gnatn. The default is no inlining.
  258.  
  259. Version 2.06 release:
  260.    The binary distribution is now available for the following configurations:
  261.       rs6000-ibm-aix3.2
  262.  
  263. Binary Installation Update News (Version 2.06):
  264.  
  265. RS6000 binary installation:
  266.     July 18, 1995 18:00 EDT
  267.     The binary distribution for RS6000 AIX 3.2 is now available in the file
  268.     gnat-2.06-rs6000-ibm-aix3.2-bin.tar.gz.
  269.  
  270. Latest features in GNAT version 2.06
  271. ====================================
  272.     Requeue Statement involving task entries
  273.     inter-unit inlining (enabled by -O2 -gnatn)
  274.     aggregates for simple controlled types
  275.  
  276. -----------------------------------------------------------------------------
  277.  
  278. Old source and binaries of GNAT have been moved to pub/gnat/private/old
  279. on cs.nyu.edu in order not to clutter up the main pub/gnat directory and
  280. not to be picked up by mirror sites. If for some reason you need to
  281. retrieve any of these old versions, that is where they can be found.
  282.  
  283. OS/2 PM bindings:
  284.     Mar 14, 1995 01:30 EST
  285.     The second public release of the OS/2 PM bindings are now available in
  286.     the contrib/os2/PM subdirectory. This version is compatible with the
  287.     version GNAT 2.03 (EMX) release or higher.
  288.  
  289. The 5.95 version of the reference manual for Ada95 is available under the
  290. directory rm9x-5.95.
  291.  
  292.   Since gnat 2.07 uses gcc version 2.7.0 the environment variables that are set
  293.   as part of the binary installation need to reference 2.7.0 rather than 2.6.3
  294.   which was used previously. So for those using the doconfig script with option
  295.   3 make sure that the file env-vals created by the script is placed in your
  296.   .cshrc and that it replaces any old one (with 2.6.3 references) that was
  297.   there from a previous installation. The -gnatv option will indicate to you
  298.   which version of gnat you are running.
  299.  
  300. ==========================================================================
  301. Mirror Sites:
  302.  
  303. US sites:
  304. ftp://ftp.cdrom.com/pub/languages/ada/compiler/gnat/distrib
  305. ftp://wuarchive.wustl.edu/languages/ada/compiler/gnat/distrib
  306.  
  307. European sites:
  308. ftp://ftp.cs.kuleuven.ac.be/pub/Ada-Belgium/mirrors/gnu-ada
  309. ftp://ftp.dit.upm.es/mirror/cs.nyu.edu/pub/gnat
  310. ftp://ftp.cs.tu-berlin.de/pub/gnu/gnat
  311. ftp://ftp.cci.de/pub/Ada/gnat
  312. ftp://ftp.informatik.rwth-aachen.de/pub/mirror/cs.nyu.edu/pub/gnat
  313. ftp://ftp.ibp.fr/pub/gnat
  314. ftp://ftp.cnam.fr/pub/Ada/PAL/compiler/gnat/distrib
  315. ftp://ftp.eunet.no/pub/gnu/gnat
  316. ftp://ftp.fsz.bme.hu/pub/ada/gnat
  317. ftp://snowwhite.it.brighton.ac.uk/gnat
  318.  
  319. Australia site:
  320. ftp://csc.canberra.edu.au/pub/ise/gnat
  321. ============================================================================
  322. CONTENTS::
  323.  
  324. The contents of the pub/gnat directory are:
  325.  
  326. This README file.
  327.  
  328. The file "features" which lists the language features that are implemented in 
  329. the lastest version of GNAT is located both in the pub/gnat directory and as 
  330. part of each distribution.  It is updated periodically to reflect new features
  331. put into the latest release.
  332.  
  333. The subdirectory "docs" contains various documents about GNAT.
  334. The file "unz50x32.exe" is used for unpacking OS/2 zip files (more below).
  335. The file "unz511x.exe" is used for unpacking DOS zip files (more below).
  336.  
  337. There are source and binary distributions both for sparc machines running
  338. SunOs 4.1 (these distribution files end in ".gz") and for OS/2 (these
  339. distribution files end in ".zip").  There are also binary distributions
  340. for other architectures/operating systems, including for example DOS and
  341. most recently Windows 95.
  342.  
  343. Since the front end of GNAT is written in Ada, you need a running version
  344. of GNAT in order to build GNAT from the sources.  Once you have GNAT
  345. running on your system, most releases can be built from previous ones.
  346. To get started initially (and when there are boostrap problems that will
  347. be documented here) you need to install GNAT from a binary distribution.
  348. We anticipate that many people will never have an interest in building
  349. GNAT, and will therefore simply pick up new binary distributions.
  350.  
  351. Intructions for installing and running GNAT are in each distribution.  The
  352. source distributions also contain instructions for building GNAT.
  353.  
  354. Make sure that you transfer with ftp in binary mode.
  355.  
  356. ===============================================================================
  357.  
  358. UNPACKING UNIX DISTRIBUTIONS::
  359.  
  360. The Unix (specifically sparc) distributions need to be uncompressed with
  361. 'gunzip' (or equivalently 'gzip -d'), and then unpacked with tar.
  362.  
  363.  So the necessary commands would be something like the following for
  364.  unpacking version GNAT 2.00 for the sparc solaris 2.3 version:
  365.  
  366.  gunzip gnat-2.00-sparc-sun-solaris2.3-bin.tar.gz
  367.  tar xf gnat-2.00-sparc-sun-solaris2.3-bin.tar
  368.  
  369. Here is the scoop on gunzip:
  370.  
  371.   Because the unix `compress' utility is patented (by two separate patents,
  372.   in fact), we cannot use it; it's not free software.
  373.  
  374.   Therefore, the GNU Project has chosen a new compression utility, `gzip',
  375.   which is free of any known software patents and which tends to compress
  376.   better anyway.  All compressed files in the GNU anonymous FTP area
  377.   (prep.ai.mit.edu:/pub/gnu) have been converted to the new format.  Files
  378.   compressed with this new compression program end in `.gz' (as opposed to
  379.   `compress'-compressed files, which end in `.Z').
  380.  
  381.   Gzip can uncompress `compress'-compressed files and `pack' files
  382.   (which end in `.z').  This is possible because the various
  383.   decompression algorithms are not patented---only compression is.
  384.  
  385.   The gzip program is available from any GNU mirror site in shar, tar, or
  386.   gzipped tar format (for those who already have a prior version of gzip and
  387.   want faster data transmission).  It works on virtually every Unix system,
  388.   MSDOS, OS/2, and VMS.
  389.  
  390. After doing this, check in the newly created GNAT distribution directory for
  391. further installation instructions.
  392.  
  393. -------------------------------------------------------------------------------
  394.  
  395. UNPACKING WINDOWS 95 / Windows NT DISTRIBUTIONS::
  396.  
  397. Retrieve seupt-gnat-3.01a-win95.exe and run it.  Dialogs will allow
  398. selecting an installation path and various installation options.
  399. It is a self-extracting compressed archive integrated into a standard
  400. setup program.  Don't forget to get the setup-gnat-3.01-win95.readme
  401. for important last-minute details.
  402.  
  403. Note: This Windows 95/ Windows NT distribution of the GNAT Ada compiler
  404. for the Intel architecture is maintained by LabTek Corporation. For questions
  405. about the Win95/Winnt version send mail to LabTek@cs.yale.edu.
  406.  
  407. -------------------------------------------------------------------------------
  408.  
  409. UNPACKING OS/2 DISTRIBUTIONS::
  410.  
  411. The executables for the OS/2 version of GNAT are split into 5 files, each of
  412. which can fit on one 3.5-inch high-density diskette. Although it is possible to
  413. install GNAT on a FAT partition, such an installation will be somewhat
  414. limiting due to the restriction of 8 character filenames. But it is possible
  415. to run GNAT in this mode using the -gnatk8 option. Therefore, we recommend to
  416. install GNAT on an HPFS partition.
  417.  
  418. If you don't have the unzip program, you can download the file unz50x32.exe,
  419. run it in an empty directory, and copy the file unzip.exe to a directory
  420. listed in your PATH environment variable.  Please note that PKUNZIP will NOT
  421. work.)
  422.  
  423. The executables for the OS/2 version of GNAT are contained in 5 zip files.
  424. They occupy about 13 megabytes when unzipped.  
  425.  
  426. The contents of each zip file are as follows (xx is the minor revision#):
  427.  
  428. #1 gnat-2.xx-os2-bin-disk1.zip:
  429. #2 gnat-2.xx-os2-bin-disk2.zip:
  430. #3 gnat-2.xx-os2-bin-disk3.zip:
  431.  The GNAT portion of the GNU compiler and utilities. GNAT runtime library.
  432.  Documentation and examples.  README.OS2.
  433.  
  434. #4 emx09a-gnat-os2-bin-disk1.zip:
  435. #5 emx09a-gnat-os2-bin-disk2.zip: Minimal EMX installation including the
  436.  GNU gcc driver, the C portion of the GNU compiler, assembler, linker,
  437.  debugger, utilities, "C" runtime library, C include files, necessary DLLs
  438.  and documentation.
  439.  
  440. Important note for users of GNAT 2.03 or later (EMX version)
  441. ----------------------------------------------------------------
  442. Since you have already installed the EMX09a zip files while installing the
  443. previous GNAT release you do not need to unzip files #4 and #5 mentioned above.
  444. Before unzipping files #1, #2 and #3 it is necessary to delete all the GNAT
  445. files from the previous GNAT installation. A command script called
  446. gnatdel.cmd located on file #3 will delete all the necessary files. When
  447. deleting directories the script will ask questions if it is okay to delete
  448. the directories. To these just answer yes.
  449.  
  450. Example (assuming "c" is the drive on which GNAT was previously installed)
  451. cd c:
  452. cd \
  453. unzip gnat-2.xx-os2-bin-disk3.zip gnatdel.cmd
  454. \gnatdel.cmd
  455.  
  456. Once this is done just follow the regular instruction starting giving below
  457. in the paragraph starting with "To begin".
  458.  
  459. Note for EMX users:
  460. -------------------
  461. Release 3.01 is based on EMX 9a (with fix02) which was GCC 2.6.3. It is not
  462. yet based on GCC 2.7.X. File #4 and #5 are required only if you don't already
  463. have EMX release (9a with fix02) installed. It is not clear if GNAT 3.01
  464. will run with EMX 9a with later fixes beyond fix02. Let us know at
  465. report@gnat.com what you find out about this.
  466. ----------------------------------
  467.  
  468. To begin the installation copy the .zip files to the root of the partition
  469. on which you wish to install GNAT. Unzip them there using unzip.exe.
  470.  
  471. Example (replace xx with the current GNAT minor version):
  472.  
  473. >c:
  474. >cd \
  475. >copy gnat-2.xx-os2-bin-disk1.zip .
  476. >copy gnat-2.xx-os2-bin-disk2.zip .
  477. >copy gnat-2.xx-os2-bin-disk3.zip .
  478. >copy emx09a-gnat-os2-bin-disk1.zip .
  479. >copy emx09a-gnat-os2-bin-disk2.zip .
  480. >unzip gnat-2.xx-os2-bin-disk1.zip .
  481. >unzip gnat-2.xx-os2-bin-disk2.zip .
  482. >unzip gnat-2.xx-os2-bin-disk3.zip .
  483. >unzip emx09a-gnat-os2-bin-disk1.zip .
  484. >unzip emx09a-gnat-os2-bin-disk2.zip .
  485.  
  486. Once you've done the above, read and follow the directions in given
  487. in \EMX\GNAT\READ.ME to complete the installation.
  488.  
  489. The file \EMX\GNAT\README.EMX (same as \EMX\README.EMX) explains about
  490. the minimal EMX system subset that is being distributed through the files
  491. emx09a-gnat-os2-bin-disk1.zip and emx09a-gnat-os2-bin-disk2.zip for support
  492. of GNAT.
  493. --------------------------------------------------------------------------
  494. UNPACKING DOS DISTRIBUTIONS::
  495.  
  496. These instructions pertain to GNAT 2.00 and later.
  497.  
  498. The file "unz511x.exe" is used for unpacking DOS zip files and is available
  499. in the ftp directory.  You can also use the popular pkunzip.exe program if 
  500. you already have it.
  501.  
  502. Unz511x.exe is a self extracting archive.  To use it you should create
  503. an empty, temporary directory, copy unz511x.exe into that directory and 
  504. run it.  (The reason for doing this is that it unzips itself and creates 
  505. a number of auxiliary files which would clutter up an existing directory.)
  506.  
  507. Once you have it unzipped, you should copy the unzip.exe executable
  508. to a directory listed in your PATH environment variable so that is can be
  509. run from the GNAT installation directory.
  510.  
  511.  
  512. The executables for the DOS version of GNAT are contained in 4 files.  They 
  513. occupy about 10 megabytes when unzipped.  
  514.  
  515. The contents of each zip file are as follows (where "xx" is the minor
  516. version number):
  517.  
  518. #1 GNAT-3.xx-DOS-BIN-DISK1.ZIP:
  519. #2 GNAT-3.xx-DOS-BIN-DISK2.ZIP:
  520. #3 GNAT-3.xx-DOS-BIN-DISK3.ZIP:  GNAT and Gnu "C" compilers and utilities.  
  521.  GNAT runtime library. Documentation and examples.  README.DOS.
  522.  
  523. #4 DJGPP-1.12M4-DOS-BIN.ZIP: Minimal DJGPP installation including the go32
  524.  memory extender, 387 emulator, assembler, utilities, "C" runtime library and
  525.  documentation.
  526.  
  527. File #4 is required only if you don't already have the latest DJGPP release
  528. installed.
  529.  
  530.  
  531. To begin the installation, create a directory called DJGPP on a drive
  532. with sufficient disk space.  Copy the .zip files to this directory and unzip
  533. them using unzip.exe or a compatible program.  The .zip files contain a
  534. complete directory tree, so if you use pkunzip be sure to include the -d 
  535. switch.
  536.  
  537. Example:
  538.  
  539. >MKDIR C:\DJGPP
  540. >COPY GNAT-3.xx-DOS-BIN-DISK1.ZIP C:\DJGPP
  541. >COPY GNAT-3.xx-DOS-BIN-DISK2.ZIP C:\DJGPP
  542. >COPY GNAT-3.xx-DOS-BIN-DISK3.ZIP C:\DJGPP
  543. >COPY DJGPP-1.12M4-DOS-BIN.ZIP C:\DJGPP
  544. >C:
  545. >CD \DJGPP
  546. >UNZIP GNAT-3.xx-DOS-BIN-DISK1.ZIP
  547. >UNZIP GNAT-3.xx-DOS-BIN-DISK2.ZIP
  548. >UNZIP GNAT-3.xx-DOS-BIN-DISK3.ZIP
  549. >UNZIP DJGPP-1.12M4-DOS-BIN.ZIP
  550. or
  551. >PKUNZIP -D GNAT-3.xx-DOS-BIN-DISK1.ZIP
  552. >PKUNZIP -D GNAT-3.xx-DOS-BIN-DISK2.ZIP
  553. >PKUNZIP -D GNAT-3.xx-DOS-BIN-DISK3.ZIP
  554. >PKUNZIP -D DJGPP-1.12M4-DOS-BIN.ZIP
  555.  
  556. Once you've done the above, read and follow the directions in 
  557. C:\DJGPP\README.DOS to complete the installation.  Be sure to also read the
  558. DJGPP readme files: README.1ST and README.DJ.
  559.  
  560. UNPACKING THE GNAT SOURCES
  561. --------------------------
  562. The GNAT sources are distributed in two formats, one using gzip and the
  563. other using zip. The gzip format appears as gnat-2.xx-src.tar.gz (where xx
  564. is the minor release number). To unpack just use gunzip and then tar to
  565. extract. The zip format appears as three zip files: gnat-2.xx-src-disk1.zip,
  566. gnat-2.xx-src-disk2.zip and gnat-2.xx-src-disk3.zip. To see which unzip
  567. utility to use in unpacking these two zip files, see the instructions given
  568. in the sections above called UNPACKING DOS DISTRIBUTIONS or
  569. UNPACKING OS/2 DISTRIBUTIONS whichever is appropriate.
  570.