Readme for KAPM 0.11
====================

NOTE: I recently realized there is already another "kapm". Oops. Anyway, my
completely unbiased opinion is that mine is better :). Hopefully we can merge
our two projects sometime.

Introduction
------------
 KAPM is a docking APM utility for KDE. Its powered by a modified version of
apmlib.c from the apmd distribution.

Requirements
------------
- A Linux 2.2 kernel with APM support compiled in.
- KDE libraries, with KWM and Kpanel running
- APM BIOS 1.1+, 32-bit support (kapm will nag if it doesn't have what it needs)
- APMD running (recommended)

Usage
-----
 When you start up KAPM, an icon will appear on the tray depicting the remaining
battery life. If the system doesn't have a battery, a question mark will appear
instead. If you battery is currently charging, a fairly obvious animation will
be displayed

  Holding your cursor over this icon will display a tool-tip with basic
APM status information. Right clicking on this icon will display a context menu
with some APM functions. A left click will immediately update the status icon
and tool-tip, which normally happens every 60 seconds. And if you are bestowed
with the privilege of a middle mouse button, it will display a detailed APM
status window when you click the icon (this is normally available through "APM
Status..." in the menu).


Mini-FAQ
--------
Q: These icons are pitiful, these icons suck up too many palette entries, these
   icons don't match my impossibly cool colour/color scheme.

A: Stop your bitching and change them! Fire up gimp/kiconedit and edit
	<kdedir>/share/icons/kapm*.xpm to suit your needs. Then send them back to me,
	please.

Q: I found a bug! What do I do now?

A: Send a bug-report, or (preferably, if you can) send a patch.

Q: What did you do to apmlib.c? Why?

A: I stripped it down and coverted it to C++. Its alot less backwards compatible
   than the original, so its a good idea to have a 2.2.x kernel.

Q: This is really glitchy/buggy/non-functional. Whats wrong?

A: Best idea is to upgrade kapm, apmd, and your kernel to the latest versions.
   If the problem persists, send a bugreport.

Bugs
----
-Crappy icons







