Brian Ward, bri@blah.math.tu-graz.ac.at, Wed Sun  3 16:35:45 MET 1996

ph is a client for a directory service server called qi. This package is a
tcl/tk client intended to replace xph, the X windows version of the client.

This is tkph 0.95a. The beta version turned out to be better than I thought
it was, so I didn't have to make very many changes. Thanks to my beta
testers, and of course, SCott Dickson, because he's the guy who "provoked"
me to write this thing, anyway.

Some features:
    - list mode ("way cool," as Dave Barr put it)
    - a nice login mode
    - hypertexty(puke)-like help
    - handles server bumps

Please send me (ward@blah.tu-graz.ac.at) comments and fixes.

I'll make updates available at ftp.math.psu.edu:/pub/ward/src.

CONTENTS:
---------
This package should contain:

	README -		this file
	ph-diffs -		some diffs to ph to make it work right
	tkph -			the actual program
	tkph.icon -		a cute tkph icon
	tkph.man -		tkph manual page

INSTALLATION:
-------------

To install, apply the diff to ph.c (where-ever you put it) and recompile ph.

*** NOTE: if you had the beta version, find your original ph.c and patch
    it again or ask me to send you one. There's a bug in the first diff
    that causes passwd changing to bomb (ie, I blew it.).

Put the icon file somewhere and remember where you put it. Then, fix the
first few lines of tkph, otherwise known as "configuration:"

#!/usr/local/bin/wish -f

set iconloc /home/ward/shell/tkph.icon
	
	This is, of course, where you put the icon file (you did
	remember where you put it, right?)

set ph /usr/local/bin/ph

	Where your new patched version of ph is.

set phserver "ural.ethz.ch"
set phserver "ph.psu.edu"

	This is your ph server. The first one is the one that happens
	to be close to me now. The latter is PSU. Make sure the one
	that you use is last...

set field1 "field1"
set field2 "field2"
set field3 "field3"

	Umm, these things can be set to a default for the "alias"
	part of the "alias=foofoo" things.

	That is, these are the defaults for the three entry-boxes that let
	you match by field.

set listField "name"

	This is the field to list on (like, what it prints for an
	entry on each line when you are in list mode). Sometime,
	this will be an option as well as a feature. You shouldn't really
	need to change this.

set pageup "R9"
set pagedown "R15"
	
	Keysyms of the page up and down keys on your system. These
	two work for a Sun. "Prior" and "Next" work for XFree86.

That's the end of the configuration.

