
	 UTREE 3.04-um - A screen oriented filesystem browser
	   @(#) x11/README, klin, Sat May 23 17:19:34 1992

------------------------------------------------------------------------------

This directory contains some files supporting utree running in a xterm window.
Enclosed are 5 utree bdf fonts (bitmap distribution format), which define some
special characters for the scrollbars and some others, an icon bitmap file
utree.xbm, a ressource file Utree.ad and a shell script starting utree in a
xterm window using utree fonts and the mouse. For using the mouse and the
fonts don't forget to set the compile option -DUSEXTERMMOUSE in src/Makefile.

	This works fine with xterm from X11R4 or X11R5 only!

------------------------------------------------------------------------------

Installation of the utree fonts:

      1 Translate the 5 utree bdf font files to the font format used by
	your X server (snf for X11R4 or pcf for X11R5) with the command
	bdftosnf or bdftopcf.

		bdftosnf utxxxx.bdf >utxxxx.snf (X11R4)
			    or
		bdftopcf utxxxx.bdf >utxxxx.pcf (X11R5)

	For further information about bdftosnf or bdftopcf see the manual
	pages for these commands. Maybe that the distributed fonts in snf
	or pcf format are compatible to your X servers font format.

      2 Create a new font directory $XFONTPATH/utree or use an existing
	font directory (e.g. $XFONTPATH/misc) to install the 5 utree fonts.
	Copy the translated utree fonts (snf or pcf) to this font directory.
	Change to this directory and create a table of contents of all font
	files contained in this directory (the file fonts.dir) using the
	command

		mkfontdir

	or add the utree fonts to this file (fonts.dir) by hand (see the
	files fonts.dir.R4 or fonts.dir.R5). Add alias names for the utree
	fonts (see fonts.alias) to the alias file of the font directory.

      3 Test the 5 utree fonts. If you have installed the utree fonts in
	a new font directory (i.e. $XFONTPATH/utree) add this directory
	to your X servers font path using the command

		xset +fp $XFONTPATH/utree

	If you have installed the utree fonts in a directory already enclosed
	in your X servers font path use the command

		xset fp rehash

	to make the new installed utree fonts visible to your X server.
	Check the new fonts using the command

		xfd -fn utree_font_name

	Utree fonts are named like utWxH or utreeWxH. The the file fonts.alias
	for all possible names and sizes.

      4 If you have successfully installed the utree fonts check the shell
	script xtree and edit some variables if needed, i.e. the full path
	of the terminal emulator xterm. Call

		xtree [utree_options]

	to test utree running in a xterm window using utree fonts with some
	special graphic characters and the mouse.

      5 Install the shell script xtree into a public directory containing
	executable file (i.e. /usr/local/bin) and copy the utree icon bitmap
	file utree.xbm to a library directory (i.e. /usr/local/lib) or
	another directory containing bitmaps (i.e. /usr/include/X11/bitmaps).

      6 Add the utree resource file Utree.ad to your ~/.Xdefaults file.
	If you have installed the utree fonts to a font directory not
	enclosed in your X servers default font path (i.e. $XFONTPATH/utree)
	add a line

		xset +fp $XFONTPATH/utree

	to your X startup file (~/.xinitrc or ~/.xsession)

------------------------------------------------------------------------------
