Support two-argument syntax from README, and other updates

Here are some more updates, mainly to support the two-argument syntax for `.per()` and similar functions as shown in one of the README examples, plus some other minor cleanup and documentation.