fix documentation; and make tests run