For the Impatient:
---------------------------------

To install KUnit, do

make
su
make install

and run it with

kunit

---------------------------------
This information can also be found as HTML in your
/usr/share/doc/en/HTML/kunit/ directory after you did
"make install", or online under
http://www.netmeister.org/apps/kunit/


The KUnit Handbook

Jan Schaumann jschauma@netmeister.org 
Version 0.5 , Tue May 02 23:00:00 EST 2001


This Handbook describes KUnit Version 0.5


1. Introduction

2. Installation

     2.1 How to obtain KUnit 
     2.2 Requirements 
     2.3 Compilation and installation 

3. Usage 

4. Copyright

5. Misc

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

1. Introduction

KUnit is a simple program to convert various units. 
KUnit currently converts the following categories: 

     acceleration 
     angle 
     angular acceleration 
     angular velocity 
     area 
     bits and bytes
     capacitance
     charge 
     colors
     current
     energy 
     force 
     illuminance 
     inductance 
     length 
     luminance 
     magnetic flux 
     mass (or weight) 
     power 
     pressure 
     Shoe Sizes
     SI prefixes
     specific heat 
     temperature 
     thermal conductivity 
     time 
     torque 
     velocity 
     viscosity (dynamic) 
     viscosity (kinematic) 
     voltage 
     volume 

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

2. Installation

2.1 How to obtain KUnit 

KUnit can be obtained from http://www.netmeister.org/apps/

2.2 Requirements 

In order to successfully compile and use KUnit, you need the following programs
and libraries which are available on most platforms
as distribution packages and thereby can be installed easily. 

Required: 

     g++ 2.7.2/g++ 2.8.1/egcs 1.1 (or compatible), available at http://www.gnu.org 
     GNU make (or compatible), available at http://www.gnu.org 
     perl 5.004, available at http://www.perl.com 
     autoconf 2.12, available at http://www.gnu.org 
     automake 1.2, available at http://www.gnu.org 
     Qt 2.2.x or higher, available at http://www.troll.no 

2.3 Compilation and installation 

In order to compile and install KUnit on your system, type the following in the
base directory of the KUnit distribution: 

     % cd kunit
     % make
	 % su
     % make install

Should you run into problems please report them to the the author at
jschauma@netmeister.org


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

3. Usage 

Straight forward: 

     Run kunit.
     Choose the category for your units. 
     Choose the unit to convert from and the unit to convert to 
     Enter the number to convert into the appropriate text-field 
     Happily read the result from the appropriate text-field 


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

4. Copyright

KUnit Copyright 2000, 2001 Jan Schaumann, jschauma@netmeister.org 

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 (at your
option) 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. 


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

5. Misc

Please take the time to visit these websites:

     http://www.aclu.org
     http://www.amnesty.org
     http://www.worldwildlife.org
     http://www.ncadp.org

Take the time to think about it.

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