home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / pascal / compiler / surpas / readme.doc < prev    next >
Text File  |  1987-10-06  |  9KB  |  194 lines
  1.  
  2.  
  3.                SURPAS SUPPLEMENTARY DOCUMENTATION
  4.                   for SURPAS-86 V1.00 (MS-DOS)
  5.  
  6.                       Copyright (C) 1987 by
  7.                          Tixaku Pty Ltd        
  8.  
  9.  
  10.  
  11. 1. Distribution and licencing.
  12. ------------------------------
  13.      
  14. This package is NOT Public Domain  nor is it FREEWARE,  although 
  15. its distribution is similar to that of "freeware".
  16.  
  17. The  basic  difference between the license for  SURPAS and that
  18. of software that is freeware is that the use of SURPAS beyond  a
  19. free trial period, is  subject to a low  mandatory usage royalty
  20. payment instead of a voluntary contribution. Unlike most commer-
  21. cial software vendors, we believe that you are entitled to a test
  22. drive with our software. On the other hand,  like many commercial
  23. software vendors, we feel that if you continue using our software
  24. you  should pay us for the  privilege.  The price you  pay should
  25. still be fair, but it should not be free.
  26.  
  27. Use of SURPAS  (or SPAS87)  beyond ten days of  first use  of the
  28. program, the "free trial period", is subject to a mandatory usage
  29. royalty payment of $20.00 (twenty dollars) per  computer  console
  30. (CRT) on which it may be used simultaneously.
  31.  
  32. This usage royalty  payment must be forwarded directly to  Tixaku
  33. Pty. Ltd. at the  address indicated  at the end of this document.
  34. The free trial period is intended to allow you to try the program
  35. before paying for it. If at the end of the free trial period, you
  36. decide you do not want to pay the usage royalty, this may be done
  37. provided all copies of the  program which are or will be  in your
  38. possession are never  used by you again.  Even in this case  they
  39. may be further distributed.
  40.  
  41. Obviously, even though payment is legally mandatory, we are rely-
  42. ing on your honesty, because in most cases,  we do not have  much
  43. capability to enforce it. Remember that your payment will help us
  44. to afford to develop other fine programs that you may also be in-
  45. terested in using.
  46.  
  47. The program SURPAS and its documentation is copyrighted by Tixaku 
  48. Pty. Ltd. We give  restricted permission to make unlimited copies
  49. for your personal use. We also give restricted permission to make
  50. unlimited number of copies of the entire package for distribution
  51. to others. This includes making the package available  for others
  52. to download from non-commercial electronic bulletin boards.
  53.  
  54. Distributed copies of this  package  must not be modified  in any
  55. way,  except for dividing it up into  several  files that must be
  56. made available at the same time,  and all copies must contain all 
  57. the files  included in the list below.
  58.  
  59. No charge  whatsoever,  except for a nominal  copying fee and the
  60. cost of the media  (diskette etc.),  may be demanded or  received
  61. for such distribution.
  62.  
  63.  
  64. 1. Distribution package overview
  65. --------------------------------
  66.  
  67. You will find the following files in your package:
  68.  
  69. README.DOC    The file you are currently reading.
  70.  
  71. SURPAS.COM    This  file is the actual SURPAS Pascal  system.  It 
  72.               contains the editor,  the compiler and the run-time
  73.               package.
  74.  
  75. SURPAS.HLP    The help message file.  This file contains the help 
  76.               messages displayed by the HELP command.
  77.  
  78. SURPAS.ERM    The  error  message file.  This file  contains  the 
  79.               error  messages displayed by the compiler  when  it 
  80.               locates an error.
  81.  
  82. SPAS87.COM    The  8087  version of SURPAS.  If your computer  is 
  83.               equipped with the 8087 chip you will  probably  want
  84.               to use this version of SURPAS instead of the standard
  85.               version,since it offers significant execution speed
  86.               improvements  on  floating  point  operations (from 
  87.               10 to 100 times faster), as well as better precision
  88.               and exponent range  (15 significant digits,  1E-300
  89.               to  1E+300). The  8087  version is fully source code
  90.               compatible with the standard version.
  91.  
  92. INSTALL.COM   The  INSTALL  program.  If you have got  an "uncon-
  93.               figured" copy of SURPAS,  i.e.  a copy which is not 
  94.               set  up for any specific terminal or computer  sys-
  95.               tem,  then before you can use it,  you must install 
  96.               it using this program.  If you try to run an uncon-
  97.               figured copy, you will simply get an error message. 
  98.               The  INSTALL program is fully self-explaining,  but 
  99.               to answer the questions asked by it you will proba-
  100.               bly have to consult your system documentation. Note 
  101.               that  the  8087  version is always  shipped  as  an 
  102.               unconfigured copy,  and thus it cannot be used  be-
  103.               fore  you have installed it.  If you wish,  you may 
  104.               also use the INSTALL program to customize an alrea-
  105.               dy installed copy to suit your individual needs.
  106.  
  107. INSTALL.TRM   Datafiles  used  by INSTALL.  These  files  contain 
  108. INSTALL.DAT   configuration data for up to 50 different terminals 
  109.               and  computers.  Note that INSTALL will not run  if 
  110.               these files are missing.
  111.  
  112. CALC.PAS      Demonstration  program  source text.  This  program 
  113.               acts as a calculator.  It allows you to enter nume-
  114.               ric expressions and have them evaluated.
  115.  
  116. HEXDUMP.PAS   Demonstration  program source  text.  HEXDUMP  will 
  117.               output  a hex listing of any file to any other file 
  118.               or the printer.
  119.  
  120. PRIMES.PAS    Demonstration program source text.  A short program 
  121.               which  computes  all prime numbers  between  1  and 
  122.               30000.
  123.  
  124. QSORT.PAS     Demonstration program source text.  QSORT generates 
  125.               a  list of random numbers and then sorts them using 
  126.               the quicksort algorithm.
  127.  
  128. CROSSREF.PAS  Demonstration program source text. CROSSREF outputs 
  129.               a  listing and a cross-reference map of any  SURPAS 
  130.               source text.
  131.  
  132. MSLIB.PAS     MS-DOS function call support routines. This include 
  133.               file contains a number of subroutines which may  be 
  134.               used to access various MS-DOS functions not direct-
  135.               ly supported by SURPAS.
  136.  
  137. Before  using SURPAS,  we strongly advice that you make a  backup 
  138. copy  of  this disk.  To generate a SURPAS work disk,  copy  SUR-
  139. PAS.COM,  SURPAS.HLP and SURPAS.ERM onto a blank disk along  with 
  140. any  other  system programs you may  require  (e.g.  COMMAND.COM, 
  141. FORMAT.COM  and CHKDSK.COM).  If you are stressed for disk space, 
  142. you may omit SURPAS.HLP and SURPAS.ERM, but then the HELP command 
  143. will not work and the compiler will only output error numbers.
  144.  
  145.  
  146.  
  147. 2. SURPAS-86 V1.00 highlights
  148. -----------------------------
  149.  
  150. SURPAS  V1.00  will automatically detect constants used as  array 
  151. indices  and optimize the code  accordingly.  For  instance,  the 
  152. assignment  "a:=data[b]"  will generate less code if b is a  con-
  153. stant than if b is a variable.  Furthermore,  if b is a  constant 
  154. which  is  out of range,  an out of range error will be  reported 
  155. during compilation, not during execution.
  156.  
  157. When  compiling  to a disk file (PROGRAM  and  OBJECT  commands), 
  158. SURPAS  V1.00  uses all available memory as a code  buffer,  thus 
  159. keeping time consuming disk access at a minimum.  The PROGRAM and 
  160. OBJECT  commands will therefore "feel" much like the COMPILE  and 
  161. RUN commands,  except that the entire program code is dumped into 
  162. the  code file in one go when the compilation is  completed.  For 
  163. large  programs  this will effectively  double  the  compilation 
  164. speed.
  165.  
  166. SURPAS  V1.00  allows programs with overlays to  be  executed  in 
  167. "direct  mode",  i.e.  from  a RUN command.  When a program  with 
  168. overlays is compiled in direct mode,  the name(s) of the  overlay 
  169. file(s)  will  be the current file name with its type changed  to 
  170. 000,  001, etc. If no current file name is established, the names 
  171. will be WORK.000,  WORK.001, etc. The current file name is set by 
  172. the LOAD and NAME commands.
  173.  
  174. The  software floating point routines in SURPAS V1.00  have  been 
  175. optimized  to  use  CPU registers  extensively. 
  176. SURPAS  does its software number crunching faster and with more 
  177. significant digits than all other Pascals.
  178.  
  179.  
  180. 3. Comments and suggestions
  181. ---------------------------
  182.  
  183. If  you have any comments to the SURPAS package and/or its  docu-
  184. mentation,  e.g.  improvements you would like to see, or bugs you 
  185. may have spotted,  please don't hesitate to contact us.  Our  ad-
  186. dress is:
  187.  
  188.     Tixaku Pty Ltd              or phone our BBS on
  189.     P.O. Box 373                2-631-8603 24 hours
  190.     Wentworthville              
  191.     NSW 2145                    (v21, v22, v23 and v22bis)
  192.              
  193.     AUSTRALIA
  194.