Links - how to install
----------------------

Follow this step-by-step:
0) Check you have installed the following libraries.
   libpng - required
   IJG libjpeg - if you want to display JPEG's (probably yes)
   TIFF Library - if you want TIFFs
   SVGAlib - if you want Links to be able to display on SVGAlib
1) Do not forget to run "ldconfig" if you have installed some new libraries :-)
2) "./configure --help"
   Read the output and choose which options you want to give ./configure.
   Probably you will want --enable-graphics and --enable-javascript and some
   more
3) "./configure <your options>"
4) Check the output of ./configure (in the table at the end) whether you really
   get what you want
5) "make"
6) If you are a root, "make install" with root privileges. If not, copy the 
   resulting "links" executable into some suitable place, preferrably within 
   your $PATH. The whole browser is just one executable.
7) If you haven't got a permanent Internet connection, save the "doc/"
   subdirectory into some suitable place (/usr/share/, /usr/local/share). The
   most important part of the "doc/" subdirectory is a calibration pattern
   you will need to get a flawless picture on your monitor.
8) Delete the archive and source directory - no more needed
9) The browser is ready now. You just have to calibrate it to get a flawless
   picture (see doc/calibration.html or the Links homepage, which is in default
   bookmarks).

PITFALLS
--------

Compile:

Unix - use ./configure; make
	in some FreeBSD 3 distributions you have to set CFLAGS=-aout before
	running ./configure.
	Tested on Linux, FreeBSD, Solaris, IRIX
	If counfigure fails, you can try generic makefile: make -f Makefile.gen

OS/2 - you can use ./configure. If it fails or if you don't have bash, use
	make -f Makefile.gen
	The only supported compiler is EMX, you probably won't be able to
	compile it with anything else

	configure under OS/2 needs to know paths to gcc, make anb bash. Set (for
	example):
	SET HOSTTYPE=i586
	SET MACHTYPE=i586-pc-os2
	SET CONFIG_SHELL=d:/prg/gnu/bin/bash.exe
	SET CC=d:/prg/emx/bin/gcc.exe
	SET MAKE=d:/prg/emx/bin/make.exe
	SET EMXOPT=-h100

Dos, Windows - port it yourself

Install:

Unix - make install

OS/2 - copy file links.exe somewhere to your path or create CMD file that runs
	links

WARNING: EMX has nasty limit of open files. Links will work badly or won't work
	with default settings. Set variable EMXOPT=-h100 before you run links.

vim: textwidth=80
