home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / sigm / vols000 / vol053 / volsam.doc < prev    next >
Text File  |  1984-04-29  |  5KB  |  121 lines
  1.     The SAM76 language deals mainly with the manipulation  of
  2. text.  The texts,  however, contain expressions, scripts and
  3. procedures written by the user, and as such can contain both
  4. character    strings  and program instructions.  SAM76 is an
  5. interactive, surprisingly powerful language,  which  appears
  6. to  be  good  for  gaming  and    artificial    intelligence
  7. applications.   Powerful, recursive macros or procedures may
  8. be    constructed.    It  is  a  language  which  encourages
  9. intellectual juggling.  
  10.    It is an esoteric language.  You will need a good  amount
  11. of  intellectual  curiosity  to  go  beyond    the    simple
  12. experiments  you  are apt to make as a result of having this
  13. disk.  When SAM76 was in  its  infancy,  Claude  Kagan,  the
  14. chief  developer,  provided source code to people who wanted
  15. to help in its development.  There  was  a  catch,  however.
  16. You  had  to  pass  a comprehensive test on the  language to
  17. demonstrate that you really understood it.  
  18.    We hope we are  not  undermining  the  character  of  the
  19. language  by  helping  you  see  the  language  work without
  20. subjecting you to the required amount of effort.    However,
  21. let  it  be  known  that  there  are  a  good   number    of
  22. demonstration  routines  included  on  this disk, which have
  23. been provided deliberately without much documentation.   The
  24. developers  purpose  is  to  compell the user to do a lot of
  25. hard work and thereby learn how to understand the use of the
  26. language.  
  27.    First of all, we must explain,  the  changes  which  were
  28. made  to  the  contents  of  the disk in order to reduce the
  29. space requirements, and to provide, thanks to Claude  Kagan,
  30. a  more recent version of SAM76 than was originally provided
  31. some time ago.  The information  provided  in  some  of  the
  32. other  DOC files refers to SAM76.COM as being the only SAM76
  33. file on the CPM Users Group disk.  Actually,  this  file  is
  34. called  S.COM  on  this  disk, so it will conform with other
  35. documentation.  This version, S.COM, will  not  display  the
  36. restart  expression &os,%is//= as explained in the Dr. Dobbs
  37. article. However, you may create a version  to  do  this  by
  38. keying in the following from CPM:  
  39.  
  40. A>ilraw
  41.  
  42. A>cpmsetl
  43.  
  44. &os,%is//=          (You are now in SAM76)
  45.  
  46. Now get the "G" function:
  47.  
  48. %bf,G/=
  49.  
  50. and execute it:
  51.  
  52. %G/=
  53.  
  54. Then type: save 63 s.com  
  55.  
  56. which will get you a copy of SAM customized for your system.
  57.  
  58.    The article in Dr.  Dobbs  Journal,  Volume  3,  Issue  1
  59. (Number 21), will get you going with the language.  Then, if
  60. you like it and want to learn more, buy or borrow a copy  of
  61. the SAM76 manual.  SAM76 is a general purpose language and a
  62. powerful  one, but lets face it, it will not be the language
  63. of choice for a lot  of  people.  If  you  like  to  explore
  64. computer languages, you will enjoy exploring this one.  
  65.    To prove that SAM76 really works, key  in  the  following
  66. and  you  will  generate  1960's  style newspaper headlines,
  67. randomly, ad infinitum, such as HIPPIES SHOUT "MAKE LOVE NOT
  68. WAR".  I'm a little older, and in my day we made both.  
  69.  
  70.   A>s news
  71.  
  72.   ^C or %ex/= will take you back to CPM.
  73.  
  74.    In SAM76 the "=" does the equivalent of "return"  in  CPM
  75. or BASIC.  It  is  preferrable  to  "return" in that you can
  76. imbed  returns  in  the  character strings since "=" must be
  77. used to terminate the text.
  78.    The SAM file, DEMO.SAM, includes routines for  converting
  79. decimal  numbers to Roman Numerals, a routine which develops
  80. the winning moves for the game  HANOI  (see  the  Dr.  Dobbs
  81. article), and a game played in the Dutch language, which not
  82. even the SAM76 Manual explains. You're supposed to figure it
  83. out  yourself.  Try  the  following after you are in  SAM to
  84. convert from decimal to Roman:  
  85.  
  86. %bf,demo/=      (This will bring file called demo.sam)
  87.  
  88. %lt, * /=       (This will list (the names of) texts
  89.                  contained in the file(s) you have brought
  90.                  into the text area)
  91.  
  92. %vt,DTR/=       (This will allow you to view text called DTR)
  93.  
  94. %DTR,1980/=     (This will give you the Roman numeral for 1980)
  95.  
  96.    The rest of the SAM files are there for you to experiment
  97. with. You can view the texts and decipher them by using  the
  98. Dr.  Dobbs article.  Then you may want to write some of your
  99. own. The FNT files are for the graphics applications, as  is
  100. PLOT.ASM.  EXTF.ASM  has the purpose of providing the coding
  101. for a real time clock. The DOC files are for you to type  to
  102. get further documentation.  
  103.    The remaining COM files are  either  explained  in  other
  104. documentation  on  this  disk,  or are utilities that Claude
  105. Kagan has fixed up and  finds  useful  for  himself  and  is
  106. providing  here.  These  are  essentially  previous CPM user
  107. group utilities that have been improved and may be useful to
  108. some members. They are as follows:  
  109.  
  110. COPY.COM  -  A disk copy program. Only 1K and fast. Specify
  111.              System, Data, or All.
  112.  
  113. KSAP.COM  -  Sorts the directory on Drive B.
  114.  
  115. XD.COM    \
  116. XDIR.COM   > Various directory listings. Choose you favorite.
  117. XM.COM    /        
  118.  
  119.  
  120.     ----------------reviewed by Stan Ericson, Rockford, Il.
  121.