home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / dev / alst-3.04.lha / ALSt-3.04 / install.txt < prev    next >
Text File  |  1994-07-07  |  11KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. _1.  _I_n_s_t_a_l_l_a_t_i_o_n _I_n_s_t_r_u_c_t_i_o_n_s
  8.  
  9.      The following lists installation instructions for those
  10. systems  to  which  Version  3  of Little Smalltalk has been
  11. ported at present.   Note  that  installation  involves  the
  12. creation of two programs.  The first, called ``initial'', is
  13. run once to create the initial object image (usually a filed
  14. called   ``systemImage'').    The   second  program  is  the
  15. smalltalk interpreter.  To run smalltalk, both  these  files
  16. must  be accessible.  Systems that use the supplied Makefile
  17. run initial automatically; in some  other  systems  you  may
  18. need to do this manually.
  19.  
  20.      If you receive the distribution on Mac or IBM disks and
  21. you want to run the system under Unix you must ``undo'' some
  22. of the changes described below.
  23.  
  24. _1._1.  _A_t_a_r_i
  25.  
  26.      I've been told (no first hand exprience) that the  code
  27. works  on  the  atari.  I've set up a minimal description in
  28. env.h - could somebody tell me if the atari supports  proto-
  29. types, signals, or some of the other features?
  30.  
  31.      You do have to make the 'rb' changes described for  the
  32. IBM  PC (below), however you keep the rm instruction instead
  33. of DEL, and change the editor to whatever  your  system  has
  34. (memacs?).
  35.  
  36. _1._2.  _G_n_u _C _C_o_m_p_i_l_e_r (_S_e_q_u_e_n_t _B_a_l_a_n_c_e)
  37.  
  38.      If at all possible, _U_s_e _t_h_e _G_n_u  _C  _C_o_m_p_i_l_e_r.   I  have
  39. found  the  code  to be much smaller (up to 1/3 smaller) and
  40. much faster (up to twice as fast).  So  far  this  has  been
  41. used on the Sequent Balance system.
  42.  
  43.      Note that these sources support old  style  prototypes,
  44. as  are  used in Lightspeed C and Turbo C, and not the newer
  45. ANSI prototypes as are used in the gcc compiler.  So do  not
  46. define PROTO when using the gcc compiler
  47.  
  48. _1._3.  _H_P-_U_X
  49.  
  50.      Simply say ``make sysvtty'' to make a version with  the
  51. tty  interface.  (As of yet, I don't have access to a system
  52. v system with an X-window interface, so I  can't  test  that
  53. code).
  54.  
  55. _1._4.  _I_B_M _P_C / _T_u_r_b_o _C _c_o_m_p_i_l_e_r
  56.  
  57. NNNNooootttteeee:::: If you receive the sources on  51/2  disks  containing
  58. both  source  and  executable,  the  following  changes have
  59. already been made to the system.
  60.  
  61.  
  62.  
  63.  
  64.                         July 7, 1994
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                            - 2 -
  71.  
  72.  
  73.      Define the symbol TURBOC at the beginning of  the  file
  74. env.h.
  75.  
  76.      Edit the file file.st, changing  the  command  used  to
  77. delete  files from rm to del (notice the space following the
  78. del):
  79.  
  80.                 delete
  81.                         ('del ', name) unixCommand
  82.  
  83. In the file file.st change the mode on the command  to  save
  84. images from w to wb.
  85.  
  86.                 saveImage: name
  87.                         scheduler critical: [
  88.                                 " first get rid of our own process "
  89.                                 scheduler removeProcess: scheduler currentProcess.
  90.                         File new;
  91.                                 name: name;
  92.                                 open: 'wb';
  93.                                 saveImage;
  94.                                 close ]
  95.  
  96. In a similar manner change the mode on the file open in  the
  97. initialize method in file tty.st to use wb instead of w.
  98.  
  99.                 initialize
  100.                         " initialize the initial object image "
  101.                         self createGlobals.
  102.                         File new;
  103.                                 name: 'systemImage';
  104.                                 open: 'wb';
  105.                                 saveImage;
  106.                                 close.
  107.  
  108. And also in tty.st change the editor from vi to me (or what-
  109. ever your favorite editor happens to be).
  110.  
  111.                         editor <- 'me'.
  112.  
  113.  
  114.      Because of segmentation limits it is  not  possible  to
  115. have  an  object  table  any  larger  than 6500 objects (the
  116. current default).  This value is set by a  define  found  in
  117. memory.h
  118.  
  119.         # define ObjectTableMax 6500
  120.  
  121.  
  122.      Compile in the compact mode (small code, large data).
  123.  
  124. _1._5.  _M_a_c_i_n_t_o_s_h _L_i_g_h_t_s_p_e_e_d _C
  125.  
  126.      NOTE: If you get the distribution on 31/4 MAC Disks the
  127.  
  128.  
  129.  
  130.                         July 7, 1994
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                            - 3 -
  137.  
  138.  
  139. source  code  changes  described below have probably already
  140. been made for you.
  141.  
  142.      The mac distrubtion disk contains the following.
  143.  
  144. (a)  A folder called ``C Sources'' that contains (naturally)
  145.      all the C sources.
  146.  
  147. (b)  A folder called  ``ST  Sources''  that  contains  (also
  148.      naturally)  all the Smalltalk sources, plus an applica-
  149.      tion called ``initial'' that can be used to  create  or
  150.      recreate  the initial object image.  To make changes to
  151.      the image, simply edit the appropriate smalltalk files,
  152.      run  initial,  and move the file ``systemImage'' to the
  153.      appropriate location.
  154.  
  155. (c)  Two  Lightspeed  C  projects  called  ``TextEdit''  and
  156.      ``Stdwin'',  containing  code taken from Guido van Ros-
  157.      sums Standard Windows package.
  158.  
  159. (d)  A file called ``systemImage'', which is the  output  of
  160.      the application from part (b)
  161.  
  162. (e)  An application called ``st'', which  is  the  smalltalk
  163.      interpreter.
  164.  
  165. (f)  A folder called ``misc''  that  contains  various  dif-
  166.      ferent files, such as documentation and other things.
  167.  
  168.      It is only necessary to recompile if you  make  changes
  169. to  the  C  source.   If  you  make changes to the Smalltalk
  170. source you only need to rerun the application called  ``ini-
  171. tial'' contained in the ``ST Sources'' folder.
  172.  
  173.      If you get the sources from some  other  location  (say
  174. off  the  net),  you  must  make  the following alterations.
  175. Change the mode on the file open in  the  saveImage  command
  176. (in  file.st) and in the initalize command (file stdwin.st).
  177. Define the symbol LIGHTC at the beginning of the file  env.h
  178. (See instructions for the IBM PC above for a fuller explana-
  179. tion).
  180.  
  181.      To compile you need guido van rossums Standard  Windows
  182. package.   Follow  his instructions to create the stdwin and
  183. textedit projects (these are  already  on  the  distribution
  184. disk).  To make the initial program, create a project ``ini-
  185. tialProj'' with segments as follows.  In the  first  segment
  186. place MacTraps.  In the second segment place Stdwin.  In the
  187. third place TextEdit.  In the forth place the  Unix  library
  188. files  math, stdio, storage, strings and unix.  In the fifth
  189. place the sources filein.c, initial.c,  interp.c,  memory.c,
  190. names.c,  news.c, primitives.c, unixio.c and winprims.c.  In
  191. the sixth and final segment place lex.c  and  parser.c.   To
  192. create  the  st  program use the same structure, subsituting
  193.  
  194.  
  195.  
  196.                         July 7, 1994
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                            - 4 -
  203.  
  204.  
  205. st.c for initial.c.  You must check  the  ``separate  STRS''
  206. option on both projects.
  207.  
  208.      Make sure when you run the initial object that all  the
  209. smalltalk  sources are in the current directory; it does not
  210. complain if it can't open a file, it simply goes  on.   Also
  211. when  you  fileIn  a  file,  the file must be in the current
  212. directory.
  213.  
  214.      The Mac version uses the windowing  interface.   It  is
  215. currently  very  fragile.   (A few known bugs; can't restore
  216. from saved image files, output sometimes goes wrong  places,
  217. output often doesn't appear until you click the mouse).
  218.  
  219.      [ It would be nice if clicking on an image  file  would
  220. start  the  smalltalk  application.  If anybody knows how to
  221. make Lightspeed C do this, let me know.  Thanks ].
  222.  
  223. _1._6.  _S_e_q_u_e_n_t _B_a_l_a_n_c_e
  224.  
  225.      Say ``make bsdtty'' to make a tty interface system.
  226.  
  227. _1._7.  _T_e_k_T_r_o_n_i_x _4_3_1_5, _G_r_e_e_n _H_i_l_l_s _C _C_o_m_p_i_l_e_r
  228.  
  229.      Say ``make bsdtty'' to make  a  tty  interface  system.
  230. Say  ``make  bsdx11''  to make an x-windows interface system
  231. (still somewhat buggy).
  232.  
  233. _1._8.  _V_A_X / _V_M_S
  234.  
  235.      Since VMS doesn't understand Unix Makefiles,  the  dis-
  236. tribution  tape  supplies a command file you can use.  First
  237. define the symbol VMS near the begining of the  file  env.h,
  238. then  execute the command file called