home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C128CPM / SGTOOL11.ARC / SGTOOL.DOC < prev    next >
Encoding:
Text File  |  1993-07-25  |  6.8 KB  |  185 lines
  1. ___________________________________________________________________
  2.  
  3.                          SG C Tools 1.1
  4.                     (C) 1993 Steve Goldsmith
  5.                        All Rights Reserved
  6. ___________________________________________________________________
  7.  
  8.  
  9. NOTICE
  10.  
  11. THIS IS NOT FREE SOFTWARE!  If you paid a public domain vendor or
  12. communications service for this product, you paid for the service
  13. of copying or transferring the product, and not for the product
  14. itself.  I guarantee you that nothing ever gets to the originator
  15. of this product from such a sale.  You may evaluate this product,
  16. but if you make use of it, you must register your copy.
  17.  
  18. I offer several incentives for you to register.  First of all,
  19. you receive the most up-to-date copy that I have which is updated
  20. on a regular basis.  Future unregistered releases will not include
  21. most source code and/or object files.  Support via GEnie, mail or
  22. phone from the author.  Price is subject to change as more modules
  23. are added.
  24.  
  25.  
  26. REGISTRATION INFORMATION
  27.  
  28. The non-commercial registration fee for SG C Tools 1.1 is $5.00
  29. plus $3.00 for shipping in US funds.
  30.  
  31. Send a check or money order for the appropriate amount to:
  32.  
  33. Steve Goldsmith
  34. 2805 Jamaica Street
  35. Sarasota, FL 34231
  36.  
  37. Please indicate what product you are ordering and if you have a
  38. requirement for 3.5" media.  I normally ship 5.25" Commodore GCR
  39. format diskettes, but will furnish 3.5" media upon request.
  40. Customers outside of the United States and Canada should include an
  41. extra $5.00 for airmail.
  42.  
  43. If you are a registered user of this product and desire an update,
  44. please contact me for upgrade prices.
  45.  
  46.  
  47. DISTRIBUTION NOTICE
  48.  
  49. This is "user-supported" software.  You are hereby granted a
  50. license by Steve Goldsmith to distribute this evaluation copy of SG
  51. C Tools and its documentation, subject to the following conditions:
  52.  
  53. 1.   SG C Tools may be distributed freely without charge in
  54.      evaluation form only.
  55.  
  56. 2.   SG C Tools may not be sold, licensed, or a fee charged for its
  57.      use.  If a fee is charged in connection with SG C Tools, it
  58.      must cover the cost of copying or dissemination only.  Such
  59.      charges must be clearly identified as such by the originating
  60.      party.  Under no circumstances may the purchaser be given the
  61.      impression that he is buying SG C Tools itself.
  62.  
  63. 3.   SG C Tools must be presented as a complete unit, including
  64.      this documentation.   Neither SG C Tools nor its documentation
  65.      may be amended or altered in any way.
  66.  
  67. 4.   By granting you the right to distribute the evaluation form of
  68.      SG C Tools, you do not become the owner of SG C Tools in any
  69.      form.  Any other use, distribution or representation of SG C
  70.      Tools is expressly forbidden without the written consent of
  71.      Steve Goldsmith.
  72.  
  73. Commodore 128 is a trademark of Commodore Business Machines.  CP/M
  74. and CP/M 3.0 are trademarks of Digital Research.  MS-DOS is a
  75. trademark of Microsoft.  IBM PC,  PC-XT and PC-AT are trademarks
  76. of International Business Machines.
  77.  
  78.  
  79. OVERVIEW
  80.  
  81. SG C Tools provides a set of high level ANSI C modules to unlock
  82. the power of the C128 running CP/M.  With a little modification it
  83. should compile with a native mode ANSI C compiler too!  All
  84. functions are included in a library to make compiling your programs
  85. fast and easy.  Example programs are included to get you started!
  86.  
  87.  
  88. VERSION INFORMATION
  89.  
  90. 1.0
  91.  
  92. First version came with basic VDC I/O, fills, copies, fast string
  93. writes and basic screen controls.
  94.  
  95. 1.1
  96.  
  97. Added up and down scrolls of any region, fast pop up windows and
  98. buffered VDC I/O.  All VDC functions are now in a library called
  99. LIBC128.LIB.  Use C FILENAME.C -LC128 to compile instead of C
  100. FILENAME.C VDC.OBJ.  Low level VDC I/O functions invdc() and
  101. outvdc() are now in a external Assembler file VDCIO.AS.  This
  102. increased the over all speed a great deal!
  103.  
  104. I used Simeon Cran's MYZ80 Z80 emulator running ZP/M 3 under
  105. Windows 3.1 to compile this version.  Sydex's 22DISK was used to
  106. transfer files from DOS to a Epson QX-10 format disk.  This allowed
  107. me to run code on a C128 without having to run a C128 native mode
  108. file transfer program like BBR.  You could also use a C128 CP/M
  109. program that read DOS disks for about the same result.
  110.  
  111.  
  112. REQUIREMENTS
  113.  
  114. *    A C128 or C128D running CP/M 3.0 or a IBM PC running a CP/M
  115.      emulator and DOS to CP/M file transfer software.
  116.  
  117. *    At least one 1581, two 1571s, large RAM disk or hard drive to
  118.      compile on a C128.
  119.  
  120. *    80 column monitor for VDC specific routines.
  121.  
  122.  
  123. COMPILING SOURCE CODE WITH HI-TECH C 3.09
  124.  
  125. First you will need to have a copy of HI-TECH C 3.09 (CP/M-80). 
  126. You can download the following Freeware files from GEnie's CP/M RT
  127. (M685;3) or other source:
  128.  
  129.  8149 LIBSRC.LZH               X BRIAN-CPM    930616   80384     39 
  130.  3
  131.       Desc: Source Code to Hitech C library
  132.  8148 Z80V309.LZH              X BRIAN-CPM    930616  194304     51 
  133.  3
  134.       Desc: Hitech C Compiler for CP/M
  135.  8147 Z80DOC.LZH               X BRIAN-CPM    930616   89088     55 
  136.  3
  137.       Desc: Documentation for Hitech C compiler
  138.  
  139. You should look over HI-TECH C's manual and compile a simple "hello
  140. world" program before proceeding.  I installed all the compiler
  141. related files on my 1581.  My source and header files are on a
  142. 1571.  You could get away with two 1571s, but a RAM disk or hard
  143. drive would be better.  You could also use a CP/M-80 emulator on
  144. the IBM PC and copy compiled files to C128 for testing.  The
  145. examples I give assume all files are on same drive.
  146.  
  147. To compile sample programs use:
  148.  
  149. C -O -X FILENAME.C -LC128
  150.  
  151. If you want to modify the code in LIBC128.LIB I have provided a
  152. input file to compile all the files.
  153.  
  154. 1.   Make sure you have all the source to LIBC128.LIB.
  155. 2.   ZAS -J VDCIO.AS to assemble low level VDC I/O.
  156. 3.   C < OBJ.MAK to make obj files.
  157. 4.   LIBR < LIB.MAK to make library.
  158. 5.   ERA VDC*.OBJ to get rid of .OBJ files.
  159.  
  160. You could also just modify one module and replace it in the library
  161. with LIBR R LIBC128.LIB FILENAME.OBJ if you don't need to build the
  162. whole library.
  163.  
  164. I also provided a submit file MAKE.SUB which will build LIBC128.LIB
  165. and all example programs.  If you are using a C128 I would
  166. recommend using a RAM drive.  I used a CP/M emulator on my 386 and
  167. it still took about 10 minutes.
  168.  
  169. You may want to leave to -O (optimize) off until code is debugged
  170. and ready for release.  This will improve compile time.  Each
  171. module and program contains a generous amount of comments, so I
  172. will not waste time explaining it here.  The best way to get a feel
  173. for SG C Tools is to experiment with the sample programs.
  174.  
  175.  
  176. HOW TO CONTACT ME
  177.  
  178. Please report any support questions (for registered users only),
  179. problems, suggestions, etc. to me via GEnie as
  180. S.GOLDSMITH2, voice phone (813) 925-1064 or mail to:
  181.  
  182. Steve Goldsmith
  183. 2805 Jamaica Street
  184. Sarasota, FL 34231
  185.