This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-codec.git
The following commit(s) were added to refs/heads/master by this push:
new b075fd14 Javadoc
b075fd14 is described below
commit b075fd146d02df5259f7f88bc5c6a02db694722f
Author: Gary Gregory <[email protected]>
AuthorDate: Sun Apr 12 11:33:10 2026 -0400
Javadoc
---
.../java/org/apache/commons/codec/digest/GitIdentifiers.java | 11 ++++++++---
1 file changed, 8 insertions(+), 3 deletions(-)
diff --git a/src/main/java/org/apache/commons/codec/digest/GitIdentifiers.java
b/src/main/java/org/apache/commons/codec/digest/GitIdentifiers.java
index bd02afe2..fb9b7b51 100644
--- a/src/main/java/org/apache/commons/codec/digest/GitIdentifiers.java
+++ b/src/main/java/org/apache/commons/codec/digest/GitIdentifiers.java
@@ -138,12 +138,14 @@ public class GitIdentifiers {
public enum FileMode {
/**
- * A sub-directory (Git sub-tree).
+ * A subdirectory. Subdirectories can only be specified by SHA or
through a tree mark set with {@code --import-marks}.
+ *
+ * @see <a
href="https://git-scm.com/docs/git-fast-import";>git-fast-import - Backend for
fast Git data importers</a>
*/
DIRECTORY("40000"),
/**
- * An executable file.
+ * A regular, but executable, file.
*/
EXECUTABLE("100755"),
@@ -158,11 +160,14 @@ public class GitIdentifiers {
/**
* A regular (non-executable) file.
+ * <p>
+ * The majority of files in most projects use this mode. If in doubt,
this is what you want.
+ * </p>
*/
REGULAR("100644"),
/**
- * A symbolic link.
+ * A symbolic link. The content of the file will be the link target.
*/
SYMBOLIC_LINK("120000");
