This is release 1.1 of xtop, an X based process monitor for Linux derived 
from the top program of the procps package. The adapted sources taken from the
procps package reside in the proc subdirectory.

    Copyright (C) 1998 Achim Bangert

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Xtop provides you with an easily configurable listing of the tasks running on
your system. You can select an arbitrary number of processes and then send 
signals to them or renice them simultaneously. Summary information about the 
CPU and memory usage is displayed in two pie charts.

INSTALLATION:

Xtop makes use of GNU autoconf/automake. You will need current versions of
these programs for compiling and installing xtop. After uncompressing and
unpacking the package change into the xtop-1.1.X directory perform the 
following steps:

1. Type "configure" to let the 'configure' script figure out how your system 
   is set up. See below for the command line options 'configure' supports.
   
2. Type "make" to compile the sources.

To install the binary and the accompanying files you will probably need to be 
root. Type 

3. "make install" to install the binary, the man page, the application 
   default resource and pixmap files.

CONFIGURE COMMAND LINE OPTIONS:

--help
	Run "configure --help" for a complete list of the command line 
	options you can specify. It's probably a good idea to have a look 
	at the autoconf/automake documentation too.

--prefix=PATH
	By default, binary and man page get installed into the 'bin' and 
	'man' subdirectories respectively of the '/usr/local/' directory. 
	You can change this by invoking 'configure' with the 
	"--prefix=PATH" option.

--x-includes=DIR
--x-libraries=DIR
	The 'configure' script sets the installation locations of the 
	resource and pixmap files through the 'x_includes' and 
	'x_libraries' output variables. If dissatisfied with the values 
	determined by `configure' you can either specify them via the 
	command line options `--x-includes=DIR' and `--x-libraries=DIR'
	or edit the 'Makefile.am' and set the corresponding 'xpmdir', 
	'bmdir' and 'addir' variables manually.

--with-XAW3D
--with-NEXTAW
	As of version 1.1.2 xtop (hopefully) works with the Xaw3d and neXtaw 
	widget sets. If the specified library is installed xtop is linked
	against it. In addition 'configure' defines the 'XAW3D' or 'NEXTAW' 
	macro respectively and makes sure the appropriate X resources are
	used.

NOTES:

To make your window manager use the provided pixmap 'xtop.xpm' as program 
icon you will probably have to edit your WM configuration file(s). 
E. g. if you happen to use the fvwm2 insertion of 'Style "xtop" Icon xtop.xpm'
into your '.fvwm2rc' file should do the trick.

Xtop derives much of its functionality from four custom widgets (which you 
are invited to use in your own projects). Unfortunately this means that xtop
will probably need to be adapted for every Xaw replacement separately. Be 
careful if on your system the Xaw library was replaced by a "sonamed"
substitute. Xtop still needs to be compiled with the matching 'configure' 
option; otherwise it may crash. Due to a bug in neXtaw-0.5.1 you have to make 
sure the 'beNiceToColormap' resource is set to 'false'. So if you want to
use the neXtaw widgets please remove any old application default files or add 
the line "Xtop*beNiceToColormap: false" to the resources.

ACKNOWLEDGEMENTS:

I want to thank the following persons for their contributions to xtop:

	Johann Snyman (gaijin@sec.lia.net)
	James Antill (nevyn@return.demon.co.uk)
	Marty Leisner (leisner@sdsp.mc.xerox.com)
	Henning Dekant (quax@frontiernet.net)
        Christoph Lameter <christoph@lameter.com>


Please send any comments, suggestions, bug reports to

abangert@ix.urz.uni-heidelberg.de

