home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c220 / 1.ddi / README < prev   
Encoding:
Text File  |  1991-04-16  |  12.6 KB  |  370 lines
  1.        Copyright (C) 1991 MetaWare Incorporated; All Rights Reserved.
  2.  
  3.                             High C Version 1.71
  4.                         for Extended DOS 80386/486
  5.                               April 1991
  6.  
  7. Table of Contents
  8. -----------------
  9.  1.  New Features
  10.  2.  Release Notes
  11.  3.  Additions/Corrections to Printed Documentation
  12.  4.  Open Files
  13.  5.  Wildcard Expansion
  14.  6.  Driver Notes
  15.  7.  New Command-Line Options
  16.  8.  Cyrix Support
  17.  9.  GFX Graphics Functions
  18.  10. Macro Incompatibility with High C Version 2.3
  19.  11. Problems
  20.  
  21.  
  22. 1.  New Features
  23. ----------------
  24.  
  25. * Compatibility with MetaWare Debugger, with support for AutoCAD ADS
  26.   applications.
  27.  
  28. * Execution profiler: see file README.PRF for information about the Profiler.
  29.  
  30. * Microsoft Graphics compatibility functions.
  31.  
  32. * SIGNAL.H functions raise() and signal() implemented.
  33.  
  34. * Interrupt vector functions added to DOS.H:
  35.      _getrvect()
  36.      _getpvect()
  37.      _setrvect()
  38.      _setpvect()
  39.      _setrpvectp()
  40.  
  41. * Functions _fsopen and _fdopen added to the library.
  42.  
  43. * Compiler and Library bugs fixed, as listed below.
  44.  
  45. * 64K node limit removed.  33% more tree storage space is needed for all
  46.   compilations (80386 host only).
  47.  
  48.  
  49. 2.  Release Notes
  50. -----------------
  51.  
  52. * For installation instructions, read the Installation Guide provided with
  53.   your documentation.
  54.  
  55. * For differences from prior versions, read the New Information! document.
  56.  
  57. * Last-minute-supplied or unclassified software is in the directory "etc".
  58.  
  59. * See file WEITEK.DOC in the WEITEK subdirectory for information about Weitek
  60.   ABACUS coprocessor support.
  61.  
  62. * "variable referenced before set" message deleted for local statics.
  63.  
  64. * Stringizing: for #x, any \ or " in x is replaced with \\ (respectively
  65.    \") only within a string.  Thus, for:
  66.  
  67.      #define str(x) #x
  68.      ...
  69.      printf(str(abc\ndef));
  70.  
  71.   High C Version 1.6 printed out:
  72.  
  73.      abc\ndef
  74.  
  75.   whereas High C 1.7 prints out:
  76.  
  77.      abc
  78.      def
  79.  
  80. *  Static functions may be declared at file scope without getting the message
  81.    "extern assumed".
  82.  
  83. *  Static variables referenced before set are no longer diagnosed.  Too often
  84.    the diagnosis was misleading.
  85.  
  86.  
  87. 3.  Additions/Corrections to Printed Documentation
  88. --------------------------------------------------
  89.  
  90.    None at this time.
  91.  
  92.  
  93. 4.  Open Files
  94. --------------
  95.  
  96.    The library has been changed so you can increase the number of file-table
  97.    entries.  Although MS-DOS usually limits the number of open files per
  98.    process to 20, there is a new MS-DOS system call that works in later
  99.    versions of MS-DOS (earlier versions were disastrously buggy) that
  100.    increases the limit.  Because C is highly dependent on the static _iob
  101.    table, you must increase the size of this table to increase the number of
  102.    files that can be open simultaneously.
  103.  
  104.    The source to the file that initializes the _iob has been provided as
  105.    LIB\SRC\CVARS.C.  Read this file for more instructions on how to increase
  106.    the number of _iob entries.
  107.  
  108.  
  109. 5.  Wildcard Expansion
  110. ----------------------
  111.  
  112.    In ETC\WCARD.C is a program that examines DOS wildcards in the argc/argv
  113.    array and expands them.  If compiled with TEST defined, the program
  114.    executes and shows the arguments before and after expansion.  Compiled
  115.    without TEST, it is suitable for inclusion in your program.
  116.  
  117. 6.  Driver Notes
  118. ----------------
  119.  
  120. - When you invoke High C with the command hc386, you are invoking a driver
  121.   program which in turn invokes the compiler.  See the Programmer's Guide
  122.   chapter Invoking and Controlling the Compiler.
  123.  
  124. - In High C Version 1.6, command hc386p invoked the protected-mode-hosted
  125.   compiler with the driver.  This command is no longer needed and is not
  126.   included with 1.7.  The protected-mode-hosted compiler is the default for
  127.   1.7, and it is invoked by the driver with command hc386.  To invoke the
  128.   real-mode-hosted compiler executable, use driver command-line option -HV.
  129.   See the Programmer's Guide chapter Driver Command-Line Options for a
  130.   description of -HV.
  131.  
  132. - Version 1.62 included programs HCLDR.EXE and HCLDRP.EXE, which were intended
  133.   to let you invoke the compiler without using the driver.  These are no
  134.   longer needed and are not included.  In 1.7, to invoke the compiler without
  135.   the driver use hcd386 for real mode, and hcd386p for protected mode.  These
  136.   commands invoke the compiler directly.  See the Programmer's Guide appendix
  137.   Driver and Compiler Controls for a list of compiler options.
  138.  
  139. 7.  New Command-Line Options
  140. ----------------------------
  141.  
  142.  -fsoft     Causes the compiler to generate emulation code and link
  143.             with the emulation library.
  144.  
  145.  -f287      Causes the compiler to generate 287 floating-point code
  146.             and link with the coprocessor library.
  147.  
  148.  -f387      Causes the compiler to generate 387 floating-point code
  149.             and link with the coprocessor library.
  150.  
  151.  -f3167     See file WEITEK.DOC in the WEITEK subdirectory, and Programmer's
  152.  -f1167     Guide chapter Floating-Point Support, for information about these
  153.             options.
  154.  
  155.  -femc87    Causes the compiler to generate code for the Cyrix EMC87
  156.             coprocessor and link with the coprocessor library.
  157.  
  158.  
  159. 8. Cyrix Support
  160. ----------------
  161.  
  162.    Support for the Cyrix EMC87 chip is enabled by including in your program:
  163.  
  164.       pragma on(emc87);
  165.  
  166.    or by including on your driver command line:
  167.  
  168.      -Hon=emc87
  169.  
  170.    You must also link with the coprocessor library.  387-like code generation
  171.    is assumed.  See Programmer's Guide chapter Floating-Point Support for
  172.    details.
  173.  
  174.    The BYTE magazine floating-point-benchmark executables are provided in the
  175.    etc directory, compiled for the 80387 and separately for the EMC87.  You
  176.    can use these two programs to determine the increase in speed possible by
  177.    using the EMC87 in memory-mapped mode.
  178.  
  179.    Some machine BIOS versions do not support EMC87 initialization, and you
  180.    must run a special initializer program called PRESON, supplied by Cyrix.
  181.    If you are using Phar Lap's 386|DOS-Extender, the error:
  182.  
  183.       Abnormal Program Termination: Page Fault
  184.  
  185.    is returned if the EMC87 is not initialized.  In the Phar Lap environment
  186.    you must run PRESON before executing any Cyrix code.
  187.  
  188.    Furthermore, Pharlap's 386|DOS-Extender may not automatically detect the
  189.    presence of the EMC87 at run time.  To force RUN386 to recognize the EMC87,
  190.    specify -weitek on.  For example:
  191.  
  192.       RUN386 -weitek on my_prog
  193.  
  194.  
  195. 9. GFX Graphics Functions
  196. -------------------------
  197.  
  198.    WARNING:  The program GFX_TEST.C included in the examples directory of your
  199.    High C distribution requires a CGA, EGA, or VGA monitor.  If you compile
  200.    this program and try to run it on a Monochrome or Hercules monitor, it will
  201.    hang your system.
  202.  
  203.    If you use option -Hansi (for strict ANSI conformance), GFX Graphics
  204.    functions will not be available to you with the documented function names
  205.    unless you explicitly link non-ANSI library NA.LIB.  This is because these
  206.    functions have non-ANSI names that appear only in NA.LIB, which is omitted
  207.    from the link when you specify -Hansi on the driver command line.
  208.  
  209.    You can use the functions as documented, with option -Hansi specified, by
  210.    linking NA.LIB and specifying #define __HIGHC__ before including GFX.H.
  211.    For example:
  212.  
  213.         #define __HIGHC__
  214.         #include <GFX.H>
  215.         #undef  __HIGHC__
  216.  
  217.    Link NA.LIB by specifying driver command-line option -lNA.LIB.
  218.  
  219.    NA.LIB includes all the non-ANSI function names.  GFX Graphics functions
  220.    have also been provided in the ANSI library, with their names lowercased
  221.    and prefixed by _gfx_.  For example, SCREEN becomes _gfx_screen.  The GFX
  222.    macro names are prefixed with an underscore.  For example, DFLT becomes
  223.    _DFLT.
  224.  
  225.    Note:  The GFX Graphics functions work only if linked with a linker that
  226.           produces Phar Lap .EXP type executables.
  227.  
  228.  
  229. 10. Macro Incompatibility with High C version 2.3
  230. ---------------------------------------------------
  231.  
  232. An area of incompatibility has been discovered between the High C Locally
  233. Optimizing Compiler and the High C Globally Optimizing Compiler.  Some #define
  234. macros in the header files have different values, and they cannot be changed
  235. so as to be compatible.  Therefore, any module using any of these macros MUST
  236. be recompiled when used with the library of the other compiler.  A module
  237. compiled with LOC cannot be linked with the GOC library if any of these macros
  238. have been used.  Likewise, modules compiled with GOC cannot be linked with the
  239. LOC library when these macros have been used.  The system issues no warning
  240. that this has happened.
  241.  
  242. The macros known to cause problems are:
  243.  
  244. *  All error values associated with the errno variable, such as:
  245.       ERANGE
  246.       EDOM
  247.       Error_path_not_found
  248.       Error_too_many_open_files
  249.       Error_access_denied
  250.  
  251. *  The getc and putc macros.  The functions are fine; only the macros exhibit
  252.    the problem.
  253.  
  254. *  The _IOFBF, _IONBF and _IOLBF values.  These are different, and each
  255.    library depends on its own set of values.
  256.  
  257. *  The LC_ALL, LC_COLLATE, LC_CTYPE, LC_MONETARY, LC_NUMERIC and LC_TIME
  258.    macros.  The values are different, but may be adjusted in GOC some time in
  259.    the future, to make them compatible.  Until then, object modules using
  260.    these constants cannot be mixed between the two High C compilers/libraries.
  261.  
  262.  
  263. 11. Problems
  264. ------------
  265.  
  266.   * There is a bug in the keyword volatile that allows the volatile data
  267.     to be optimized away.  For example:
  268.  
  269.        void junk(void){
  270.           unsigned char a = 1, b = 2, c = 3;
  271.           volatile unsigned char *p;
  272.           p = (volatile unsigned char *) &a;
  273.           *p = b;
  274.           c = *p;
  275.           }
  276.  
  277.     If you compile this program with -Hasm and examine the assembly listing,
  278.     you will see that below the line c = *p; the pointer is optimized away.
  279.  
  280.   * Foward references to nested functions are not properly resolved.  For
  281.     example:
  282.  
  283.        void main(){
  284.           int a = 10;
  285.           void nf1(void) {
  286.              if (a-- > 0)
  287.                  nf2();
  288.              }
  289.           void nf2(void) {
  290.              if (a-- > 0)
  291.                  nf1();
  292.              }
  293.           nf1();
  294.           }
  295.  
  296.     This code generates the compiler warnings:
  297.        nf2: Function called but not defined
  298.        nf2: Local Function never referenced; no code will be generated.
  299.  
  300.     Also:
  301.  
  302.      void main(){
  303.         int a = 10;
  304.         void nf2(void);
  305.  
  306.         void nf1(void) {
  307.            if (a-- > 0)
  308.                nf2();
  309.            }
  310.         void nf2(void) {
  311.            if (a-- > 0)
  312.                 nf1();
  313.            }
  314.         nf1();
  315.         }
  316.  
  317.     This code generates the compiler warning:
  318.        nf2: This function should be declared "extern" Assumed
  319.  
  320.     and compiler error:
  321.        nf2: This is multiply defined.
  322.  
  323.   * Function _bios_disk does not support read, write, and verify operations.
  324.  
  325.   * The graphics functions provided work only if linked with a linker which
  326.     produces Phar Lap .EXP type executables.
  327.  
  328.   * There is a bug in fgets that causes the end-of-file flag to not be set
  329.     when end-of-file is reached while reading a file in binary mode.  When
  330.     end-of-file is reached, fgets returns NULL.
  331.  
  332.   * The signal and raise functions support only Ctrl-C and the critical-error
  333.     exception at the hardware level.  All other signals are supported at the
  334.     software level (via raise).
  335.  
  336.     Warning:  If a hardware interrupt occurs during a DOS or BIOS operation,
  337.     it may not be possible to execute the signal handler.  In this case, the
  338.     results are undefined, and may result in a system crash.  See the Library
  339.     Reference Manual for a description of signal and raise.
  340.  
  341.   * Running program SI_TEST.C in the Blackstar C Function Library may hang
  342.     your machine.
  343.  
  344.  
  345. Problems
  346. --------
  347.  
  348. If you think you have discovered a compiler problem, send a problem report to
  349. MetaWare Technical Support.  If possible, please send a test case that
  350. demonstrates the problem.
  351.  
  352. All problem reports must include your serial number and specify which version
  353. of the compiler you are using.  If your sample code exceeds 15 lines, please
  354. send it by diskette to the address below, or by E-mail to:
  355.  
  356.    uunet!acad!metaware!tech
  357.              -or-
  358.    Internet tech@metaware.com
  359.              -or-
  360.    INTERNET:tech@metaware.com
  361.  
  362. MetaWare Technical Support can be reached at (408) 429-6111, 8:00 am to 4:30 pm
  363. Monday through Friday.
  364.  
  365.  
  366. MetaWare Incorporated
  367. 2161 Delaware Avenue
  368. Santa Cruz, CA 95060-5706
  369. (408)429-6382  FAX:(408)429-9273
  370.