]> git.ipfire.org Git - thirdparty/git.git/commitdiff
Merge branch 'vd/doc-unpack-objects' into maint
authorJunio C Hamano <gitster@pobox.com>
Thu, 7 Nov 2013 22:37:35 +0000 (14:37 -0800)
committerJunio C Hamano <gitster@pobox.com>
Thu, 7 Nov 2013 22:37:36 +0000 (14:37 -0800)
The synopsis section of "git unpack-objects" documentation has been
clarified a bit.

* vd/doc-unpack-objects:
  Documentation: "pack-file" is not literal in unpack-objects
  Documentation: restore a space in unpack-objects usage

1  2 
Documentation/git-unpack-objects.txt

index ff23494e7013c5d491c7a7e2642ec30133906aac,6b94df39b6c57545572259060807429e2c3cb45b..12cb108b8561a6365192a65688d116901468decf
@@@ -1,49 -1,39 +1,49 @@@
  git-unpack-objects(1)
  =====================
 -v0.1, July 2005
  
  NAME
  ----
 -git-unpack-objects - Unpack objects from a packed archive.
 +git-unpack-objects - Unpack objects from a packed archive
  
  
  SYNOPSIS
  --------
 -'git-unpack-objects' [-q] < <pack-file>
 +[verse]
- 'git unpack-objects' [-n] [-q] [-r] [--strict] <pack-file
++'git unpack-objects' [-n] [-q] [-r] [--strict] < <pack-file>
  
  
  DESCRIPTION
  -----------
 -Reads a packed archive (.pack) from the standard input, and
 -expands the objects contained in the pack into "one-file
 -one-object" format in $GIT_OBJECT_DIRECTORY.
 +Read a packed archive (.pack) from the standard input, expanding
 +the objects contained within and writing them into the repository in
 +"loose" (one object per file) format.
 +
 +Objects that already exist in the repository will *not* be unpacked
 +from the pack-file.  Therefore, nothing will be unpacked if you use
 +this command on a pack-file that exists within the target repository.
 +
 +See linkgit:git-repack[1] for options to generate
 +new packs and replace existing ones.
  
  OPTIONS
  -------
 +-n::
 +        Dry run.  Check the pack file without actually unpacking
 +      the objects.
 +
  -q::
        The command usually shows percentage progress.  This
        flag suppresses it.
  
 +-r::
 +      When unpacking a corrupt packfile, the command dies at
 +      the first corruption.  This flag tells it to keep going
 +      and make the best effort to recover as many objects as
 +      possible.
  
 -Author
 -------
 -Written by Linus Torvalds <torvalds@osdl.org>
 -
 -Documentation
 --------------
 -Documentation by Junio C Hamano
 +--strict::
 +      Don't write objects with broken content or links.
  
  GIT
  ---
 -Part of the link:git.html[git] suite
 -
 +Part of the linkgit:git[1] suite