mirror of
https://github.com/git/git
synced 2024-08-25 10:45:59 +00:00
show-index: update documentation for index v2
Commit 32637cdf4a
(show-index.c: learn about index v2,
2007-04-09) changed the output format of show-index to
include the object CRC32 but didn't update the
documentation. Let's fix that and generally describe the
output in more detail.
There are a few other fixes here while we're rewording:
- refer to index-pack along with pack-objects, since either
can create .idx files
- use "linkgit:" for referring to other commands
- expand the bit about verify-pack, giving reasons why you
might want this command instead. I almost omitted this
entirely, but referring to verify-pack might help a
reader who is looking for more information.
Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
parent
ff417260cf
commit
fb3010c31f
|
@ -14,13 +14,27 @@ SYNOPSIS
|
||||||
|
|
||||||
DESCRIPTION
|
DESCRIPTION
|
||||||
-----------
|
-----------
|
||||||
Read the idx file for a Git packfile created with
|
Read the `.idx` file for a Git packfile (created with
|
||||||
'git pack-objects' command from the standard input, and
|
linkgit:git-pack-objects[1] or linkgit:git-index-pack[1]) from the
|
||||||
dump its contents.
|
standard input, and dump its contents. The output consists of one object
|
||||||
|
per line, with each line containing two or three space-separated
|
||||||
|
columns:
|
||||||
|
|
||||||
The information it outputs is subset of what you can get from
|
- the first column is the offset in bytes of the object within the
|
||||||
'git verify-pack -v'; this command only shows the packfile
|
corresponding packfile
|
||||||
offset and SHA-1 of each object.
|
|
||||||
|
- the second column is the object id of the object
|
||||||
|
|
||||||
|
- if the index version is 2 or higher, the third column contains the
|
||||||
|
CRC32 of the object data
|
||||||
|
|
||||||
|
The objects are output in the order in which they are found in the index
|
||||||
|
file, which should be (in a correctly constructed file) sorted by object
|
||||||
|
id.
|
||||||
|
|
||||||
|
Note that you can get more information on a packfile by calling
|
||||||
|
linkgit:git-verify-pack[1]. However, as this command considers only the
|
||||||
|
index file itself, it's both faster and more flexible.
|
||||||
|
|
||||||
GIT
|
GIT
|
||||||
---
|
---
|
||||||
|
|
Loading…
Reference in a new issue