INSTALLATION INSTRUCTIONS


This file contains brief installation instructions
for the packages which are needed to compile the 
file ambleside.tex into a PDF presentation on a UNIX
system. 

SHORT INSTRUCTIONS

First, you must dowload the file amble.tar.gz and place
it into a temporary directory. Change into this directory
and type at the unix prompt

tar xvfz amble.tar.gz

This will extract all the source files into the current
directory. To compile the source file ambleside.tex into
a viewable PDF file, use the script provided, typing

./compile ambleside

If everything went allright, you will have two PDF files
called ambleside.pdf and ambleside2.pdf, which you can view 
using the command

acroread ambleside2.pdf

Typing Ctrl-L switches to and from full screen mode.
If something went wrong, you may need to install some 
extra programs, so read the longer instructions.


LONG INSTRUCTIONS

The file ambleside.tex is a latex document which needs
to be compiled via pdflatex. It will _not_ compile 
with latex alone. To produce the output file, run 
the command:

(1)	pdflatex ambleside.tex

Note that 

	(a) your latex installation requires the program 
	pdflatex to exist. If you get the error "command not
	found" then your installation might not include this
	program. Go first to 

	http://www.ctan.org/tex-archive/systems/pdftex/

	where you will find the latest version of pdf(la)tex
	and some installation instructions.  

	(b) the package pdfscreen is required to successfully
	compile the file ambleside.tex; you may download this
	at the web site

	http://www.ctan.org/tex-archive/macros/latex/contrib/supported/pdfscreen/


The command (1) should produce a file called ambleside.pdf
which you can view onscreen using the command

(2)	acroread ambleside.pdf

If you get an error when executing (2) you might not have
the Adobe Acrobat reader installed. You can download
this free program (with installation instructions) at:

http://www.adobe.com/products/acrobat/readermain.html

Once you have the output file ambleside.pdf, you are halfway
there. Notice that some pages when viewed include a little
orange square, which represents a pause in the presentation.
In the latex file ambleside.tex, this is represented by the 
macro \pause. To turn the square into an actual pause in the
presentation, we need to postprocess the ambleside.pdf file,
obtaining a new file called say ambleside2.pdf; this requires
the Java program PPower4 which can be found in the 
directory PPower4. The actual homepage and further instructions
are to be found at:

http://www.ctan.org/tex-archive/support/ppower4/

You will also need Java 1.2 or above to run this program. 
Download the latest version of Java at:

http://java.sun.com/

Finally, the file ambleside2.pdf can be viewed onscreen using the 
command

	acroread ambleside2.pdf

If you press Ctrl+L while inside acrobat reader, you can see the
presentation in full screen mode...