{"thread":{"id":"11700","subject":"[PATCH/RFC] pack-objects documentation and usage update","startedAt":"2008-01-22T08:03:05Z","lastAt":"2008-01-22T08:03:05Z","messageCount":1,"participants":["Johannes Sixt"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"66287","messageId":"4795A339.40103@viscovery.net","threadId":"11700","inReplyTo":null,"subject":"[PATCH/RFC] pack-objects documentation and usage update","fromName":"Johannes Sixt","fromEmail":"j.sixt@viscovery.net","sentAt":"2008-01-22T08:03:05Z","receivedAt":"2008-01-22T08:03:05Z","isPatch":true,"sender":{"key":"j6t@kdbg.org","avatar":"https://avatars.githubusercontent.com/u/14810926?v=4"},"body":"With the previous ordering in the short usage help it was difficult to\nspot that either a base-name or --stdout must be specified. Some\npunctuation is dropped because it is more hindrance than help.\n\nThe documentation of --reflog is added and the synopsis updated to include\nall options that pack-objects understands.\n\nSigned-off-by: Johannes Sixt <johannes.sixt@telecom.at>\n---\nSince this patch does not fill in the missing documentation of\n--keep-unreachable, I marked it as RFC.\n\n08cdfb13374 says about --keep-unreachable:\n\n    This new option is meant to be used in conjunction with the\n    options \"git repack -a -d\" usually invokes the underlying\n    pack-objects with.  When this option is given, objects unreachable\n    from the refs in packs named with --unpacked= option are added\n    to the resulting pack, in addition to the reachable objects that\n    are not in packs marked with *.keep files.\n\nbut this sentence is too complicated for my small brain.\n\n-- Hannes\n\n Documentation/git-pack-objects.txt |   15 ++++++++++++---\n builtin-pack-objects.c             |    4 ++--\n 2 files changed, 14 insertions(+), 5 deletions(-)\n\ndiff --git a/Documentation/git-pack-objects.txt b/Documentation/git-pack-objects.txt\nindex 74cc7c1..6a3ddc9 100644\n--- a/Documentation/git-pack-objects.txt\n+++ b/Documentation/git-pack-objects.txt\n@@ -9,9 +9,13 @@ git-pack-objects - Create a packed archive of objects\n SYNOPSIS\n --------\n [verse]\n-'git-pack-objects' [-q] [--no-reuse-delta] [--delta-base-offset] [--non-empty]\n-\t[--local] [--incremental] [--window=N] [--depth=N] [--all-progress]\n-\t[--revs [--unpacked | --all]*] [--stdout | base-name] < object-list\n+'git-pack-objects' [-q | --progress | --all-progress]\n+        [--max-pack-size=N] [--local] [--incremental]\n+        [--window=N] [--window-memory=N] [--depth=N]\n+        [--no-reuse-delta] [--no-reuse-object] [--delta-base-offset]\n+        [--threads=N] [--non-empty] [--revs [--unpacked | --all]*] [--reflog]\n+        [--keep-unreachable] --stdout | base-name < ref-or-object-list\n+\n\n\n DESCRIPTION\n@@ -73,6 +77,11 @@ base-name::\n \tas if all refs under `$GIT_DIR/refs` are specified to be\n \tincluded.\n\n+--reflog::\n+\tThis implies `--revs`. In addition to the objects reachable\n+\tfrom the revision arguments, pack also those objects that\n+\tare reachable from those revisions' reflogs.\n+\n --window=[N], --depth=[N]::\n \tThese two options affect how the objects contained in\n \tthe pack are stored using delta compression.  The\ndiff --git a/builtin-pack-objects.c b/builtin-pack-objects.c\nindex ec10238..cd7a272 100644\n--- a/builtin-pack-objects.c\n+++ b/builtin-pack-objects.c\n@@ -20,12 +20,12 @@\n #endif\n\n static const char pack_usage[] = \"\\\n-git-pack-objects [{ -q | --progress | --all-progress }] \\n\\\n+git-pack-objects [-q | --progress | --all-progress] \\n\\\n \t[--max-pack-size=N] [--local] [--incremental] \\n\\\n \t[--window=N] [--window-memory=N] [--depth=N] \\n\\\n \t[--no-reuse-delta] [--no-reuse-object] [--delta-base-offset] \\n\\\n \t[--threads=N] [--non-empty] [--revs [--unpacked | --all]*] [--reflog] \\n\\\n-\t[--stdout | base-name] [--keep-unreachable] [<ref-list | <object-list]\";\n+\t[--keep-unreachable] --stdout | base-name < ref-or-object-list\";\n\n struct object_entry {\n \tstruct pack_idx_entry idx;\n-- \n1.5.4.rc3.24.g25a9a\n"}]}