1Before installation
2-------------------
3
4To install qscheme you need the following packages:
5
6	* libgmp-2.0.2
7	* pcre-3.1
8	* ffcall-1.5
9
10If your system does not contain already this packages, please install
11them before trying to install qscheme. Don't panic. Installation is
12rather simple, just unpack and make and make install. For example:
13
14	tar xvzf libgmp-2.0.2.tar.gz
15	cd libgmp-2.0.2
16	./configure && make && make install
17
18
19Compiling QScheme
20-----------------
21
22* extract the source package: (if you read this document, you have
23alredy complete this stage)
24
25	tar xvzf qscheme-*.tgz
26
27* goto the source directory
28
29	cd qscheme-*
30
31* configure and compile
32
33	./configure && make
34
35You should see some warnings during compilation of sgtk, don't care
36too much about them.
37
38Testing QScheme
39---------------
40
41After that, you should be able to run your first test:
42
43	time qscheme < wloop.scm
44
45And compare it to a perl loop:
46
47	time perl -e 'for ($i=0; $i<3000000; $i++) {}'
48
49It should typically be more than 2.5 times faster than perl.
50
51Testing the sgtk extension
52--------------------------
53
54Sgtk is a specialized QScheme interpreter containing most of the
55binding to the gtk library. This extension is not absolutely tested,
56you may have some surprises. Anyway, you should be able to run the
57following:
58
59	cd sgtk
60	sgtk -i hello.scm
61	(hello)
62
63This will open a dialog with 3 buttons, an entry area and a draw
64area. The draw area capture the mouse movements, the entry field runs
65the qscheme evaluator. Try to type (print "Hello world") in it and
66observe what is displayed in your terminal.
67
68If you have libglade (>= 0.12) installed on your system, you should
69also be able to try the following:
70
71	make sglade.so
72	sgtk -i sconsole.scm
73	(start)
74
75Entry in the sconsole window are interpreted when you type ctrl-return.
76
77You may also try to use the mulithreading: simply try this:
78
79	sgtk -i sconsole.scm
80	(thread start)
81
82Have fun.
83
84
85
86