Unclear handling of RefName

[uzytkownik]

It is unclear from documentation how to resolve RefName (returned by for example tagList) and Revision (accepted by most functions and acceptable to convert to Ref). I come up with fromString . refNameRaw but that doesn't return any errors etc. The difference between Ref, Revision and RefName are also not clearly documented.