* Except when HEAD is detached, in which case this method returns the
* current ObjectId in hexadecimal string format.
*
- * @return name of current branch (for example {@code refs/heads/master}) or
- * an ObjectId in hex format if the current branch is detached.
+ * @return name of current branch (for example {@code refs/heads/master}),
+ * an ObjectId in hex format if the current branch is detached,
+ * or null if the repository is corrupt and has no HEAD reference.
* @throws IOException
*/
public String getFullBranch() throws IOException {
* leading prefix {@code refs/heads/} is removed from the reference before
* it is returned to the caller.
*
- * @return name of current branch (for example {@code master}), or an
- * ObjectId in hex format if the current branch is detached.
+ * @return name of current branch (for example {@code master}), an
+ * ObjectId in hex format if the current branch is detached,
+ * or null if the repository is corrupt and has no HEAD reference.
* @throws IOException
*/
public String getBranch() throws IOException {