more documentation, rename :arg-lists to :arglists. Closes #17