Fix edoc usage errors

Errors discovered using `erldocs`:
  Superfluous @hidden tag would exit edoc application;
  'Multiple @spec tag': put -spec above function of right arity;
  '@spec arity does not match': added missing argument.