From patchwork Tue Oct 29 20:41:44 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Kristoffer Haugsbakk X-Patchwork-Id: 13855468 Received: from fhigh-a2-smtp.messagingengine.com (fhigh-a2-smtp.messagingengine.com [103.168.172.153]) (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 50A9520898D for ; Tue, 29 Oct 2024 20:41:58 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.153 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1730234520; cv=none; b=bK0+MCX3nhmGRSP8xhlljXrelgeMdYqNx6iFxS5OskAhL+iO+/xV0OfQeRjFXl9TbmoUEVWIDSsZNrWmZke26NwephY8a1abyBQIdmhxFh6UfpoS0EaFVWXvPJKdIqNKPOgsD76wCTU1yqjoFecWCUqhzVSa8uVuL4bJYRqCrrY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1730234520; c=relaxed/simple; bh=A2osqUr0Q82gKuoMAvgU2q+hln8ffEVgVSHpItg2qaQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=S6dV7fdrsDhXd98mKqHj35Xf1BdwjOjy4OA3KaNcWLHauCbxdko3+b55eq4r8sFAocJ0mm8nL2jE5wLz/6fmP5SWQg1mJ+nwKkweYQGeqAA/+lmB7srmegh8WV5lTJVtZ84w9KfQN83WYP1oeCI5x+CG6TIDSU9Jqt02G3nPOJ8= 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=agBr8zjm; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=HGuNJRWt; arc=none smtp.client-ip=103.168.172.153 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="agBr8zjm"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="HGuNJRWt" Received: from phl-compute-12.internal (phl-compute-12.phl.internal [10.202.2.52]) by mailfhigh.phl.internal (Postfix) with ESMTP id 50BE81140106; Tue, 29 Oct 2024 16:41:57 -0400 (EDT) Received: from phl-mailfrontend-02 ([10.202.2.163]) by phl-compute-12.internal (MEProxy); Tue, 29 Oct 2024 16:41:57 -0400 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=1730234517; x=1730320917; bh=ok82hs0GYpVdQZvH04p7+sCnxRd9ReVNKhoMXMpywgs=; b= agBr8zjmdL8yCTx34utWWZR4DG+s+YJvsnNMBom96kbqWH60lZp6pjCoW98/RMh6 /YAXm+Jixepw5DgoIaK/WKPBvDTfsGA+J3fvu9D9TxFCmRmSaW4ugk26fv9UEjUc L4Kh3XLqK64ubvOIjLXGRS54HqA74czW2Z1HKuEvPKKfvB+UePA5Ng8GqJQRZhb7 4oIcFS1uvsOEv5SyVgp2esgQKsrRKUNDNBcCRb0Z46gbo9zQmUE1u4MW97h9AVxE 7m4D1J7SO6cI/rCwaHMpE0eCyKGejV+8iCKz7MZ9P8Wx/mmCozWEfgOt4AOkjLdG n5+G9iY+uV3YZWthRLjzZA== 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=1730234517; x= 1730320917; bh=ok82hs0GYpVdQZvH04p7+sCnxRd9ReVNKhoMXMpywgs=; b=H GuNJRWt4eO0ewMaRzIEGxEbkd6BQrce4d1u2qFsON3aBQyxAWMyspa7Qg7QFxzZT Q3796iAxd0EaZUtDFLzY4jmm+Zoob3e7U4X8ulV0UQXTjRd+PIIrgTbEIzK1JXNA gZGbGcjHKnyYjXy3EWDwXmdrsoZxqZDGczRqOSeum89BFXpZaJCQS/s0VphJyCxn C05q0Mv5wn7jP4hvHCQ0Vt9BPjyDnzRTc+Xws55NmMA0E5b0eVnZLfVIYU72YpyQ xO8uBW6gh3SyeO5U/AFpkprlEKJ3Iidovmf0CtY40cl8P8eDSTToBqJZYOQ6BPHX xtjo1mlNcse3jS/Y4uEjQ== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeftddrvdekuddgudefhecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvve fufffkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhh rghughhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpedtff dthfelieevgfethfdvffetffejfeejteetjeelveetgedtffdtgfehuddvffenucffohhm rghinhepshhtrggtkhhovhgvrhhflhhofidrtghomhdpkhgvrhhnvghlrdhorhhgpdgtrg hnrghlshhoohhpvghrrghtvghonhgsuhhnughlvghfihhlvghsrdhithenucevlhhushht vghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehkrhhishhtohhffhgvrh hhrghughhssggrkhhksehfrghsthhmrghilhdrtghomhdpnhgspghrtghpthhtohepgedp mhhouggvpehsmhhtphhouhhtpdhrtghpthhtohepghhithesvhhgvghrrdhkvghrnhgvlh drohhrghdprhgtphhtthhopegtohguvgeskhhhrghughhssggrkhhkrdhnrghmvgdprhgt phhtthhopegrvhgrrhgrsgesghhmrghilhdrtghomhdprhgtphhtthhopehmvgesthhtrg ihlhhorhhrrdgtohhm X-ME-Proxy: Feedback-ID: i8b11424c:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue, 29 Oct 2024 16:41:55 -0400 (EDT) From: kristofferhaugsbakk@fastmail.com To: git@vger.kernel.org Cc: Kristoffer Haugsbakk , avarab@gmail.com, me@ttaylorr.com Subject: [PATCH v2 1/3] Documentation/git-bundle.txt: mention full backup example Date: Tue, 29 Oct 2024 21:41:44 +0100 Message-ID: X-Mailer: git-send-email 2.46.1.641.g54e7913fcb6 In-Reply-To: References: Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Commit-Hash: e9be866f33daab2d4038f8b3f1140fe41e5f49c5 X-Previous-Commits: f7d9aa89c953ca7d15b5047487b4347ef62e77a9 From: Kristoffer Haugsbakk Tell the user how to make a full backup of the repository right at the start of the doc. 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 Signed-off-by: Kristoffer Haugsbakk --- Notes (series): 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/ Documentation/git-bundle.txt | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/Documentation/git-bundle.txt b/Documentation/git-bundle.txt index 3ab42a19cae..0fa181c749d 100644 --- a/Documentation/git-bundle.txt +++ b/Documentation/git-bundle.txt @@ -23,8 +23,8 @@ 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 (`git bundle create --all`), and to relay the state of +the references in one repository to another. Git commands that fetch or otherwise "read" via protocols such as `ssh://` and `https://` can also operate on bundle files. It is @@ -203,8 +203,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 Tue Oct 29 20:41:45 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Kristoffer Haugsbakk X-Patchwork-Id: 13855469 Received: from fout-a6-smtp.messagingengine.com (fout-a6-smtp.messagingengine.com [103.168.172.149]) (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 3DBEC20A5DA for ; Tue, 29 Oct 2024 20:42:02 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.149 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1730234524; cv=none; b=mF4HBjtFVBW/smD4qpHPkXvuLYbjtFeVerBGzXd49LH1FxIviFzCnvb2MlTQ0KmN+3aTRDb0s88njQqhasHSxmawgy9M7LqHGC8y63pAl53IdeJPQNS0gl4/CibE2QcPlqIi0es9J7430sRiDKCHvpthIJsTGvo70XAecquZskU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1730234524; c=relaxed/simple; bh=BCUq9k7s+lf8RGWILukt8xZoYWzgtnTpWgDrA8hCbgU=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=bhh+ncohm3MiwaFZp3L7CsnFh2DquFR+rNu02WVsxrxkMyOgluF5NUnf79gBQT2d7PLAPki8vwTcjGkaP4G+1YDzsgOqMq2+HsoFpaNYBlen9JTFUFbBFyicX5XTSeqoMRGM8d3EDf3iN1DBoQFAZ+HeUIERjNhCFgNfpOV9Gz0= 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=Ql36j5yi; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=Ii7I1PRM; arc=none smtp.client-ip=103.168.172.149 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="Ql36j5yi"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="Ii7I1PRM" Received: from phl-compute-02.internal (phl-compute-02.phl.internal [10.202.2.42]) by mailfout.phl.internal (Postfix) with ESMTP id 6850A1380145; Tue, 29 Oct 2024 16:42:01 -0400 (EDT) Received: from phl-mailfrontend-01 ([10.202.2.162]) by phl-compute-02.internal (MEProxy); Tue, 29 Oct 2024 16:42:01 -0400 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=1730234521; x=1730320921; bh=U5+7OrOSCN8Hz1IKFFLpRiQs7OHR9WzDhifh9b72vOA=; b= Ql36j5yiOrGqHGgqewbPOMbQqrwXJMnsmXZcp1DyPDrJuAuQxkB4oVr31C9qoeSU lhdMnuP6c59fdFH2fi3R13tKIrj5+26nvfsfzs8aOKW/gAWXyxzE4bu0M9Bm9hHo IDwaUGDcPPBe4WRn198kNqKoM1obfYmQitls5dEHMagpP2GVUFsAOQJHcnSMWsFy yhM8PMEuLfZLedY5hNGHiSgB4201qXWM7J7occpPWkIai1hwQsmaf9n4C9PqfsFO BSdr5vAU6biyU5zHTmpfk3dhrL6+pve4qV/5nlNS1JZIGio6ce+gxab6tWdp9ZJu uty9ah4t0z9tBg5MDPyV2Q== 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=1730234521; x= 1730320921; bh=U5+7OrOSCN8Hz1IKFFLpRiQs7OHR9WzDhifh9b72vOA=; b=I i7I1PRM01GgiQrekV+W47IYJswXzMiWx4djFxRsUpx4gioJ1mw7Kgd3TwWdFowQ6 WZ8O3AopHDny10V2ipPK5fTKYMNBQqv4HMMnrdxri3Q8ZlpMDj+Tar1V91MQkkuv SlIPALzxBe2G76K+R/2lAzbLJRTtLEt8aOOAuuIn5lQdoe2urSwS4khQV5KmieBg MfvO0ZV8292c2pSY8kN9rCN+/lD9vHHqZiQ4nIZR0nM2HJ/uyCJeFVYV58vrsxAO +5a4grEd27d2O3e/hS0voeepjNAMgDzR/fY8sAy8ACzOpKihqMny0SforG+wcqQ2 i0n3MU8fwAD6wf13m7fEA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeftddrvdekuddgudefhecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvve fufffkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhh rghughhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpefhgf eglefhjeekgfetleetjefhteeiheegfedtudduffegjefhkeetudeggffhkeenucevlhhu shhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehkrhhishhtohhffh gvrhhhrghughhssggrkhhksehfrghsthhmrghilhdrtghomhdpnhgspghrtghpthhtohep gedpmhhouggvpehsmhhtphhouhhtpdhrtghpthhtohepghhithesvhhgvghrrdhkvghrnh gvlhdrohhrghdprhgtphhtthhopegtohguvgeskhhhrghughhssggrkhhkrdhnrghmvgdp rhgtphhtthhopegrvhgrrhgrsgesghhmrghilhdrtghomhdprhgtphhtthhopehmvgesth htrgihlhhorhhrrdgtohhm X-ME-Proxy: Feedback-ID: i8b11424c:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue, 29 Oct 2024 16:41:59 -0400 (EDT) From: kristofferhaugsbakk@fastmail.com To: git@vger.kernel.org Cc: Kristoffer Haugsbakk , avarab@gmail.com, me@ttaylorr.com Subject: [PATCH v2 2/3] Documentation/git-bundle.txt: mention --all in spec. refs Date: Tue, 29 Oct 2024 21:41:45 +0100 Message-ID: X-Mailer: git-send-email 2.46.1.641.g54e7913fcb6 In-Reply-To: References: Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Commit-Hash: f18f8ca453d04a65149deb8a25f34b51158c4933 X-Previous-Commits: 33980a47d132c9ea56238641031e72c5c7e2565a 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 0fa181c749d..bce62bc8309 100644 --- a/Documentation/git-bundle.txt +++ b/Documentation/git-bundle.txt @@ -132,7 +132,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 Tue Oct 29 20:41:46 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Kristoffer Haugsbakk X-Patchwork-Id: 13855470 Received: from fout-a6-smtp.messagingengine.com (fout-a6-smtp.messagingengine.com [103.168.172.149]) (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 A94ED20A5F8 for ; Tue, 29 Oct 2024 20:42:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.149 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1730234529; cv=none; b=LAYfLGtRuQHpMkbg6A3Gs0R7zS6q8gxssaCyAH0BVTE9RL6T1+BY1uvNws+vKKMZHPEqfbJsLnqwQRu2B60J3Jnq8Li62ky8iC07uMA1qpU3Wq7xhWTWdsGYC3NmL1sCOVgKZhutCQDxKk9bgxajo11ZpxD9vmjykRzJB3yYEAA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1730234529; c=relaxed/simple; bh=oR5oz57jViqRkFGVH0kcFg8bqjS6Xv08V/0RLBZNXAw=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=E7qrfLPq3lnY9QDyTWzON/UjMGghiTpZ3iWmFq2aSwPNWyWa59WA3Yn0ahLG7rO1PFh9KsbV6p8xBTtTmNI4Mv1r83voRTO30c8XBx90JLm/qHbyRAChkc4kTigezYS2pQ3Fs6GSvDQJwu5FwSoYCJFni80+grHbQ/VxOCHymtA= 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=l4luyKOb; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=BtMEuRVr; arc=none smtp.client-ip=103.168.172.149 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="l4luyKOb"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="BtMEuRVr" Received: from phl-compute-12.internal (phl-compute-12.phl.internal [10.202.2.52]) by mailfout.phl.internal (Postfix) with ESMTP id C718D138019D; Tue, 29 Oct 2024 16:42:04 -0400 (EDT) Received: from phl-mailfrontend-02 ([10.202.2.163]) by phl-compute-12.internal (MEProxy); Tue, 29 Oct 2024 16:42:04 -0400 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=1730234524; x=1730320924; bh=XX1gm/ptQfCIzW0m/8BY7dIYEkLGI81LOv/KDky2eRk=; b= l4luyKObo0t1Zf184W95qyyahImiqZ/6cj/ORRS/gPAwl/VA4xCjFzGK+t4Ge8P1 FDaOy73/KqVSHO7BRoAX79jVEk3II7Hv+5QLDFdU+rUPVvRIaTijPxTm+qqtPiA0 ZoZZpJZ/L0oIobO67lWkz1xjm6joWoFiBtg9/Gzrl/VynY4j1IHwyEV62kHIeIvg AHS6Wq/R02SpCu2/5Q37A9SJXLMoDOIKCvJNPne5RWp8PDKB23WOSnL6GD/gqcPL epH00x+p1hH9bIDe5NFzC+Bf/dYhRoKTYKuiUt8vgpfgg8QsIoBVwGqfx7EDaOir 6SACY9er1tMJiqOkvfd66A== 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=1730234524; x= 1730320924; bh=XX1gm/ptQfCIzW0m/8BY7dIYEkLGI81LOv/KDky2eRk=; b=B tMEuRVrg+zFs9AD57EyNNovlfLnM6x2hImdeahhVEFn6NhlO7g31rujQ5ZDqKGQu KhnWPxSMymxwkWz/6gL6ItKCBVc0bjApddE7VUIXra39gHAJRX8PhYLfvJm9Xs4+ R91DB2390bU/5WRkULjzzJJP3in5nmyx3cuhfnftxF1P+al6yFrruRw4GNrAABZD sdXdZ+8W0X53Owxiai7pQzUFXLo+/c644bjfUmD9HeyaFwTo++xB3s0e3D9fUV9m 8a3E+T11FVc9pd3ZyqCZ8XGSjE7EmFyrbQLNV+ZbX5e9A1ffHXfNd1UjgCCKrKNr Qpdly6/iltmmL3K4W/7lw== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeftddrvdekuddgudefhecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvve fufffkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhh rghughhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpedule fgueeiueetkeelieefgedufeehteekhfejffekvdeuhedtvefhkeeikefhgfenucffohhm rghinhepkhgvrhhnvghlrdhorhhgnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrg hmpehmrghilhhfrhhomhepkhhrihhsthhofhhfvghrhhgruhhgshgsrghkkhesfhgrshht mhgrihhlrdgtohhmpdhnsggprhgtphhtthhopeegpdhmohguvgepshhmthhpohhuthdprh gtphhtthhopehgihhtsehvghgvrhdrkhgvrhhnvghlrdhorhhgpdhrtghpthhtoheptgho uggvsehkhhgruhhgshgsrghkkhdrnhgrmhgvpdhrtghpthhtoheprghvrghrrggssehgmh grihhlrdgtohhmpdhrtghpthhtohepmhgvsehtthgrhihlohhrrhdrtghomh X-ME-Proxy: Feedback-ID: i8b11424c:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue, 29 Oct 2024 16:42:03 -0400 (EDT) From: kristofferhaugsbakk@fastmail.com To: git@vger.kernel.org Cc: Kristoffer Haugsbakk , avarab@gmail.com, me@ttaylorr.com Subject: [PATCH v2 3/3] =?utf-8?q?Documentation/git-bundle=2Etxt=3A_discuss_?= =?utf-8?q?na=C3=AFve_backups?= Date: Tue, 29 Oct 2024 21:41:46 +0100 Message-ID: X-Mailer: git-send-email 2.46.1.641.g54e7913fcb6 In-Reply-To: References: Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Commit-Hash: c50f9d405f9043a03cb5ca1855fbf27f9423c759 X-Previous-Commits: 63a431537b78e2d84a172b5c837adba6184a1f1b 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): 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 | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/Documentation/git-bundle.txt b/Documentation/git-bundle.txt index bce62bc8309..7bffd2e4a05 100644 --- a/Documentation/git-bundle.txt +++ b/Documentation/git-bundle.txt @@ -319,6 +319,20 @@ 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 -a `. 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]. + +See also linkgit:gitfaq[7], section "TRANSFERS" for a discussion of the +problems associated with file syncing across systems. + FILE FORMAT -----------