home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / adav313.zip / gnat-3_13p-os2-bin-20010916.zip / emx / gnat / gnatinfo.txt < prev    next >
Text File  |  1999-09-24  |  7KB  |  124 lines
  1. ------------------------------------------------------------------------------
  2. --                                                                          --
  3. --                              GNAT DOCUMENTS                              --
  4. --                                                                          --
  5. --                           G N A T I N F O . T X T                        --
  6. --                                                                          --
  7. --                            $Revision: 1.111 $                            --
  8. --                                                                          --
  9. --                            GNAT version 3.12                             --
  10. --                                                                          --
  11. --         Copyright (C) 1992 - 1997 Free Software Foundation, Inc.         --
  12. --                                                                          --
  13. -- GNAT is free software;  you can  redistribute it  and/or modify it under --
  14. -- terms of the  GNU General Public License as published  by the Free Soft- --
  15. -- ware  Foundation;  either version 2,  or (at your option) any later ver- --
  16. -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
  17. -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  18. -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
  19. -- for  more details.  You should have  received  a copy of the GNU General --
  20. -- Public License  distributed with GNAT;  see file COPYING.  If not, write --
  21. -- to  the Free Software Foundation,  59 Temple Place - Suite 330,  Boston, --
  22. -- MA 02111-1307, USA.                                                      --
  23. --                                                                          --
  24. -- GNAT was originally developed  by the GNAT team at  New York University. --
  25. -- It is now maintained by Ada Core Technologies Inc (http://www.gnat.com). --
  26. --                                                                          --
  27. ------------------------------------------------------------------------------
  28.  
  29. For information about commercial support of GNAT from Ada Core Technologies
  30. send email to sales@gnat.com or visit our home page at http://www.gnat.com
  31.  
  32. In Europe information about commercial support of GNAT should be sent to
  33. sales@act-europe.fr or visit the ACT Europe (The European GNAT Company)
  34. home page at http://www.act-europe.fr
  35.  
  36. All bug reports and technical correspondence should be sent to report@gnat.com
  37.  
  38. Documentation
  39. =============
  40.  
  41. The Documentation for GNAT consists of two manuals, the GNAT User's Guide
  42. and the GNAT Reference Manual. These are available in a number of formats
  43. (ASCII, HTML, PostScript and info) and are bundled as a separate documentation
  44. distribution and can be found at the same places as the GNAT binary and
  45. source distributions.
  46.  
  47. Copyright and Licensing Considerations
  48. ======================================
  49.  
  50. The GNAT runtime code is included in full source form (as well as in binary
  51. form in the binary releases). It is licensed using a modified version of the
  52. General Public License (GPL) which allows unlimited distribution without
  53. license fees, and incorporation into any program executable without
  54. restriction. In particular, the GNAT run time can be incorporated into
  55. proprietary or classified programs, and in no way restricts the desired
  56. licensing or distribution of such programs.
  57.  
  58. The compiler code itself is covered by the GPL, which means that it is
  59. freely redistributable, and that source code is available (source
  60. distributions are available at cs.nyu.edu, and at other mirror sites
  61. internationally). You may freely modify the compiler for your own use,
  62. but if you redistribute modified versions of the GNAT compiler itself
  63. or associated tools, then they must themselves be distributed under
  64. the terms of the GPL, and in particular you cannot incorporate GNAT
  65. compiler code into proprietary programs.
  66.  
  67. For more information on the licensing provisions, consult the headers
  68. of the appropriate source files.
  69.  
  70. Submitting Bug Reports
  71. ======================
  72.  
  73. We welcome bug reports, they are of course a vital part of the process of the
  74. continuing improvement of GNAT. You will help us (and make it more likely
  75. that we will look at your report in a timely manner) if you follow these
  76. guidelines. We process all bug reports from both users supported by Ada
  77. Core Technologies, and from unsupported users. Naturally supported users
  78. have our priority attention. We will acknowledge all reports from unsupported
  79. users and eventually correct any problems that are clearly reported, but
  80. we cannot enter into correspondence regarding such reports.
  81.  
  82. We only receive bug reports by internet, addressed to report@gnat.com.
  83.  
  84. Note: if you believe you have found a GCC (C language or configuration
  85. file) bug rather than an GNAT (Ada language) bug please report it to
  86. bug-gcc@prep.ai.mit.edu.  If you have found a bug when using GCC to
  87. compile C++, please report it to bug-g++@prep.ai.mit.edu.
  88.  
  89. Please report each bug in a separate message, and add a short but specific
  90. subject (a general subject like "GNAT bug" is useless, a title like
  91. "bug in visibility with generics" is more useful). Some users find it
  92. useful to assign unique identifying numbers to bug reports.
  93.  
  94. Please include full sources. We can't duplicate errors without the full
  95. sources. Include all sources in the single email message with appropriate
  96. indications in the multiple file cases, see below. Also say exactly
  97. what you saw, do not assume that we can guess what you saw, or duplicate
  98. the behavior you encountered.
  99.  
  100. All sources must be sent in plain ASCII form. Please include COMPLETE
  101. identification of the version of the system you are running.
  102.  
  103. To be maximally helpful, for a report that contains multiple separate
  104. compilation units, and hence multiple files, submit them in the form of
  105. a single file that is acceptable input to gnatchop, i.e. contains no
  106. non-Ada text. If you use banners to separate the files, make sure they
  107. are composed entirely of blank lines or Ada comments. The first line of
  108. sources should be marked with an Ada comment line, and the sources should
  109. extend to the end of the message. If you must include a signature, make
  110. it look like an Ada comment.
  111.  
  112. Also, it is helpful if you try to reduce your example to a simple one
  113. but do not spend too much time doing this. Especially when you are
  114. reporting a blow up during compilation, rather than bad code generated,
  115. we can in practice work with big sources if you have trouble narrowing
  116. things down.
  117.  
  118. If a bug involves incorrect operation of the generated code, then the
  119. first thing the program should do is to output a line indicating the
  120. expected output or behavior. If at all possible, do a test later on
  121. that prints out "passed" or "failed" depending on the behavior. Of course
  122. it may not always be possible to structure a test this way, but that's the
  123. most convenient form (for obvious reasons!)
  124.