	    README for Xarchie - X11 browser interface to Archie

		George Ferguson, ferguson@cs.rochester.edu

			 Last Change: 28 Aug 1991

DISCLAIMER:

     This is release 1.1.

     This software is provided as is with no warranty expressed or
     implied. I hope you find it useful, but I won't be held responsible
     for any damage that may occur from reading, compiling, installing,
     using, or even thinking about it.

     You are free to use any parts of the code that I wrote for other
     purposes. It would be nice if you could keep my name on some part of
     whatever the final product is. Parts of the code that are derived from
     the Prospero archie client are subject to their own copyright, which
     is included in aquery.c and other files that were not written by me.
     See the file "copyright.h" for details. Examples of other things
     Prospero can do are in the file "README.PROSP" in this distribution.

     The original standalone archie client was written by Brendan Kehoe,
     (brendan@cs.widener.edu), based on the Prospero archie client by
     Clifford Neuman, (bcn@isi.edu). The file "README.FILES" describes
     the files that are shared with these clients. The archie service was
     conceived of and implemented by Alan Emtage (bajan@cs.mcgill.ca) and
     Peter Deutsch (peterd@expresso.cc.mcgill.ca).

INSTALLATION:

     1. Edit the Imakefile to reflect any changes for your site. These
	include setting BINDIR, LIBDIR, and MANDIR if needed, and
	checking CDEBUGFLAGS if debugging or optimization is desired.

	[from Brendan Kehoe (brendan@cs.widener.edu)]
	If your default C compiler is gcc, dirsend.c shouldn't be compiled
	with Gnu C.  Until gcc 2.0, structure passing is completely hosed
	on Suns -- and the inet_ntoa() calls in dirsend will seg fault.
	There is a suitable target that you can uncomment if you are
	using gcc.

	Compiling this program requires the "ad2c" program. You should
	have received a copy of ad2c with this distribution, in the
	subdirectory "Ad2c". You should	set the AD2C variable as
	required. Actually, ad2c is only required if you change	Xarchie.ad
	and want the new defaults compiled in as fallback resources. If
	you don't have ad2c, you probably want to remove the line that
	adds Xarchie.ad.h to the "clean" target.

        You may want to change defaults in Xarchie.ad; consult the man page
	for details, and see above about ad2c.

     2. Execute
		% xmkmf
	to create the Makefile.

     3. Execute
		% make Makefiles
	to run xmkmf in the Ad2c and EzMenu subdirectories. Alternately,
	run it (or imake) in each subdirectory by hand.

     4. Execute
		% make depend
	to add the dependencies to the Makefile. This is necessary to
	ensure that Xarchie.ad.h is created when needed.
	IMPORTANT: Ignore the error message from makedepend if Xarchie.ad.h
		   is not found; it will be created automatically.

     4. Make the package using
		% make
	or install it directly with
		% make install install.man
	Note that this will also "make install" in Ad2c and EzMenu by
	default. Since you may want to install xarchie without installing
	these other things, you can instead do
		% make install.xarchie
	to install xarchie, its resource file, and its man page only.

HISTORY:
     Version 1.1 - 28 Aug 1991
	Released to comp.sources.x.
