INSTALL

   1
   2 ------ Shell Lineal ----------------------------------------------------
   3
   4 > ./run.sh -l sbcl -m shell
   5
   6 This is the default, so you can instead do:
   7 > ./run.sh
   8
   9 If you don't fancy the run script, boot up a lisp and
  10 > (load "src/shell/devvars")
  11
  12 Type 'exit' or 'quit' to get out of Lineal's REPL
  13
  14 CLISP, CMUCL, ECL and SBCL are known to work with the shell version.
  15
  16
  17        THE REST OF THIS FILE IS SPECIFIC TO THE WEB INTERFACE
  18
  19 ------ Required Libraries ----------------------------------------------
  20
  21 Hunchentoot - http://www.cliki.net/hunchentoot
  22 CL-WHO - http://www.cliki.net/CL-WHO
  23 ParenScript - http://www.cliki.net/Parenscript
  24
  25 ------ Tested Lisps ----------------------------------------------------
  26
  27 SBCL, others *should* work though.
  28
  29 ------ Steps to Run ----------------------------------------------------
  30
  31 Use the invocation script
  32 > ./run.sh -l sbcl -m webui
  33
  34 or boot up a lisp and
  35 > (load "src/webui/devvars.lisp")
  36
  37
  38 If all the libraries are installed correctly,
  39 this should signal no errors or warnings.
  40 If something goes wrong here, let me know.
  41
  42 For the web interface,
  43 Go to localhost:41938 in a web browser.
  44 Port 41938 was chosen to stand for 'AlgEB'ra
  45
  46 There are surely lots of bugs and security issues
  47 hosted on your system, congratulations on your new Lineal!
  48
  49 ------ Security Issues -------------------------------------------------
  50
  51 Though Lineal checks input, it's probable that someone
  52 can take over the running lisp. If you find a way to
  53 execute unwanted code, tell me about it.
  54
  55 You should sandbox your lisp if there's any risk factors.
  56 Common sense.
  57
  58 The save/restore feature is no longer more hazardous than
  59 the regular calculator, but the option to disable it
  60 still exists. You can do this by uncommenting the line
  61 where 'no-save-restore is set in "src/webui/config.lisp".
  62
  63 -----------------------------------------------------------------------
  64  vim:ft=:expandtab:tw=72: