Ditch floating point numbers, use cents instead; bump version to 3.2

README.md

@@ -1,77 +1,24 @@
-# NAME
+# revbank - Banking for hackerspace visitors
 
-revbank - Banking for hackerspace visitors
+## Upgrading
 
-# ANNOUNCEMENTS
+When upgrading from a previous version, please refer to the file `UPGRADING.md`
+because there might be incompatible changes that require your attention.
 
-The following features were removed:
+## Installing
 
-- plugins `nyan` and `game`
+1. Install the Perl module Term::ReadLine::Gnu
 
-    Please remove these from your `revbank.plugins` configuration file.
+```
+Debian:  apt install libterm-readline-gnu-perl
+Generic: cpan Term::ReadLine::Gnu
+```
 
-- creating new accounts with `deposit`
+2. Clone the repository, run revbank :)
 
-    Use `adduser` instead.
+## Exiting revbank
 
-- Method `$cart->is_multi_user`
-- Method `$cart->delete($user, $index)`
-
-    Delete a specific entry, as returned by `$cart->entries`, instead.
-
-The following will disappear in a future version:
-
-## Hooks `add` and `added`
-
-Use `add_entry` and `added_entry` instead, which gets a RevBank::Cart::Entry
-object, instead.
-
-Note that the new "entries", unlike old "items", can have a `quantity` other
-than 1.
-
-## Method `$cart->add(undef, ...)`
-
-## Method `$cart->add($user, ...)`
-
-The `add` method now always creates an entry from the perspective of the
-current user, and returns a RevBank::Cart::Entry object to which "contras" can
-be added with `add_contra`. The contras can be used for counteracting a value
-with an operation on another account.
-
-To upgrade a plugin that does a single `add` with `undef` as the first
-argument, simply remove the `undef, `. When multiple items were added that
-belong together, consider using `add_contra` for the subsequent lines; see the
-`take` and `give` plugins for examples.
-
-## Method `$cart->select_items`
-
-Use `entries` instead, which takes the same kind of argument. Note that
-entries work slightly differently: they can have a quantity and attached contra
-entries. Attributes are now accessed through the `has_attribute` and
-`attribute` methods, instead of directly manipulating the hash.
-
-# DESCRIPTION
-
-Maybe I'll write some documentation, but not now.
-
-Shell-like invocation with `-c` is supported, sort of, but it has to be a
-complete command. Currently, multiple commands are supported on the command
-line (space separated), but that's an unintended feature...
-
-# PLUGINS
-
-Refer to [RevBank::Plugins](https://metacpan.org/pod/RevBank::Plugins) for documentation about writing plugins.
-
-Plugins themselves may have some documentation in the respective plugin files.
-
-Note that plugins that begin with `revspace_` are revspace specific hacks, and
-were not written with reusability in mind. They will probably not work for your
-setup.
-
-# AUTHOR
-
-Juerd Waalboer <#####@juerd.nl>
-
-# LICENSE
-
-Pick your favorite OSI license.
+Exiting is not supported because it's desigend to run continuously. But if you
+run it from a shell, you can probably stop it using ctrl+Z and then kill the
+process (e.g. `kill %1`). RevBank does not keep any files open, so it's safe
+to kill when idle.