Quick install
=============

[WARNING!  This part only applies if you have a full distribution.]
[If you don't, there's no LINK.COM to run.  In such a case, you must]
[read "Slow install" instead]

To do this quick install, it is required that you have NETLIB.  You
can check if it's already installed by checking for the logical name
NETLIB_SHRXFR.  If yuo don't have it installed, please download
NETLIB022.ZIP from ftp://ftp.wku.edu/vms/fileserv/ or a mirror, unpack 
and install (it is done with SYS$UPDATE:VMSINSTAL.COM).

Now, all you have to do is the following:

	$ @LINK

That will give you FISH.EXE, which you either let stay put or move
to a place of your preference, and then all you need to do is to
make a foreign command of it:

	$ FISH :== $dev:[dir]FISH.EXE

Replace "dev" and "dir" with appropriate values.  That line should
also be inserted in SYS$MANAGER:SYLOGIN.COM if you intend to make
FISH available to everyone.

Also, you will find a FISH.HLP, that you can insert in the help
library of your choice.



Slow install
============

The libraries that come with this package have been put together on
VMS 6.2 and 7.1 for VAX and VMS 7.1 for AXP.  You *may* run into
problems due to differences between VMS versions.  In that case, a
recompile is in place.

To recompile, you need the following things:

	- DEC C (or VAX C if you really have to.  See below)
	- DEC MMS or MadGoat's MMK (a MMS clone).  I use MMK in my examples.
	- OpenSSL 0.9.3 or later
	- NETLIB

You will find the necessary things at the following places:

	NETLIB, MMK		ftp://ftp.wku.edu/vms/fileserv/ and mirrors
	OpenSSL 0.9.3a		ftp://ftp.lp.se/vms/OpenSSL-0_9_3a.tar-gz
	RSAREF (US only!)	ftp://ftp.rsa.com/rsaref/README

The compilation is done like this:

	$! dev:[dir] is the directory where you have put this package
	$ SET DEFAULT dev:[dir.SRC]

	$! If you have have OpenSSL installed so the libraries are in
	$! SSLLIB: and the header files are in SSLINCLUDE:, then all
	$! you need is this.
	$ MMK

	$! Otherwise, you want to change SSLINCLUDEDIR and SSLLIBDIR
	$! in DESCRIP.MMS or, like I do, give a different value for those.
	$ MMK/MACRO=(SSLINCLUDEDIR=SSLROOT:[INCLUDE],SSLLIBDIR=SSLLIB:)

	$! Also, if your crypto library has another name than mine
	$! (LIBCRYPTO.OLB), you can change it the same way.
	$ MMK/MACRO=(SSLLIBRARYNAME="CRYPTO-VAX-VAXC.OLB")

You may get a bunch of warnings from the linker, but that's usually
nothing to worry about.

The end result is that in dev:[dir] (the FISH distribution directory),
you should find a FISH.EXE and a FISH.HLP that can be installed according
to the quick install above.


What if I really have to compile with VAX C?
============================================

[WARNING!  I have not tried compiling this version of FISH with VAX C.]
[You're on your own!]

It's not recommended, since VAX C is pretty damn old these days.  But
it does work.  What you do is the following:

	$ MMK/MAC=(CC="CC/VAXC/DEBUG",LDFLAGS=",VAXCRTL.OPT/OPT") -
	_$ VAXCRTL.OPT,ALL

And if you don't have OpenSSL installed as desribed above, you will
need to add those MMS/MMK macros as well.

-- 
/Richard Levitte <richard@levitte.org>
