git/Documentation
Patrick Steinhardt 7174098834 pack-bitmap: fix bug with exact ref match in "pack.preferBitmapTips"
The "pack.preferBitmapTips" configuration allows the user to specify
which references should be preferred when generating bitmaps. This
option is typically expected to be set to a reference prefix, like for
example "refs/heads/".

It's not unreasonable though for a user to configure one specific
reference as preferred. But if they do, they'll hit a `BUG()`:

    $ git -c pack.preferBitmapTips=refs/heads/main repack -adb
    BUG: ../refs/iterator.c:366: attempt to trim too many characters
    error: pack-objects died of signal 6

The root cause for this bug is how we enumerate these references. We
call `refs_for_each_ref_in()`, which will:

  - Yield all references that have a user-specified prefix.

  - Trim each of these references so that the prefix is removed.

Typically, this function is called with a trailing slash, like
"refs/heads/", and in that case things work alright. But if the function
is called with the name of an existing reference then we'll try to trim
the full reference name, which would leave us with an empty name. And as
this would not really leave us with anything sensible, we call `BUG()`
instead of yielding this reference.

One could argue that this is a bug in `refs_for_each_ref_in()`. But the
question then becomes what the correct behaviour would be:

  - Do we want to skip exact matches? In our case we certainly don't
    want that, as the user has asked us to generate a bitmap for it.

  - Do we want to yield the reference with the empty refname? That would
    lead to a somewhat weird result.

Neither of these feel like viable options, so calling `BUG()` feels like
a sensible way out. The root cause ultimately is that we even try to
trim the whole refname in the first place. There are two possible ways
to fix this issue:

  - We can fix the bug by using `refs_for_each_fullref_in()` instead,
    which does not strip the prefix at all. Consequently, we would now
    start to accept all references that start with the configured
    prefix, including exact matches. So if we had "refs/heads/main", we
    would both match "refs/heads/main" and "refs/heads/main-branch".

  - Or we can fix the bug by appending a slash to the prefix if it
    doesn't already have one. This would mean that we only match
    ref hierarchies that start with this prefix.

While the first fix leaves the user with strictly _more_ configuration
options, we have already fixed a similar case in 10e8a9352b (refs.c:
stop matching non-directory prefixes in exclude patterns, 2025-03-06) by
using the second option. So for the sake of consistency, let's apply the
same fix here.

Clarify the documentation accordingly.

