home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / pc / source / mssup201.arc / README.1ST < prev    next >
Encoding:
Text File  |  1988-08-26  |  6.9 KB  |  131 lines
  1.               MS-DOS Source Support Package for Zoo 2.01
  2.  
  3. This support package, in conjunction with the portable UNIX/VMS source for
  4. zoo 2.01, will allow you to recompile zoo 2.01 on your MS-DOS system,
  5. provided you have the necessary C compiler and assembler as described
  6. below.  To use this package, combine all files in this package with all
  7. files in the UNIX/VMS source package.  There should be no files with
  8. duplicate names in the two packages.  (You may wish to do newline
  9. conversions at this point, since the UNIX/VMS source package contains text
  10. files with lines terminated with the linefeed character, while many MS-DOS
  11. programs require lines terminated by carriage return and linefeed.)
  12.  
  13. This package contains the following files:
  14.  
  15. addbfcrc.asm  1,066  8-25-88 10:31a    makefile.msc  1,143  8-24-88  3:31p
  16. asmconst.ai     423  8-25-88 10:32a    msc.c         1,528  8-24-88  3:31p
  17. dta.h           404  6-21-87 11:49a    msdos.c       2,205 12-27-87  6:09p
  18. fiz.prj          44  8-24-88 12:53p    readme.1st    7,048  8-26-88 12:08a
  19. fiz.tc        1,380  8-24-88 12:51p    signal.c      2,455  8-09-87  1:24p
  20. intdos.h        495  6-21-87  9:09p    signal.man    3,054  8-09-87  1:38p
  21. lzc.asm      12,849  8-24-88 11:23p    tcconfig.tc   1,380  8-24-88 12:14p
  22. lzd.asm       9,496  8-24-88 11:23p    turboc.c      1,627  8-25-88 12:04a
  23. macros.ai       284  8-27-86 12:40p    zoo.prj         433  8-24-88 12:15p
  24.  
  25. With the availability of the C and assembly source, there now exists the
  26. possibility of modified copies of zoo becoming available for MS-DOS
  27. systems.  To help users distinguish independently-compiled copies and the
  28. one that I distribute, I distribute a compiled version of zoo for MS-DOS
  29. that is slightly smaller in size than the executable program that you will
  30. get from this source code.  It will also have a different CRC value.  The
  31. executable version of zoo 2.01 for MS-DOS that I distribute, when stored
  32. compressed in a zoo archive whose contents are listed with the "lC" command,
  33. has the following attributes:
  34.  
  35.      original size   = 40078 bytes  (will be same in an ARC archive)
  36.      CRC value       = 27db         (will be same in an ARC archive)
  37.      compressed size = 31814        (may be different in an ARC archive)
  38.  
  39. To recompile the provided source code for MS-DOS you will need a C compiler
  40. and the Microsoft Macro Assembler (I use version 4.0).  To use any C
  41. compiler other than Turbo C 1.0 or Microsoft C 3.0 you may need to modify
  42. the code, as some compiler-specific features crop up here and there.  In
  43. particular the C-assembly linkage (how the stack is manipulated and how the
  44. 8086 registers are used etc.) is designed for Turbo C or Microsoft C.
  45.  
  46. Please note that there are certain copyright requirements.  The following is
  47. an explanation of some highlights;  consult the actual copyright policy
  48. supplied elsewhere for precise details.  In particular note that if you
  49. distribute an executable program that you create from the zoo source code,
  50. you must also distribute the source code from which you created the
  51. executable program.  Exceptions to this policy are permissible only if you
  52. have negotiated them with me privately.  Also note that you are forbidden
  53. from creating, either deliberately or through negligence, any derivative
  54. work that creates archives that are incompatible with those created by the
  55. authorized versions of zoo that I distribute in source and binary form.
  56.  
  57.                         Notes for Turbo C 1.0
  58.  
  59. Project files "zoo.prj" and "fiz.prj" are supplied for use with the
  60. integrated environment of Turbo C 1.0.  Also provided are configuration
  61. files "tcconfig.tc" and "fiz.tc".  The supplied configuration files assume
  62. that all sources are in the current directory which is C:/ZOO and that the
  63. Turbo C include files are in C:/TURBOC/INCLUDE.
  64.  
  65. For best results you should edit the include file signal.h that came with
  66. Turbo C 1.0 to contain the following function prototype for the signal()
  67. function at the end:
  68.  
  69.      int (*_Cdecl signal (int sig, int (*action)())) ();  /* R.D */
  70.  
  71. This is not strictly necessary, but not doing so may cause Turbo C to give
  72. you a warning message when zoo is compiled.
  73.  
  74. The Microsoft Macro Assembler 4.0 is referred to as "masm" in the following
  75. instructions.
  76.  
  77. To compile zoo:
  78.  
  79. (a)  If you have compiled fiz previously, delete any copy of "portable.obj"
  80.      that still exists from that compilation.
  81. (b)  Use the command line "tcc -c *.asm" to assemble all the assembly
  82.      source files.  If you don't have "tcc" (the command line version of
  83.      Turbo C) available, assemble each assembly language file separately,
  84.      supplying the "/mx" switch to masm to make it preserve case.  For
  85.      example, to assemble the file "addbfcrc.asm", the command is
  86.      "masm /mx addbfcrc;".  The trailing semicolon in the command line
  87.      suppresses superfluous prompts from masm.
  88. (c)  Invoke the integrated environment version of Turbo C 1.0.  Load 
  89.      the configuration file "tcconfig.tc" and begin compiling.  There
  90.      should be no warnings and no errors reported by Turbo C.
  91.  
  92. To compile fiz:
  93.  
  94. (a)  If you have compiled zoo previously, delete any copy of "portable.obj"
  95.      that still exists from that compilation.
  96. (b)  If addbfcrc.obj does not already exist from compiling zoo, create it by
  97.      assembling "addbfcrc.asm" with the command line "tcc -c addbfcrc.asm"
  98.      or with the command line "masm /mx addbfcrc;".  The "/mx" switch is
  99.      used to make masm preserve case in symbols.
  100. (c)  Invoke the integrated environment version of Turbo C 1.0.  Load the
  101.      configuration file "fiz.tc".  Begin compiling.  There should be no
  102.      warnings and no errors reported by Turbo C.
  103.  
  104. I have not tried using any other versions of Turbo C.
  105.  
  106. This source will produce an executable program that will be slightly larger
  107. in size than the executable version of zoo that I compile and distribute. 
  108. This difference in size does not affect performance in any way;  your
  109. compiled copy of zoo 2.01 should behave identically to the authorized
  110. executable, except that it may need slightly more memory.
  111.  
  112.                         Notes for Microsoft C 3.0
  113.  
  114. Zoo 2.01 can be compiled with Microsoft C 3.0.  There will be an increase in
  115. size.
  116.  
  117. The environment variables INCLUDE, LIB, and TMP should be set as needed by
  118. Microsoft C 3.0 (consult your compiler's documentation).  Rename the file
  119. "makefile.msc" to "makefile" and use the shareware make utility called
  120. "ndmake" written by D G. Kneller.  Version 4.31 of this make utility is
  121. known to work correctly with this makefile.
  122.  
  123. The supplied source code uses unbuffered I/O is used when compiling with
  124. Microsoft C 3.0.  Casual testing of the executable program shows that this
  125. works.  I have not exhaustively tested the executable program obtained with
  126. Microsoft C 3.0.
  127.  
  128. I have not tried using any other versions of Microsoft C.
  129.  
  130.                                    -- Rahul Dhesi 1988/08/25
  131.