Autogenerated HTML docs for v2.51.0-511-gac7d0

Author: gitster

RelNotes/2.52.0.adoc

@@ -298,6 +298,16 @@ including security updates, are included in this release.
  * Handling of an empty subdirectory of .git/refs/ in the ref-files
    backend has been corrected.
 
+ * Our CI script requires "sudo" that can be told to preserve
+   environment, but Ubuntu replaced with "sudo" with an implementation
+   that lacks the feature.  Work this around by reinstalling the
+   original version.
+   (merge fddb484255 ps/ci-avoid-broken-sudo-on-ubuntu later to maint).
+
+ * The reftable backend learned to sanity check its on-disk data more
+   carefully.
+   (merge 466a3a1afd kn/reftable-consistency-checks later to maint).
+
  * Other code cleanup, docfix, build fix, etc.
    (merge 823d537fa7 kh/doc-git-log-markup-fix later to maint).
    (merge cf7efa4f33 rj/t6137-cygwin-fix later to maint).
@@ -326,3 +336,4 @@ including security updates, are included in this release.
    (merge e1d062e8ba ps/odb-clean-stale-wrappers later to maint).
    (merge fdd21ba116 mh/doc-credential-url-prefix later to maint).
    (merge 1c573a3451 en/doc-merge-tree-describe-merge-base later to maint).
+   (merge 84a6bf7965 ja/doc-markup-attached-paragraph-fix later to maint).

fsck-msgids.adoc

@@ -38,6 +38,9 @@
 `badReferentName`::
 	(ERROR) The referent name of a symref is invalid.
 
+`badReftableTableName`::
+	(WARN) A reftable table has an invalid name.
+
 `badTagName`::
 	(INFO) A tag has an invalid format.
 
@@ -104,9 +107,6 @@
 `gitmodulesParse`::
 	(INFO) Could not parse `.gitmodules` blob.
 
-`gitmodulesLarge`;
-	(ERROR) `.gitmodules` blob is too large to parse.
-
 `gitmodulesPath`::
 	(ERROR) `.gitmodules` path is invalid.
 

git-config.html

@@ -4518,8 +4518,6 @@ <h3 id="_variables">Variables</h3>
 <p>Unless otherwise stated, is an error to specify an extension if
 <code>core.repositoryFormatVersion</code> is not <code>1</code>. See
 <a href="gitrepository-layout.html">gitrepository-layout(5)</a>.</p>
-<div class="openblock">
-<div class="content">
 <div class="dlist">
 <dl>
 <dt class="hdlist1">compatObjectFormat</dt>
@@ -4590,6 +4588,8 @@ <h3 id="_variables">Variables</h3>
 <dt class="hdlist1">refStorage</dt>
 <dd>
 <p>Specify the ref storage format to use. The acceptable values are:</p>
+<div class="openblock">
+<div class="content">
 <div class="ulist">
 <ul>
 <li>
@@ -4601,6 +4601,8 @@ <h3 id="_variables">Variables</h3>
 </li>
 </ul>
 </div>
+</div>
+</div>
 <div class="paragraph">
 <p>Note that this setting should only be set by <a href="git-init.html">git-init(1)</a> or
 <a href="git-clone.html">git-clone(1)</a>. Trying to change it after initialization will not
@@ -4629,6 +4631,8 @@ <h3 id="_variables">Variables</h3>
 certain values from the common config file to the main working tree&#8217;s
 <code>config.worktree</code> file, if present:</p>
 </div>
+<div class="openblock">
+<div class="content">
 <div class="ulist">
 <ul>
 <li>
@@ -4641,6 +4645,8 @@ <h3 id="_variables">Variables</h3>
 </li>
 </ul>
 </div>
+</div>
+</div>
 <div class="paragraph">
 <p>It may also be beneficial to adjust the locations of <code>core.sparseCheckout</code>
 and <code>core.sparseCheckoutCone</code> depending on your desire for customizable
@@ -4652,15 +4658,12 @@ <h3 id="_variables">Variables</h3>
 details.</p>
 </div>
 <div class="paragraph">
-<p>+
-For historical reasons, this extension is respected regardless of the
+<p>For historical reasons, this extension is respected regardless of the
 <code>core.repositoryFormatVersion</code> setting.</p>
 </div>
 </dd>
 </dl>
 </div>
-</div>
-</div>
 </dd>
 <dt class="hdlist1">fastimport.unpackLimit</dt>
 <dd>

git-diff-tree.html

@@ -2163,13 +2163,16 @@ <h2 id="_pretty_formats">PRETTY FORMATS</h2>
 </li>
 </ul>
 </div>
+<div class="openblock">
+<div class="content">
 <div class="paragraph">
 <p>For example, to produce decorations with no wrapping
 or tag annotations, and spaces as separators:</p>
 </div>
 <div class="paragraph">
