home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / lisp / stk-3.0-d / stk-3 / STk-3.0-doc / Manual / stk.txt < prev   
Encoding:
Text File  |  1996-01-21  |  8.7 KB  |  265 lines
  1.  
  2.  
  3.  
  4. STk(1)                                                     STk(1)
  5.  
  6.  
  7. _________________________________________________________________
  8.  
  9. NNAAMMEE
  10.        stk, snow - A Scheme interpreter using the Tk toolkit
  11.  
  12. SSYYNNOOPPSSIISS
  13.        ssttkk  [_o_p_t_i_o_n_s] [_a_r_g _a_r_g _._._.]
  14.        ssnnooww [_o_p_t_i_o_n_s] [_a_r_g _a_r_g _._._.]
  15.  
  16. OOPPTTIIOONNSS
  17.        ssttkk interpreter accepts several command-line options which
  18.        may be abbreviated, as long as the abbreviation  is  unam-
  19.        biguous  (e.g.  --hh,  --hhee, --hheell are three possibe abbrevia-
  20.        tions for the --hheellpp option).
  21.  
  22.  
  23.        --ddiissppllaayy _d_i_s_p_l_a_y
  24.                       Display (and screen) on  which  to  display
  25.                       window.
  26.  
  27.        --ffiillee _f_i_l_e_N_a_m_e Read  commands  from  _f_i_l_e_N_a_m_e  rather than
  28.                       standard input.  The last element in  _f_i_l_e_-
  29.                       _N_a_m_e  will  be  used  as  the title for the
  30.                       application and name of its interpreter for
  31.                       sseenndd  commands  (unless  overridden  by the
  32.                       --nnaammee option).
  33.  
  34.        --ggeeoommeettrryy _g_e_o_m_e_t_r_y
  35.                       Initial geometry to use for window.
  36.  
  37.        --nnaammee _n_a_m_e     Use _n_a_m_e as the title to  be  displayed  in
  38.                       the  window,  and as the name of the inter-
  39.                       preter for sseenndd commands.
  40.  
  41.        --ssyynncc          Execute  all   X   server   commands   syn-
  42.                       chronously,  so  that  errors  are reported
  43.                       immediately.   This  will  result  in  much
  44.                       slower  execution,  but  it  is  useful for
  45.                       debugging.
  46.  
  47.        --nnoo--ttkk         Don't initialize the Tk toolkit
  48.  
  49.        --llooaadd _f_i_l_e_N_a_m_e Evaluate expressions contained in  _f_i_l_e_N_a_m_e
  50.                       before  reading  expressions  from standard
  51.                       input.
  52.  
  53.        --iimmaaggee _f_i_l_e_N_a_m_e
  54.                       Restore the state saved in _f_i_l_e_N_a_m_e by  the
  55.                       _d_u_m_p  primitive  (Note: For now, _d_u_m_p works
  56.                       only on SunOS 4.1.x, Linux 1.x (a.out  for-
  57.                       mat) and FreeBSD).
  58.  
  59.        --cceellllss _n_u_m_b_e_r  Set the default size for the heap to _n_u_m_b_e_r
  60.                       cells. The given number is also the  amount
  61.  
  62.  
  63.  
  64. January_1996                   3.0                              1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. STk(1)                                                     STk(1)
  71.  
  72.  
  73.                       of  cells  used  when  extending  the heap.
  74.                       Default value is 20000.
  75.  
  76.        --iinntteerraaccttiivvee   Tell the interpreter that it is used inter-
  77.                       actively (even if it doesn't think so).
  78.  
  79.        --hheellpp          Print a summary of the command-line options
  80.                       and exit.
  81. _________________________________________________________________
  82.  
  83.  
  84. DDEESSCCRRIIPPTTIIOONN
  85.        SSttkk is a Scheme R4RS interpreter which  provide  a  simple
  86.        access to the X11 Tk toolkit. If the --nnoo--ttkk option is pro-
  87.        vided to the interpreter, the Tk library is  not  initial-
  88.        ized  and  no  main  window is created.  If ssttkk is invoked
  89.        with no --ff option then it reads Scheme expressions  inter-
  90.        actively from standard input.  It will continue processing
  91.        commands until all windows have been deleted or until end-
  92.        of-file is reached on standard input.
  93.  
  94.  
  95.        SSnnooww  is a _l_i_g_h_t version of the ssttkk interpreter which does
  96.        not provide support for the Tk toolkit.  This  interpreter
  97.        does  not recognize the options --ddiissppllaayy, --ggeeoommeettrryy, --ssyynncc
  98.        and --nnoo--ttkk which are meaningless without Tk.  This  inter-
  99.        preter  is  called, rather than the standard one, when the
  100.        shell DISPLAY variable is not initialized.
  101.  
  102.  
  103.        If the --ffiillee option is provided  to  Tk,  then  ssttkk  reads
  104.        Scheme  forms  from  the  file  named in the --ffiillee option.
  105.        These forms will normally create an interactive  interface
  106.        consisting  of  one  or more widgets.  When the end of the
  107.        command file is reached, ssttkk will continue to respond to X
  108.        events until all windows have been deleted.
  109.  
  110.  
  111.        The --iinntteerraaccttiivvee option forces the interpreter in interac-
  112.        tive mode. In this  mode,  standard  output  and  standard
  113.        error are unbuffered.  Use this option when you launch ssttkk
  114.        from eemmaaccss.
  115.  
  116.  
  117.  
  118. VVAARRIIAABBLLEESS
  119.        Following Scheme variables are set when SSttkk starts:
  120.  
  121.        **aarrggcc**         Contains a count of the number of _a_r_g argu-
  122.                       ments   (0  if  none),  not  including  the
  123.                       options described above.
  124.  
  125.        **aarrggvv**         Contains a Scheme list whose  elements  are
  126.                       the   _a_r_g   arguments  (not  including  the
  127.  
  128.  
  129.  
  130. January_1996                   3.0                              2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. STk(1)                                                     STk(1)
  137.  
  138.  
  139.                       options described above), in order,  or  an
  140.                       empty list if there are no _a_r_g arguments.
  141.  
  142.        **pprrooggrraamm--nnaammee** Contains  _f_i_l_e_N_a_m_e  if  it  was  specified.
  143.                       Otherwise, contains the name by  which  ssttkk
  144.                       was invoked.
  145.  
  146.  
  147.  
  148. SSCCRRIIPPTT FFIILLEESS
  149.        If you create a STk script in a file whose first line is
  150.  
  151.               ##!!//uussrr//llooccaall//bbiinn//ssttkk --ff
  152.        then  you  can  invoke  the script file directly from your
  153.        shell if you mark it as executable.  This assumes that ssttkk
  154.        has   been   installed   in   the   default   location  in
  155.        /usr/local/bin;  if it's  installed  somewhere  else  then
  156.        you'll have to modify the above line to match.
  157.  
  158.  
  159. EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
  160.        ssttkk uses the following shell variables:
  161.  
  162.        _S_T_K___L_I_B_R_A_R_Y    This  variable  indicates where the library
  163.                       files are located. This variable allows  to
  164.                       overload  the  default  value of the Scheme
  165.                       variable _*_s_t_k_-_l_i_b_r_a_r_y_* which  is  automati-
  166.                       cally  calculated  by the interpreter.(i.e.
  167.                       _s_t_k or _s_n_o_w).
  168.  
  169.        _S_T_K___L_O_A_D___P_A_T_H  This  variable  serves  to  initialize  the
  170.                       _*_l_o_a_d_-_p_a_t_h_*  Scheme variable. This variable
  171.                       is a list of paths to try when  in  a  load
  172.                       command.
  173.  
  174.        _S_T_K___H_E_L_P___P_A_T_H  This  variable  serves  to  initialize  the
  175.                       _*_h_e_l_p_-_p_a_t_h_* Scheme variable. It  must  con-
  176.                       tain  a  list of documentation directories.
  177.                       This variable is used by  the  help  proce-
  178.                       dure.
  179.  
  180.  
  181.  
  182. FFIILLEESS
  183.        _._/_i_n_i_t_._s_t_k
  184.  
  185.        _$_S_T_k___L_I_B_R_A_R_Y_/_S_T_k_/_i_n_i_t_._s_t_k
  186.                       When  ssttkk  starts running, it tries to load
  187.                       the file _i_n_i_t_._s_t_k in the current directory.
  188.                       If  this  file  is not present, it tries to
  189.                       load this file in the SSTTkk__LLIIBBRRAARRYY directory
  190.                       (the  value of SSTTkk__LLIIBBRRAARRYY is automatically
  191.                       computed to be in a  sibling  directory  of
  192.                       the interpreter executable.
  193.  
  194.  
  195.  
  196. January_1996                   3.0                              3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. STk(1)                                                     STk(1)
  203.  
  204.  
  205.        _~_/_._s_t_k_r_c       Standard  _i_n_i_t_._s_t_k  file  tries to load the
  206.                       file _~_/_._s_t_k_r_c. This file  can  be  used  to
  207.                       store  function  definitions  or  variables
  208.                       settings that you want to  be  executed  at
  209.                       each interpretater invocation.
  210.  
  211.  
  212. SSEEEE AALLSSOO
  213.        wish(1)
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. January_1996                   3.0                              4
  263.  
  264.  
  265.