wrap up of readme; all low-level API functions now return namedtuples, even in the absence of a result