1 files changed, 315 insertions, 3 deletions
diff --git a/man1/git-fsck.1 b/man1/git-fsck.1
index 09618aa0e..aab06c585 100644
--- a/man1/git-fsck.1
+++ b/man1/git-fsck.1
@@ -2,12 +2,12 @@
 .\"     Title: git-fsck
 .\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 10/28/2022
+.\"      Date: 11/04/2022
 .\"    Manual: Git Manual
-.\"    Source: Git 2.38.1.280.g63bba4fdd8
+.\"    Source: Git 2.38.1.385.g3b08839926
 .\"  Language: English
 .\"
-.TH "GIT\-FSCK" "1" "10/28/2022" "Git 2\&.38\&.1\&.280\&.g63bba4" "Git Manual"
+.TH "GIT\-FSCK" "1" "11/04/2022" "Git 2\&.38\&.1\&.385\&.g3b0883" "Git Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -191,6 +191,13 @@ value will cause fsck to die, but doing the same for
 and
 \fBfetch\&.fsck\&.<msg\-id>\fR
 will only cause git to warn\&.
+.sp
+See
+\fBFsck Messages\fR
+section of
+\fBgit-fsck\fR(1)
+for supported values of
+\fB<msg\-id>\fR\&.
 .RE
 .PP
 fsck\&.skipList
