From patchwork Sun Oct 20 19:14:59 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Kristoffer Haugsbakk X-Patchwork-Id: 13843223 Received: from fout-a8-smtp.messagingengine.com (fout-a8-smtp.messagingengine.com [103.168.172.151]) (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 9D2C317591 for ; Sun, 20 Oct 2024 19:15:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.151 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729451728; cv=none; b=YIHl/o+GeYClELqtMdROqaleShdq682FZJHcAD3HjI1mDKshq9yilT8Em6vczybzCyr6B5aTpJphSU/KHDo/SeC02x1yx65qmY+fycJ7foBNocyNwrPVvEr/rKbTJaYn4HkrThPaQ+blcQzbkzu0n6JCPa/kE5hsaqfurhXqbSs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729451728; c=relaxed/simple; bh=W0HRXv75Olog3VcXT5uniHF+hbeL7hD+14dbXjuZhPQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=TJTGriJaRWEd4zDeEtLexNvJEWKxLCZnQ47GQka5cXqp7gpR/Ck3GGjJePm5HPeuAj7sAvTdMG3IP9Yw22dLuAVNfs3ICuWNLLLzfVmIR8fyTF8z1HBtR4S+Z8BIZYljvkwv7nEub9eMzgIL2+KTQrG2CGAE0OD+DRCusR9SbuY= 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=mK69vg2a; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=LsNFvR6t; arc=none smtp.client-ip=103.168.172.151 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="mK69vg2a"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="LsNFvR6t" Received: from phl-compute-08.internal (phl-compute-08.phl.internal [10.202.2.48]) by mailfout.phl.internal (Postfix) with ESMTP id A77691380044; Sun, 20 Oct 2024 15:15:25 -0400 (EDT) Received: from phl-mailfrontend-01 ([10.202.2.162]) by phl-compute-08.internal (MEProxy); Sun, 20 Oct 2024 15:15:25 -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=1729451725; x=1729538125; bh=BCivB4Ny1UqIOLClQxgJJ5Kno0E0mrZTkUeFe5tQRc8=; b= mK69vg2aC+HzIp7a+2j4HlcC4FqW8DDZUv7nECQ60V46c9wC7fXA9U2UJlAAoaf2 YTkzUPIgPdn5+2Lly83lRCCMstDOAxfV//anBc3ZRtBCrb7Y0zZYxazt0E6p+/xD w0433tza/4wJDP8sEUDAzr2sLa3rccTR1n5HkVP9mYZ1jUMKfaRzSDgBGzVEPsbG YIqjr7wn6+DJjpx4pp/sE+ppUB1wxKMFyhO+1BvbSRipknGUZQqJDc9DMJ3INU06 hz9nGtWYHw2T1Y+bgxRxsuS6Y9og5rQGCGmlwWsHnwHZyR4w41zfqtlTTG1pFT0F X2OfbbF6yfWku606442Ujg== 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-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1729451725; x= 1729538125; bh=BCivB4Ny1UqIOLClQxgJJ5Kno0E0mrZTkUeFe5tQRc8=; b=L sNFvR6t3HP473RbVkouf7IYzlIaD6DQhaCbgdOO4L9src69Fl6LFqkp36mihA7Cw MabefIMTXyCVWQspkIQ9Hx5dvw3qvwqky2qgUJIk9Ore/jfbsVAHugNSpq6kQg6n GN49mxp93u76SHWFhghqBT/AvSrAqKlUA1DKjW+F1qi6gmt+lHo11WJRouvHGudw 5A+SxSzyWH6TSmOok3z+PiJ5i3YJj/bQgcgQIspRKl5ldSgXJp5VC8FqgWZZM9Ln uPKcn1TSCgSF69hg6uGYN8ubwQGe/GukVZntOe0QcERFqsInrOI1cqnjYvEOpNgP gGjfvx+Y7su5OmZxwyCEg== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeftddrvdehjedgudeffecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvve fufffkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhh rghughhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpefhgf eglefhjeekgfetleetjefhteeiheegfedtudduffegjefhkeetudeggffhkeenucevlhhu shhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehkrhhishhtohhffh gvrhhhrghughhssggrkhhksehfrghsthhmrghilhdrtghomhdpnhgspghrtghpthhtohep fedpmhhouggvpehsmhhtphhouhhtpdhrtghpthhtohepghhithesvhhgvghrrdhkvghrnh gvlhdrohhrghdprhgtphhtthhopegtohguvgeskhhhrghughhssggrkhhkrdhnrghmvgdp rhgtphhtthhopegrvhgrrhgrsgesghhmrghilhdrtghomh X-ME-Proxy: Feedback-ID: i8b11424c:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sun, 20 Oct 2024 15:15:24 -0400 (EDT) From: kristofferhaugsbakk@fastmail.com To: git@vger.kernel.org Cc: Kristoffer Haugsbakk , avarab@gmail.com Subject: [PATCH 1/4] Documentation/git-bundle.txt: mention --all in Synopsis Date: Sun, 20 Oct 2024 21:14:59 +0200 Message-ID: <39bdc5941c7b53c432966984fa79b81fde978e86.1729451376.git.code@khaugsbakk.name> 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: 39bdc5941c7b53c432966984fa79b81fde978e86 From: Kristoffer Haugsbakk `--all` is convenient for bundling all refs. But it is only mentioned once, halfway through the doc, under the demure section “Object prerequisites”. It deserves to be mentioned as an alternative to ``. Signed-off-by: Kristoffer Haugsbakk --- Notes (series): Long line in bundle.c now? Documentation/git-bundle.txt | 2 +- builtin/bundle.c | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/git-bundle.txt b/Documentation/git-bundle.txt index 3ab42a19cae..7579dd309ac 100644 --- a/Documentation/git-bundle.txt +++ b/Documentation/git-bundle.txt @@ -10,7 +10,7 @@ SYNOPSIS -------- [verse] 'git bundle' create [-q | --quiet | --progress] - [--version=] + [--version=] ( | --all) 'git bundle' verify [-q | --quiet] 'git bundle' list-heads [...] 'git bundle' unbundle [--progress] [...] diff --git a/builtin/bundle.c b/builtin/bundle.c index 127518c2a8d..6d610253575 100644 --- a/builtin/bundle.c +++ b/builtin/bundle.c @@ -17,7 +17,7 @@ #define BUILTIN_BUNDLE_CREATE_USAGE \ N_("git bundle create [-q | --quiet | --progress]\n" \ - " [--version=] ") + " [--version=] ( | --all)") #define BUILTIN_BUNDLE_VERIFY_USAGE \ N_("git bundle verify [-q | --quiet] ") #define BUILTIN_BUNDLE_LIST_HEADS_USAGE \ From patchwork Sun Oct 20 19:15:00 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Kristoffer Haugsbakk X-Patchwork-Id: 13843224 Received: from fout-a8-smtp.messagingengine.com (fout-a8-smtp.messagingengine.com [103.168.172.151]) (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 30BDA195FEA for ; Sun, 20 Oct 2024 19:15:30 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.151 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729451732; cv=none; b=Yl6M1SVTi50ybLuBiM1jbz8UQSz31EubEpsAWL7zn8gPvs6xCD+9DKAhXvNl78F3GwgaCKdjiSxjJyHqm/ng+KjihwHJqfN5LQ8d2Gnli+EGw0n7mzMMcjMPMHh54MM8GNLHHbSlx4nAT6SvsBgOIZ1qLLhAtd8t40fC+b31aDM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729451732; c=relaxed/simple; bh=Uj6T06+gVO8k5Z5Z/gK8PhutkLhd7UfbydIYheMMxFs=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=eNhevF9YmOkHC6s74OVq8PUqKljuHjQQxMndGHwZ8ddVEoj0aOHFccrt2TqRNDtTKkG5san17aPFuxZdfT5JLefSD3rNIM7JUh+JilLJvwqe2GzO4fgeEE+BSKRywJz6P+/qrIHsx1kbOeBWp/LIzoBUnK5Zwm5BKlvySmNUuLo= 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=NGTG1v8Z; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=GJqx306t; arc=none smtp.client-ip=103.168.172.151 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="NGTG1v8Z"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="GJqx306t" Received: from phl-compute-04.internal (phl-compute-04.phl.internal [10.202.2.44]) by mailfout.phl.internal (Postfix) with ESMTP id 3482313801FA; Sun, 20 Oct 2024 15:15:29 -0400 (EDT) Received: from phl-mailfrontend-02 ([10.202.2.163]) by phl-compute-04.internal (MEProxy); Sun, 20 Oct 2024 15:15:29 -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=1729451729; x=1729538129; bh=er+cTxxt30Rbzddm76yLWCIVuDvUNkel9hS38y/x4XI=; b= NGTG1v8ZOCCKXQWlMySVMitVMRPFiSHLIHIYP8mKw8W0qzd4L3wJN0XUAuWcQq6L THMZ7Zn5eM+fjx+YqEuTtGeI8Wugv0wYAIU3qs1oAHX39DOl2Pak2JKpT1IahT1f rF9ODROX3eGc824mwak4HXl4GV3+WFFBBJT4Ag0dAYBM1sW/Lwb+5iozs72cno9X gMUIGK8G7WIAZbo25QbJ/ndQN39psO2A2Pt+j+U5NIdWuwdT3ZHM2RdFuogfWaoP icUCfQRATIrjNDBrix/rFVpxMwWSwhNFwlXJ5MR7TEumpNPIpU2ZSuuu73wImHKv +wZOMkKinUSNdXRNwX0mKg== 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-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1729451729; x= 1729538129; bh=er+cTxxt30Rbzddm76yLWCIVuDvUNkel9hS38y/x4XI=; b=G Jqx306toRuZL7UJ95FZv67UuSHiY/IkULWQxMmvnejogQGn7JtqwIzYiAVDEZiI1 KEVS/DXy2jqLzUODbXBuXQ5hV0W1rp77PEGdVn3jK3Kv8oD+CDS8epd/n8/+AhKU bsmAbU/NE+e1Et2unV0/iX4JA4FdwtMOXI/18FMnV8jHRXTkbFYsCT62p6YWhP9H 4UA/QcKfrDZ2+Vf0RFXFBu+QKd3FcFK9XGXqcRJWwn0W3U81dz38jAoKdAa/pjAt ilayDVQAnrH7jeks6RDIiXPGr3xOAhpau3V3LFaFI9Ok6LeZZGYfIx8nSeydwVHz nbmBiV9IUu61+UwzeDdKg== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeftddrvdehjedgudefgecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvve fufffkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhh rghughhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpefhte fftddtgeeifedvteefffekheeiledukeevieevleefueegjefhkeelteduueenucffohhm rghinhepshhtrggtkhhovhgvrhhflhhofidrtghomhdptggrnhgrlhhsohhophgvrhgrth gvohhnsghunhgulhgvfhhilhgvshdrihhtnecuvehluhhsthgvrhfuihiivgeptdenucfr rghrrghmpehmrghilhhfrhhomhepkhhrihhsthhofhhfvghrhhgruhhgshgsrghkkhesfh grshhtmhgrihhlrdgtohhmpdhnsggprhgtphhtthhopeefpdhmohguvgepshhmthhpohhu thdprhgtphhtthhopehgihhtsehvghgvrhdrkhgvrhhnvghlrdhorhhgpdhrtghpthhtoh eptghouggvsehkhhgruhhgshgsrghkkhdrnhgrmhgvpdhrtghpthhtoheprghvrghrrggs sehgmhgrihhlrdgtohhm X-ME-Proxy: Feedback-ID: i8b11424c:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sun, 20 Oct 2024 15:15:28 -0400 (EDT) From: kristofferhaugsbakk@fastmail.com To: git@vger.kernel.org Cc: Kristoffer Haugsbakk , avarab@gmail.com Subject: [PATCH 2/4] Documentation/git-bundle.txt: mention full backup example Date: Sun, 20 Oct 2024 21:15:00 +0200 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: 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. diff --git a/Documentation/git-bundle.txt b/Documentation/git-bundle.txt index 7579dd309ac..bf0d448a736 100644 --- a/Documentation/git-bundle.txt +++ b/Documentation/git-bundle.txt @@ -26,6 +26,9 @@ 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. +You can use `git bundle create --all` to create a full backup of +your repository. + Git commands that fetch or otherwise "read" via protocols such as `ssh://` and `https://` can also operate on bundle files. It is possible linkgit:git-clone[1] a new repository from a bundle, to use From patchwork Sun Oct 20 19:15:01 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Kristoffer Haugsbakk X-Patchwork-Id: 13843225 Received: from fhigh-a5-smtp.messagingengine.com (fhigh-a5-smtp.messagingengine.com [103.168.172.156]) (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 65DC926AC3 for ; Sun, 20 Oct 2024 19:15:33 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.156 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729451735; cv=none; b=oYwhumNr3fn8pNfQksxSozpqvsoEAbBODbGWKOyeDnN44UkRZ7Z5PYIPiE0QVi1Z6S2MFUdX4r9SZi1mKwRG7coIHKtEw77YLUlYoRLT90tc+BVlvj7dJlopXIRbtYIw2Wp393cxTtIkXaiosjufP01Kb9otuu6cXGU7Ek/mttY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729451735; c=relaxed/simple; bh=bBUJGfXqLApaJvISgfFs5lI3HvmB8BQFJXBKFxR1ShQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=W1Fpi0mVdG4R+ZEpPhJCfG/pXhajJFT/O5cBW4/LZpejxTmMxC8VuZBt1Ppd0Dk3tWQer516YkCJyltI6vh2h56m/I+OyLfBoscYHWiEH4PU6XW8GuaPTuV+ZdQkpj5btf98edRlN+vvSo1JLCV2vY1Kna6vAKo/4772K/gb0Sc= 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=HWMgIUO5; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=m/sAez/C; arc=none smtp.client-ip=103.168.172.156 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="HWMgIUO5"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="m/sAez/C" Received: from phl-compute-06.internal (phl-compute-06.phl.internal [10.202.2.46]) by mailfhigh.phl.internal (Postfix) with ESMTP id 76ECF1140145; Sun, 20 Oct 2024 15:15:32 -0400 (EDT) Received: from phl-mailfrontend-01 ([10.202.2.162]) by phl-compute-06.internal (MEProxy); Sun, 20 Oct 2024 15:15:32 -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=1729451732; x=1729538132; bh=kaiciUjgduZ3ceg7eCnFvGMa4CI8e9VIGRC729QtW8U=; b= HWMgIUO5Zw6Tn4Fz/0vsedlR8NGTSaOiK2gAVue9JSTXYaz1DtrWCc0RsGIFb0BE HkgCfo/pbir4znp8lxT8882Lc4wYacaDNX7LH3QfQK09bUruw1AgiUohIsxN903/ nDclbJ8T3uHq5aQ8iWqIAitOSmt2BxRugdKEZz/A5jZgaXmz9yn0T/e1zX1ds7Vl D0+SHSVjQT/NpINFsHRWNLjMvOYS/Pw5/aXvgArQR/acTFU1wXKYPxdyqb0Ou0vv N9blXuwnnxHCVKrMPRhjM0uEC7aEuXt4YrRq6/e9fZHg5YoYT6nq7HWGUzQDI78r sGjb1YF7vWllIMA6hew4Mw== 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-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1729451732; x= 1729538132; bh=kaiciUjgduZ3ceg7eCnFvGMa4CI8e9VIGRC729QtW8U=; b=m /sAez/C2gAdlJ3/Wib9fZ+JHNbIaRzXWjThtT/+5SKEci9E3+WIkHA1UI5FQN+Al i11/o641YJ9loMf6PTSuNdjEsUls69DAESKSp6kV9n26f3Knjr0vi0JkFz3HScHt MMeTa0D6zXu70PhzedbMcTzq76AU369dWmQuLMllaYrhLa5c0UGSCYmofgewrOoY kaGbOErMivZUeKZeV8PJ7iKmfxdYw+LTXUwMd7288+rV6I4e31EsUuFAbcxlxXBi Ucep6/361dGAkNXIPZN92tAwgqT+/QkaDLfhMW7Z5q8WPGVTwn8U7nyRrK3fLFiw G6WsNkAu50bdaQPT4PDtw== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeftddrvdehjedgudefgecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvve fufffkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhh rghughhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpefhgf eglefhjeekgfetleetjefhteeiheegfedtudduffegjefhkeetudeggffhkeenucevlhhu shhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehkrhhishhtohhffh gvrhhhrghughhssggrkhhksehfrghsthhmrghilhdrtghomhdpnhgspghrtghpthhtohep fedpmhhouggvpehsmhhtphhouhhtpdhrtghpthhtohepghhithesvhhgvghrrdhkvghrnh gvlhdrohhrghdprhgtphhtthhopegtohguvgeskhhhrghughhssggrkhhkrdhnrghmvgdp rhgtphhtthhopegrvhgrrhgrsgesghhmrghilhdrtghomh X-ME-Proxy: Feedback-ID: i8b11424c:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sun, 20 Oct 2024 15:15:31 -0400 (EDT) From: kristofferhaugsbakk@fastmail.com To: git@vger.kernel.org Cc: Kristoffer Haugsbakk , avarab@gmail.com Subject: [PATCH 3/4] Documentation/git-bundle.txt: mention --all in spec. refs Date: Sun, 20 Oct 2024 21:15:01 +0200 Message-ID: <33980a47d132c9ea56238641031e72c5c7e2565a.1729451376.git.code@khaugsbakk.name> 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: 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 bf0d448a736..cf25e6e8540 100644 --- a/Documentation/git-bundle.txt +++ b/Documentation/git-bundle.txt @@ -135,7 +135,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 Sun Oct 20 19:15:02 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Kristoffer Haugsbakk X-Patchwork-Id: 13843226 Received: from fhigh-a5-smtp.messagingengine.com (fhigh-a5-smtp.messagingengine.com [103.168.172.156]) (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 D371E19580B for ; Sun, 20 Oct 2024 19:15:36 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.156 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729451738; cv=none; b=hIQQo01vSBc5dkMipvZZ9aN5IbRlysl3Vq0dJNs7AJT3x1+L78xccaM3P84sRnVA8uKhXIfhZpm7lhy8t2rXoTe17ta9/RiodKLnEXs0wBnshnGdAfsfpUnsDLoamKyx7HSt3iUvt8XR1Sj36BifOGMG8D5koA7fnJFEZHqjENY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729451738; c=relaxed/simple; bh=0+BgZkjSmyjRFmxz89GrCNbGDxwZ4PpB6LR0GQzEsdI=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=BLehVb855B/QY18ycZDt5xCqRt5b4NpGoHQEkoZDt52EZrp1VsqTfpFTYFKBPYF/wxVGz8jCCB+rvhqQkn0U4bv4C7/DKelR+hrDAutiiV0AD6giKF80zIzSBecdikJdUzBqzLCajySfPs2pInHZay1WIuZU2fBq1Rn5eYHjo3A= 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=U/c8tpGx; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=HsdUrvmo; arc=none smtp.client-ip=103.168.172.156 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="U/c8tpGx"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="HsdUrvmo" Received: from phl-compute-06.internal (phl-compute-06.phl.internal [10.202.2.46]) by mailfhigh.phl.internal (Postfix) with ESMTP id E58E51140179; Sun, 20 Oct 2024 15:15:35 -0400 (EDT) Received: from phl-mailfrontend-01 ([10.202.2.162]) by phl-compute-06.internal (MEProxy); Sun, 20 Oct 2024 15:15:35 -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=1729451735; x=1729538135; bh=Ano7V7VIyEJBflUNcHh9rZN5tCZP/ksRYK3rcV9kJbA=; b= U/c8tpGxG1Xe0Eq5MBsKiMcXQ4BbWTZULqorgnz8XQWYFeNtp4IBLs5TRElpcm0x IQNwRBWhMD83oLJ4EeMRtg/eBrWNGU9I54b6tbAQCcbdMK7otSrsyYYP5hm7x8VO DotthZambW5sr6E8K9gwEnAnAILNltLuKQ/Zj/lJgP7CA5HN8oi8XQGnqImkKx6h N1OTBmIWH+v3gTH6cHJ4euh7F9p22NdGeNNe+/iBjhUwbVyyCEfaoI8Y1FMhdLBc P7+4z66qGPerjLJtiXHnqDspKhg41AVubucOYphQpCske2xhgnk1VKc6EbT+ihxd 5HykjqoJZMYixCn9tl4VRw== 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-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1729451735; x= 1729538135; bh=Ano7V7VIyEJBflUNcHh9rZN5tCZP/ksRYK3rcV9kJbA=; b=H sdUrvmoyt0S3FVrp/iLQNKthJyfI93I+KR5hzCOEH3ghWY0maHO3aV73DfFqdVY4 EbHqch5dYxfrhcWAk3DicLvBGSTgmnkj66mRR+Diig3yvJOE/M+0LPAGQDyyNCpK AOGn5n6qbA32vjSD4Onx2+uxJ71gRcNgnlsPiwGMVAnuUHSuREYLx1k4m+s3DfWU WV7T3R+yLNanlEJ0xaBGoCBDXtYrZLalemGGzPDGZ+B+NHtRy9IOPVoB/f5Oc16Y m44CIRUj1WprF4xZiszFLTg8wR3TsHtDUaEMhUC/Sg7GMQQRjhRJ8LqjWTw84oXA yi3uY7/Sa6FHgvIsi1opQ== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeftddrvdehjedgudefgecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvve fufffkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhh rghughhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpefhgf eglefhjeekgfetleetjefhteeiheegfedtudduffegjefhkeetudeggffhkeenucevlhhu shhtvghrufhiiigvpedunecurfgrrhgrmhepmhgrihhlfhhrohhmpehkrhhishhtohhffh gvrhhhrghughhssggrkhhksehfrghsthhmrghilhdrtghomhdpnhgspghrtghpthhtohep fedpmhhouggvpehsmhhtphhouhhtpdhrtghpthhtohepghhithesvhhgvghrrdhkvghrnh gvlhdrohhrghdprhgtphhtthhopegtohguvgeskhhhrghughhssggrkhhkrdhnrghmvgdp rhgtphhtthhopegrvhgrrhgrsgesghhmrghilhdrtghomh X-ME-Proxy: Feedback-ID: i8b11424c:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sun, 20 Oct 2024 15:15:34 -0400 (EDT) From: kristofferhaugsbakk@fastmail.com To: git@vger.kernel.org Cc: Kristoffer Haugsbakk , avarab@gmail.com Subject: [PATCH 4/4] =?utf-8?q?Documentation/git-bundle=2Etxt=3A_discuss_na?= =?utf-8?q?=C3=AFve_backups?= Date: Sun, 20 Oct 2024 21:15:02 +0200 Message-ID: <63a431537b78e2d84a172b5c837adba6184a1f1b.1729451376.git.code@khaugsbakk.name> 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: 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): 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 cf25e6e8540..b5cc4746b45 100644 --- a/Documentation/git-bundle.txt +++ b/Documentation/git-bundle.txt @@ -324,6 +324,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[1], section "TRANSFERS" for a discussion of the +problems associated with file syncing across systems. + FILE FORMAT -----------