This is version 0.3 of khostchooser, a drop-in replacement for
the ugly "chooser" that is X11--Standard.

khostchooser is derived from X--Consortium Source, so it is under
the X--Consortium License. (see chooser.c).

Installation:
-------------

Just do a "configure && make && make install". In order to configure
khostchooser edit $(KDEDIR)/share/config/khostchooserrc.

Here is an example:

#KDE Config file
[chooser]
HostlistFont=-*-helvetica-medium-r-*-*-*-180-*-*-*-*-*-*
HeaderFont=-*-utopia-bold-r-*-*-*-360-*-*-*-*-*-*
ButtonFont=-*-helvetica-medium-r-*-*-*-180-*-*-*-*-*-*
MessageFont=-*-helvetica-medium-r-*-*-*-140-*-*-*-*-*-*  
HeaderText=KDE Host Chooser
MessageText=This is the optional message text
HeaderLogo=chooserlogo.xpm
Width=480
Height=360
BgColor=Black
GUIStyle=Motif
NamePercent=40     

HostlistFont --> X Font used for the host list 
HeaderFont   --> X Font used for writing the header
ButtonFont   --> X Font used for the "Accept", "Cancel" and "Ping" buttons
MessageFont  --> X Font used for the optional Message String (see MessageText)
HeaderText   --> Header to be displayed (CLIENTNAME substitution
		 does not yet work)
MessageText  --> An optional text that is displayed between the host list
		 and the button row. At my university this text typically reads:
                 "Please do not turn off the terminal when you leave"
HeaderLogo   --> A Pixmap displayed in the upper left corner of
		 khostchooser. -- Make it point to your company's logo ;-) 
		 (If you dont specify a full path starting with a "/",
		 $KDEDIR/share/apps/khostchooser/<HeaderLogo> is assumed 
		 as location).
Width
Height	    --> Width and height (in pixels) of the host chooser
		the default value is 640x480. (The chooser window
		is centered on the screen.)
GUIStyle    --> specify either Motif or Windows as the GUI Style
		to use.
NamePercent --> Percentage of the hostlist width that will be used
		for the host name. Valid range is 10-100

		A bigger value will use more space for the hostname
		(for example "stud1.tuwien.ac.at"), while a smaller
		value will use more space for the comment
		(for example "Willing to manage")

Installation
------------

Furthermore you have to make your system use khostchooser instead of
the standard chooser. I recommend the following procedure:

+) Locate the configuration file "xdm-config" (which is also used by
   kdm, BTW). -- Usually youll find that file in 
    /usr/lib/X11/xdm/xdm-config

+) Search for a line specifying the Display Manager to use. This
   line will usually start with

     DisplayManager*chooser:

+) Change this line to make it point to your khostchooser binary. 
   If KDE is installed in "/usr/local/kde" change this line to:

	DisplayManager*chooser:         /usr/local/kde/bin/khostchooser

+) If you cannot find a "DisplayManager*chooser:" entry in your
   xdm-config file (as for DLD Linux, for example), simply add 
   it to your config file. 

+) Restart xdm (or kdm.. ;-)) 

Alternatively you can of course simply replace the original "chooser"
binary (normally located in "/usr/lib/X11/xdm") with khostchooser.

For general information on how to set up your machine for host
choosing, just have a look a the Tips-HOWTO.


TODO:
+) Make CLIENTNAME substitution work
+) comment the code

     Christian Czezatke
     e9025461@student.tuwien.ac.at


