home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / dev / aforth-1.4.lha / AForth-1.4 / docs / USER.DOC < prev    next >
Encoding:
Text File  |  1994-04-28  |  11.0 KB  |  302 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                            A F O R T H
  7.                            -----------
  8.  
  9.         A FORTH-79 Standard Implementation For The AMIGA®
  10.         -------------------------------------------------
  11.  
  12.                            Version 1.0
  13.                            -----------
  14.                            
  15.               U S E R    D O C U M E N T A T I O N
  16.               ------------------------------------
  17.  
  18.                   Copyright © Stratagem4, 1994
  19.                   ----------------------------
  20.  
  21.                        All Rights Reserved
  22.                        -------------------
  23.  
  24.  
  25.                AFORTH was written by Steve Martin
  26.  
  27.                      Address:   Stratagem4
  28.                                 125 Broadview Avenue
  29.                                 Rainham
  30.                                 Gillingham
  31.                                 Kent
  32.                                 ME8 9JD
  33.                                 United Kingdom
  34.                          
  35.                    Telephone:   (0634) 261412
  36.  
  37.  
  38.      Program and Documentation Copyright © Stratagem4, 1994
  39.     AMIGA is a Registered Trademark of Commodore-Amiga, Inc.
  40.  AmigaDOS and Workbench are trademarks of Commodore-Amiga, Inc.
  41.          FORTH is a Registered Trademark of FORTH, Inc.
  42.          
  43.                       All rights reserved.
  44.  
  45.  
  46. Acknowledgements
  47. ~~~~~~~~~~~~~~~~
  48. My  thanks  go  to  all  those  who played a part in Beta testing
  49. AFORTH.   Thanks  are  also  due  to  Lynn  for her patience, and
  50. Commodore Amiga for providing an excellent computer.
  51.  
  52.  
  53. INTRODUCTION
  54. ============
  55.  
  56. Overview
  57. ~~~~~~~~
  58. AFORTH is an implementation of the FORTH programming language for
  59. the  Commodore  Amiga,  it  adheres  very closely to the FORTH-79
  60. standard as defined by the FORTH Standards Team.
  61.  
  62.  
  63. What Is Shareware?
  64. ~~~~~~~~~~~~~~~~~~
  65. Shareware  distribution  gives  users  a  chance  to try software
  66. before  buying  it.   If you try a Shareware program and continue
  67. using  it,  you  are  expected  to register.  Individual programs
  68. differ on details, some request registration while others require
  69. it,  some  specify a maximum trial period.  With registration you
  70. get anything from the simple right to continue using the software
  71. to an updated program with printed manual.
  72.  
  73. Copyright  laws  apply to both Shareware and commercial software,
  74. and  the copyright holder retains all rights, with a few specific
  75. exceptions  as  stated below.  Shareware authors are accomplished
  76. programmers,  just  like commercial authors, and the programs are
  77. of  comparable  quality.  (In both cases, there are good programs
  78. and   bad  ones!)  The  main  difference  is  in  the  method  of
  79. distribution.   The  author specifically grants the right to copy
  80. and  distribute  the  software,  either to all and sundry or to a
  81. specific  group.   For  example,  some  authors  require  written
  82. permission  before  a  commercial  disk  vendor  may  copy  their
  83. Shareware.
  84.  
  85. Shareware  is a distribution method, not a type of software.  You
  86. should find software that suits your needs and pocket, whether it
  87. is  commercial  or Shareware.  The Shareware system makes fitting
  88. your  needs  easier,  because  you  can  try  before you buy, and
  89. because  the overhead is low, prices are also low.  Shareware has
  90. the ultimate money-back guarantee - if you don't use the product,
  91. you don't pay for it.
  92.  
  93. Disclaimer
  94. ~~~~~~~~~~
  95. Users of AFORTH must accept this disclaimer of warranty:
  96.  
  97. "AFORTH  is supplied as is.  The author disclaims all warranties,
  98. expressed   or   implied,   including,  without  limitation,  the
  99. warranties  of  merchantability  and  of fitness for any purpose.
  100. The   author   assumes   no  liability  for  damages,  direct  or
  101. consequential, which may result from the use of AFORTH."
  102.  
  103. Terms And Conditions
  104. ~~~~~~~~~~~~~~~~~~~~
  105. AFORTH  is  a "Shareware program" and is provided at no charge to
  106. the  user  for  evaluation.   Feel  free  to  share  it with your
  107. friends,  but  please  do  not give it away altered or as part of
  108. another  system.   The essence of "user-supported" software is to
  109. provide  personal  computer  users  with quality software without
  110. high  prices,  and  yet  to  provide incentive for programmers to
  111. continue  to  develop  new  products.   If  you find this program
  112. useful  and  find  that  you are using AFORTH and continue to use
  113. AFORTH   after  a  reasonable  trial  period,  you  must  make  a
  114. registration   payment  of  £30.00  to  Stratagem4.   The  £30.00
  115. registration  fee  will  license  one  copy  for  use  on any one
  116. computer at any one time.  You must treat this software just like
  117. a  book.   An  example  is  that this software may be used by any
  118. number  of  people  and  may  be  freely  moved from one computer
  119. location  to  another,  so  long as there is no possibility of it
  120. being  used  at  one  location  while it's being used at another.
  121. Just  as  a  book  cannot be read by two different persons at the
  122. same time.
  123.  
  124. Commercial users of AFORTH must register and pay for their copies
  125. of  AFORTH  within  30  days  of  first  use  or their licence is
  126. withdrawn.   Site  Licence arrangements may be made by contacting
  127. Stratagem4.
  128.  
  129. Anyone  distributing  AFORTH  for any kind of remuneration should
  130. register  with  Stratagem4 at the address below.  Further details
  131. may be found in the file VENDOR.DOC.
  132.  
  133. You are encouraged to pass a copy of AFORTH along to your friends
  134. for  evaluation.  Please encourage them to register their copy if
  135. they  find  that  they  can  use  it.   All registered users will
  136. receive a copy of the latest version of AFORTH.
  137.  
  138. Registration
  139. ~~~~~~~~~~~~
  140. AFORTH  is  a shareware product.  This means that you are free to
  141. use  it for trial purposes only and you may freely pass copies on
  142. to  your  friends  and  colleagues.   However, if you find AFORTH
  143. useful  and  intend  to continue using it, you must register your
  144. copy.   To do this, either print out and fill in the registration
  145. form  provided  (Type  'TYPE  >PRT:   REGISTER.DOC'  from the CLI
  146. prompt  or  use any other preferred method), or write the details
  147. in  a  letter,  enclose  a  cheque  for £30.00 and post it to the
  148. following address:
  149.  
  150.                              AFORTH
  151.                            Stratagem4
  152.                       125 Broadview Avenue
  153.                              Rainham
  154.                            Gillingham
  155.                               Kent
  156.                              ME8 9JD
  157.  
  158. For your money, you will receive the following benefits:
  159.  
  160. 1)  the   latest  registered  version  of  AFORTH,   without  the
  161.     registration encouragement screen;
  162. 2)  access   to   bulletins   detailing   upgrades,   fixes   and
  163.     enhancements,  which may only be available in registered user
  164.     copies;
  165. 3)  access to support from the author;
  166. 4)  upgrades at nominal, or reduced, rates;
  167. 5)  preferential distribution of new product releases.
  168.  
  169. Please  remember  that  if  you  use  this  product then you must
  170. register as a user.
  171.  
  172. Nominal   rates   should  be  interpreted  as  'media  cost  plus
  173. handling'.   Reduced rates should be interpreted as a 'percentage
  174. of the registration fee in force at the time'.  Such charges will
  175. only  be  made  when  a  major  enhancement  or  upgrade has been
  176. undertaken.   You  will of course receive advance notification of
  177. such charges, and are in no way obligated to purchase.
  178.  
  179. Overseas Registrations
  180. ~~~~~~~~~~~~~~~~~~~~~~
  181. For  European  users,  there  is an additional shipping charge of
  182. £2.00 and for other overseas users, the charge is an extra £5.00.
  183. However  for those in the USA or Canada, AFORTH can be registered
  184. for  just  $60.00  (US dollars).  Users in Australia can register
  185. AFORTH for $85.00 (Australian dollars).
  186.  
  187. Support
  188. ~~~~~~~
  189. Support  is  offered  to  registered users in the following ways.
  190. Firstly,  any  updates  of  AFORTH will be available to you for a
  191. nominal,  or reduced, fee.  All registered users will be notified
  192. of  any  major  updates.  Lifetime support for AFORTH is provided
  193. and  can  be  obtained by contacting Stratagem4 in writing at the
  194. address  listed  at the front of this manual, or by telephone, at
  195. any  (reasonable) time, on the number listed at the front of this
  196. manual.
  197.  
  198. The Future
  199. ~~~~~~~~~~
  200. It  is  hard  to  predict the future of AFORTH.  What changes and
  201. enhancements  will  be  made  depends  very  much on you and your
  202. feedback,  which  I  can assure you will be listened to and acted
  203. upon to make AFORTH the product you want it to be.
  204.  
  205. A  number  of  additional  programs are planned, or are currently
  206. under  development,  these will be available, to REGISTERED USERS
  207. only,  as FREE updates on successful completion of the coding and
  208. testing cycle.  These include:
  209.  
  210. 1)  a   complete   68000   (minimum)   assembler   (source   code
  211.     distribution);
  212. 2)  a  stand alone compiler to generate AFORTH programs which run
  213.     in  the  AmigaDOS/WorkBench  environment, without  the AFORTH
  214.     interactive environment;
  215. 3)  fd file to AFORTH converter for distributed libraries;
  216. 4)  a  complete  set  of Commodore library interfaces (subject to
  217.     licencing arrangements).
  218.  
  219.  
  220.  
  221. INSTALLATION AND GETTING STARTED
  222. ================================
  223.  
  224. Installation
  225. ~~~~~~~~~~~~
  226. Installation  is a very straightforward process.  All you need to
  227. do  is  copy AFORTH to any directory you deem fit for the purpose
  228. and it is immediately available for use.
  229.  
  230. Getting Started
  231. ~~~~~~~~~~~~~~~
  232. AFORTH  may  be  run from the CLI or the Workbench.
  233.  
  234. Workbench:  double click on the AFORTH icon.
  235.  
  236. CLI:  CD to the installed directory and type AFORTH<return>.
  237.  
  238. After  both  of these operations you will be placed in the AFORTH
  239. interactive  environment, now would be a good time to consult the
  240. included document UsingAFORTH.doc.
  241.  
  242. Conclusion
  243. ----------
  244.  
  245. So there you have it!  Use and enjoy as you see fit!
  246.  
  247.         //
  248. Thanx \X/ Amiga.
  249.  
  250.  
  251. Copyright © 1994, Stratagem4
  252.  
  253.      /*----------------cut here--------------------------*/
  254.  
  255.  
  256.                U S E R    R E G I S T R A T I O N
  257.                ----------------------------------
  258.  
  259. I  wish to register my copy of AFORTH.  Please send me the latest
  260. registered version for which I enclose full payment.
  261.  
  262. Name    _________________________________________________________
  263.  
  264. Company _________________________________________________________
  265.  
  266. Address _________________________________________________________
  267.  
  268.         _________________________________________________________
  269.  
  270.         _________________________________________________________
  271.  
  272.         _________________________________________________________
  273.  
  274. From Where Did You Obtain AFORTH?  ______________________________
  275.  
  276.    I wish to receive evaluation copies of future releases.
  277.    I do not wish to receive evaluation copies of future releases.
  278.                      (Delete as applicable)
  279.  
  280. The registration price is as follows and may be paid by cheque:
  281.  
  282.     UK:                 £30.00 (Sterling)
  283.     Europe:             £32.00 (Sterling)
  284.     USA & Canada:       $60.00 (US Dollars)
  285.     Australia:          $85.00 (Australian Dollars)
  286.     Rest Of The World:  £35.00 (Sterling)
  287.  
  288. Cheques should be made payable to Stratagem4.
  289.  
  290. Mail cheque to:
  291.  
  292.         AFORTH
  293.         Stratagem4
  294.         125 Broadview Avenue
  295.         Rainham
  296.         Gillingham
  297.         Kent
  298.         ME8 9JD
  299.         UK
  300.  
  301.              Please write for Site Licence details.
  302.