fixed documentation, faulty arity