a Repository.
canonical name of the reference HEAD should point to.
true if head was successfully set, false otherwise.