# [PATCH] git-pack-objects.txt: Make wording slightly less ambiguous 2 messages from 2008-04-05 to 2008-04-06. Participants: Peter Eriksen, Shawn O. Pearce. Thread: https://gitlist.dev/t/12997 ## Peter Eriksen, 2008-04-05 19:46 Subject: [PATCH] git-pack-objects.txt: Make wording slightly less ambiguous Message-ID: <20080405194649.GA248@bohr.gbar.dtu.dk> URL: https://gitlist.dev/e/20080405194649.GA248%40bohr.gbar.dtu.dk ``` It is a bit confusing on first read, that "The packed archive format (.pack) is designed to be unpackable..." Signed-off-by: Peter Eriksen --- Documentation/git-pack-objects.txt | 5 +++-- 1 files changed, 3 insertions(+), 2 deletions(-) diff --git a/Documentation/git-pack-objects.txt b/Documentation/git-pack-objects.txt index eed0a94..3a1be08 100644 --- a/Documentation/git-pack-objects.txt +++ b/Documentation/git-pack-objects.txt @@ -22,8 +22,9 @@ archive with specified base-name, or to the standard output. A packed archive is an efficient way to transfer set of objects between two repositories, and also is an archival format which is efficient to access. The packed archive format (.pack) is -designed to be unpackable without having anything else, but for -random access, accompanied with the pack index file (.idx). +designed to be self contained so that it can be unpacked without +any further information, but for fast, random access to the objects +in the pack, a pack index file (.idx) will be generated. Placing both in the pack/ subdirectory of $GIT_OBJECT_DIRECTORY (or any of the directories on $GIT_ALTERNATE_OBJECT_DIRECTORIES) -- 1.5.5-rc3.GIT ``` ## Shawn O. Pearce, 2008-04-06 04:35 Subject: Re: [PATCH] git-pack-objects.txt: Make wording slightly less ambiguous Message-ID: <20080406043513.GZ10274@spearce.org> URL: https://gitlist.dev/e/20080406043513.GZ10274%40spearce.org In-Reply-To: <20080405194649.GA248@bohr.gbar.dtu.dk> ``` Peter Eriksen wrote: > It is a bit confusing on first read, that > > "The packed archive format (.pack) is designed > to be unpackable..." > > Signed-off-by: Peter Eriksen Yea, this is a good improvement in readability. I can't even make sense out of the old language, and I know how this works. :-) > diff --git a/Documentation/git-pack-objects.txt b/Documentation/git-pack-objects.txt > index eed0a94..3a1be08 100644 > --- a/Documentation/git-pack-objects.txt > +++ b/Documentation/git-pack-objects.txt > @@ -22,8 +22,9 @@ archive with specified base-name, or to the standard output. > A packed archive is an efficient way to transfer set of objects > between two repositories, and also is an archival format which > is efficient to access. The packed archive format (.pack) is > -designed to be unpackable without having anything else, but for > -random access, accompanied with the pack index file (.idx). > +designed to be self contained so that it can be unpacked without > +any further information, but for fast, random access to the objects > +in the pack, a pack index file (.idx) will be generated. > > Placing both in the pack/ subdirectory of $GIT_OBJECT_DIRECTORY (or > any of the directories on $GIT_ALTERNATE_OBJECT_DIRECTORIES) -- Shawn. ```