Minor documentation updates in code and docs

The documentation incorporates loads of minor revisions--almost
exclusively typographical and grammatical corrections and revisions.

In the code, the tunable parameters for low battery detection are now
documented with comments and have been moved from system.c to
system.h.