dockapps/wmacpi
Doug Torrance ffd4b11477 wmacpi: Bump to version 2.2rc1.
Source obtained from http://sourceforge.net/projects/wmacpi/files/.

2007 July 14 2.2rc1
	Major changes to command line handling and to the way we use
	libdockapp, courtesy of Patrice Dumas. This should hopefully fix
	several long-standing bugs with non-wmaker window managers (in
	particular Debian bugs #280495 and 293546).

	Updated to support newer kernels that no longer support
	/proc/acpi/info - thanks to Samuel Ortiz.

	Fixed a longstanding issue with redrawing - thanks to Vito
	Caputo.

	This version changes a number of command line options (little used
	ones, but they're still incompatible changes) due to the
	libdockapp work. In particular, -w becomes -x, -v becomes -V (and
	takes an argument rather than being repeated), and -V becomes -v
	(thanks to libdockapp grabbing -h, -v and -w for itself). Also,
	long options are now supported for everything in wmacpi (but not
	acpi, since it doesn't use libdockapp for command line parsing).
2014-08-19 18:13:57 +01:00
..
.arch-ids wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +01:00
debian wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +01:00
.hg_archival.txt wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +01:00
.hgempty wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +01:00
.hgignore wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +01:00
.hgtags wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +01:00
acpi.1 wmacpi: Bump to version 1.99. 2014-08-19 18:13:56 +01:00
acpi.c wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +01:00
AUTHORS wmacpi: Bump to version 2.2a1. 2014-08-19 18:13:57 +01:00
ChangeLog wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +01:00
COPYING wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00
INSTALL wmacpi: Bump to version 2.1rc1. 2014-08-19 18:13:57 +01:00
libacpi.c wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +01:00
libacpi.h wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +01:00
Makefile wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +01:00
master.xpm wmacpi: Bump to version 1.99r7. 2014-08-19 18:13:57 +01:00
master_low.xpm wmacpi: Bump to version 1.99r7. 2014-08-19 18:13:57 +01:00
README wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +01:00
TODO wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +01:00
wmacpi.1 wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +01:00
wmacpi.c wmacpi: Bump to version 2.2rc1. 2014-08-19 18:13:57 +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 battery 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 --sample-rate option specifies the number of times the
battery is sampled every minute - the default is 20, and the maximum
value is 600. Since -s 600 translates to sampling every 0.1 seconds,
you really don't want to 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@himi.org>

Simon Fowler, 2007-07-13.