README for Ldapper 1.2

PREREQUISITES

Ldapper relies on Ldap-pkg (http://www.aston.ac.uk/~oweng/ldap/) to provide
LDAP functionality.


INSTALLING

	System wide

	  In the directory you found this , execute (as root) the command
	  
		wish -f install.system

	  change the paths to taste. Hit the install button.

	  Assuming you accepted the defaults you should now have

		/usr/local/bin/ldapper  - the application
		/usr/local/lib/ldapper  - a directory containing

				config - default configuration file
				Ldapper.ad - example X resources file
				iso3166.tcl - proc to set up country array
				ldapper-lib.tcl - procs for invoking exmh &
						  netscape
				tclIndex  - so wish can find the above two

	  For customisation docs read config.

	Personal

	  In the directory you found this , execute the command
	  
		wish -f install.personal

	  change the paths to taste. Hit the install button.

	  Assuming you accepted the defaults you should now have
	  
		~/bin/ldapper  -  the application
		~/.ldapper     -  the config file
		~/.tk/ldapper  -  a directory containing

				config - default configuration file
				Ldapper.ad - example X resources file
				iso3166.tcl - proc to set up country array
				ldapper-lib.tcl - procs for invoking exmh &
						  netscape
				tclIndex  - so wish can find the above two

	  For customisation docs read config.

Invoking from Exmh

  To add it to the Address... menu you need to edit ~/.exmh-defaults 
  and add ldap to the entrylist -

           *Main.addr.m.entrylist: alias addr ldap

  then add the lines (label text and procedure to call respectively)

           *Main.addr.m.l_ldap: Ldap
           *Main.addr.m.c_ldap: InvokeLdapper
      

  And in ~/.tk/exmh/ put the following in a file  

           proc InvokeLdapper {} {
               if {[lsearch [winfo interps] ldapper]==-1} {
                      exec /usr/local/bin/ldapper &
               } else {
                      send ldapper wm deiconify .
               }
           }
      

  Don't forget to do a 

           % auto_mkindex . *.tcl
    

  or similar in ~/.tk/exmh .


Gareth Owen <oweng@aston.ac.uk>