Signed-off-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2026-02-19 10:41:18 -08:00
..
RelNotes RelNotes: a few spelling fixes 2026-01-27 12:12:06 -08:00
config pack-bitmap: fix bug with exact ref match in "pack.preferBitmapTips" 2026-02-19 10:41:18 -08:00
howto meson: make GIT_HTML_PATH configurable 2025-11-06 09:58:56 -08:00
includes doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
mergetools doc: check well-formedness of delimited sections 2025-08-11 14:16:03 -07:00
technical Merge branch 'en/xdiff-cleanup-2' 2025-12-05 14:49:56 +09:00
.gitignore Remove obsolete ".txt" extensions for AsciiDoc files 2025-01-21 12:56:10 -08:00
BreakingChanges.adoc refs/files: deprecate writing symrefs as symbolic links 2025-10-15 09:11:08 -07:00
CodingGuidelines Documentation: note styling for bit fields 2025-08-26 15:46:03 -07:00
DecisionMaking.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
Makefile Merge branch 'en/xdiff-cleanup-2' 2025-12-05 14:49:56 +09:00
MyFirstContribution.adoc MyFirstContribution: add note on confirming patches 2025-10-27 09:09:53 -07:00
MyFirstObjectWalk.adoc Merge branch 'jc/you-still-use-whatchanged' 2025-06-25 14:07:35 -07:00
ReviewingGuidelines.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
SubmittingPatches Merge branch 'cc/doc-submitting-patches-with-ai' 2025-11-04 07:48:06 -08:00
ToolsForGit.adoc doc: add a blank line around block delimiters 2025-03-10 09:58:06 -07:00
asciidoc.conf.in doc: git-log: convert rev list options to new doc format 2025-07-07 13:45:00 -07:00
asciidoctor-extensions.rb.in doc: git-log: convert rev list options to new doc format 2025-07-07 13:45:00 -07:00
blame-options.adoc doc: blame-options: convert to new doc format 2026-01-09 06:15:31 -08:00
build-docdep.perl doc: fix build-docdep.perl 2025-03-01 10:26:15 -08:00
cat-texi.perl
cmd-list.sh Documentation: stop depending on Perl to generate command list 2025-04-16 07:30:30 -07:00
config.adoc Merge branch 'jc/doc-includeif-hasconfig-remote-url-fix' into maint-2.51 2025-10-15 10:29:34 -07:00
date-formats.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
diff-algorithm-option.adoc blame: make diff algorithm configurable 2025-11-17 09:31:59 -08:00
diff-context-options.adoc add-patch: add diff.context command line overrides 2025-07-29 08:52:45 -07:00
diff-format.adoc doc: check well-formedness of delimited sections 2025-08-11 14:16:03 -07:00
diff-generate-patch.adoc Merge branch 'ma/doc-diff-cc-headers' 2025-06-18 13:53:34 -07:00
diff-options.adoc blame: make diff algorithm configurable 2025-11-17 09:31:59 -08:00
doc-diff
docbook-xsl.css
docbook.xsl
docinfo-html.in
everyday.adoco doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
fetch-options.adoc doc: convert git pull to synopsis style 2025-11-19 15:00:42 -08:00
fix-texi.sh Documentation: stop depending on Perl to massage user manual 2025-04-16 07:30:29 -07:00
for-each-ref-options.adoc Merge branch 'ja/doc-lint-sections-and-synopsis' 2025-08-25 14:22:02 -07:00
fsck-msgids.adoc builtin/fsck: move generic HEAD check into `refs_fsck()` 2026-01-12 06:55:41 -08:00
generate-mergetool-list.sh Documentation: extract script to generate a list of mergetools 2024-12-07 07:52:13 +09:00
git-add.adoc add-patch: fully document option P 2025-10-21 14:35:44 -07:00
git-am.adoc Merge branch 'kh/doc-committer-date-is-author-date' 2025-12-05 14:49:57 +09:00
git-annotate.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-apply.adoc apply docs: clarify wording for --intent-to-add 2025-07-07 06:41:11 -07:00
git-archimport.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-archive.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-backfill.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-bisect-lk2009.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-bisect.adoc bisect: update usage and docs to match each other 2025-10-28 15:41:42 -07:00
git-blame.adoc doc: git-blame: convert to new doc format 2026-01-09 06:15:53 -08:00
git-branch.adoc doc: branch: fix inline-verbatim 2025-05-05 10:48:07 -07:00
git-bugreport.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-bundle.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-cat-file.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-check-attr.adoc doc: check for absence of multiple terms in each entry of desc list 2025-08-11 14:16:04 -07:00
git-check-ignore.adoc doc: check for absence of multiple terms in each entry of desc list 2025-08-11 14:16:04 -07:00
git-check-mailmap.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-check-ref-format.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-checkout-index.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-checkout.adoc doc: fix asciidoc markup issues in several files 2025-12-20 14:55:43 +09:00
git-cherry-pick.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-cherry.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-citool.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-clean.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-clone.adoc Merge branch 'kr/clone-synopsis-fix' into maint-2.51 2025-10-15 10:29:32 -07:00
git-column.adoc doc: column: fix blank lines around block delimiters 2025-06-01 17:20:16 -07:00
git-commit-graph.adoc commit-graph: add new config for changed-paths & recommend it in scalar 2025-10-22 10:40:11 -07:00
git-commit-tree.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-commit.adoc doc: commit: link to git-status(1) on all format options 2025-11-14 08:56:35 -08:00
git-config.adoc Merge branch 'ps/config-doc-get-urlmatch-fix' 2026-01-21 16:16:28 -08:00
git-count-objects.adoc Merge branch 'ds/doc-count-objects-fix' into maint-2.51 2025-10-14 13:40:54 -07:00
git-credential-cache--daemon.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-credential-cache.adoc Merge branch 'bc/doc-adoc-not-txt' 2025-02-14 17:53:47 -08:00
git-credential-store.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-credential.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-cvsexportcommit.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-cvsimport.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-cvsserver.adoc doc: add a blank line around block delimiters 2025-03-10 09:58:06 -07:00
git-daemon.adoc git-daemon doc: update mark-up of synopsis option descriptions 2025-05-12 09:25:26 -07:00
git-describe.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-diagnose.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-diff-files.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-diff-index.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-diff-pairs.adoc builtin/diff-pairs: allow explicit diff queue flush 2025-03-03 08:17:47 -08:00
git-diff-tree.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-diff.adoc diff --no-index: support limiting by pathspec 2025-05-22 14:20:11 -07:00
git-difftool.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-fast-export.adoc fast-(import|export): improve on commit signature output format 2025-07-09 16:08:29 -07:00
git-fast-import.adoc fast-import: add 'strip-if-invalid' mode to --signed-commits=<mode> 2025-11-26 08:43:44 -08:00
git-fetch-pack.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-fetch.adoc doc: convert git fetch to synopsis style 2025-11-19 15:00:37 -08:00
git-filter-branch.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-fmt-merge-msg.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-for-each-ref.adoc Merge branch 'ja/doc-lint-sections-and-synopsis' 2025-08-25 14:22:02 -07:00
git-for-each-repo.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-format-patch.adoc Merge branch 'js/doc-sending-patch-via-thunderbird' 2025-09-02 08:21:26 -07:00
git-fsck-objects.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-fsck.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-fsmonitor--daemon.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-gc.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-get-tar-commit-id.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-grep.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-gui.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-hash-object.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-help.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-hook.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-http-backend.adoc Merge branch 'ps/doc-http-upload-archive-service' 2025-02-14 17:53:49 -08:00
git-http-fetch.adoc doc: check for absence of multiple terms in each entry of desc list 2025-08-11 14:16:04 -07:00
git-http-push.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-imap-send.adoc docs: explain how to use `git imap-send --list` command to get a list of available folders 2025-07-22 08:49:15 -07:00
git-index-pack.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-init-db.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-init.adoc breaking-changes: switch default branch to main 2025-09-10 13:34:58 -07:00
git-instaweb.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-interpret-trailers.adoc doc: interpret-trailers: close all pairs of single quotes 2025-08-22 11:12:27 -07:00
git-last-modified.adoc last-modified: new subcommand to show when files were last modified 2025-08-28 16:44:58 -07:00
git-log.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-ls-files.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-ls-remote.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-ls-tree.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-mailinfo.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-mailsplit.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-maintenance.adoc maintenance: add 'is-needed' subcommand 2025-11-10 09:28:48 -08:00
git-merge-base.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-merge-file.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-merge-index.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-merge-one-file.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-merge-tree.adoc Merge branch 'en/doc-merge-tree-describe-merge-base' 2025-10-10 12:51:46 -07:00
git-merge.adoc Merge branch 'ts/merge-orig-head-doc-fix' 2025-07-14 11:19:28 -07:00
git-mergetool--lib.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-mergetool.adoc doc: convert git-mergetool manpage to new synopsis style 2025-05-27 07:51:01 -07:00
git-mktag.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-mktree.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-multi-pack-index.adoc Merge branch 'kh/doc-markup-fixes' into maint-2.51 2025-10-15 10:29:33 -07:00
git-mv.adoc doc: convert git-mv to new documentation format 2025-04-14 14:43:52 -07:00
git-name-rev.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-notes.adoc doc: notes: use stuck form throughout 2025-05-27 15:31:08 -07:00
git-p4.adoc doc: check well-formedness of delimited sections 2025-08-11 14:16:03 -07:00
git-pack-objects.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-pack-redundant.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-pack-refs.adoc doc: pack-refs: factor out common options 2025-09-19 10:02:56 -07:00
git-patch-id.adoc doc: patch-id: --verbatim locks in --stable 2026-01-09 06:08:37 -08:00
git-prune-packed.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-prune.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-pull.adoc Merge branch 'je/doc-pull' 2025-12-14 17:04:37 +09:00
git-push.adoc doc: convert git push to synopsis style 2025-11-19 15:00:45 -08:00
git-quiltimport.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-range-diff.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-read-tree.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-rebase.adoc Merge branch 'ja/doc-misc-fixes' 2025-12-28 17:36:16 +09:00
git-receive-pack.adoc builtin/receive-pack: add option to skip connectivity check 2025-05-20 11:43:36 -07:00
git-reflog.adoc builtin/reflog: implement subcommand to write new entries 2025-08-06 07:36:30 -07:00
git-refs.adoc Merge branch 'ms/refs-optimize' 2025-10-02 12:26:12 -07:00
git-remote-ext.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-remote-fd.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-remote-helpers.adoco doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-remote.adoc doc: convert git-remote to synopsis style 2025-12-21 11:33:10 +09:00
git-repack.adoc doc: correct minor wording issues 2025-12-20 14:55:43 +09:00
git-replace.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-replay.adoc replay: drop rev-list formatting options from manual 2026-01-20 09:38:56 -08:00
git-repo.adoc Merge branch 'jt/repo-struct-more-objinfo' 2025-12-30 12:58:19 +09:00
git-request-pull.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-rerere.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-reset.adoc doc: git-reset: clarify `git reset <pathspec>` 2026-01-06 08:10:14 +09:00
git-restore.adoc Merge branch 'lm/add-p-context' 2025-08-04 08:10:33 -07:00
git-rev-list.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-rev-parse.adoc Merge branch 'bc/sha1-256-interop-01' 2025-10-22 11:38:58 -07:00
git-revert.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-rm.adoc doc: convert git-rm to new documentation format 2025-04-14 14:43:52 -07:00
git-send-email.adoc Merge branch 'ja/doc-misc-fixes' 2025-12-28 17:36:16 +09:00
git-send-pack.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-sh-i18n--envsubst.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-sh-i18n.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-sh-setup.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-shell.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-shortlog.adoc doc: fix accidental literal blocks 2025-10-10 07:56:09 -07:00
git-show-branch.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-show-index.adoc Merge branch 'bc/doc-adoc-not-txt' 2025-02-14 17:53:47 -08:00
git-show-ref.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-show.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-sparse-checkout.adoc Merge branch 'ds/sparse-checkout-clean' 2025-10-28 10:29:09 -07:00
git-stage.adoc doc: convert git stage to use synopsis block 2025-12-21 11:33:10 +09:00
git-stash.adoc doc: convert git-stash.adoc to synopis style 2025-10-05 16:09:03 -07:00
git-status.adoc doc: convert git-status tables to AsciiDoc format 2025-12-21 11:33:10 +09:00
git-stripspace.adoc doc: stripspace: mention where the default comes from 2025-05-27 15:31:05 -07:00
git-submodule.adoc Merge branch 'ja/doc-lint-sections-and-synopsis' 2025-08-25 14:22:02 -07:00
git-svn.adoc doc: check well-formedness of delimited sections 2025-08-11 14:16:03 -07:00
git-switch.adoc builtin: unmark git-switch and git-restore as experimental 2025-07-28 14:24:03 -07:00
git-symbolic-ref.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-tag.adoc Merge branch 'cc/fast-import-strip-signed-tags' 2025-10-28 10:29:09 -07:00
git-tools.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-unpack-file.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-unpack-objects.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-update-index.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-update-ref.adoc Merge branch 'sb/doc-update-ref-markup-fix' 2026-01-23 13:34:35 -08:00
git-update-server-info.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-upload-archive.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-upload-pack.adoc doc: check for absence of the form --[no-]parameter 2025-08-11 14:16:04 -07:00
git-var.adoc git-var doc: fix usage of $ENV_VAR vs ENV_VAR 2025-05-12 09:25:27 -07:00
git-verify-commit.adoc git-verify-* doc: update mark-up of synopsis option descriptions 2025-05-12 09:25:27 -07:00
git-verify-pack.adoc git-verify-* doc: update mark-up of synopsis option descriptions 2025-05-12 09:25:27 -07:00
git-verify-tag.adoc git-verify-* doc: update mark-up of synopsis option descriptions 2025-05-12 09:25:27 -07:00
git-version.adoc help: include unsafe SHA-1 build info in version 2025-04-07 14:39:27 -07:00
git-web--browse.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
git-whatchanged.adoc whatchanged: remove not-even-shorter clause 2025-09-17 13:47:24 -07:00
git-worktree.adoc doc: fix asciidoc markup issues in several files 2025-12-20 14:55:43 +09:00
git-write-tree.adoc git-{var,write-tree} docs: update mark-up of synopsis option descriptions 2025-05-12 09:25:26 -07:00
git.adoc Merge branch 'js/progress-delay-fix' into maint-2.51 2025-10-14 13:40:54 -07:00
gitattributes.adoc doc: add a blank line around block delimiters 2025-03-10 09:58:06 -07:00
gitcli.adoc doc: clarify command equivalence comment 2025-11-04 09:25:51 -08:00
gitcore-tutorial.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitcredentials.adoc Merge branch 'mh/doc-credential-url-prefix' into maint-2.51 2025-10-15 10:29:35 -07:00
gitcvs-migration.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitdatamodel.adoc doc: remove stray text in Git data model 2025-12-03 00:17:07 -08:00
gitdiffcore.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
giteveryday.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitfaq.adoc Merge branch 'bc/doc-stash-import-export' 2026-01-16 12:40:27 -08:00
gitformat-bundle.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitformat-chunk.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitformat-commit-graph.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitformat-index.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitformat-loose.adoc docs: add documentation for loose objects 2025-10-09 17:46:14 -07:00
gitformat-pack.adoc docs: improve ambiguous areas of pack format documentation 2025-10-09 17:46:14 -07:00
gitformat-signature.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitglossary.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
githooks.adoc doc: join default pre-commit paragraphs 2025-12-08 22:20:14 +09:00
gitignore.adoc doc: document backslash in gitignore patterns 2025-10-29 09:17:21 -07:00
gitk.adoc Merge branch 'js/doc-gitk-history' into maint-2.51 2025-10-14 13:40:53 -07:00
gitmailmap.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitmodules.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitnamespaces.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitpacking.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitprotocol-capabilities.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitprotocol-common.adoc doc: add a blank line around block delimiters 2025-03-10 09:58:06 -07:00
gitprotocol-http.adoc doc: clarify server behavior for invalid 'want' lines in HTTP protocol 2025-11-06 09:45:38 -08:00
gitprotocol-pack.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitprotocol-v2.adoc promisor-remote: allow a server to advertise more fields 2025-09-08 10:30:54 -07:00
gitremote-helpers.adoc Merge branch 'bs/remote-helpers-doc-markup-fix' 2025-07-14 11:19:22 -07:00
gitrepository-layout.adoc docs: fix repository-layout when building with breaking changes 2025-03-05 07:25:11 -08:00
gitrevisions.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitsubmodules.adoc doc: check well-formedness of delimited sections 2025-08-11 14:16:03 -07:00
gittutorial-2.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gittutorial.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
gitweb.adoc doc: add a blank line around block delimiters 2025-03-10 09:58:06 -07:00
gitweb.conf.adoc doc: test linkgit macros for well-formedness 2025-08-11 14:16:03 -07:00
gitworkflows.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
glossary-content.adoc doc: add an explanation of Git's data model 2025-11-12 12:21:15 -08:00
i18n.adoc Merge branch 'bc/doc-adoc-not-txt' 2025-02-14 17:53:47 -08:00
install-doc-quick.sh
install-webdoc.sh doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
line-range-format.adoc doc: git-log: convert line range format to new doc format 2025-07-07 13:45:00 -07:00
line-range-options.adoc doc: git-log: convert line range options to new doc format 2025-07-07 13:45:00 -07:00
lint-delimited-sections.perl doc: check well-formedness of delimited sections 2025-08-11 14:16:03 -07:00
lint-documentation-style.perl doc lint: check that synopsis manpages have synopsis inlines 2025-08-11 14:16:04 -07:00
lint-fsck-msgids.perl
lint-gitlink.perl lint-gitlink: preemptively ignore all /ifn?def|endif/ macros 2026-01-21 08:26:00 -08:00
lint-man-end-blurb.perl
lint-man-section-order.perl
lint-manpages.sh doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
manpage-bold-literal.xsl
manpage-normal.xsl
manpage.xsl
merge-options.adoc doc: convert git pull to synopsis style 2025-11-19 15:00:42 -08:00
merge-strategies.adoc doc: convert merge strategies to synopsis format 2025-05-27 07:51:00 -07:00
meson.build Merge branch 'je/doc-data-model' 2025-11-30 18:31:40 -08:00
object-format-disclaimer.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
pack-refs-options.adoc doc: pack-refs: factor out common options 2025-09-19 10:02:56 -07:00
pretty-formats.adoc Merge branch 'ja/doc-markup-attached-paragraph-fix' into maint-2.51 2025-10-15 10:29:35 -07:00
pretty-options.adoc doc: do not break sentences into "lego" pieces 2025-10-05 16:10:53 -07:00
pull-fetch-param.adoc doc: pull-fetch-param typofix 2025-11-24 10:55:48 -08:00
ref-reachability-filters.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
ref-storage-format.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
rerere-options.adoc doc: convert merge options to new synopsis format 2025-05-27 07:50:59 -07:00
rev-list-description.adoc doc: git-log convert rev-list-description to new doc format 2025-07-07 13:45:00 -07:00
rev-list-options.adoc replay: drop rev-list formatting options from manual 2026-01-20 09:38:56 -08:00
revisions.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
scalar.adoc scalar: document config settings 2025-12-16 09:42:44 +09:00
sequencer.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
signoff-option.adoc signoff-option: linkify the reference to gitfaq 2025-12-19 21:51:01 +09:00
texi.xsl
trace2-target-values.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
transfer-data-leaks.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
urls-remotes.adoc doc: convert git pull to synopsis style 2025-11-19 15:00:42 -08:00
urls.adoc doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
user-manual.adoc config: drop `git_config()` wrapper 2025-07-23 08:15:18 -07:00