home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / commercial-software / programming / AZTEC302.ZIP / DEVRLS.DOC < prev    next >
Text File  |  1998-09-16  |  11KB  |  258 lines
  1.           Aztec C86, version 3.2d
  2.             Developer System
  3.               for CP/M-86
  4.            Release Document
  5.  
  6.  
  7.     This package contains version 3.2d of the Aztec C86 Developer
  8. System for CP/m-86.
  9.     This release document is organized into the follwoing sections:
  10.  
  11.      1.  New Features
  12.      2.  Packaging
  13.      3.  Additional Documentation
  14.  
  15.  
  16. 1.  New Features
  17.  
  18.     This section describes the differences between version 3.2d of the
  19. Aztec C86 Developer System and version 1.06d of the Aztec C86 Pro
  20. System.
  21.  
  22.      .  Version 3.2d has two compilers: cc, which produces very
  23.         efficient, optimized code, and can optionally generate code
  24.         for the 80186 and 80286 processors; and ccb, which is an
  25.         upgrade of the 1.06d compilter.  Modules that have been
  26.         compiled with either compiler can be linked together.
  27.      .  The v3.2d compilers support the follwoing features that
  28.         weren't supported by the v2.2b compiler.  These fratures are
  29.         described in the Programmer section of the Compiler chapter.
  30.  
  31.               + cc supports bit fields
  32.               + names are significant to 31 characters
  33.               + Structure asignment
  34.               + Line continuation
  35.               + The void data type and restrictions on pointer
  36.                 assignments
  37.               + const, signed, and volatile are reserved words.
  38.               + The special symbols __FILE__, __LINE__,
  39.                 and __FUNC__
  40.               + String merging
  41.      .  The v3.2d compilers support several new options.  These are
  42.         preceded by a + character.
  43.  
  44.            The -M option isn't supported by the v3.2d compilers.
  45.  
  46.            The -J option is supported by the v3.2d ccb compiler, as
  47.         the +J option; it isn't supported by v3.2d of the cc compiler.
  48.         For a complete discussion of the new options, see the
  49.         Compiler chapter.
  50.      .  Compiler error codes greater that 115 are new.
  51.      .  When writing assembly-language modules for v3.2d, the name
  52.         of the segments containing a program's code and data must be
  53.         codeseg and dataseg, respectively.
  54.      .  For assembly-language modules, the assume directive must be
  55.         used to identify the contents of the segment registers to the
  56.         assembler.
  57.      .  The v3.2d assembler supports macros in a manner comptible
  58.         with the PCDOS/MSDOS assembler.
  59.      .  Several options have been added to the assembler relating to
  60.         the generation oflistings, squeezing, and the creation of
  61.         symbols.
  62.      .  The ioctl function has been made fully UNIX compatible.
  63.      .  The utility programs lb, and ord were not in v1./06d.  lb is a
  64.         replacement for the libutil program that's in v1.06d, and ord is
  65.         a utility that can be useful when creating object libraries.  lb is
  66.         described in the manual's Utility Programs chapter, ord is
  67.         described in the Additional Documentation section of this
  68.         release document.
  69.      .  The programs grep and diff, which are similar t the UNIX
  70.         programs of the same names, were not in v1.06d.  They're
  71.         described in the manual's Unitools chapter.
  72.      .  A new math library, the 'sensing library';
  73.      .  Assembly language macros are provided, which simplify the
  74.         task of writing C-callable, assemblyu language routines.  See the
  75.         Technical Information chapter for details;
  76.      .  Support for the generation of ROMable programs has been
  77.         added.
  78.      .  There are new library functions;
  79.      .  There is a new manual.
  80. The following paragraphs descuss some of the new features.
  81.  
  82. 1.1  The 'sensing' math library
  83.  
  84.     There are three math libraries in version 3.2d of the Aztec C86
  85. Developer System: m.lib and m87.lib, which were in the previous
  86. versions of Aztec C86, and a new 'sensing' math library, m86s.lib.
  87.  
  88.     The floating point operations for a program linked with one of the
  89. versions of m.lib will be performed using software routines, while thos
  90. of a program linked with one of the version of m87 will be
  91. performed using the 8087.
  92.  
  93.     The floating point operations for a program linked with one of the
  94. versions of m87s.lib will be performed using the 8087, if it is available;
  95. otherwise, they will be performed using software toueings.
  96.  
  97.     The advantages and disadvantages of the different math libraries
  98. are:
  99.  
  100.       .  Linking a program with one of the versions of m87.lib results
  101.          in a small, fast program that can only be run on a machine
  102.          that has an 8087.
  103.       .  Linking it with one of ther versions of m.lib results in a larger,
  104.          slower program that can be run on any machine.
  105.       .  Linking it with one of the version of m87s.lib results in a
  106.          program that is about the same size as when linked with m.lib.
  107.          The program will be as fase as when linked with m87.lib when
  108.          the machine on which it runs has an 8087.  The program can
  109.          run on any machine./
  110.  
  111. 1.2  New functions
  112.  
  113.     The following functions are either new or have been changed in
  114. version 3.2d of the Aztec C86 Developer System for CP/M-86.
  115.  
  116.         function          description
  117.         access            determine file accessibility
  118.         assert            verify program assertion
  119.         brk               set heap pointer
  120.         memccpy, etc      memory operations
  121.         mktemp            make name for temporary file
  122.         movblock          move block of memory
  123.         perror, etc       write error message
  124.         sbrk              set heap pointer
  125.         scr_curs, etc     accesss console via ROM BIOS
  126.         tmpfile           create & open temporary file
  127.         tmpnam            make name for temporary file
  128.  
  129.     For details, see their description in the 8086 Functions chapter.
  130.  
  131. 1.3 New Manual
  132.  
  133.     The new manual describes some features that are only availabe
  134. with the Aztec C86 Commercial System for PCDOS/MSDOS.  The
  135. features that are not supporte by the CP/M-86 Developer System are:
  136.  
  137.      .  Support for the large memory models;
  138.      .  The UNIX utility make;
  139.      .  The text editor Z and the related utility ctags;
  140.      .  The db debugger;
  141.      .  Support for the Microsoft assembler and linker;
  142.      .  'Foreign Library' support;
  143.      .  The term utility program is provided in source form only.
  144.         This program is coede for use on an IBM PC running PCDOS
  145.         and will have to be changed for use in other environments.
  146.  
  147.     Changes have been made to the new manual since it was last
  148. printed:  there's new features, and some existing features have changed.
  149. The Additional Documentation section of this release document
  150. contains the new documentation, in a form suitable for inclusion in
  151. the manual.
  152.  
  153. 2. Packaging
  154.  
  155.     The Aztec C86 package includes the following files that contain
  156. executable programs:
  157.  
  158.          CC.CMD         Optimizing C Compiler
  159.          CCB.CMD        Non-optimizing C Compiler
  160.          AS.CMD         Assembler
  161.          LN.CMD         linker
  162.          LB.CMD         Object file librarian
  163.          ORD.CMD        Sort utility for lb
  164.          CNM.CMD        Object file utility
  165.          OBD.CMD        Object file utility
  166.          SQZ.CMD        Object file utility
  167.          HEX86.CMD      Hex utility for generating
  168.                         ROMable programs
  169.          DIFF.CMD       Source file comparator
  170.          GREP.CMD       Source File pattern matcherr
  171.          CRC.CMD        CRC utility
  172.          ARCV.CMD       Source archive utility
  173.  
  174.     It includes the following libraries, each ofwhich uses the 'small
  175. code' and 'small data' memory modes:
  176.  
  177.          C.LIB          Library of non-floating point functions
  178.                         for CP/M-86 programs
  179.          M.LIB          Library of floating point functions
  180.                         (non-8087 version)
  181.          M87.LIB        Library of floating point functions
  182.                         (8087 version)
  183.          M87S.LIB       Library of floating point functions
  184.                         (sensing version)
  185.          S.LIB          Screen functions (for IBM PC only)
  186.          G.LIB          Graphics functions (fopr IBM PC only)
  187.          D11.LIB        Version of C.LIB for
  188.                         PCDOS/MSDOS 1.1 programs
  189.          D20.LIB        version of C.LIB for
  190.                         PCDOS/MSDOS 2.x programs
  191.  
  192.     The following object modules rea included:
  193.  
  194.          OVLD.O, OVLDPATH.O, OVBGN.O
  195.                         Object modules for overlay support
  196.          SROM.O         Startup routine for ROM programs
  197.  
  198.     It includes the source to a sample C program in the file EXMPL.C.
  199.  
  200.     It includes the following files that contain source archives, which
  201. can be unpacked using the ARCV program (See the Utility Program
  202. chapter for details):
  203.  
  204.          HEADER.ARC     *.H Files
  205.          STDIO.ARC      STDIO functions
  206.          CPM86.ARC      CP/M-86 functions
  207.          DOS11.ARC      PCDOS/MSDOS 1.1 functions
  208.          DOS20.ARC      PCDOS/MSODS 2.0 functions
  209.          MATH.ARC       Math functions
  210.          MCH86.ARC      8086 functions
  211.          MISC.ARC       Miscellaneous functions
  212.          S.ARC          Screen functions
  213.          G.ARC          Graphics functions
  214.          TERM.ARC       term utility source
  215.  
  216.     The first one of theses source archives, that you will need is
  217. header.ard, which contains the #include files such as stdio.h, ctype.h, etc.
  218.  
  219.     The file CRCLIST contains the CRC values for the files.  You can
  220. compute the CRC values of the files we sent you and then compare
  221. then with their expected values, using the program CRC.  For
  222. example, entering
  223.  
  224.          CRC *.*
  225.  
  226. computes the CRC of all files on the current directory of the
  227. default drive.
  228.  
  229. 3. Additional Documentation
  230.  
  231.     This section discusses the following topics:
  232.  
  233.        .  New Compiler options.
  234.        .  The ord program.
  235.        .  Generating ROMable code.
  236.        .  The clock function.
  237.        .  The signal function.
  238.        .  The ls program.
  239.        .  New features for Z.
  240.  
  241.     The description of new compiler options can be appended to the
  242. manual's Compiler chapter.
  243.  
  244.     The ord program is new to Aztec C86;  its description can be
  245. appended to the manual's Utility Programs chapter.
  246.  
  247.     The discussion about generation of ROMable code replaces a
  248. section of the manual's Technical Information chapter.
  249.  
  250.     The other new documentation describes features that are provbided
  251. with the PCDOS/MSDOS version of the Azted C86 Commercial
  252. System, but that aren't provided with the CP/M-86 verion of the
  253. Aztec C86 Developer System.  We are including theie descriptions so
  254. that your manual will continue to be current.  The descriptions of the
  255. clock and signal functions can be appended to the manual's 8086
  256. Functions chapter.  The descriptiojns of ls and new Z features can be
  257. appended to the manual's Unitools chapter.
  258.