-<p>+
-<code>%</code>(<code>decorate:prefix=,suffix=,tag=,separator=</code> )</p>
+<p><code>%</code>(<code>decorate:prefix=,suffix=,tag=,separator=</code> )</p>
+</div>
+</div>
 </div>
 <div class="dlist">
 <dl>

git-fsck.html

@@ -803,6 +803,10 @@ <h2 id="_fsck_messages">FSCK MESSAGES</h2>
 <dd>
 <p>(ERROR) The referent name of a symref is invalid.</p>
 </dd>
+<dt class="hdlist1"><code>badReftableTableName</code></dt>
+<dd>
+<p>(WARN) A reftable table has an invalid name.</p>
+</dd>
 <dt class="hdlist1"><code>badTagName</code></dt>
 <dd>
 <p>(INFO) A tag has an invalid format.</p>
@@ -890,14 +894,6 @@ <h2 id="_fsck_messages">FSCK MESSAGES</h2>
 <dd>
 <p>(INFO) Could not parse .<code>gitmodules</code> blob.</p>
 </dd>
-</dl>
-</div>
-<div class="paragraph">
-<p><code>gitmodulesLarge</code>;
-	(ERROR) .<code>gitmodules</code> blob is too large to parse.</p>
-</div>
-<div class="dlist">
-<dl>
 <dt class="hdlist1"><code>gitmodulesPath</code></dt>
 <dd>
 <p>(ERROR) .<code>gitmodules</code> path is invalid.</p>

git-log.html

@@ -2493,13 +2493,16 @@ <h2 id="_pretty_formats">PRETTY FORMATS</h2>
 </li>
 </ul>
 </div>
+<div class="openblock">
+<div class="content">
 <div class="paragraph">
 <p>For example, to produce decorations with no wrapping
 or tag annotations, and spaces as separators:</p>
 </div>
 <div class="paragraph">
-<p>+
-<code>%</code>(<code>decorate:prefix=,suffix=,tag=,separator=</code> )</p>
+<p><code>%</code>(<code>decorate:prefix=,suffix=,tag=,separator=</code> )</p>
+</div>
+</div>
 </div>
 <div class="dlist">
 <dl>

git-rev-list.html

@@ -2629,13 +2629,16 @@ <h2 id="_pretty_formats">PRETTY FORMATS</h2>
 </li>
 </ul>
 </div>
+<div class="openblock">
+<div class="content">
 <div class="paragraph">
 <p>For example, to produce decorations with no wrapping
 or tag annotations, and spaces as separators:</p>
 </div>
 <div class="paragraph">
-<p>+
-<code>%</code>(<code>decorate:prefix=,suffix=,tag=,separator=</code> )</p>
+<p><code>%</code>(<code>decorate:prefix=,suffix=,tag=,separator=</code> )</p>
+</div>
+</div>
 </div>
 <div class="dlist">
 <dl>

git-show.html

@@ -1123,13 +1123,16 @@ <h2 id="_pretty_formats">PRETTY FORMATS</h2>
 </li>
 </ul>
 </div>
+<div class="openblock">
+<div class="content">
 <div class="paragraph">
 <p>For example, to produce decorations with no wrapping
 or tag annotations, and spaces as separators:</p>
 </div>
 <div class="paragraph">
-<p>+
-<code>%</code>(<code>decorate:prefix=,suffix=,tag=,separator=</code> )</p>
+<p><code>%</code>(<code>decorate:prefix=,suffix=,tag=,separator=</code> )</p>
+</div>
+</div>
 </div>
 <div class="dlist">
 <dl>

pretty-formats.adoc

@@ -232,7 +232,7 @@ ref names with custom decorations. The `decorate` string may be followed by a
 colon and zero or more comma-separated options. Option values may contain
 literal formatting codes. These must be used for commas (`%x2C`) and closing
 parentheses (`%x29`), due to their role in the option syntax.
-+
+
 ** `prefix=<value>`: Shown before the list of ref names.  Defaults to "{nbsp}++(++".
 ** `suffix=<value>`: Shown after the list of ref names.  Defaults to "+)+".
 ** `separator=<value>`: Shown between ref names.  Defaults to "+,+{nbsp}".
@@ -241,10 +241,12 @@ parentheses (`%x29`), due to their role in the option syntax.
 ** `tag=<value>`: Shown before tag names. Defaults to "`tag:`{nbsp}".
 
 +
+--
 For example, to produce decorations with no wrapping
 or tag annotations, and spaces as separators:
-+
+
 ++%(decorate:prefix=,suffix=,tag=,separator= )++
+--
 
 ++%(describe++`[:<option>,...]`++)++::
 human-readable name, like linkgit:git-describe[1]; empty string for