From patchwork Sat Nov 16 14:54:51 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Kristoffer Haugsbakk X-Patchwork-Id: 13877612 Received: from fhigh-a8-smtp.messagingengine.com (fhigh-a8-smtp.messagingengine.com [103.168.172.159]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 542AAEAF1 for ; Sat, 16 Nov 2024 14:55:59 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.159 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1731768961; cv=none; b=s9+Avod68TQF50U6N4Fo/Su9u3dW6+Z1M6iPV6kcKrx1J570MSC68ETAqq8IVi/oWUbdzZgfSOi8mjmSZe1OuqKAZQkA8YHc5eQJdib0R1t8XZE8twO3C3B9aUvwQaLy7NEHJbMYUkZ16VMGSg/FLI3fxy/P93h4MKvZ/5X2+LU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1731768961; c=relaxed/simple; bh=m72Fhd0LYMNJOuTcl+0EkOMBgCbpdTum1NXiOJH/YQw=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=aiSaZJQgT5nHpBSoRZVorr9y/37d8Eq2Qpipv4WxaqaXw03mQ53JaxSXdShsim2kPbe8IL5vw6r4ag0oMwD7rEKoXm5Vaq8US/If63CvjoD5yhcTg10MPIU2XpniZ6dXlBU3xHZDSy1KttYjtSqkZDYSHctCSTE/XrfpnGo3vG0= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=fastmail.com; spf=pass smtp.mailfrom=fastmail.com; dkim=pass (2048-bit key) header.d=fastmail.com header.i=@fastmail.com header.b=SGVPs5hz; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=EF1GqJHV; arc=none smtp.client-ip=103.168.172.159 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=fastmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=fastmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=fastmail.com header.i=@fastmail.com header.b="SGVPs5hz"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="EF1GqJHV" Received: from phl-compute-02.internal (phl-compute-02.phl.internal [10.202.2.42]) by mailfhigh.phl.internal (Postfix) with ESMTP id 6E47E1140085; Sat, 16 Nov 2024 09:55:58 -0500 (EST) Received: from phl-mailfrontend-01 ([10.202.2.162]) by phl-compute-02.internal (MEProxy); Sat, 16 Nov 2024 09:55:58 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.com; h= cc:cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm3; t=1731768958; x=1731855358; bh=rvlI4qdIhflD+LAhup2n+PNiUEpki9MCcIjxcE4x94c=; b= SGVPs5hzhYUNPcQnkjkGswcRvIQM0TcKh2ExBC3H1ubP6p7zU1YAA7Lyd0x3w4yH 2TqObNgf6vU1iRfkuDeL7S9AkqPFlQCyv7TQVr02lDC4Zra2YLWRPxSaHITKNMvS 9pe2tZvnzHB2c1JyYTZk54Zh2I3TnYGBvjeTuoAWtNzgBMfGkyKodrhE8qd3+PQA cCWtuN3xz2ewD0yByMqHmMwWBNVRUEXPiX3nT9WHE0svoURNbNfKMsrYBhEZLZsd vmUTJrLzxocybUnYumSpWbeksIqVl+B2MbWJWvQo5WsNCpDsXfxjYv9Aoz0eWQrL NiT5sfyDcLhLwX+5boncOQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1731768958; x= 1731855358; bh=rvlI4qdIhflD+LAhup2n+PNiUEpki9MCcIjxcE4x94c=; b=E F1GqJHVuz6/7Z6BvnYHB1A9fniuxU3Jd6lAJXxhgG3yY8A1MxMe5CsYzvfDJtkzE KVNo/87ktuu628fTOO60FZt/LlLD7H3GEk1CI4Ow9L7uuAW6u+VqGNaZjnTmLxGx fSL1Q5z75tmc/4VKmLJX+sNPXzbq6BUFLJ0vk3bUHp0tj3LxePyLnAAMgrVyW8lm dDXdls9LYx92Kl5aMYmOJvLmUZoIF5JofM+eYDNB+712GYV+wj214ATOfVeI5zjv h6WJNAh1KfryAknYJlBeManpBuILjh7YXy7jMfh0LdOlBqUBKjZxH4kRMTcHJyEN 8Gk++qKkFg1ErzgLXhfiA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefuddrvdeigdeijecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdpuffr tefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvvefuff fkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhhrghu ghhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpedtffdthf elieevgfethfdvffetffejfeejteetjeelveetgedtffdtgfehuddvffenucffohhmrghi nhepshhtrggtkhhovhgvrhhflhhofidrtghomhdpkhgvrhhnvghlrdhorhhgpdgtrghnrg hlshhoohhpvghrrghtvghonhgsuhhnughlvghfihhlvghsrdhithenucevlhhushhtvghr ufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehkrhhishhtohhffhgvrhhhrg hughhssggrkhhksehfrghsthhmrghilhdrtghomhdpnhgspghrtghpthhtohephedpmhho uggvpehsmhhtphhouhhtpdhrtghpthhtohepghhithesvhhgvghrrdhkvghrnhgvlhdroh hrghdprhgtphhtthhopegtohguvgeskhhhrghughhssggrkhhkrdhnrghmvgdprhgtphht thhopegrvhgrrhgrsgesghhmrghilhdrtghomhdprhgtphhtthhopehmvgesthhtrgihlh horhhrrdgtohhmpdhrtghpthhtohepghhithhsthgvrhesphhosghogidrtghomh X-ME-Proxy: Feedback-ID: i8b11424c:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sat, 16 Nov 2024 09:55:56 -0500 (EST) From: kristofferhaugsbakk@fastmail.com To: git@vger.kernel.org Cc: Kristoffer Haugsbakk , avarab@gmail.com, me@ttaylorr.com, gitster@pobox.com Subject: [PATCH v4 1/4] Documentation/git-bundle.txt: mention full backup example Date: Sat, 16 Nov 2024 15:54:51 +0100 Message-ID: <5121edfee674aaa44d047c16040c39bdbe7dae30.1731768344.git.code@khaugsbakk.name> X-Mailer: git-send-email 2.47.0.317.g7d2562b9734 In-Reply-To: References: Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 From: Kristoffer Haugsbakk Provide an example about how to make a “full backup” with caveats about what that means in this case. This is a requested use-case.[1] But the doc is a bit unassuming about it: If you want to match `git clone --mirror`, which would include your refs such as `refs/remotes/*`, use `--all`. The user cannot be expected to formulate “I want a full backup” as “I want to match `git clone --mirror`” for a bundle file or something. Let’s drop this mention of `--all` later in the doc and frontload it. † 1: E.g.: • https://stackoverflow.com/questions/5578270/fully-backup-a-git-repo • https://stackoverflow.com/questions/11792671/how-to-git-bundle-a-complete-repo Helped-by: Junio C Hamano Signed-off-by: Kristoffer Haugsbakk --- Notes (series): v4: • Drop the part about `refs/stash` since that is wrong. What we want to communicate is that the state of the stash is not transferred since git-clone(1) does not include the reflogs. We can just lump that in with the existin list of the index, working tree, … etc. Link: https://lore.kernel.org/git/xmqqh68c3vr8.fsf@gitster.g/ • Add para. describing how to recover the backup Link: https://lore.kernel.org/git/xmqq1pzmqy97.fsf@gitster.g/ • Correct tense: “transferring” v3: • Elaborate on “full backups” in Examples instead • Just point to the section in the second paragraph where everything is elaborated • Incorporate some of Junio’s suggestions: • Mention what the “full backup” here does not include Link: https://lore.kernel.org/git/xmqqh68q1l37.fsf@gitster.g/ Link: https://lore.kernel.org/git/xmqqzfmiza69.fsf@gitster.g/#t • Remove the final paragraph pointing to Examples now that we mention it in the second paragraph v2: • Mention as a parenthetical on an existing paragraph (don’t create a new sentence and paragraph) • Remove the “mirror” mention Link (both): https://lore.kernel.org/git/ZxbIWEGS1UB3UIg+@nand.local/ Notes (meta-trailers): Helped-by: Junio C Hamano Link: https://lore.kernel.org/git/xmqqzfmiza69.fsf@gitster.g/ Documentation/git-bundle.txt | 37 ++++++++++++++++++++++++++++++------ 1 file changed, 31 insertions(+), 6 deletions(-) diff --git a/Documentation/git-bundle.txt b/Documentation/git-bundle.txt index 3ab42a19cae..b9eb9cef2f8 100644 --- a/Documentation/git-bundle.txt +++ b/Documentation/git-bundle.txt @@ -23,8 +23,9 @@ the "offline" transfer of Git objects without an active "server" sitting on the other side of the network connection. They can be used to create both incremental and full backups of a -repository, and to relay the state of the references in one repository -to another. +repository (see the "full backup" example in "EXAMPLES"), and to relay +the state of the references in one repository to another (see the second +example). Git commands that fetch or otherwise "read" via protocols such as `ssh://` and `https://` can also operate on bundle files. It is @@ -34,8 +35,6 @@ contained within it with linkgit:git-ls-remote[1]. There's no corresponding "write" support, i.e.a 'git push' into a bundle is not supported. -See the "EXAMPLES" section below for examples of how to use bundles. - BUNDLE FORMAT ------------- @@ -216,8 +215,34 @@ bundle. EXAMPLES -------- -Assume you want to transfer the history from a repository R1 on machine A -to another repository R2 on machine B. +We'll discuss two cases: + +1. Taking a full backup of a repository +2. Transferring the history of a repository to another machine when the + two machines have no direct connection + +First let's consider a full backup of the repository. The following +command will take a full backup of the repository in the sense that all +refs are included in the bundle: + +---------------- +$ git bundle create backup.bundle --all +---------------- + +But note again that this is only for the refs, i.e. you will only +include refs and commits reachable from those refs. You will not +include other local state, such as the contents of the index, working +tree, the stash, per-repository configuration, hooks, etc. + +You can later recover that repository by using for example +linkgit:git-clone[1]: + +---------------- +$ git clone backup.bundle +---------------- + +For the next example, assume you want to transfer the history from a +repository R1 on machine A to another repository R2 on machine B. For whatever reason, direct connection between A and B is not allowed, but we can move data from A to B via some mechanism (CD, email, etc.). We want to update R2 with development made on the branch master in R1. From patchwork Sat Nov 16 14:54:52 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Kristoffer Haugsbakk X-Patchwork-Id: 13877613 Received: from fhigh-a8-smtp.messagingengine.com (fhigh-a8-smtp.messagingengine.com [103.168.172.159]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id EE63939AEB for ; Sat, 16 Nov 2024 14:56:02 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.159 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1731768965; cv=none; b=GIE/oocN4fpx7gMgQINIpOE0dvJe+ViGHuQN+Z6qPDcxtR9zCMqmWnElBxPo3ro38sjnU13A7jjaJQxt4slN+z2IhNcvfnY7dl9n8Di+OzWclmdxt+3qaA8V2DHgZMAVg3cXI6sHOdEnS6B4PLhcKqLXzsqTh0XCZxVeEoScWNo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1731768965; c=relaxed/simple; bh=Fk68GoRz/RT+T8JshBs68BTx5krzlabaUnPTMpnpdOg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=J52s+UEzlA5v34gNRlvtVgYGivhYrYR6OjkG13lEYt1IVa1FjGY0PPUsWJATQRCHEnxv0gJbXK9BWKo8XaEb6t6LRLhmyulwpjALnRzVoOchtDUoDWziutwJnPE+m3ifFcyxUACZNhrNlVt9pi9XIXn6ktFwHFRO6TIihkypulg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=fastmail.com; spf=pass smtp.mailfrom=fastmail.com; dkim=pass (2048-bit key) header.d=fastmail.com header.i=@fastmail.com header.b=RDhND7+B; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=SMTfxVL3; arc=none smtp.client-ip=103.168.172.159 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=fastmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=fastmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=fastmail.com header.i=@fastmail.com header.b="RDhND7+B"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="SMTfxVL3" Received: from phl-compute-04.internal (phl-compute-04.phl.internal [10.202.2.44]) by mailfhigh.phl.internal (Postfix) with ESMTP id 008EC1140085; Sat, 16 Nov 2024 09:56:02 -0500 (EST) Received: from phl-mailfrontend-02 ([10.202.2.163]) by phl-compute-04.internal (MEProxy); Sat, 16 Nov 2024 09:56:01 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.com; h= cc:cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm3; t=1731768961; x=1731855361; bh=bBDQZ4dWqtbmm1vwJ3MAj34IPKlUIih8354uxmk2kI4=; b= RDhND7+B2Ih5bJf/PhV+f0+si2C5jigJR9SCXDPYcj5UpKeU5fRLmZoACfqfO9+r TPCK338ccaEQ9zPQdw0/jKyQ4CBSOyaGDxq5TOPTU+CyUlsFQfhCtMlUuUbjeHqH C9uvh5BY14Fzge8RnEtq/1p8RseZxsKNdTLKDHRE4cHHlthZJzvtvxU5WHImyHTO SuD6dnMUG8Fm4FLDI8FiVnfu015D/WPZg9r3J94XB4y/k1UiDJLQHScV/4XwcB0m nPR7A1YNsCpBsOdBxr2dkoRJ3bTtwnCzQo8tTIx/e9Q4udVA9mAbn1kG5/eAjGR9 ZZPtPKX7hEM0MnSz0nc5IA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1731768961; x= 1731855361; bh=bBDQZ4dWqtbmm1vwJ3MAj34IPKlUIih8354uxmk2kI4=; b=S MTfxVL3BE0gx/+SP8S+W4o92eijSLjcSRJ69e7YAs7mBYKW9E8SkbgYRKeuUckkE F/OeylWSqXPBvggjj9x0mhLEzY4+P/fKhUEbExDx71JYKIpubABlg2X/9wyq6uWC TSDq7ApVY0FpiYZ9hAVUJdhYuepIn53LF8vdv9NnfqOL+7Zf/zfUNrYASG0OCUKk 7fPBJ06D7jI9oGXv1POCN+KXdPcPiNae4SC2ziffSatYGL+ggD4WHD5LgJ7ep+3e BfwbY13jUrKEzbP+jAy+6Pq1rUAjLJg0iKKyHVXm11tgwkAOJr9yH1YmVXtR3Zqz 8w1qF3jfJfJcg/AsKqPxQ== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefuddrvdeigdeijecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdpuffr tefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvvefuff fkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhhrghu ghhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpedulefgue eiueetkeelieefgedufeehteekhfejffekvdeuhedtvefhkeeikefhgfenucffohhmrghi nhepkhgvrhhnvghlrdhorhhgnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpe hmrghilhhfrhhomhepkhhrihhsthhofhhfvghrhhgruhhgshgsrghkkhesfhgrshhtmhgr ihhlrdgtohhmpdhnsggprhgtphhtthhopeehpdhmohguvgepshhmthhpohhuthdprhgtph htthhopehgihhtsehvghgvrhdrkhgvrhhnvghlrdhorhhgpdhrtghpthhtoheptghouggv sehkhhgruhhgshgsrghkkhdrnhgrmhgvpdhrtghpthhtoheprghvrghrrggssehgmhgrih hlrdgtohhmpdhrtghpthhtohepmhgvsehtthgrhihlohhrrhdrtghomhdprhgtphhtthho pehgihhtshhtvghrsehpohgsohigrdgtohhm X-ME-Proxy: Feedback-ID: i8b11424c:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sat, 16 Nov 2024 09:56:00 -0500 (EST) From: kristofferhaugsbakk@fastmail.com To: git@vger.kernel.org Cc: Kristoffer Haugsbakk , avarab@gmail.com, me@ttaylorr.com, gitster@pobox.com Subject: [PATCH v4 2/4] Documentation/git-bundle.txt: remove old `--all` example Date: Sat, 16 Nov 2024 15:54:52 +0100 Message-ID: <7e9f320fadeaddb4b402fc1e03d95f0ef5fccb0f.1731768344.git.code@khaugsbakk.name> X-Mailer: git-send-email 2.47.0.317.g7d2562b9734 In-Reply-To: References: Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 From: Kristoffer Haugsbakk We don’t need this part now that we have a fleshed-out `--all` example. Signed-off-by: Kristoffer Haugsbakk --- Notes (series): v3: • Moved over from previous patch Removing this mention was first suggested in the following link. Link: https://lore.kernel.org/git/ZxbIWEGS1UB3UIg+@nand.local/ Documentation/git-bundle.txt | 2 -- 1 file changed, 2 deletions(-) diff --git a/Documentation/git-bundle.txt b/Documentation/git-bundle.txt index b9eb9cef2f8..917d39356bb 100644 --- a/Documentation/git-bundle.txt +++ b/Documentation/git-bundle.txt @@ -202,8 +202,6 @@ It is okay to err on the side of caution, causing the bundle file to contain objects already in the destination, as these are ignored when unpacking at the destination. -If you want to match `git clone --mirror`, which would include your -refs such as `refs/remotes/*`, use `--all`. If you want to provide the same set of refs that a clone directly from the source repository would get, use `--branches --tags` for the ``. From patchwork Sat Nov 16 14:54:53 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Kristoffer Haugsbakk X-Patchwork-Id: 13877614 Received: from fhigh-a8-smtp.messagingengine.com (fhigh-a8-smtp.messagingengine.com [103.168.172.159]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 6750E39AEB for ; Sat, 16 Nov 2024 14:56:06 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.159 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1731768968; cv=none; b=egqEKKMb9R1GvoxKhY2LUbawsTFfjPsY9X6nYEBIFhAun5rqq3RAQZYj/3TLPuWw3CCfnORpmFEnTuMSiuczvhoTmqknPguoOgm9D4tnLU3iA3FLf3Q/Lwqz8XgBeVtnArA7dt9UvlF2SAqdFx6o5yGRFpTnulfqM+OKk0i2Gfk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1731768968; c=relaxed/simple; bh=6gMOIE5pBm/bMmA46h6Y6WLJcXKnfdHGEHXOTtnBIAA=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=hj0L0hwfCidCXb+pTOhOVO0wOVfd0WzgWX+hm++4O9UPYuFLdwQMHuTQserEUKnCOTjXfaUsgDhVc0AjY8QYbOHYiXe1ueXYIHF+8OJLs8G34dSaHKYVpA4P/c0stduKf+jUYa04kNOpxopqn4Afg+iqJeLciqJDA/X5w6eaSjM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=fastmail.com; spf=pass smtp.mailfrom=fastmail.com; dkim=pass (2048-bit key) header.d=fastmail.com header.i=@fastmail.com header.b=jSjm2fNs; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=WuVdBAGR; arc=none smtp.client-ip=103.168.172.159 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=fastmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=fastmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=fastmail.com header.i=@fastmail.com header.b="jSjm2fNs"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="WuVdBAGR" Received: from phl-compute-09.internal (phl-compute-09.phl.internal [10.202.2.49]) by mailfhigh.phl.internal (Postfix) with ESMTP id 5F03A1140085; Sat, 16 Nov 2024 09:56:05 -0500 (EST) Received: from phl-mailfrontend-01 ([10.202.2.162]) by phl-compute-09.internal (MEProxy); Sat, 16 Nov 2024 09:56:05 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.com; h= cc:cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm3; t=1731768965; x=1731855365; bh=sJwBk1EdWrXdANBZGKHFkgr2D2ItW4bZgnpbbbctIjo=; b= jSjm2fNsoEtZeki4PYv3Ww6Ru43BQXiiG1Nv8LILHkg3t17qt+0ymOcsX23jcR/W 4ziLXXczNtbRs2LyjfIknVb6qHGw30s7gaLoBkUZA3MwMJYzn7yH5TzMm4iShSgr YO3V2CXM2tXGUJVsj6XcfwjPFeXdttZbfGjeNUYQ3cD563nL2qIh5094T3bY5Lps qnjVaJMSLTFBOAeSXtilXgIyrxs5W3daNa3wba5OhrtoGi9TyQIrrrwxuvIX7s2m ayARmEgvjzvlrU8chAOdqfNwFdBcElK4luSmXenRV3jkRV5ZxKf91M5zEkIcVGkr iBN6+gFam6jfi9GLduDRmA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1731768965; x= 1731855365; bh=sJwBk1EdWrXdANBZGKHFkgr2D2ItW4bZgnpbbbctIjo=; b=W uVdBAGRe5U5TF7TvuUp8axezBW+3CQ9kTbreeng4HuhqfJ1iswgh38HD3Amk58So CGSX/iZdKWx5RoB4a41EEgjAKsgceZ+tuU0OdmYEyGygKBwX+0hiHPcCKPaJ5Lj/ i4GjYDC0VPW2VQOey15nPLNuRGi2WIRWz7aLi408i7zu6czlU8b3CjVF/VukVXEE b49Q4qQwKQd4q01jvNmK+9V7yzjMuGIQofHals4xBIfoJsuqO7WkbOzwV71gU04a 8Hg9EGhuIFlgekJrvrjfKoN9IsgSRDlXJDfZJiDTCmM4xSHlqqoBVz00ufmtf9qz x/2w+kXLTtxhTnTWBFZtQ== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefuddrvdeigdeijecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdpuffr tefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvvefuff fkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhhrghu ghhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpefhgfegle fhjeekgfetleetjefhteeiheegfedtudduffegjefhkeetudeggffhkeenucevlhhushht vghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehkrhhishhtohhffhgvrh hhrghughhssggrkhhksehfrghsthhmrghilhdrtghomhdpnhgspghrtghpthhtohephedp mhhouggvpehsmhhtphhouhhtpdhrtghpthhtohepghhithesvhhgvghrrdhkvghrnhgvlh drohhrghdprhgtphhtthhopegtohguvgeskhhhrghughhssggrkhhkrdhnrghmvgdprhgt phhtthhopegrvhgrrhgrsgesghhmrghilhdrtghomhdprhgtphhtthhopehmvgesthhtrg ihlhhorhhrrdgtohhmpdhrtghpthhtohepghhithhsthgvrhesphhosghogidrtghomh X-ME-Proxy: Feedback-ID: i8b11424c:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sat, 16 Nov 2024 09:56:03 -0500 (EST) From: kristofferhaugsbakk@fastmail.com To: git@vger.kernel.org Cc: Kristoffer Haugsbakk , avarab@gmail.com, me@ttaylorr.com, gitster@pobox.com Subject: [PATCH v4 3/4] Documentation/git-bundle.txt: mention --all in spec. refs Date: Sat, 16 Nov 2024 15:54:53 +0100 Message-ID: <4e9907f092ea7825418d2a35d7cdfc1deaee8400.1731768344.git.code@khaugsbakk.name> X-Mailer: git-send-email 2.47.0.317.g7d2562b9734 In-Reply-To: References: Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 From: Kristoffer Haugsbakk Mention `--all` as an alternative in “Specifying References”. Signed-off-by: Kristoffer Haugsbakk --- Documentation/git-bundle.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/git-bundle.txt b/Documentation/git-bundle.txt index 917d39356bb..eaa16fc4b83 100644 --- a/Documentation/git-bundle.txt +++ b/Documentation/git-bundle.txt @@ -131,7 +131,7 @@ SPECIFYING REFERENCES --------------------- Revisions must be accompanied by reference names to be packaged in a -bundle. +bundle. Alternatively `--all` can be used to package all refs. More than one reference may be packaged, and more than one set of prerequisite objects can be specified. The objects packaged are those not contained in the From patchwork Sat Nov 16 14:54:54 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Kristoffer Haugsbakk X-Patchwork-Id: 13877615 Received: from fhigh-a8-smtp.messagingengine.com (fhigh-a8-smtp.messagingengine.com [103.168.172.159]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id AA508537E5 for ; Sat, 16 Nov 2024 14:56:09 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.159 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1731768971; cv=none; b=dcLc/fQCizSkAEnboDQFFpyrxi6ArUkoRggo2iyDiIMt5x8ZXVAXdTVE6fPvYGgRSVbQi/47hnzLd/ozpMplCrB+1QLAlcEFgD/stuoIPc/mNB/020G4uQmGuOSPKeyzKlXNx0O++Rz59fKaneCSmYLFj201gKXjNgNxAnnhoAI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1731768971; c=relaxed/simple; bh=UmBOFlUojmkMS+uOsAFEnfbqjPODljRLoVFw3YQMCmg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=mB5w7/BGf3Wkl6vY1TGqQtZxwYOPh7sQmqYuy6QIm1UD0oS/pOaxlrIq5HmVU643bz+UaiC94MRZ+mKyIuK6JvO/wnZGZEw8PmKJl3Ngb9Z/6CRCCJfPDJ8nXvtoyxqibqSRQb0ZXbMe5swZLVPye6ydxOx1ccqtlB7f0hHkc4s= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=fastmail.com; spf=pass smtp.mailfrom=fastmail.com; dkim=pass (2048-bit key) header.d=fastmail.com header.i=@fastmail.com header.b=GEAZto+M; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=G8Ulw7rL; arc=none smtp.client-ip=103.168.172.159 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=fastmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=fastmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=fastmail.com header.i=@fastmail.com header.b="GEAZto+M"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="G8Ulw7rL" Received: from phl-compute-07.internal (phl-compute-07.phl.internal [10.202.2.47]) by mailfhigh.phl.internal (Postfix) with ESMTP id CD94E11400F6; Sat, 16 Nov 2024 09:56:08 -0500 (EST) Received: from phl-mailfrontend-02 ([10.202.2.163]) by phl-compute-07.internal (MEProxy); Sat, 16 Nov 2024 09:56:08 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.com; h= cc:cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm3; t=1731768968; x=1731855368; bh=mWNaLnbiHS96eYBp95mYmqG0s2vQ1ikE9azuMU1YbFg=; b= GEAZto+MRLJZ3eqbmk4ZxbT8HijL+IYN7qbY5Kyn+AL9MuOQSkBB2fCnwbrKz+es ciQS2+c/IYUZ4J00CuBcTbK1nKF3Dpvloy/ovGWnwy7QzItnFV0N/5cCwVjwZioZ 58yTzJGoX9OlhJnDR0qKka71/5llwK/bs9pdCnmCXgjBD/wzfwe2Os5U5AfeeVwF kcDCGwuTs8PXjiqB9QiIO1iCEIQJCIX65yD3PaBhr77mh7gl2c+SZ58MDxvm49zN WH2305b4ehsOkEAOWO/84kmRjTgldjiPjSQ1qoHj5Edi4HVEvqPmOs33s4NgiiUc KIEPWtVAg2cJT5b6OjZW4g== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1731768968; x= 1731855368; bh=mWNaLnbiHS96eYBp95mYmqG0s2vQ1ikE9azuMU1YbFg=; b=G 8Ulw7rL+iLuBQsc5DvLey0QtV4OGMO4QmRPeo4diNPaZHVmocJHef96LpGC2RQm3 Y5L5DzskF/NtgodjCyEPfNP4RA3aCxCUHyXGroqk/IRfLZXY+/62kTj1Mb0O0cuf AJZSBDZEyTMG0dF1Nb5SzGurpq7O20iP7ocLCE3FsS4CFHMBpnNsCllr9grTL2Cl JZhrJBQ5RbDgNFS/PPxWriG7k4s+kfRRFq6VxL1M44ReqTJaYPuodM8AUzspEd9d LEYz3AXdqaboJs35oNLLg9pEdqbdZKckMyLqJJ41ExB6bYAUHCy/7xdcPrQFr+fW snvOEdvXR73b0lIBEbAVQ== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefuddrvdeigdeijecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdpuffr tefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvvefuff fkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhhrghu ghhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpedulefgue eiueetkeelieefgedufeehteekhfejffekvdeuhedtvefhkeeikefhgfenucffohhmrghi nhepkhgvrhhnvghlrdhorhhgnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpe hmrghilhhfrhhomhepkhhrihhsthhofhhfvghrhhgruhhgshgsrghkkhesfhgrshhtmhgr ihhlrdgtohhmpdhnsggprhgtphhtthhopeehpdhmohguvgepshhmthhpohhuthdprhgtph htthhopehgihhtsehvghgvrhdrkhgvrhhnvghlrdhorhhgpdhrtghpthhtoheptghouggv sehkhhgruhhgshgsrghkkhdrnhgrmhgvpdhrtghpthhtoheprghvrghrrggssehgmhgrih hlrdgtohhmpdhrtghpthhtohepmhgvsehtthgrhihlohhrrhdrtghomhdprhgtphhtthho pehgihhtshhtvghrsehpohgsohigrdgtohhm X-ME-Proxy: Feedback-ID: i8b11424c:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sat, 16 Nov 2024 09:56:07 -0500 (EST) From: kristofferhaugsbakk@fastmail.com To: git@vger.kernel.org Cc: Kristoffer Haugsbakk , avarab@gmail.com, me@ttaylorr.com, gitster@pobox.com Subject: [PATCH v4 4/4] =?utf-8?q?Documentation/git-bundle=2Etxt=3A_discuss_?= =?utf-8?q?na=C3=AFve_backups?= Date: Sat, 16 Nov 2024 15:54:54 +0100 Message-ID: X-Mailer: git-send-email 2.47.0.317.g7d2562b9734 In-Reply-To: References: Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 From: Kristoffer Haugsbakk It might be naïve to think that those who need this education would end up here in the first place. But I think it’s good to mention this high-level concept here on a command which provides a backup strategy. Signed-off-by: Kristoffer Haugsbakk --- Notes (series): v4: • Mention the stash (knock-on effect from patch 1/4) v3: • Use `cp -r` instead of `cp -a` since the former is more widely supported (even though it is just an example) • Mention what this “full backup” does not cover here as well (see first patch) v2: • Fix gitfaq(7) link Link: https://lore.kernel.org/git/ZxfhAAgNlbEq60VB@nand.local/#t v1: Correct mention of the section? All-caps seems to be the convention. Documentation/git-bundle.txt | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/Documentation/git-bundle.txt b/Documentation/git-bundle.txt index eaa16fc4b83..504b8a8143a 100644 --- a/Documentation/git-bundle.txt +++ b/Documentation/git-bundle.txt @@ -344,6 +344,24 @@ You can also see what references it offers: $ git ls-remote mybundle ---------------- +DISCUSSION +---------- + +A naive way to make a full backup of a repository is to use something to +the effect of `cp -r `. This is discouraged since +the repository could be written to during the copy operation. In turn +some files at `` could be corrupted. + +This is why it is recommended to use Git tooling for making repository +backups, either with this command or with e.g. linkgit:git-clone[1]. +But keep in mind that these tools will not help you backup state other +than refs and commits. In other words they will not help you backup +contents of the index, working tree, the stash, per-repository +configuration, hooks, etc. + +See also linkgit:gitfaq[7], section "TRANSFERS" for a discussion of the +problems associated with file syncing across systems. + FILE FORMAT -----------