|
@c $Id$ |
|
|
|
|
|
|
|
1 |
@page |
@page |
2 |
@node What is Guile? |
@node What is Guile? |
3 |
@chapter What is Guile? |
@chapter What is Guile? |
850 |
Scheme files can be autoloaded. Thus, we recommend that you define |
Scheme files can be autoloaded. Thus, we recommend that you define |
851 |
your modules in Scheme. |
your modules in Scheme. |
852 |
|
|
853 |
|
|
854 |
|
@page |
855 |
|
@node Obtaining and Installing Guile |
856 |
|
@chapter Obtaining and Installing Guile |
857 |
|
|
858 |
|
Here is the information you will need to get and install Guile and extra |
859 |
|
packages and documentation you might need or find interesting. |
860 |
|
|
861 |
|
@menu |
862 |
|
* The Basic Guile Package:: |
863 |
|
* Packages not shipped with Guile:: |
864 |
|
@end menu |
865 |
|
|
866 |
|
|
867 |
|
@node The Basic Guile Package |
868 |
|
@section The Basic Guile Package |
869 |
|
|
870 |
|
Guile can be obtained from the main GNU archive site |
871 |
|
@url{ftp://prep.ai.mit.edu/pub/gnu} or any of its mirrors. The file |
872 |
|
will be named guile-version.tar.gz. The current version is |
873 |
|
@value{VERSION}, so the file you should grab is: |
874 |
|
|
875 |
|
@url{ftp://prep.ai.mit.edu/pub/gnu/guile-@value{VERSION}.tar.gz} |
876 |
|
|
877 |
|
To unbundle Guile use the instruction |
878 |
|
@example |
879 |
|
zcat guile-@value{VERSION}.tar.gz | tar xvf - |
880 |
|
@end example |
881 |
|
which will create a directory called @file{guile-@value{VERSION}} with |
882 |
|
all the sources. You can look at the file @file{INSTALL} for detailed |
883 |
|
instructions on how to build and install Guile, but you should be able |
884 |
|
to just do |
885 |
|
@example |
886 |
|
cd guile-@value{VERSION} |
887 |
|
./configure |
888 |
|
make install |
889 |
|
@end example |
890 |
|
|
891 |
|
This will install the Guile executable @file{guile}, the Guile library |
892 |
|
@file{libguile.a} and various associated header files and support |
893 |
|
libraries. It will also install the Guile tutorial and reference manual. |
894 |
|
|
895 |
|
@c [[include instructions for getting R5RS]] |
896 |
|
|
897 |
|
Since this manual frequently refers to the Scheme ``standard'', also |
898 |
|
known as R5RS, or the |
899 |
|
@iftex |
900 |
|
``Revised$^5$ Report on the Algorithmic Language Scheme'', |
901 |
|
@end iftex |
902 |
|
@ifinfo |
903 |
|
``Revised^5 Report on the Algorithmic Language Scheme'', |
904 |
|
@end ifinfo |
905 |
|
we have included the report in the Guile distribution; |
906 |
|
@xref{Top, , Introduction, r5rs, Revised(5) Report on the Algorithmic |
907 |
|
Language Scheme}. |
908 |
|
This will also be installed in your info directory. |
909 |
|
|
910 |
|
|
911 |
|
@node Packages not shipped with Guile |
912 |
|
@section Packages not shipped with Guile |
913 |
|
|
914 |
|
We ship the Guile tutorial and reference manual with the Guile |
915 |
|
distribution. Since the Scheme standard (R5RS) is a stable document, we |
916 |
|
ship that too. |
917 |
|
|
918 |
|
Here are references (usually World Wide Web URLs) to some other freely |
919 |
|
redistributable documents and packages which you might find useful if |
920 |
|
you are using Guile. |
921 |
|
|
922 |
|
@table @strong |
923 |
|
@item SCSH |
924 |
|
the Scheme Shell. Gary Houston has ported SCSH to Guile. The relevant |
925 |
|
chapter (@pxref{The Scheme shell (scsh)}) has references to the SCSH web |
926 |
|
page with all its documentation. |
927 |
|
|
928 |
|
@item SLIB |
929 |
|
a portable Scheme library maintained by Aubrey Jaffer. SLIB can be |
930 |
|
obtained by ftp from @url{ftp://prep.ai.mit.edu/pub/gnu/jacal/}. |
931 |
|
|
932 |
|
The SLIB package should be unpacked somewhere in Guile's load path. It |
933 |
|
will typically be unpacked in @file{/usr/local/share/guile/site}, so |
934 |
|
that it will be @file{/usr/local/share/guile/site/slib}. |
935 |
|
|
936 |
|
Guile might have been installed with a different prefix, in which case |
937 |
|
the load path can be checked from inside the interpreter with: |
938 |
|
|
939 |
|
@smalllisp |
940 |
|
guile> %load-path |
941 |
|
("/usr/local/share/guile/site" "/usr/local/share/guile/1.3a" "/usr/local/share/guile" ".") |
942 |
|
@end smalllisp |
943 |
|
|
944 |
|
The relevant chapter (@pxref{SLIB}) has details on how to use SLIB with |
945 |
|
Guile. |
946 |
|
|
947 |
|
@item JACAL |
948 |
|
a symbolic math package by Aubrey Jaffer. The latest version of Jacal |
949 |
|
can be obtained from @url{ftp://prep.ai.mit.edu/pub/gnu/jacal/}, and |
950 |
|
should be unpacked in @file{/usr/local/share/guile/site/slib} so that |
951 |
|
it will be in @file{/usr/local/share/guile/site/slib/jacal}. |
952 |
|
|
953 |
|
The relevant section (@pxref{JACAL}) has details on how to use Jacal. |
954 |
|
@end table |
955 |
|
|
956 |
|
|
957 |
@page |
@page |
958 |
@node Reporting Bugs |
@node Reporting Bugs |
959 |
@chapter Reporting Bugs |
@chapter Reporting Bugs |