From 073fcc996da5fc1c0e715affd1a38ef1fffb2506 Mon Sep 17 00:00:00 2001 From: Jose Antonio Ortega Ruiz Date: Sun, 20 Jun 2010 03:27:25 +0200 Subject: Manual: installation section. --- doc/geiser.texi | 3 +- doc/install.texi | 108 +++++++++++++++++++++++++++++++++++++++++++++++++------ doc/intro.texi | 2 +- doc/quick.texi | 2 ++ 4 files changed, 103 insertions(+), 12 deletions(-) diff --git a/doc/geiser.texi b/doc/geiser.texi index e47450b..eff5c2d 100644 --- a/doc/geiser.texi +++ b/doc/geiser.texi @@ -74,7 +74,8 @@ Installation * Must needs:: * Friends:: -* Getting it:: +* On your marks ...:: +* ... set ...:: Copying This Manual diff --git a/doc/install.texi b/doc/install.texi index 78bc0df..e7d061c 100644 --- a/doc/install.texi +++ b/doc/install.texi @@ -4,23 +4,24 @@ @menu * Must needs:: * Friends:: -* Getting it:: +* On your marks ...:: +* ... set ...:: @end menu @node Must needs, Friends, Installation, Installation @section Must needs If Geiser came with any guarantees, you'd break all of them by not using -GNU Emacs 23 (or better) and at least one of the supported schemes, -which right now are @uref{http://www.racket-lang.org, Racket} 5.0 (or -better) and the latest and greatest -@uref{http://www.gnu.org/software/guile, Guile} 1.9 directly compiled -from a recent checkout of -@uref{http://www.gnu.org/software/guile/repository.html, its git master +GNU Emacs 23 (or better, if there actually @i{is} anything better) and +at least one of the supported schemes, which right now are +@uref{http://www.racket-lang.org, Racket} 5.0 (or better) and the latest +and greatest @uref{http://www.gnu.org/software/guile, Guile} 1.9 +directly compiled from a recent checkout of +@uref{http://www.gnu.org/software/guile/repository.html, its Git @i{master} branch}. Since Geiser supports multiple REPLs, having both of them will just add to the fun. -@node Friends, Getting it, Must needs, Installation +@node Friends, On your marks ..., Must needs, Installation @section Friends Although Geiser does not need them, it plays well with (and is enhanced @@ -38,11 +39,98 @@ of thing: judge by yourself with the help of @uref{http://www.screentoaster.com/watch/stU0lSRERIR1pYRFVdXVlRVFFV/company_mode_for_gnu_emacs, this screencast}. @end itemize +In both cases, you just need to install and setup them as standalone +packages that they are. Geiser will notice their presence and react +accordingly. -@node Getting it, , Friends, Installation -@section Getting it +@node On your marks ..., ... set ..., Friends, Installation +@section On your marks ... +Until version 0.1 is out (which will happen shortly after i finish +writing a decent manual), your best bet is grabbing Geiser from its +Git repository over at @uref{http://git.savannah.gnu.org/cgit/geiser.git/, +Savannah}, either with the following incantation: +@example +git clone git://git.sv.gnu.org/geiser.git + +@end example +@noindent or, if you happen to live under a firewall, with the alternative: +@example + +git clone http://git.sv.gnu.org/r/geiser.git + +@end example +@onindent +If you don't want to install Git, you can instead grab a tarball from +Geiser's @uref{http://gitorious.org/geiser/mainline/commits/master, +Gitorious mirror}, where you'll find a +@uref{http://gitorious.org/geiser/mainline/archive-tarball/master, link} +generating it for you. Either way, you'll now be in possession of a copy +of Geiser's libre code. I'll follow you into its directory and the next +section. + +@node ... set ..., , On your marks ..., Installation +@section ... set ... + +Geiser is ready to be used out of the box without much more ado. For the +sake of concreteness, let's assume you put its source in the directory +@file{~/lisp/geiser}. All you need to do is to add the following +line to your Emacs initialisation file (be it @file{~/.emacs} or any of +its moral equivalents): +@example + +(load-file "~/lisp/geiser/geiser.el") + +@end example +@noindent +or simply evaluate that form inside Emacs (you wouldn't kill a friend +just to start using Geiser, would you?). That's it: you're ready to +@ref{quick-start,,go}. + +What? You still here? I promise the above is all that's needed to start +using Geiser. But, in case you are missing your @t{configure/make all +install} routine, by all means, you can go through those motions to byte +compile and install Geiser too. That is, you enter the source directory +and (since we grabbed the development tree) run the customary +@i{autogen} script: +@example + +$ cd ~/lib/geiser +$ ./autogen.sh + +@end example +@noindent I recommend that you compile Geiser is a separate directory: +@example + +$ mkdir build && cd build +$ ../configure + +$ make all + +$ sudo make install + +@end example +@noindent +With the above spell, Geiser will be compiled and installed in a safe +place inside Emacs load path. To load it into Emacs you'll need, +@i{instead} of the @code{load-file} form above, the following line in +your initialisation file: +@example + +(require 'geiser-install) + +@end example +@noindent +Please note that we're requiring @code{geiser-install}, and @i{not} +@code{geiser}, and that there's no @code{load-file} to be seen this +time. There are some ways of fine-tuning this process, mainly by +providing additional arguments in the call to @t{configure}: you'll find +those gory details in the file called @file{INSTALL}, right at the root +of the source tree. The installation will also take care of placing this +manual, in Info format, where Emacs can find it, so you can continue to +learn about Geiser inside its natural habitat. See you there and into +the next chapter! @c Local Variables: @c mode: texinfo diff --git a/doc/intro.texi b/doc/intro.texi index 50b3826..f610525 100644 --- a/doc/intro.texi +++ b/doc/intro.texi @@ -3,7 +3,7 @@ Geiser is an Emacs environment to hack and have fun in Scheme. If that's enough for you, see @ref{Installation} to get it running and -@ref{Quick start} for the fun. +@ref{Quick start} for the fun part. @menu * Manifesto:: diff --git a/doc/quick.texi b/doc/quick.texi index 0714242..b1c193f 100644 --- a/doc/quick.texi +++ b/doc/quick.texi @@ -1,6 +1,8 @@ @node Quick start, Copying This Manual, Installation, Top @chapter Quick start +@anchor{quick-start} + @c Local Variables: @c mode: texinfo -- cgit v1.2.3