home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / SMARTMAG / V2.MSA / README.TXT < prev    next >
Text File  |  2003-12-17  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                                START, The ST Quarterly
  7.                                                Fall 1986: Volume 1, #2
  8.  
  9.  
  10.  
  11.      To compile any of the programs included on this disk, you will
  12. need the following program files from the Developer's Toolkit:
  13.  
  14.  
  15. cp68.prg      C preprocessor
  16. c068.prg      C parser
  17. c168.prg      C code generator
  18. as68.prg      MC68000 assembler
  19. link68.prg    ST linker program
  20. relmod.prg    ST relocation program
  21.  
  22.      To use the batch files included in each folder, you will need
  23. these programs as well:
  24.  
  25.  
  26. batch.prg     ST batch processing program
  27. rm.prg        ST delete (ReMove) file program
  28. wait.prg      ST wait to return to Desktop
  29.  
  30.      In each START folder you will find one or more .BAT files.  If
  31. every necessary file is on the default drive, each program can be
  32. compiled and linked by running batch.prg with this .BAT file as the
  33. parameter.
  34.  
  35.  
  36.      Although not every program requires these header files to
  37. compile, following is an exhaustive list of every system header file
  38. used by every program included on this disk.  By "system header file"
  39. we mean header files provided with the developer's toolkit, and not
  40. any header files a programmer may have created for the specific
  41. program.
  42.  
  43.  
  44. portab.h       - definitions intended to assist in writing
  45.                  portable code (from IBM to ST)
  46. machine.h      - intended to assist in porting between 8086
  47.                  and 68000
  48. gembind.h      - GEM procedure bindings and other GEM
  49.                  things
  50. gemdefs.h      - common GEM definitions from AES manual
  51. obdefs.h       - GEM object definitions
  52. osbind.h       - definitions useful for using osbind.o
  53.                  (GEMDOS)
  54. vdibind.h      - extern declarations for GEM VDI procedure
  55.                  calls
  56. taddr.h        - another way to get to the GEM object
  57.                  structure
  58.  
  59.      Look for the #INCLUDE instructions in a particular program's
  60. listing to determine what specific system header files will be needed
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. on the compile disk.
  73.  
  74.  
  75.      Although not every program requires link files (by which we mean
  76. object and library files necessary to link) following is a list of
  77. every link file necessary to produce any program included on this
  78. disk:
  79.  
  80.  
  81. accstart.o     - accessory program startup
  82. apstart.o      - application program startup
  83. gems.o         - standard C lib. routines (printf, etc.)
  84. gemstart.o     - non-gem program startup
  85. osbind.o       - calls for Atari TOS and bios traps
  86. libf           - floating point library
  87. vdibind        - GEM VDI call bindings
  88. aesbind        - GEM AES call bindings
  89.  
  90.      See the associated batch files for a list of the specific link
  91. files necessary for a particular program.
  92.  
  93.  
  94.      Note that some may use separate resource files.  In some cases,
  95. the resource file C sources are included.  In all cases, at least the
  96. .RSC file itself is included.
  97.  
  98.  
  99.      Creating a .RSC file from the sources is a difficult thing to do.
  100. We suggest you use DRI's resource editor (on the sources, of course)
  101. if you want to change any of these separate resources.
  102.  
  103.  
  104.      All of these programs work with Alcyon C, the compiler provided
  105. with the Developer's Toolkit.  Note that Atari officially recognizes
  106. only two versions of the Developer's Kit.  Atari released Alcyon
  107. version 4.14 as the magazine went to press.  Some programs may need
  108. modification to run on this most recent version.  However, all run on
  109. the current, and most popular version.  Many of the programs will also
  110. compile immediately with Megamax C.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.                        SUBSCRIPTION INFORMATION
  139.  
  140.  
  141. All programs, object code, source code, and text files contained on
  142. this disk are (C) Copyright 1986 by Antic Publishing and, unless
  143. otherwise noted, are NOT to be considered as part of the public
  144. domain.
  145.  
  146. START, The ST Quarterly is a magazine with disk that is published four
  147. times per year by Antic Publishing, 524 Second Street, San Francisco,
  148. CA  94107.
  149.  
  150. SUBSCRIPTIONS TO START:
  151.  
  152.     --- One year (4 issues) of START, The ST Quarterly, (magazine + 3
  153. 1/2 inch disk) for $59.95.  Act now and receive, absolutely free, 12
  154. issues of ANTIC, including the ST Resource each issue. (Current Antic
  155. subscriptions extended 12 additional issues.)
  156.  
  157.     --- One year (4 issues) of START, The ST Quarterly, (magazine + 3
  158. 1/2 inch disk), plus 12 issues of ANTIC's Action Edition (magazine + 5
  159. 1/4 inch disk), for $149.95. (Current Antic disk subscriptions
  160. extended 12 additional issues.)
  161.  
  162.      Send check or money order to:
  163.  
  164.  
  165.                          START SUBSCRIPTIONS
  166.                           524 Second Street
  167.                        San Francisco, CA  94107
  168.  
  169.     (All orders must be prepaid.  Add $25.00 postage for foreign
  170. subscriptions per year.  Please allow 4-6 weeks for delivery of your
  171. first issue.)
  172.  
  173.      Back issues of START magazine and disks or additional copies of
  174. the current disk may be purchased by sending $5.00 per magazine, or
  175. $10.95 for disk plus $2.00 for postage and handling per order, to
  176. START DISK, 524 Second St., San Fransisco, CA  94107, or call (800)
  177. 443-0100 ext. 133.
  178.  
  179.  
  180. TO SUBSCRIBE, call toll free:  (800) 443-0100 ext. 133.
  181.  
  182. TO ORDER SOFTWARE FROM "The Catalog":  call (800) 443-0100 ext. 133.
  183.  
  184. CUSTOMER SERVICE:  call (415) 957-0886, 8:00 a.m. to 1:00 p.m. Pacific
  185. Time, Monday through Friday. (Please do not call the 800 number for
  186. Customer Service, thank you.)
  187.  
  188. COMPUSERVE for ANTIC ONLINE:  type GO ANTIC.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.