dockapps/wmacpi
Doug Torrance 6961aed640 wmacpi: Bump to version 1.99.
Source obtained from http://sourceforge.net/projects/wmacpi/files/.

2003 November 23 1.99
	Finally claimed the wmacpi name as my own . . .

	Renamed wmacpi-ng and acpi-ng, renamed the header files, fixed up
	the makefile.

	For the Debian package, also made compilation of the command line
	tool optional, defaulting to not building it. This is because
	after the renaming, my acpi clashes with the acpi package that's
	already in Debian. The command line functionality is now
	accessible via the -w option to wmacpi.

	This is wmacpi 1.99, so that I can have a release packaged and in
	Debian before going to 2.0, so that any bugs that are left can be
	found by all the extra users.
2014-08-19 18:13:56 +01:00
..
debian wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00
acpi.1 wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00
acpi.c wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00
AUTHORS wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00
ChangeLog wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00
COPYING wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00
INSTALL wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00
libacpi.c wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00
libacpi.h wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00
Makefile wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00
master.xpm wmacpi: Bump to wmacpi-ng version 0.90. 2014-08-19 18:13:56 +01:00
master_low.xpm wmacpi: Bump to wmacpi-ng version 0.90. 2014-08-19 18:13:56 +01:00
README wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00
TODO wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00
wmacpi.1 wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00
wmacpi.c wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00
wmacpi.h wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00

For install instructions, see "INSTALL" file.

Usage:

+-------------+
|battery graph| <- visual percentage battery remaining
|[:][=] [100%]| <- [:] - on AC (blink when charging) [=] - on battery
|[00:00]  [bX]| <- [00:00] time remaining   [bX] battery being monitored.
|status   area| <- messages scroll here
+-------------+

see wmacpi -h for some command line switches

**********************************************************************

wmacpi is a dockapp ACPI battery monitor for modern kernels (ie,
2.4.17 or later, and 2.6 kernels). Basically, it opens various files
under /proc/acpi, reads status information from them, and then
displays summaries.

Version 1.99 and later provides full support for multiple
batteries. You can tell it to monitor a particular batter with the -m
option, which will display the percentage remaining and current status
message for that battery. The time remaining and AC/battery status are
global - the time remaining is calculated based on all batteries found
on the system. When charging, the time displayed is the time remaining
until the battery is fully charged - this only works sensibly if your
ACPI system is implemented properly (far, far too many laptops have
buggered ACPI implementations).

The displayed time is averaged over 50 samples, each taken every three
seconds (by default). This greatly improves the accuracy of the
numbers - on my laptop, the time remaining seems to be overstated by a
good hour or so if you only sample once compared to fifty times.

Some ACPI implementations are stupid enough to block interrupts while
reading status information from the battery over a slow bus - this
means that on such b0rken laptops, running an ACPI battery monitor
could affect interactivity. To provide a workaround for this, current
versions of wmacpi supports setting the sample rate from the command
line. The default -s setting is 100, which translates to once every
three seconds. -s 10 will sample every 30 seconds, -s 1 every 300
seconds. -s 1000 will sample every 0.3 seconds - don't do that unless
you're just having fun . . .

Also provided is a command line tool to report the battery status. By
default this will only sample once, but with the -a option you can
specify a number. Be aware that it will try to take all those samples
in the space of one second, so if your ACPI implementation is b0rken
this could have adverse effects.

Please report bugs to <simon@dreamcraft.com.au>.

Simon Fowler, 2003-11-23.