Fresh Fish 5/FreshFish_July-August1994.bin/bbs/dev/alst-3.04.lha/ALSt-3.04/install.txt

Text File | 1994-07-08 | 10.9 KB | 331 lines

_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

     The following lists installation instructions for those
systems  to  which  Version  3  of Little Smalltalk has been
ported at present.   Note  that  installation  involves  the
creation of two programs.  The first, called ``initial'', is
run once to create the initial object image (usually a filed
called   ``systemImage'').    The   second  program  is  the
smalltalk interpreter.  To run smalltalk, both  these  files
must  be accessible.  Systems that use the supplied Makefile
run initial automatically; in some  other  systems  you  may
need to do this manually.

     If you receive the distribution on Mac or IBM disks and
you want to run the system under Unix you must ``undo'' some
of the changes described below.

_1._1.  _A_t_a_r_i

     I've been told (no first hand exprience) that the  code
works  on  the  atari.  I've set up a minimal description in
env.h - could somebody tell me if the atari supports  proto-
types, signals, or some of the other features?

     You do have to make the 'rb' changes described for  the
IBM  PC (below), however you keep the rm instruction instead
of DEL, and change the editor to whatever  your  system  has
(memacs?).

_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)

     If at all possible, _U_s_e _t_h_e _G_n_u  _C  _C_o_m_p_i_l_e_r.   I  have
found  the  code  to be much smaller (up to 1/3 smaller) and
much faster (up to twice as fast).  So  far  this  has  been
used on the Sequent Balance system.

     Note that these sources support old  style  prototypes,
as  are  used in Lightspeed C and Turbo C, and not the newer
ANSI prototypes as are used in the gcc compiler.  So do  not
define PROTO when using the gcc compiler

_1._3.  _H_P-_U_X

     Simply say ``make sysvtty'' to make a version with  the
tty  interface.  (As of yet, I don't have access to a system
v system with an X-window interface, so I  can't  test  that
code).

_1._4.  _I_B_M _P_C / _T_u_r_b_o _C _c_o_m_p_i_l_e_r

NNNNooootttteeee:::: If you receive the sources on  51/2  disks  containing
both  source  and  executable,  the  following  changes have
already been made to the system.




                        July 7, 1994





                           - 2 -


     Define the symbol TURBOC at the beginning of  the  file
env.h.

     Edit the file file.st, changing  the  command  used  to
delete  files from rm to del (notice the space following the
del):

                delete
                        ('del ', name) unixCommand

In the file file.st change the mode on the command  to  save
images from w to wb.

                saveImage: name
                        scheduler critical: [
                                " first get rid of our own process "
                                scheduler removeProcess: scheduler currentProcess.
                        File new;
                                name: name;
                                open: 'wb';
                                saveImage;
                                close ]

In a similar manner change the mode on the file open in  the
initialize method in file tty.st to use wb instead of w.

                initialize
                        " initialize the initial object image "
                        self createGlobals.
                        File new;
                                name: 'systemImage';
                                open: 'wb';
                                saveImage;
                                close.

And also in tty.st change the editor from vi to me (or what-
ever your favorite editor happens to be).

                        editor <- 'me'.


     Because of segmentation limits it is  not  possible  to
have  an  object  table  any  larger  than 6500 objects (the
current default).  This value is set by a  define  found  in
memory.h

        # define ObjectTableMax 6500


     Compile in the compact mode (small code, large data).

_1._5.  _M_a_c_i_n_t_o_s_h _L_i_g_h_t_s_p_e_e_d _C

     NOTE: If you get the distribution on 31/4 MAC Disks the



                        July 7, 1994





                           - 3 -


source  code  changes  described below have probably already
been made for you.

     The mac distrubtion disk contains the following.

(a)  A folder called ``C Sources'' that contains (naturally)
     all the C sources.

(b)  A folder called  ``ST  Sources''  that  contains  (also
     naturally)  all the Smalltalk sources, plus an applica-
     tion called ``initial'' that can be used to  create  or
     recreate  the initial object image.  To make changes to
     the image, simply edit the appropriate smalltalk files,
     run  initial,  and move the file ``systemImage'' to the
     appropriate location.

(c)  Two  Lightspeed  C  projects  called  ``TextEdit''  and
     ``Stdwin'',  containing  code taken from Guido van Ros-
     sums Standard Windows package.

(d)  A file called ``systemImage'', which is the  output  of
     the application from part (b)

(e)  An application called ``st'', which  is  the  smalltalk
     interpreter.

(f)  A folder called ``misc''  that  contains  various  dif-
     ferent files, such as documentation and other things.

     It is only necessary to recompile if you  make  changes
to  the  C  source.   If  you  make changes to the Smalltalk
source you only need to rerun the application called  ``ini-
tial'' contained in the ``ST Sources'' folder.

     If you get the sources from some  other  location  (say
off  the  net),  you  must  make  the following alterations.
Change the mode on the file open in  the  saveImage  command
(in  file.st) and in the initalize command (file stdwin.st).
Define the symbol LIGHTC at the beginning of the file  env.h
(See instructions for the IBM PC above for a fuller explana-
tion).

     To compile you need guido van rossums Standard  Windows
