threads / patch / 12997

patchgit-pack-objects.txt: Make wording slightly less ambiguous

Subject: [PATCH] git-pack-objects.txt: Make wording slightly less ambiguous

## tl;dr

2 messages between Apr 5, 2008 and Apr 6, 2008. Diffs are folded; open one to read it.

replies: 1people: 2as markdown or json

Peter Eriksen· Apr 5, 2008, 19:46 UTC · lore
It is a bit confusing on first read, that
        "The packed archive format (.pack) is designed
        to be unpackable..."
Signed-off-by: Peter Eriksen <s022018@student.dtu.dk>
---
 Documentation/git-pack-objects.txt |    5 +++--
 1 files changed, 3 insertions(+), 2 deletions(-)
Show changes to Documentation/git-pack-objects.txt +3 −2
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· Apr 6, 2008, 04:35 UTC · re: Peter Eriksen · lore

Re: [PATCH] git-pack-objects.txt: Make wording slightly less ambiguous

Peter Eriksen <s022018@student.dtu.dk> wrote:
Show 6 quoted lines
> It is a bit confusing on first read, that
> 
>         "The packed archive format (.pack) is designed
>         to be unpackable..."
> 
> Signed-off-by: Peter Eriksen <s022018@student.dtu.dk>

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.

:-)
Show 16 quoted lines
> 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.

← back to recent threads