git/Documentation
Justin Tobler c6d896bcfd rev-list: add print-info action to print missing object path
Missing objects identified through git-rev-list(1) can be printed by
setting the `--missing=print` option. Additional information about the
missing object, such as its path and type, may be present in its
containing object.

Add the `print-info` missing action for the `--missing` option that,
when set, prints additional insight about the missing object inferred
from its containing object. Each line of output for a missing object is
in the form: `?<oid> [<token>=<value>]...`. The `<token>=<value>` pairs
containing additional information are separated from each other by a SP.
The value is encoded in a token specific fashion, but SP or LF contained
in value are always expected to be represented in such a way that the
resulting encoded value does not have either of these two problematic
bytes. This format is kept generic so it can be extended in the future
to support additional information.

For now, only a missing object path info is implemented. It follows the
form `path=<path>` and specifies the full path to the object from the
top-level tree. A path containing SP or special characters is enclosed
in double-quotes in the C style as needed. In a subsequent commit,
missing object type info will also be added.

Signed-off-by: Justin Tobler <jltobler@gmail.com>
Acked-by: Christian Couder <christian.couder@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2025-02-05 09:32:01 -08:00
..
RelNotes The seventh batch 2025-02-03 10:23:35 -08:00
config Merge branch 'ja/doc-notes-markup-updates' 2025-01-31 09:44:15 -08:00
howto meson: generate articles 2024-12-27 08:28:11 -08:00
includes
mergetools
technical Merge branch 'ds/path-walk-1' 2025-01-29 14:05:09 -08:00
.gitattributes
.gitignore Documentation: wire up sanity checks for Meson 2024-12-27 08:28:12 -08:00
BreakingChanges.txt remote: announce removal of "branches/" and "remotes/" 2025-01-24 08:08:56 -08:00
CodingGuidelines Merge branch 'ps/build' 2024-12-15 17:54:33 -08:00
DecisionMaking.txt Documentation: fix typos 2024-09-23 12:47:36 -07:00
Makefile Documentation: wire up sanity checks for Meson 2024-12-27 08:28:12 -08:00
MyFirstContribution.txt
MyFirstObjectWalk.txt
ReviewingGuidelines.txt
SubmittingPatches Merge branch 'as/gitk-git-gui-repo-update' 2024-12-28 10:11:42 -08:00
ToolsForGit.txt
asciidoc.conf.in Documentation: inline user-manual.conf 2024-12-27 08:28:10 -08:00
asciidoctor-extensions.rb.in asciidoctor-extensions.rb.in: inject GIT_DATE 2024-12-20 17:34:35 -08:00
blame-options.txt
build-docdep.perl Documentation: allow sourcing generated includes from separate dir 2024-12-07 07:52:12 +09:00
cat-texi.perl
cmd-list.perl Documentation: teach "cmd-list.perl" about out-of-tree builds 2024-12-07 07:52:12 +09:00
config.txt
date-formats.txt
diff-format.txt doc: git-diff: apply format changes to diff-format 2024-11-19 12:31:04 +09:00
diff-generate-patch.txt doc: git-diff: apply format changes to diff-generate-patch 2024-11-19 12:31:05 +09:00
diff-options.txt doc: git-diff: apply format changes to diff-options 2024-11-19 12:31:04 +09:00
doc-diff
docbook-xsl.css
docbook.xsl
docinfo-html.in
everyday.txto
fetch-options.txt doc: correct misleading descriptions for --shallow-exclude 2024-11-04 22:53:23 -08:00
fix-texi.perl
fsck-msgids.txt ref: add symlink ref content check for files backend 2024-11-21 08:21:34 +09:00
generate-mergetool-list.sh Documentation: extract script to generate a list of mergetools 2024-12-07 07:52:13 +09:00
git-add.txt doc: git-add.txt: convert to new style convention 2024-11-12 09:32:18 +09:00
git-am.txt
git-annotate.txt
git-apply.txt
git-archimport.txt
git-archive.txt
git-bisect-lk2009.txt
git-bisect.txt
git-blame.txt
git-branch.txt
git-bugreport.txt
git-bundle.txt Merge branch 'kh/doc-bundle-typofix' 2024-12-13 07:33:38 -08:00
git-cat-file.txt
git-check-attr.txt
git-check-ignore.txt
git-check-mailmap.txt
git-check-ref-format.txt
git-checkout-index.txt
git-checkout.txt checkout: refer to other-worktree branch, not ref 2024-10-10 13:09:13 -07:00
git-cherry-pick.txt
git-cherry.txt
git-citool.txt
git-clean.txt
git-clone.txt Merge branch 'bc/allow-upload-pack-from-other-people' 2024-12-10 10:04:55 +09:00
git-column.txt
git-commit-graph.txt
git-commit-tree.txt
git-commit.txt doc: make more direct explanations in git commit options 2025-01-15 14:43:36 -08:00
git-config.txt git-config.1: remove value from positional args in unset usage 2024-10-08 23:35:45 -07:00
git-count-objects.txt
git-credential-cache--daemon.txt
git-credential-cache.txt docs: discuss caching personal access tokens 2025-01-10 15:10:00 -08:00
git-credential-store.txt
git-credential.txt
git-cvsexportcommit.txt
git-cvsimport.txt
git-cvsserver.txt
git-daemon.txt
git-describe.txt
git-diagnose.txt
git-diff-files.txt
git-diff-index.txt
git-diff-tree.txt
git-diff.txt doc: git-diff: apply new documentation guidelines 2024-11-19 12:31:04 +09:00
git-difftool.txt
git-fast-export.txt
git-fast-import.txt
git-fetch-pack.txt doc: correct misleading descriptions for --shallow-exclude 2024-11-04 22:53:23 -08:00
git-fetch.txt
git-filter-branch.txt
git-fmt-merge-msg.txt
git-for-each-ref.txt
git-for-each-repo.txt
git-format-patch.txt global: Fix duplicate word typos 2024-10-21 16:05:04 -04:00
git-fsck-objects.txt
git-fsck.txt
git-fsmonitor--daemon.txt
git-gc.txt
git-get-tar-commit-id.txt
git-grep.txt
git-gui.txt
git-hash-object.txt
git-help.txt
git-hook.txt
git-http-backend.txt
git-http-fetch.txt
git-http-push.txt
git-imap-send.txt
git-index-pack.txt index-pack: teach --promisor to forbid pack name 2024-11-20 10:37:56 +09:00
git-init-db.txt
git-init.txt doc: apply synopsis simplification on git-clone and git-init 2024-09-24 10:20:26 -07:00
git-instaweb.txt
git-interpret-trailers.txt
git-log.txt
git-ls-files.txt
git-ls-remote.txt transport.c:🤝 make use of server options from remote 2024-10-08 10:22:08 -07:00
git-ls-tree.txt
git-mailinfo.txt
git-mailsplit.txt
git-maintenance.txt doc: add a note about staggering of maintenance 2024-10-03 11:23:09 -07:00
git-merge-base.txt
git-merge-file.txt
git-merge-index.txt
git-merge-one-file.txt
git-merge-tree.txt doc: merge-tree: improve example script 2024-10-09 10:40:42 -07:00
git-merge.txt
git-mergetool--lib.txt
git-mergetool.txt
git-mktag.txt
git-mktree.txt
git-multi-pack-index.txt
git-mv.txt
git-name-rev.txt
git-notes.txt doc: convert git-notes to new documentation format 2025-01-10 15:19:52 -08:00
git-p4.txt
git-pack-objects.txt
git-pack-redundant.txt
git-pack-refs.txt
git-patch-id.txt
git-prune-packed.txt
git-prune.txt
git-pull.txt
git-push.txt
git-quiltimport.txt
git-range-diff.txt range-diff: introduce the convenience option `--remerge-diff` 2024-12-16 08:45:48 -08:00
git-read-tree.txt
git-rebase.txt
git-receive-pack.txt
git-reflog.txt
git-refs.txt refs: add support for migrating reflogs 2024-12-16 09:45:34 -08:00
git-remote-ext.txt
git-remote-fd.txt
git-remote-helpers.txto
git-remote.txt
git-repack.txt
git-replace.txt
git-replay.txt
git-request-pull.txt
git-rerere.txt
git-reset.txt
git-restore.txt doc: convert git-restore to new style format 2025-01-10 15:21:21 -08:00
git-rev-list.txt
git-rev-parse.txt
git-revert.txt
git-rm.txt
git-send-email.txt send-email: document --mailmap and associated configuration 2024-09-25 08:58:38 -07:00
git-send-pack.txt
git-sh-i18n--envsubst.txt
git-sh-i18n.txt
git-sh-setup.txt
git-shell.txt
git-shortlog.txt
git-show-branch.txt
git-show-index.txt show-index: the short help should say the command reads from its input 2024-12-20 17:30:57 -08:00
git-show-ref.txt
git-show.txt
git-sparse-checkout.txt
git-stage.txt
git-stash.txt
git-status.txt
git-stripspace.txt
git-submodule.txt
git-svn.txt
git-switch.txt
git-symbolic-ref.txt Documentation: mutually link update-ref and symbolic-ref 2024-10-21 16:49:31 -04:00
git-tag.txt
git-tools.txt
git-unpack-file.txt
git-unpack-objects.txt
git-update-index.txt
git-update-ref.txt Merge branch 'kh/doc-update-ref-grammofix' 2024-12-13 07:33:39 -08:00
git-update-server-info.txt
git-upload-archive.txt
git-upload-pack.txt
git-var.txt
git-verify-commit.txt
git-verify-pack.txt
git-verify-tag.txt
git-version.txt
git-web--browse.txt
git-whatchanged.txt
git-worktree.txt worktree: add relative cli/config options to `repair` command 2024-12-02 09:36:17 +09:00
git-write-tree.txt
git.txt Merge branch 'mh/doc-windows-home-env' 2025-01-06 08:23:29 -08:00
gitattributes.txt docs: fix typesetting of merge driver placeholders 2025-01-07 15:11:36 -08:00
gitcli.txt Merge branch 'jc/cli-doc-option-and-config' 2025-01-23 15:07:02 -08:00
gitcore-tutorial.txt
gitcredentials.txt docs: list popular credential helpers 2025-01-10 15:10:00 -08:00
gitcvs-migration.txt
gitdiffcore.txt
giteveryday.txt
gitfaq.txt
gitformat-bundle.txt
gitformat-chunk.txt
gitformat-commit-graph.txt Documentation: fix typos 2024-09-23 12:47:36 -07:00
gitformat-index.txt
gitformat-pack.txt
gitformat-signature.txt
gitglossary.txt
githooks.txt
gitignore.txt
gitk.txt
gitmailmap.txt
gitmodules.txt
gitnamespaces.txt
gitpacking.txt
gitprotocol-capabilities.txt
gitprotocol-common.txt
gitprotocol-http.txt
gitprotocol-pack.txt
gitprotocol-v2.txt Merge branch 'xx/protocol-v2-doc-markup-fix' into maint-2.47 2024-11-25 12:29:47 +09:00
gitremote-helpers.txt
gitrepository-layout.txt remote: announce removal of "branches/" and "remotes/" 2025-01-24 08:08:56 -08:00
gitrevisions.txt
gitsubmodules.txt
gittutorial-2.txt
gittutorial.txt
gitweb.conf.txt
gitweb.txt Documentation: fix typos 2024-09-23 12:47:36 -07:00
gitworkflows.txt
glossary-content.txt Documentation/glossary: describe "trailer" 2024-11-18 09:41:24 +09:00
i18n.txt doc: migrate git-commit manpage secondary files to new format 2025-01-15 14:43:36 -08:00
install-doc-quick.sh
install-webdoc.sh
line-range-format.txt
line-range-options.txt
lint-fsck-msgids.perl
lint-gitlink.perl
lint-man-end-blurb.perl
lint-man-section-order.perl
lint-manpages.sh
manpage-bold-literal.xsl
manpage-normal.xsl
manpage.xsl
merge-options.txt
merge-strategies.txt
meson.build Documentation: wire up sanity checks for Meson 2024-12-27 08:28:12 -08:00
object-format-disclaimer.txt
pretty-formats.txt
pretty-options.txt
pull-fetch-param.txt doc: clarify <src> in refspec syntax 2024-10-09 16:59:01 -07:00
ref-reachability-filters.txt
ref-storage-format.txt
rerere-options.txt
rev-list-description.txt
rev-list-options.txt rev-list: add print-info action to print missing object path 2025-02-05 09:32:01 -08:00
revisions.txt
scalar.txt
sequencer.txt
signoff-option.txt doc: migrate git-commit manpage secondary files to new format 2025-01-15 14:43:36 -08:00
texi.xsl
trace2-target-values.txt
transfer-data-leaks.txt
urls-remotes.txt
urls.txt doc: apply synopsis simplification on git-clone and git-init 2024-09-24 10:20:26 -07:00
user-manual.txt