@@ -251,6 +258,311 @@ hash mismatch <object>
 .RS 4
 The database has an object whose hash doesn\(cqt match the object database value\&. This indicates a serious data integrity problem\&.
 .RE
+.SH "FSCK MESSAGES"
+.sp
+The following lists the types of errors \fBgit fsck\fR detects and what each error means, with their default severity\&. The severity of the error, other than those that are marked as "(FATAL)", can be tweaked by setting the corresponding \fBfsck\&.<msg\-id>\fR configuration variable\&.
+.PP
+\fBbadDate\fR
+.RS 4
+(ERROR) Invalid date format in an author/committer line\&.
+.RE
+.PP
+\fBbadDateOverflow\fR
+.RS 4
+(ERROR) Invalid date value in an author/committer line\&.
+.RE
+.PP
+\fBbadEmail\fR
+.RS 4
+(ERROR) Invalid email format in an author/committer line\&.
+.RE
+.PP
+\fBbadFilemode\fR
+.RS 4
+(INFO) A tree contains a bad filemode entry\&.
+.RE
+.PP
+\fBbadName\fR
+.RS 4
+(ERROR) An author/committer name is empty\&.
+.RE
+.PP
+\fBbadObjectSha1\fR
+.RS 4
+(ERROR) An object has a bad sha1\&.
+.RE
+.PP
+\fBbadParentSha1\fR
+.RS 4
+(ERROR) A commit object has a bad parent sha1\&.
+.RE
+.PP
+\fBbadTagName\fR
+.RS 4
+(INFO) A tag has an invalid format\&.
+.RE
+.PP
+\fBbadTimezone\fR
+.RS 4
+(ERROR) Found an invalid time zone in an author/committer line\&.
+.RE
+.PP
+\fBbadTree\fR
+.RS 4
+(ERROR) A tree cannot be parsed\&.
+.RE
+.PP
+\fBbadTreeSha1\fR
+.RS 4
+(ERROR) A tree has an invalid format\&.
+.RE
+.PP
+\fBbadType\fR
+.RS 4
+(ERROR) Found an invalid object type\&.
+.RE
+.PP
+\fBduplicateEntries\fR
+.RS 4
+(ERROR) A tree contains duplicate file entries\&.
+.RE
+.PP
+\fBemptyName\fR
+.RS 4
+(WARN) A path contains an empty name\&.
+.RE
+.PP
+\fBextraHeaderEntry\fR
+.RS 4
+(IGNORE) Extra headers found after
+\fBtagger\fR\&.
+.RE
+.PP
+\fBfullPathname\fR
+.RS 4
+(WARN) A path contains the full path starting with "/"\&.
+.RE
+.PP
+\fBgitattributesSymlink\fR
+.RS 4
+(INFO)
+\fB\&.gitattributes\fR
+is a symlink\&.
+.RE
+.PP
+\fBgitignoreSymlink\fR
+.RS 4
+(INFO)
+\fB\&.gitignore\fR
+is a symlink\&.
+.RE
+.PP
+\fBgitmodulesBlob\fR
+.RS 4
+(ERROR) A non\-blob found at
+\fB\&.gitmodules\fR\&.
+.RE
+.PP
+\fBgitmodulesLarge\fR
+.RS 4
+(ERROR) The
+\fB\&.gitmodules\fR
+file is too large to parse\&.
+.RE
+.PP
+\fBgitmodulesMissing\fR
+.RS 4
+(ERROR) Unable to read
+\fB\&.gitmodules\fR
+blob\&.
+.RE
+.PP
+\fBgitmodulesName\fR
+.RS 4
+(ERROR) A submodule name is invalid\&.
+.RE
+.PP
+\fBgitmodulesParse\fR
+.RS 4
+(INFO) Could not parse
+\fB\&.gitmodules\fR
+blob\&.
+.RE
+.sp
+\fBgitmodulesLarge\fR; (ERROR) \fB\&.gitmodules\fR blob is too large to parse\&.
+.PP
+\fBgitmodulesPath\fR
+.RS 4
+(ERROR)
+\fB\&.gitmodules\fR
+path is invalid\&.
+.RE
+.PP
+\fBgitmodulesSymlink\fR
+.RS 4
+(ERROR)
+\fB\&.gitmodules\fR
+is a symlink\&.
+.RE
+.PP
+\fBgitmodulesUpdate\fR
+.RS 4
+(ERROR) Found an invalid submodule update setting\&.
+.RE
+.PP
+\fBgitmodulesUrl\fR
+.RS 4
+(ERROR) Found an invalid submodule url\&.
+.RE
+.PP
+\fBhasDot\fR
+.RS 4
+(WARN) A tree contains an entry named
+\fB\&.\fR\&.
+.RE
+.PP
+\fBhasDotdot\fR
+.RS 4
+(WARN) A tree contains an entry named
+\fB\&.\&.\fR\&.
+.RE
+.PP
+\fBhasDotgit\fR
+.RS 4
+(WARN) A tree contains an entry named
+\fB\&.git\fR\&.
+.RE
+.PP
+\fBmailmapSymlink\fR
+.RS 4
+(INFO)
+\fB\&.mailmap\fR
+is a symlink\&.
+.RE
+.PP
+\fBmissingAuthor\fR
+.RS 4
+(ERROR) Author is missing\&.
+.RE
+.PP
+\fBmissingCommitter\fR
+.RS 4
+(ERROR) Committer is missing\&.
+.RE
+.PP
+\fBmissingEmail\fR
+.RS 4
+(ERROR) Email is missing in an author/committer line\&.
+.RE
+.PP
+\fBmissingNameBeforeEmail\fR
+.RS 4
+(ERROR) Missing name before an email in an author/committer line\&.
+.RE
+.PP
+\fBmissingObject\fR
+.RS 4
+(ERROR) Missing
+\fBobject\fR
+line in tag object\&.
+.RE
+.PP
+\fBmissingSpaceBeforeDate\fR
+.RS 4
+(ERROR) Missing space before date in an author/committer line\&.
+.RE
+.PP
+\fBmissingSpaceBeforeEmail\fR
+.RS 4
+(ERROR) Missing space before the email in author/committer line\&.
+.RE
+.PP
+\fBmissingTag\fR
+.RS 4
+(ERROR) Unexpected end after
+\fBtype\fR
+line in a tag object\&.
+.RE
+.PP
+\fBmissingTagEntry\fR
+.RS 4
+(ERROR) Missing
+\fBtag\fR
+line in a tag object\&.
+.RE
+.PP
+\fBmissingTaggerEntry\fR
+.RS 4
+(INFO) Missing
+\fBtagger\fR
+line in a tag object\&.
+.RE
+.PP
+\fBmissingTree\fR
+.RS 4
+(ERROR) Missing
+\fBtree\fR
+line in a commit object\&.
+.RE
+.PP
+\fBmissingType\fR
+.RS 4
+(ERROR) Invalid type value on the
+\fBtype\fR
+line in a tag object\&.
+.RE
+.PP
+\fBmissingTypeEntry\fR
+.RS 4
+(ERROR) Missing
+\fBtype\fR
+line in a tag object\&.
+.RE
+.PP
+\fBmultipleAuthors\fR
+.RS 4
+(ERROR) Multiple author lines found in a commit\&.
+.RE
+.PP
+\fBnulInCommit\fR
+.RS 4
+(WARN) Found a NUL byte in the commit object body\&.
+.RE
+.PP
+\fBnulInHeader\fR
+.RS 4
+(FATAL) NUL byte exists in the object header\&.
+.RE
+.PP
+\fBnullSha1\fR
+.RS 4
+(WARN) Tree contains entries pointing to a null sha1\&.
+.RE
+.PP
+\fBtreeNotSorted\fR
+.RS 4
+(ERROR) A tree is not properly sorted\&.
+.RE
+.PP
+\fBunknownType\fR
+.RS 4
+(ERROR) Found an unknown object type\&.
+.RE
+.PP
+\fBunterminatedHeader\fR
+.RS 4
+(FATAL) Missing end\-of\-line in the object header\&.
+.RE
+.PP
+\fBzeroPaddedDate\fR
+.RS 4
+(ERROR) Found a zero padded date in an author/commiter line\&.
+.RE
+.PP
+\fBzeroPaddedFilemode\fR
+.RS 4
+(WARN) Found a zero padded filemode in a tree\&.
+.RE
 .SH "ENVIRONMENT VARIABLES"
 .PP
 GIT_OBJECT_DIRECTORY