[For information on changes, see the file CHANGES]

Xph 2.3, beta release.

Xph -- an X-windows interface to the CSO Nameserver.


INTRODUCTION
Xph is similar to the CSO nameserver client program ph, except that
xph uses the X-windows system as a user interface.  It is similar in
style to the Mac Ph client, from which I blatantly stole many of my
ideas.


BUILDING AND INSTALLING XPH
Xph requires the XPM (X Pixmap) library, version 3.  If you do not have this
library, you'll find the source in libxpm.  See the README file there
for instructions on building and/or installing the library.  If you
can make the library to be shared, I would suggest doing so.  Once
you've got an XPM library ready, edit the Imakefile (for xph) and edit
the XMPLIB variable to reflect the location of the XPM library.

Now we can build xph.  If you have Imake, the related config files, and
xmkmf installed, great.  All you should have to do is:
	1) xmkmf
	2) make depend
	3) make
	4) make install
	5) make install.man
You may wish to make sure the install targets are doing what you'd like.
You can check their behavior, of course, with "make -n install" and
"make -n install.man".  I only mention this because I've seen many
sites with busted Imake configurations.  Caveat emptor.

If you don't have the Imake goodies, then copy Makefile.noimake to Makefile
and edit it.  Make sure the XPMLIB, CC, and install-related variables are
correct.  Once you've finished editing, you should:
	1) make
	2) make install
	3) make install.man
See the discussion above on the install targets.


AMINISTRATION NOTES
Xph provides a popup menu listing of all of the known sites running the Ph
server system.  This information is obtained from the default server.  In
addition, xph expects help text for the Help menu from the server as well.
These and other dependencies on the Ph server are discussed in the document
ADMIN_NOTES.  Please read this file.


BUG REPORTS
This is my first X program.  So if you're an X guru, keep that in mind.
The code is fairly organized right now, but I'm still cleaning things up
and incorporating more efficient X idioms as I learn them.  Your comments
on style, functionality, and of course bug reports, will be very useful.
However, there are portions of the code that are structured to aid in
more develeopment, as again, this is a beta-version.  So, please don't
flame me on problems related to the current development structure.
Essentially, I'm working on this program in my spare time.  See the file
TODO for a list of planned enhancements.

Enjoy.
--
Bradley C. Spatz                                        Internet:  bcs@ufl.edu
Computer and Information Sciences                    UUCP:  uunet!uflorida!bcs
College of Engineering
University of Florida                  "School IS Hell." -- Matt Groening
