{"thread":{"id":"12292","subject":"[PATCH 0/3] Enhancements to the bundle documentation","startedAt":"2008-02-24T13:41:14Z","lastAt":"2008-02-24T13:42:40Z","messageCount":4,"participants":["Santi Béjar"],"isPatch":true,"patchVersion":1,"patchTotal":3},"messages":[{"id":"69786","messageId":"1203860474-12291-1-git-send-email-sbejar@gmail.com","threadId":"12292","inReplyTo":null,"subject":"[PATCH 0/3] Enhancements to the bundle documentation","fromName":"Santi Béjar","fromEmail":"sbejar@gmail.com","sentAt":"2008-02-24T13:41:14Z","receivedAt":"2008-02-24T13:41:14Z","isPatch":true,"sender":{"key":"santi@agolina.net","avatar":null},"body":"At the end the most convenient way to work with bundles (at least for me) is\njust:\n\n$ git bundle create mybundle HEAD --since=2.weeks.ago\n\nor:\n\n[alias]\n\tbpush = bundle create bundle --since=2.weeks.ago\n\n$ git bpush HEAD\n\nThe bundles are bigger than strictly necessary, but not that much.\n\nSanti\n\nSanti BÃ©jar (3):\n      urls.txt: Add bundles to the list of local urls.\n      git-bundle.txt: Bundles as [remote \"\"] is a feature, not an example\n      git-bundle.txt: Add different strategies to create the bundle\n\n Documentation/git-bundle.txt |   66 +++++++++++++++++++++++++++++------------\n Documentation/urls.txt       |    5 ++-\n 2 files changed, 49 insertions(+), 22 deletions(-)\n"},{"id":"69787","messageId":"1203860521-12333-1-git-send-email-sbejar@gmail.com","threadId":"12292","inReplyTo":"1203860474-12291-1-git-send-email-sbejar@gmail.com","subject":"[PATCH 1/3] urls.txt: Add bundles to the list of local urls.","fromName":"Santi Béjar","fromEmail":"sbejar@gmail.com","sentAt":"2008-02-24T13:42:01Z","receivedAt":"2008-02-24T13:42:01Z","isPatch":true,"sender":{"key":"santi@agolina.net","avatar":null},"body":"\nSigned-off-by: Santi Béjar <sbejar@gmail.com>\n---\n Documentation/urls.txt |    5 +++--\n 1 files changed, 3 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/urls.txt b/Documentation/urls.txt\nindex 81ac17f..894bb46 100644\n--- a/Documentation/urls.txt\n+++ b/Documentation/urls.txt\n@@ -34,13 +34,14 @@ To sync with a local directory, you can use:\n ===============================================================\n - /path/to/repo.git/\n - file:///path/to/repo.git/\n+- /path/to/bundle\n ===============================================================\n \n ifndef::git-clone[]\n-They are mostly equivalent, except when cloning.  See\n+The first two are mostly equivalent, except when cloning.  See\n linkgit:git-clone[1] for details.\n endif::git-clone[]\n \n ifdef::git-clone[]\n-They are equivalent, except the former implies --local option.\n+The first two are equivalent, except the former implies --local option.\n endif::git-clone[]\n-- \n1.5.4.3.293.gac81\n"},{"id":"69788","messageId":"1203860541-12365-1-git-send-email-sbejar@gmail.com","threadId":"12292","inReplyTo":"1203860474-12291-1-git-send-email-sbejar@gmail.com","subject":"[PATCH 2/3] git-bundle.txt: Bundles as [remote \"\"] is a feature, not an example","fromName":"Santi Béjar","fromEmail":"sbejar@gmail.com","sentAt":"2008-02-24T13:42:21Z","receivedAt":"2008-02-24T13:42:21Z","isPatch":true,"sender":{"key":"santi@agolina.net","avatar":null},"body":"\nSigned-off-by: Santi Béjar <sbejar@gmail.com>\n---\n Documentation/git-bundle.txt |   38 ++++++++++++++++++++------------------\n 1 files changed, 20 insertions(+), 18 deletions(-)\n\ndiff --git a/Documentation/git-bundle.txt b/Documentation/git-bundle.txt\nindex 72f080a..1143cdc 100644\n--- a/Documentation/git-bundle.txt\n+++ b/Documentation/git-bundle.txt\n@@ -92,6 +92,26 @@ It is okay to err on the side of conservatism, causing the bundle file\n to contain objects already in the destination as these are ignored\n when unpacking at the destination.\n \n+REMOTES\n+-------\n+\n+With something like this in your config:\n+\n+[remote \"bundle\"]\n+    url = /path/to/file.bdl\n+    fetch = refs/heads/*:refs/remotes/bundle/*\n+\n+You can place a bundle in /path/to/file.bdl and then these commands:\n+\n+------------\n+$ git ls-remote bundle\n+$ git fetch bundle\n+$ git pull bundle\n+------------\n+\n+would treat it as if it is talking with a remote side over the\n+network.\n+\n EXAMPLE\n -------\n \n@@ -121,24 +141,6 @@ $ git-fetch mybundle  refspec\n where refspec is refInBundle:localRef\n \n \n-Also, with something like this in your config:\n-\n-[remote \"bundle\"]\n-    url = /home/me/tmp/file.bdl\n-    fetch = refs/heads/*:refs/remotes/origin/*\n-\n-You can first sneakernet the bundle file to ~/tmp/file.bdl and\n-then these commands:\n-\n-------------\n-$ git ls-remote bundle\n-$ git fetch bundle\n-$ git pull bundle\n-------------\n-\n-would treat it as if it is talking with a remote side over the\n-network.\n-\n Author\n ------\n Written by Mark Levedahl <mdl123@verizon.net>\n-- \n1.5.4.3.293.gac81\n"},{"id":"69789","messageId":"1203860560-12399-1-git-send-email-sbejar@gmail.com","threadId":"12292","inReplyTo":"1203860474-12291-1-git-send-email-sbejar@gmail.com","subject":"[PATCH 3/3] git-bundle.txt: Add different strategies to create the bundle","fromName":"Santi Béjar","fromEmail":"sbejar@gmail.com","sentAt":"2008-02-24T13:42:40Z","receivedAt":"2008-02-24T13:42:40Z","isPatch":true,"sender":{"key":"santi@agolina.net","avatar":null},"body":"\nSigned-off-by: Santi Béjar <sbejar@gmail.com>\n---\n Documentation/git-bundle.txt |   38 +++++++++++++++++++++++++++++++-------\n 1 files changed, 31 insertions(+), 7 deletions(-)\n\ndiff --git a/Documentation/git-bundle.txt b/Documentation/git-bundle.txt\nindex 1143cdc..be6c7d9 100644\n--- a/Documentation/git-bundle.txt\n+++ b/Documentation/git-bundle.txt\n@@ -119,27 +119,51 @@ Assume two repositories exist as R1 on machine A, and R2 on machine B.\n For whatever reason, direct connection between A and B is not allowed,\n but we can move data from A to B via some mechanism (CD, email, etc).\n We want to update R2 with developments made on branch master in R1.\n+\n+To create the bundle you have to specify the basis. You have some options:\n+\n+- Without basis.\n++\n+This is usefull to send the whole history.\n+\n+------------\n+$ git bundle create mybundle master\n+------------\n+\n+- Using temporally tags.\n++\n We set a tag in R1 (lastR2bundle) after the previous such transport,\n and move it afterwards to help build the bundle.\n \n-in R1 on A:\n-\n ------------\n $ git-bundle create mybundle master ^lastR2bundle\n $ git tag -f lastR2bundle master\n ------------\n \n-(move mybundle from A to B by some mechanism)\n+- Using a tag present in both repositories\n+\n+------------\n+$ git bundle create mybundle master ^v1.0.0\n+------------\n+\n+- A basis based on time.\n+\n+------------\n+$ git bundle create mybundle master --since=10.days.ago\n+------------\n \n-in R2 on B:\n+- With a limit on the number of commits\n \n ------------\n-$ git-bundle verify mybundle\n-$ git-fetch mybundle  refspec\n+$ git bundle create mybundle master -n 10\n ------------\n \n-where refspec is refInBundle:localRef\n+Then you move mybundle from A to B, and in R2 on B:\n \n+------------\n+$ git-bundle verify mybundle\n+$ git-fetch mybundle master:localRef\n+------------\n \n Author\n ------\n-- \n1.5.4.3.293.gac81\n"}]}