home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c329 / 1.img / README.DOC < prev   
Encoding:
Text File  |  1990-03-27  |  14.6 KB  |  311 lines
  1.  
  2.  
  3.                                NDP C-386
  4.                               Version 2.1
  5.  
  6.  
  7. Overview
  8.  
  9.     Version 2.1 of the NDP compilers provide all the functionality of
  10.     the previous release (v2.0.8), with the addition of increased
  11.     compatibility with the new C standard ANSI X3.159-1989 and with
  12.     Microsoft C Version 5.0.
  13.  
  14.     NDP Fortran and Pascal users should note that, although there are no
  15.     major changes that impact those compilers, there are bug fixes and
  16.     other minor enhancements meant to increase the reliability of the
  17.     entire line of NDP compilers.
  18.  
  19.     This file also clarifies the use of binary file I/O as it applies to
  20.     all the compilers.
  21.  
  22.     
  23. Installation
  24.      
  25.     For DOS users, a utility simplifies the installation process. To use
  26.     it, insert Disk 1 into drive A, type "A:INSTALL", press <Enter>, and
  27.     follow the instructions that appear on the screen.
  28.  
  29.     You can also install the compiler using the directions in Chapter 1
  30.     of the User's Manual.  It is recommended that you install it in a
  31.     new directory (e.g., \NDP21), to facilitate the compilation and
  32.     testing of existing source code.
  33.  
  34.  
  35. ANSI Compatibility (C only)
  36.  
  37.     This version of the compiler is intended to be compatible with ANSI
  38.     X3.159-1989.  This compatiblity is achieved with library LIBA.LIB
  39.     and changes to header files.  There are two incompatible INCLUDE
  40.     directories. \INCL contains the standard NDP include files; \INCL_A
  41.     contains header files that support the ANSI standard.  These
  42.     directories contain files which may share a common name but which
  43.     have different contents.  Copying these files into the same
  44.     directory may cause problems.
  45.  
  46.     To compile a program written to the ANSI standard, do the following:
  47.  
  48.         1. Set the INCLUDE environment variable to be equal to the name
  49.            of the directory where the ANSI include files are installed.
  50.            For example:
  51.  
  52.                 set include=c:\ndp21\ansi
  53.  
  54.         2. Use the -ansi switch when compiling.  For example:
  55.  
  56.                 cc hi.c -ansi
  57.  
  58.     The ANSI compatible keywords supported in this release are:
  59.     
  60.         auto                extern                  sizeof
  61.         break               float                   static
  62.         case                for                     struct
  63.         char                goto                    switch
  64.         const               if                      typedef
  65.         continue            int                     union
  66.         default             long                    unsigned
  67.         do                  register                void
  68.         double              return                  volatile
  69.         else                short                   while
  70.         enum                signed
  71.  
  72.     The functions and/or macros that provide ANSI compatibility:
  73.  
  74.         Function   Header file          Function   Header file
  75.         --------   -----------          --------   -----------
  76.         abort      (stdlib.h)           mbstowcs   (stdlib.h)
  77.         abs        (stdlib.h)           mbtowc     (stdlib.h)
  78.         acos       (math.h)             memchr     (string.h)
  79.         asctime    (time.h)             memcmp     (string.h)
  80.         asin       (math.h)             memcpy     (string.h)
  81.         assert     (assert.h)           memmove    (string.h)
  82.         atan       (math.h)             memset     (string.h)
  83.         atan2      (math.h)             mktime     (time.h)
  84.         atexit     (stdlib.h)           modf       (math.h)
  85.         atof       (stdlib.h)           perror     (stdio.h)
  86.         atoi       (stdlib.h)           pow        (math.h)
  87.         atol       (stdlib.h)           printf     (stdio.h)
  88.         bsearch    (stdlib.h)           putc       (stdio.h)
  89.         calloc     (stdlib.h)           putchar    (stdio.h)
  90.         ceil       (math.h)             puts       (stdio.h)
  91.         clearerr   (stdio.h)            qsort      (stdlib.h)
  92.         clock      (time.h)             raise      (signal.h)
  93.         cos        (math.h)             rand       (stdlib.h)
  94.         cosh       (math.h)             realloc    (stdlib.h)
  95.         ctime      (time.h)             remove     (stdio.h)
  96.         difftime   (time.h)             rename     (stdio.h)
  97.         div        (math.h)             rewind     (stdio.h)
  98.         exit       (stdlib.h)           scanf      (stdio.h)
  99.         exp        (math.h)             setbuf     (stdio.h)
  100.         fabs       (math.h)             setjmp     (setjmp.h)
  101.         fclose     (stdio.h)            setlocale  (locale.h)
  102.         feof       (stdio.h)            setvbuf    (stdio.h)
  103.         ferror     (stdio.h)            signal     (signal.h)
  104.         fflush     (stdio.h)            sin        (math.h)
  105.         fgetc      (stdio.h)            sinh       (math.h)
  106.         fgetpos    (stdio.h)            sprintf    (stdio.h)
  107.         fgets      (stdio.h)            sqrt       (math.h)
  108.         floor      (math.h)             srand      (stdlib.h)
  109.         fmod       (math.h)             sscanf     (stdio.h)
  110.         fopen      (stdio.h)            strcat     (string.h)
  111.         fprintf    (stdio.h)            strchr     (string.h)
  112.         fputc      (stdio.h)            strcmp     (string.h)
  113.         fputs      (stdio.h)            strcoll    (string.h)
  114.         fread      (stdio.h)            strcpy     (string.h)
  115.         free       (stdlib.h)           strcspn    (string.h)
  116.         freopen    (stdio.h)            strerror   (string.h)
  117.         frexp      (math.h)             strftime   (time.h)
  118.         fscanf     (stdio.h)            strlen     (string.h)
  119.         fseek      (stdio.h)            strncat    (string.h)
  120.         fsetpos    (stdio.h)            strncmp    (string.h)
  121.         ftell      (stdio.h)            strncpy    (string.h)
  122.         fwrite     (stdio.h)            strpbrk    (string.h)
  123.         getc       (stdio.h)            strrchr    (string.h)
  124.         getchar    (stdio.h)            strspn     (string.h)
  125.         getenv     (stdlib.h)           strstr     (string.h)
  126.         gets       (stdio.h)            strtod     (stdlib.h)
  127.         gmtime     (time.h)             strtok     (string.h)
  128.         isalnum    (ctype.h)            strtol     (stdlib.h)
  129.         isalpha    (ctype.h)            strtoul    (stdlib.h)
  130.         iscntrl    (ctype.h)            strxfrm    (string.h)
  131.         isdigit    (ctype.h)            system     (stdlib.h)
  132.         isgraph    (ctype.h)            tan        (math.h)
  133.         islower    (ctype.h)            tanh       (math.h)
  134.         isprint    (ctype.h)            time       (time.h)
  135.         ispunct    (ctype.h)            tmpfile    (stdio.h)
  136.         isspace    (ctype.h)            tmpnam     (stdio.h)
  137.         isupper    (ctype.h)            tolower    (ctype.h)
  138.         isxdigit   (ctype.h)            toupper    (ctype.h)
  139.         labs       (stdlib.h)           ungetc     (stdio.h)
  140.         ldexp      (math.h)             va_arg     (stdarg.h)
  141.         ldiv       (stdlib.h)           va_end     (stdarg.h)
  142.         localeconv (locale.h)           va_start   (stdarg.h)
  143.         localtime  (time.h)             vfprintf   (stdio.h,stdarg.h)
  144.         log        (math.h)             vprintf    (stdio.h,stdarg.h)
  145.         log10      (math.h)             vsprintf   (stdio.h,stdarg.h)
  146.         longjmp    (setjmp.h)           wcstombs   (stdlib.h)
  147.         malloc     (stdlib.h)           wctomb     (stdlib.h)
  148.         mblen      (stdlib.h)
  149.  
  150.  
  151. Microsoft C compatibility  (C only)
  152.  
  153.     Version 2.1 of the compiler is intended to be compatible with
  154.     Microsoft C v5.0.  This compatiblity is achieved with a new library
  155.     and changes to header files, as follows:
  156.  
  157.         LIBMS    LIB    Microsoft compatible functions library
  158.         MALLOC   H      new header file for MS compatibility
  159.         DOS      H      altered header file
  160.         FLOAT    H      new header file for MS compatibility
  161.         STDLIB   H      altered header file
  162.         STDIO    H      altered header file
  163.  
  164.     The following is a list of the new functions and macros contained in
  165.     the libarary and header files.  Items followed by a header file name
  166.     are macros; items follows by "n/i" will be implemented in a later
  167.     release.
  168.  
  169.         alloca                 eof                    _nfree (malloc.h)
  170.         bdos                   fcloseall              _nheapchk (malloc.h)
  171.         _bios_disk             _ffree (malloc.h)      _nheapset (malloc.h)
  172.         _bios_equiplist        fgetchar (stdio.h)     _nheapwalk (malloc.h)
  173.         _bios_keybrd           _fheapchk (malloc.h)   _nmalloc (malloc.h)
  174.         _bios_memsize          _fheapset (malloc.h)   _nmsize (malloc.h)
  175.         _bios_printer          _fheapwalk (malloc.h)  onexit (stdlib.h)
  176.         _bios_serialcom        fieeetomsbin (n/i)     putch
  177.         _bios_timeofday        filelength             putenv
  178.         cgets                  flushall               rmdir
  179.         chdir                  _fmalloc (malloc.h)    rmtmp (n/i)
  180.         chmod                  fmsbintoieee (n/i)     _rotl
  181.         chsize                 _fmsize (malloc.h)     _rotr
  182.         _clear87 (float.h)     _fpreset               _searchenv
  183.         _control87 (float.h)   fputchar (stdio.h)     segread
  184.         cprintf                _freect                sopen
  185.         cputs                  fstat (n/i)            spawnl
  186.         cscanf                 ftime                  spawnle
  187.         dieeetomsbin (n/i)     getch                  spawnlp
  188.         dmsbintoieee (n/i)     getche                 spawnlpe
  189.         _disable (dos.h)       getcwd                 spawnv
  190.         _dos_allocmem          halloc (malloc.h)      spawnve
  191.         _dos_close             _heapchk               spawnvp
  192.         _dos_creat             _heapset               spawnvpe
  193.         _dos_creatnew          _heapwalk              _splitpath
  194.         dosexterr              hfree (malloc.h)       stackavail
  195.         _dos_findfirst         int86                  stat (n/i)
  196.         _dos_findnext          int86x                 _status87
  197.         _dos_freemem           intdos                 strcmpi
  198.         _dos_getdate           intdosx                _strdate
  199.         _dos_getdiskfree       itoa                   strdup
  200.         _dos_getdrive          kbhit                  _strerror
  201.         _dos_getfileattr       lfind                  stricmp
  202.         _dos_getftime          locking                strlwr
  203.         _dos_gettime           _lrotl                 strnicmp
  204.         _dos_keep              _lrotr                 strnset
  205.         _dos_open              lsearch                strrev
  206.         _dos_read              ltoa                   strset
  207.         _dos_setblock          _makepath              _strtime
  208.         _dos_setdate           matherr (n/i)          strupr
  209.         _dos_setdrive          max (stdlib.h)         tell
  210.         _dos_setfileattr       _memavl                tempnam
  211.         _dos_setftime          _memmax                tzset
  212.         _dos_settime           min (stdlib.h)         ultoa
  213.         _dos_write             mkdir                  umask (n/i)
  214.         dup                    movedata               ungetch
  215.         dup2                   _msize                 utime
  216.         _enable (dos.h)
  217.  
  218.     The following Microsoft C functions are NOT supported:
  219.  
  220.         _dos_getvect          execlp                  execvp
  221.         _dos_setvect          execlpe                 execvpe
  222.         execl                 execv                   _expand
  223.         execle                execve
  224.  
  225.     Compatibility with Microsoft's graphics was initially available in
  226.     NDP C-386 Version 2.0.8.  The following functions are supported:
  227.  
  228.         _clearscreen                   _putimage
  229.         _ellipse                       _rectangle
  230.         _floodfill                     _remapallpalette
  231.         _getbkcolor                    _remappalette
  232.         _getch                         _setactivepage
  233.         _getcurrentposition            _setbkcolor
  234.         _getimage                      _setcliprgn
  235.         _getlogcoord                   _setcolor
  236.         _getphyscoord                  _setlogorg
  237.         _getpixel                      _setpixel
  238.         _gettextcolor                  _settextcolor
  239.         _gettextposition               _settextposition
  240.         _getvideoconfig                _settextwindow
  241.         _imagesize                     _setvideomode
  242.         _lineto                        _setviewport
  243.         _moveto                        _setvisualpage
  244.         _outtext                       _wrapon
  245.  
  246.     The following graphics functions are NOT supported:
  247.  
  248.         _arc                           _pie
  249.         _displaycursor                 _selectpalette
  250.         _getfillmask                   _setfillmask
  251.  
  252.     Please see Chapter 11 of the NDP C-386 User's Manual for more
  253.     information about the graphic functions that are supported.
  254.  
  255.  
  256. Binary File I/O (all compilers)
  257.  
  258.     Support for binary file I/O was available in previous releases;
  259.     however, there has been some confusion regarding it.  The type of
  260.     I/O performed depends on the setting of the global variable _pmode.
  261.     Setting _pmode to 8000hex will cause files to be opened in binary
  262.     mode.  The default is _pmode = 4000hex (text mode).
  263.  
  264.     The file I/O type is set when the file is opened.  Subsequent
  265.     changes to _pmode will have not alter the I/O type of an already
  266.     open file.
  267.  
  268.  
  269. Bug Fixes
  270.  
  271.     1. Text I/O has been accelerated with a change to UNGETC in run time
  272.        library.
  273.  
  274.     2. SCANF now correctly reports EOF.
  275.  
  276.     3. The compiler driver now passes the full path name of .OBJ files
  277.        to the linker.   Previously, a command such as:
  278.  
  279.                 f77 c:\subdirectory\fm001.f
  280.  
  281.        caused the linker to look for fm001.obj in the current directory.
  282.  
  283.     4. The compiler driver now recognizes the SRC (source) environment
  284.        variable.
  285.  
  286.     5. The count register used by REP MOV no longer is corrupted by
  287.        fixup routine.
  288.  
  289.     6. In the FORTRAN library (module F_CLOS.C), direct access formatted
  290.        files are not overwritten when opened with READONLY.
  291.  
  292.     7. In the MATH library LIBM1167 (FORTRAN, C, and Pascal compilers),
  293.        the Weitek single precision math function RACOS is now correctly
  294.        working with negative values.
  295.  
  296.  
  297. Technical Support
  298.  
  299.     If you have any questions, you can contact MicroWay's technical
  300.     support staff at:
  301.  
  302.         Voice:  (508) 746-7341
  303.         FAX:    (508) 746-4678
  304.  
  305.     Please refer to your User Number, product name, version number, and
  306.     hardware configuration when contacting us.
  307.  
  308.     You should register your purchase by completing and returning the
  309.     User Registration card.
  310.  
  311.