package.   Follow  his instructions to create the stdwin and
textedit projects (these are  already  on  the  distribution
disk).  To make the initial program, create a project ``ini-
tialProj'' with segments as follows.  In the  first  segment
place MacTraps.  In the second segment place Stdwin.  In the
third place TextEdit.  In the forth place the  Unix  library
files  math, stdio, storage, strings and unix.  In the fifth
place the sources filein.c, initial.c,  interp.c,  memory.c,
names.c,  news.c, primitives.c, unixio.c and winprims.c.  In
the sixth and final segment place lex.c  and  parser.c.   To
create  the  st  program use the same structure, subsituting



                        July 7, 1994





                           - 4 -


st.c for initial.c.  You must check  the  ``separate  STRS''
option on both projects.

     Make sure when you run the initial object that all  the
smalltalk  sources are in the current directory; it does not
complain if it can't open a file, it simply goes  on.   Also
when  you  fileIn  a  file,  the file must be in the current
directory.

     The Mac version uses the windowing  interface.   It  is
currently  very  fragile.   (A few known bugs; can't restore
from saved image files, output sometimes goes wrong  places,
output often doesn't appear until you click the mouse).

     [ It would be nice if clicking on an image  file  would
start  the  smalltalk  application.  If anybody knows how to
make Lightspeed C do this, let me know.  Thanks ].

_1._6.  _S_e_q_u_e_n_t _B_a_l_a_n_c_e

     Say ``make bsdtty'' to make a tty interface system.

_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

     Say ``make bsdtty'' to make  a  tty  interface  system.
Say  ``make  bsdx11''  to make an x-windows interface system
(still somewhat buggy).

_1._8.  _V_A_X / _V_M_S

     Since VMS doesn't understand Unix Makefiles,  the  dis-
tribution  tape  supplies a command file you can use.  First
define the symbol VMS near the begining of the  file  env.h,
then  execute the command file called vms.com.  This makes a
version using the tty interface.  A VMS  version  using  the
X-windows interface has not been created yet.

_2.  _T_e_s_t _C_a_s_e_s

     One you have a running system;  the  following  can  be
used  to  run  the standard test cases.  First load the file
test.st.  If you are using the  windowing  interface  select
the  fileIn  menu item and the file ``test.st'' (from the ST
Sources folder), if you are using the tty interface use  the
following command

        File new; fileIn: 'test.st'

Then give the command to run all test cases.

        Test new all

Messages will be displayed as test cases are performed,  and
if any test cases fail.



                        July 7, 1994





                           - 5 -


_3.  _T_h_e _S_t_a_n_d_a_r_d _W_i_n_d_o_w _P_a_c_k_a_g_e

     There is an experimental windows style interface  based
on  Guido van rossums standard window package.  This permits
the system to work on top  of  X-windows,  as  well  as  the
macintosh.   Information on standard windows can be obtained
directly from guido at [e-mail], or mcvax!guido,  or
possibly  [e-mail].   His paper mail address is Guido
van Rossum, Center for  Mathematics  and  Computer  Science,
P.O.  Box 4079, 1009 AB Amsterdam, The Netherlands.  Sources
for the standard window package are not included on the Lit-
tle  Smalltalk  distribution,  but they are available public
domain by  ftp  from  DEC  SRC,  machine  gatekeeper.dec.com
(address  [128.45.9.52]).   The  subdirectory is pub/stdwin.
Contact guido for more details.

     To make the projects for the macintosh version,  follow
guidos instructions.  For other versions, make a file stdw.o
by linking together all of guidos sources for your  particu-
lar  system.   Here  is  a makefile for the X11 version, for
example.

#
# X11 version of stdwins
#
x11 = caret.o draw.o font.o menu.o timer.o cutbuffer.o error.o general.o scroll.o window.o dialog.o event.o llevent.o system.o
alfa = bind.o draw.o event.o keymap.o measure.o menu.o scroll.o stdwin.o syswin.o
gen = askfile.o  perror.o
textedit = editwin.o textdbg.o textedit.o textlow.o textbrk.o
tools = endian.o getopt.o glob.o monocase.o strdup.o swap.o
x11files = ${x11} ${gen} ${textedit} ${tools}

stdw.o:  ${x11files}
        ld -r -o stdw.o ${x11files}



     I emphasize this interface is very fragile.

_4.  _P_o_s_s_i_b_l_e _C_h_a_n_g_e_s

     There are a couple of easy changes you may want to make
at  your  site.   The default editor is vi (indicated by the
value of the global variable set in the  routine  createGlo-
bals  in either tty.st or stdwin.st); this can be changed to
any other editor you  like.   The  system  also  prints  the
current  object  count prior to asking for commands from the
user.  This can be eliminated by removing the primitive  <2>
from the method initialize, class Scheduler, file tty.st.








                        July 7, 1994