Document errors via `@retval`

[ashvardanian]

Besides existing @return doxygen tags for return types/objects, in some cases, we should enumerate possible values and errors with @retval.