home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C128CPM / SGTOOL10.ARC / SGCTOOLS.DOC < prev    next >
Encoding:
Text File  |  1993-07-19  |  5.6 KB  |  151 lines
  1. ___________________________________________________________________
  2.  
  3.                          SG C Tools 1.0
  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.0 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 must
  58. cover the cost of copying or dissemination only.  Such charges must
  59. be clearly identified as such by the originating party.  Under no
  60. circumstances may the purchaser be given the impression that he is
  61. 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 may
  65. 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 form. 
  69. Any other use, distribution or representation of SG C Tools is
  70. expressly forbidden without the written consent of Steve Goldsmith.
  71.  
  72. Commodore 128 is a trademark of Commodore Business Machines.  CP/M
  73. and CP/M 3.0 are trademarks of Digital Research.  MS-DOS is a
  74. trademark of Microsoft.  IBM PC,  PC-XT and PC-AT are trademarks
  75. of International Business Machines.
  76.  
  77.  
  78. * OVERVIEW
  79.  
  80. SG C Tools provides a set of high level ANSI C modules to unlock
  81. the power of the C128 running CP/M.  With a little modification it
  82. should compile with a native mode ANSI C compiler too!  The first
  83. module provides lightning fast VDC functions for fills, copies,
  84. string output 9 times faster than puts(), page flipping, etc.  This
  85. puts you in complete control of the VDC!  Future releases will
  86. include more VDC functions, custom fonts, bit mapped graphics, SID
  87. sound and much more.  If you have seen any of my Pascal code you
  88. know I like cutting edge stuff.  After all, I was the first to
  89. produce .PCX graphics viewers, 4 bit digitized sound, multimedia
  90. etc. on the C128 in CP/M mode!
  91.  
  92.  
  93. * REQUIREMENTS
  94.  
  95. + A C128 or C128D running CP/M 3.0 or a IBM PC running a CP/M     
  96.   emulator.
  97. + At least one 1581, two 1571s, large RAM disk or hard drive to   
  98.   compile on a C128.
  99. + 40 or 80 column monitor
  100.  
  101.  
  102. * COMPILING SOURCE CODE WITH HI-TECH C 3.09
  103.  
  104. First you will need to have a copy of HI-TECH C 3.09 (CP/M-80). 
  105. You can download the following Freeware files from GEnie's CP/M RT
  106. (M685;3) or other source:
  107.  
  108.  8149 LIBSRC.LZH               X BRIAN-CPM    930616   80384     39 
  109.  3
  110.       Desc: Source Code to Hitech C library
  111.  8148 Z80V309.LZH              X BRIAN-CPM    930616  194304     51 
  112.  3
  113.       Desc: Hitech C Compiler for CP/M
  114.  8147 Z80DOC.LZH               X BRIAN-CPM    930616   89088     55 
  115.  3
  116.       Desc: Documentation for Hitech C compiler
  117.  
  118. You should look over HI-TECH C's manual and compile a simple "hello
  119. world" program before proceeding.  I installed all the compiler
  120. related files on my 1581.  My source and header files are on a
  121. 1571.  You could get away with two 1571s, but a RAM disk or hard
  122. drive would be better.  You could also use a CP/M-80 emulator on
  123. the IBM PC and copy compiled files to C128 for testing.  The
  124. examples I give assume all files are on same drive.
  125.  
  126. To compile the VDC.C module use:
  127.  
  128. C -C -O -X VDC.C
  129.  
  130. To compile sample programs use:
  131.  
  132. C -O -X FILENAME.C VDC.OBJ
  133.  
  134. You may want to leave to -O (optimize) and -X (strip local symbols)
  135. off until code is debugged and ready for release.  This will
  136. improve compile time.  Each module and program contains a generous
  137. of comments, so I will not waste time explaining it here.  The best
  138. way to get a feel for SG C Tools is to experiment with the VDC
  139. module.
  140.  
  141.  
  142. * HOW TO CONTACT ME
  143.  
  144. Please report any support questions (for registered users only),
  145. problems, suggestions, etc. to me via GEnie as
  146. S.GOLDSMITH2, voice phone (813) 925-1064 or mail to:
  147.  
  148. Steve Goldsmith
  149. 2805 Jamaica Street
  150. Sarasota, FL 34231
  151.