home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / GLEN / MC20.ZIP / READ.ME < prev    next >
Text File  |  1990-08-20  |  11KB  |  220 lines
  1.                           * The MICRO-C 2.0 Compiler *
  2.     
  3.        MICRO-C is a tiny compiler for the 'C' language. It has been designed
  4.     to be VERY portable, and can be moved between different  processors  and
  5.     operating systems with little difficulty.
  6.     
  7.        MICRO-C should not be compared to MICROSOFT, TURBO,  or  any  of  the
  8.     other P.C. compilers, because it it intended for en  entirely  different
  9.     purpose. These are very good compilers, but they are  large,  expensive,
  10.     and dedicated to specific computer environments. MICRO-C is tiny (it can
  11.     be made to run in less that 32K), and allows you to take it anywhere you
  12.     want.
  13.     
  14.        The complete MICRO-C package includes all  source  code  and  support
  15.     files you need to port the compiler to any environment. It also includes
  16.     code  generators  for  the  6809,  68HC11,   8080/8085/Z80   and   80x86
  17.     processors. With this package you can turn out an "instant" compiler for
  18.     any machine using one of those processors. The documentation  file  also
  19.     contains detailed information on writing new code generators  for  other
  20.     processors.
  21.     
  22.        MICRO-C is also  an  excellent  learning  tool.  Not  only  does  the
  23.     complete, well documented source code for  the  compiler  and  utilities
  24.     give you the opportunity to explore and understand those  programs,  the
  25.     source code for the library gives you information on all kinds of system
  26.     programming, such as:
  27.     
  28.                 - DOS and BIOS services
  29.                 - Video screen and windowing functions
  30.                 - Interrupt driven serial communications
  31.                 - Terminate and Stay Resident (TSR)
  32.                 - Lots MORE (Over 130 functions)
  33.     
  34.        For more information on the compiler, see the file MC.DOC. This  file
  35.     is quite large, make sure you are in no hurry before printing  it  on  a
  36.     slow printer. The table of contents pages are printed last,  and  should
  37.     be inserted between the title page and page 1.
  38.     
  39.        Version 2.0 of MICRO-C represents many code  improvments,  bug  fix's
  40.     and added  capabilities.  It  is  no  longer  "User  supported  Software
  41.     (shareware)", due to lack of  user  support.  This  archive  contains  a
  42.     "DEMO" package, consisting of the IBM PC executables and support  files.
  43.     If you like what you see, and wish to obtain the complete  package  with
  44.     source code for the compiler, libraries  and  utilities,  Fill  out  the
  45.     order form at the end of this document,  and  send  it  along  with  the
  46.     required payment to:
  47.     
  48.                         Dave Dunfield
  49.                         56 Burnetts Grove Circle,
  50.                         Nepean, Ont. (Canada)
  51.                         K1J 1N6
  52.     
  53.        If you decide not to order the complete  MICRO-C  package,  you  MUST
  54.     discontinue using MICRO-C within thirty days.
  55.     
  56.        Permission is granted to copy and distribute this  archive,  provided
  57.     that it is kept in its original form, with no modifications of any kind.
  58.     
  59.                               * Getting Started *
  60.     
  61.        To install MICRO-C on a hard drive, simply  create  a  directory  and
  62.     unpack this archive into it. The directory  "\MC"  is  preferred,  since
  63.     some of the utilities assume this is the MICRO-C home  directory  unless
  64.     told otherwise.
  65.     
  66.        Once you have installed the system, refer  to  the  section  entitled
  67.     "THE COMMAND CO-ORDINATOR" in the MC.DOC file for information on how  to
  68.     compile programs using the 'CC' command. You should either  include  the
  69.     MICRO-C directory "\MC" in your PATH, or  copy  the  CC.COM  file  to  a
  70.     directory which is already in your PATH. Also, make sure that  the  MASM
  71.     and LINK commands are available on your  system.  The  MCDIR  and  MCTMP
  72.     environment variables should be set up  as  described  in  the  document
  73.     before attempting to use CC.
  74.     
  75.        Once you have everything set up, you may wish to try  compiling  some
  76.     of the example programs which are included in this archive.
  77.     
  78.                             * MICRO-C under MS-DOS *
  79.                             * Implementation notes *
  80.     
  81.        The 8086/MS-DOS implementation of the compiler produces code for  the
  82.     Microsoft MASM (or compatible) assembler in either  the  TINY  or  SMALL
  83.     models. It has been tested with MASM 4.0, MASM 5.1  and  TASM  1.0.  The
  84.     LINK utility is required to create a ".EXE"  file.  NOTE  that  programs
  85.     produced for the TINY model will execute as ".EXE" files,  however,  due
  86.     to PSP being outside of the data/code segment, command  line  parameters
  87.     are only available when the program is converted to ".COM"  format  with
  88.     the EXE2BIN utility.
  89.     
  90.        The memory model to use is selected by  the  runtime  library,  which
  91.     MUST BE FIRST in the list of object files  passed  to  the  linker.  The
  92.     8086RL_T.OBJ file distributed with MICRO-C is configured  for  the  TINY
  93.     model, and the 8086RL_S.OBJ file is configured for the SMALL model.
  94.     
  95.        The variables ARGC and ARGV (Note  capitals)  are  available  in  the
  96.     runtime  library  module  for  use  as  EXTERNAL  references  from  your
  97.     programs. This makes it easy for  a  function  other  than  'main()'  to
  98.     access the programs arguments.  The  variables  PSP  and  ENV  are  also
  99.     available to  determine  the  PROGRAM  SEGMENT  PREFIX  and  ENVIRONMENT
  100.     segments.
  101.     
  102.             ie:     extern int ARGC;        /* Count of arguments */
  103.                     extern char *ARGV[];    /* Array of ptrs to args */
  104.                     extern int PSP;         /* PSP segment */
  105.                     extern int ENV;         /* Environment segment */
  106.     
  107.        If you are using a DOS version prior to  3.0,  the  argv[0]  (program
  108.     name) argument will not work correctly.
  109.     
  110.        All of the source and header files  ('.c',  and  '.h')  were  written
  111.     using tab stops every 4 characters, which is much  more  convenient  for
  112.     'C' development than the usual MS-DOS tab stops of every  8  characters.
  113.     Source for a program called "type4.c" is provided, which  reads  a  file
  114.     and displays it using  spaces  to  simulate  the  tabs  at  4  character
  115.     intervals. To compile this program, use:
  116.     
  117.                                     cc type4
  118.     
  119.        The resulting "type4.com" file may be used to view/print  the  source
  120.     files with proper spacing.
  121.     
  122.                            * Files in this archive *
  123.     
  124.             READ.ME         - This file
  125.             CATALOG         - Catalog of available software
  126.             FEATURES.DOC    - A summary of MICRO-C features
  127.             MC.DOC          - MICRO-C Technical Documentation
  128.             CINTRO.DOC      - Introduction to 'C'
  129.             CC.COM          - Command Co-ordinator
  130.             MCC.COM         - Compiler
  131.             MCP.COM         - Preprocessor
  132.             MCO.COM         - Optimizer
  133.             EXE2BIN.COM     - Executable to Binary convertor
  134.             WINDEMO.COM     - Window package demonstration
  135.             LC.BAT          - Batch file to link multiple objects
  136.             8086RL_T.OBJ    - Tiny model runtime library
  137.             8086RL_S.OBJ    - Small model runtime library
  138.             MCLIB.LIB       - MICRO-C Function Library
  139.             *.h             - Header files as described in the documentation
  140.             *.c             - Various example programs
  141.     
  142.                             ************************
  143.                             *** Ordering MICRO-C ***
  144.                             ************************
  145.     
  146.        MICRO-C IS NOT FREE SOFTWARE,  if  you  like  MICRO-C,  and  wish  to
  147.     continue using it, you MUST order a complete copy of the  program,  this
  148.     gets you many things not included in the demo archive, including:
  149.     
  150.             - More utilities, such as MAKE, TOUCH, SLINK, SINDEX.
  151.     
  152.             - Complete source code for compiler, libraries and utilities.
  153.     
  154.             - Code generators for 6809, 68HC11, and 8080 (with source).
  155.     
  156.             - An nice set of windowing library functions (with source).
  157.               Run the WINDEMO.COM program for a taste.
  158.     
  159.             - More example programs (with source).
  160.     
  161.        Once you purchase a copy of MICRO-C, you may at any time,  obtain  an
  162.     update to the current revision of the product by filling out  the  order
  163.     form below, and sending it and the required update fee  to  the  address
  164.     mentioned above. Don't forget to check the 'Update' box, and to fill  in
  165.     your MICRO-C serial number.
  166.                            * MICRO-C Product Order Form *
  167.     
  168.             Name: _____________________________________________________
  169.     
  170.             Street address: ___________________________________________
  171.     
  172.             City: ___________________ State/Prov: _____________________
  173.     
  174.             Zip/Postal Code: ______________ Country: __________________
  175.     
  176.         For the purposes of this document, the term "MICRO-C" shall be used
  177.         to refer to the licenced MICRO-C package, including all documentation,
  178.         source code, executable and support files, for the compiler, libraries,
  179.         utilities and example programs.
  180.     
  181.         By signing this order form, you indicate you acceptance of the following
  182.         conditions:
  183.     
  184.         1)  You may make a backup copy of MICRO-C, and you may install MICRO-C
  185.             on your computer systems hard disk, but only one copy of MICRO-C may
  186.             be in use at one time.
  187.     
  188.         2)  You may modify MICRO-C in any way you like, but the modified code
  189.             shall, regardless of the extent of modification, remain the property
  190.             of the original author, Dave Dunfield. You may not remove or alter
  191.             the copyright notices contained in the source files, or displayed
  192.             by the executables.
  193.     
  194.         3)  You are granted permission to distribute any programs you develop
  195.             with MICRO-C. You may distribute executable code for MICRO-C library
  196.             functions only if such code is contained within the executable image
  197.             of a program which you compiled with MICRO-C.
  198.     
  199.         4)  With the exception of embedded code mentioned above, You may not
  200.             re-distribute any part of MICRO-C in any way. Any and all copies
  201.             of MICRO-C must be retained in your possession at all times.
  202.     
  203.         5)  You may transfer the licence and complete MICRO-C package, provided
  204.             that you retain no copies of any portion of MICRO-C, and that the
  205.             transferee completes and sends in a signed copy of this order form,
  206.             indicating the serial number of the MICRO-C package being transferred.
  207.     
  208.         Please check one:
  209.     
  210.                 [ ] New order, $25 (U.S.) enclosed.
  211.     
  212.                 [ ] Update, $10 (U.S.) enclosed, Serial No. ________
  213.     
  214.                 [ ] Transfer of MICRO-C licence, Serial No. ________
  215.     
  216.         I have read and agree to be bound by the above conditions.
  217.     
  218.     
  219.             Date: ___________       Signed: _________________
  220.