From patchwork Tue Oct 15 19:03:10 2024
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-Patchwork-Submitter: Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
X-Patchwork-Id: 13836983
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 E9D141F80BE
	for <git@vger.kernel.org>; Tue, 15 Oct 2024 19:05: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=1729019107; cv=none;
 b=dXBlPxkiRbg4KVfLBg4Iv3uTgouzyzapGmFVaips/yMj9pDvgNBeHFByAFegm0/pgondBBXbX+Q4rTD9x6A16fJZGryYHg7hXHZfru3h6WXCORlIav+FIUq2ai7BsCZQ0mvn1eGZGKAm2NCxYiQMuhuWTIfLl6v4H8mXhBJao3Y=
ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org;
	s=arc-20240116; t=1729019107; c=relaxed/simple;
	bh=z8HdXqGUY5mXcPSq8Zu6DewopHPuqxNZFZP26CAMcgE=;
	h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References:
	 MIME-Version:Content-Type;
 b=AkBJI4UDSc9MxK8CKtcaTRd6glat2DdW1v7CPDz55IXG/oR5/iGmAn3EZG3Ie4oxX5Q0RWxOovN/Zw/d8ygOqCdqJyIxV/pu58b9qpp+/RNzlb789DtjMCVexMpAJyg9xKif5oOrmUNV09sB/3dlCpIB9bpLVs4de8qHWB2W8Tw=
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=JrdfRQBN;
 dkim=pass (2048-bit key) header.d=messagingengine.com
 header.i=@messagingengine.com
 header.b=n5GKAorw; 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="JrdfRQBN";
	dkim=pass (2048-bit key) header.d=messagingengine.com
 header.i=@messagingengine.com header.b="n5GKAorw"
Received: from phl-compute-01.internal (phl-compute-01.phl.internal
 [10.202.2.41])
	by mailfout.phl.internal (Postfix) with ESMTP id DEE791380208;
	Tue, 15 Oct 2024 15:05:04 -0400 (EDT)
Received: from phl-mailfrontend-01 ([10.202.2.162])
  by phl-compute-01.internal (MEProxy); Tue, 15 Oct 2024 15:05: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=fm2; t=1729019104;
	 x=1729105504; bh=wRxXC2uikfYIstg5i3zgwyPvm+NpX25UmAeVRp9V8Lg=; b=
	JrdfRQBNgtxbvfNyLyIRBrykL6bP9E68knxlH2ILmZBGDQASzs+rncK0DAELVasM
	682ZCnqUrxiqXYwhvMgmqrLt1v1LgpWQc82aYm+7fuEU7lj58kqiBL5Cayj0U+TH
	4Pbu7519ZezR8+0q46faKpm/KRoWS3gq7XgkSPux7W3v534jc7NVJsZGcSiKYqqG
	HY1TPNZgzkCEvGlk+YNb8nfpH6XKO0/yhHGzH45486V4nv+dZhO4cgkZ7VQmYWTe
	iTDTZRq86N2osWtxG2S86Wb3BJrvxMvwK/cjwZayLyWm7hisDpGw2HNLOCyB46Ci
	3O9UHgYDotkyu8v3mOLsOg==
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=fm2; t=1729019104; x=
	1729105504; bh=wRxXC2uikfYIstg5i3zgwyPvm+NpX25UmAeVRp9V8Lg=; b=n
	5GKAorw5M9KKrZqZ0GwsR6ak2VNgZs9/Mmlt46uKZ17MdNhSlHwLaP07hJfJpmbh
	/B3H2wONek+h/BeV/13BtXZi41Br8Hyl+i4dLShWZcm58/VoLvuRWvaUaQiJtTSF
	TDwyBcVCCc+FLgeAc//qs2QTVsJM789eUtkt4EXkSYoy9aR7zNurMH9YbRZdm2Sw
	6nttXjrfQD63/W59ecnGDD5MSjSLlo/qr/TS6zdyB+nkvBAHPtX3q9WROkf57u05
	wI7jXuWttFUPsIIPlShq4FoqsbVjkkrn39e2msmm51hggl20J/McCFm6NGENhYDL
	QlWJcW4nB8o0XUzB3g6hg==
X-ME-Sender: <xms:4LwOZ05XO9OjR88KY_Kt38MpwzIUgASkHNJyu7NhzlMNN3AlXJpVdnY>
    <xme:4LwOZ15ckqjR-Zhk-94aQbycJlrskNGvcwrHUG8oJTK4zQm3xJCSUDX9ym1yXP7An
    zzMzVCHlqP-i2ldIQ>
X-ME-Received: 
 <xmr:4LwOZzcgVue06avuce3eKIWh1dU7TVkK3q760B2mNyYKVE2Xgwz_i3ahl8jhcH2GEwsYKhMEieS3USXmQPFDMM2ZjiECNNq2SiTUIZZavg>
X-ME-Proxy-Cause: 
 gggruggvucftvghtrhhoucdtuddrgeeftddrvdegjedgudeffecutefuodetggdotefrod
    ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp
    uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvve
    fufffkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhh
    rghughhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpefhgf
    eglefhjeekgfetleetjefhteeiheegfedtudduffegjefhkeetudeggffhkeenucevlhhu
    shhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehkrhhishhtohhffh
    gvrhhhrghughhssggrkhhksehfrghsthhmrghilhdrtghomhdpnhgspghrtghpthhtohep
    iedpmhhouggvpehsmhhtphhouhhtpdhrtghpthhtohepghhithesvhhgvghrrdhkvghrnh
    gvlhdrohhrghdprhgtphhtthhopegtohguvgeskhhhrghughhssggrkhhkrdhnrghmvgdp
    rhgtphhtthhopehphhhilhhlihhprdifohhougesughunhgvlhhmrdhorhhgrdhukhdprh
    gtphhtthhopehgihhtshhtvghrsehpohgsohigrdgtohhmpdhrtghpthhtohepsggvnhgt
    vgesfhgvrhguihhnrghnugihrdgtohhmpdhrtghpthhtohepkhgrrhhthhhikhdrudekke
    esghhmrghilhdrtghomh
X-ME-Proxy: <xmx:4LwOZ5KNNIqtfei8PBhhopAMMcnLT5jW4ApCWn7NUecF3T_SoNbwNA>
    <xmx:4LwOZ4I3bWqhesQ78vm8jV4WsnE7zSEY3duga6GCoR6jP-P6Yqfk-g>
    <xmx:4LwOZ6wKHtkrtrHlInni_5KT_UB44O-u7sn2kslMSq_hPW9tpKdQ8Q>
    <xmx:4LwOZ8KkjuDDw6gPCqL8NWq4jZuqCIG0NnYi2a_Jaa3uCgFsdcTM4g>
    <xmx:4LwOZw8shZM1x3C0TTlNRb6K8v90YujZPKsAKs91sfZpy3SqukteNcB2>
Feedback-ID: i8b11424c:Fastmail
Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue,
 15 Oct 2024 15:05:02 -0400 (EDT)
From: kristofferhaugsbakk@fastmail.com
To: git@vger.kernel.org
Cc: Kristoffer Haugsbakk <code@khaugsbakk.name>,
	phillip.wood@dunelm.org.uk,
	gitster@pobox.com,
	bence@ferdinandy.com,
	karthik.188@gmail.com
Subject: [PATCH 1/6] =?utf-8?b?ZG9jOiB1cGRhdGUtcmVmOiBkcm9wIOKAnGZsYWfigJ0=?=
Date: Tue, 15 Oct 2024 21:03:10 +0200
Message-ID: 
 <ad9ee00a2a971522968f95dd413deae24839ef71.1729017728.git.code@khaugsbakk.name>
X-Mailer: git-send-email 2.46.1.641.g54e7913fcb6
In-Reply-To: <cover.1729017728.git.code@khaugsbakk.name>
References: 
 <CAOLa=ZQJy1ZkQqBoWwJJvL0f+NCP=3SAfyeSNuztgApzNH1mGg@mail.gmail.com>
 <cover.1729017728.git.code@khaugsbakk.name>
Precedence: bulk
X-Mailing-List: git@vger.kernel.org
List-Id: <git.vger.kernel.org>
List-Subscribe: <mailto:git+subscribe@vger.kernel.org>
List-Unsubscribe: <mailto:git+unsubscribe@vger.kernel.org>
MIME-Version: 1.0
X-Commit-Hash: ad9ee00a2a971522968f95dd413deae24839ef71

From: Kristoffer Haugsbakk <code@khaugsbakk.name>

The other paragraphs on options say `With <option>,`.  Let’s be uniform.

Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
---
 Documentation/git-update-ref.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/git-update-ref.txt b/Documentation/git-update-ref.txt
index afcf33cf608..fe5967234e9 100644
--- a/Documentation/git-update-ref.txt
+++ b/Documentation/git-update-ref.txt
@@ -55,7 +55,7 @@ for reading but not for writing (so we'll never write through a
 ref symlink to some other tree, if you have copied a whole
 archive by creating a symlink tree).
 
-With `-d` flag, it deletes the named <ref> after verifying it
+With `-d`, it deletes the named <ref> after verifying it
 still contains <old-oid>.
 
 With `--stdin`, update-ref reads instructions from standard input and

From patchwork Tue Oct 15 19:03:11 2024
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-Patchwork-Submitter: Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
X-Patchwork-Id: 13836984
Received: from fhigh-a3-smtp.messagingengine.com
 (fhigh-a3-smtp.messagingengine.com [103.168.172.154])
	(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 7053D1F80BE
	for <git@vger.kernel.org>; Tue, 15 Oct 2024 19:05:10 +0000 (UTC)
Authentication-Results: smtp.subspace.kernel.org;
 arc=none smtp.client-ip=103.168.172.154
ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;
	t=1729019112; cv=none;
 b=S8ovDXdJ3iXLRT1wAiHofQYM0RPWjZyqT58vCnoE3fH/C+mBkIGBBQ8WyGk8Mbx8MK5foUWZqLPJVQfSOfEsiEtfBfddhDAynyASCZ85P3H1F8HW5k6RmMDt57RUFBdG5BDkTHiSWIVumIa4WzHlclT/Kb5ABz5bisKhxV8a4Eg=
ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org;
	s=arc-20240116; t=1729019112; c=relaxed/simple;
	bh=Vc70rSkACb+z9LN3VBa9wiuQtXp+uCaKgpKZHMWS284=;
	h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References:
	 MIME-Version:Content-Type;
 b=YYMS9Qc0gp6bxkRk33HLd1o+loxLOts1meXw3LC6ONFQW0MIWUvBQ0XxxNu2aQUv9U9kBc4ohED0OTmWvpVEnUo47GdvJ0iu/OylqLOuztcEwmGBaXMO0zcvOAFwtuKQxiYZmzwWtOs72xr0OCSxjRIs3kSVlhVNUKItKOSbnRo=
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=ZqJWkIg6;
 dkim=pass (2048-bit key) header.d=messagingengine.com
 header.i=@messagingengine.com
 header.b=WPDs15Re; arc=none smtp.client-ip=103.168.172.154
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="ZqJWkIg6";
	dkim=pass (2048-bit key) header.d=messagingengine.com
 header.i=@messagingengine.com header.b="WPDs15Re"
Received: from phl-compute-05.internal (phl-compute-05.phl.internal
 [10.202.2.45])
	by mailfhigh.phl.internal (Postfix) with ESMTP id 8AA9F1140155;
	Tue, 15 Oct 2024 15:05:09 -0400 (EDT)
Received: from phl-mailfrontend-02 ([10.202.2.163])
  by phl-compute-05.internal (MEProxy); Tue, 15 Oct 2024 15:05:09 -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=fm2; t=1729019109;
	 x=1729105509; bh=Bhrv7252ZG4qY1DnpP0qMysTLtZ7/itaY1GIjmU7wzQ=; b=
	ZqJWkIg6nP0sgAYfQ8Cdbi/obToh0nCxgNuaNEfQYCHBQS8WUU9Pv751ETn609f/
	vMXHOKXAM718xQh66a30oLsdJ3FhMS5yc3aq4XVpz+Y7evMCssd0TC88UvsJ75Ii
	ryFec4uQeg9+BaKRPdGOqYAYiQRl3mmKXUGgrYpan3F6X1tPQA8q6garEIMU71I0
	szBu/H2DlGdC8YWhteaD7waPoU7exsN3mJ8cC7UA79pexl6o+Gi6D/e8l+LMkOUI
	HbRmkaX9HBCTc4WN6P0BvuYAcu2eYDZqQA6IyQk3nx9ov/SptMhHhVkocKd+p/3/
	TwDZKsKtXd520x0XKPgM5w==
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=fm2; t=1729019109; x=
	1729105509; bh=Bhrv7252ZG4qY1DnpP0qMysTLtZ7/itaY1GIjmU7wzQ=; b=W
	PDs15RenO5tC62VOerDP7+9JQg+TONPsQJ9V3E/qNveOmWHLRotTNAqdFEaoZIcd
	jJzuzWoeNikAnDD8TUxIsIeS64bPNPYFp0SCyHiCTNV4DBodLbHy5wtxtvV+lFYs
	zL41PwOlVjFhLAqrJa4/VIxF1FNjQwB4E9XQ82zBrB7VLGE3YiG1gNdF62i/Jmk1
	ED1Fx5opwCPUKKxpYkDitFItcHlGkjC/Quq5tsEOhPQHyRev/KSad3orAAZbHTm8
	FxNyKLGkieg10R3kQtxFgmp4atskW682BRu5nygS6sDkzdHwP3U+3VcybsceD9tm
	/sFLBKa6dCMronktVnGLA==
X-ME-Sender: <xms:5bwOZ2T8ol0aPfvQSz91VUJaOOWpM0acVhHqtaqKweI_loXZ9hRWQRM>
    <xme:5bwOZ7xqTflBOAufYqnGepMVPY7mCJn51GyPaWbd2z0JDXoKsctu4Mmj0y-4PS-mB
    cyNdQVxrGhEktcvQQ>
X-ME-Received: 
 <xmr:5bwOZz2yixhqaMgBW6jsSZGDK_MJmQAHDvlOL6PwwdrJK1RERXzg076I9K3SQiMNDHz7Z_WHf0chfB6kUnHSiRc_WiVqX-PByBzB6PWcpA>
X-ME-Proxy-Cause: 
 gggruggvucftvghtrhhoucdtuddrgeeftddrvdegjedgudefvdcutefuodetggdotefrod
    ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp
    uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvve
    fufffkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhh
    rghughhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpefhgf
    eglefhjeekgfetleetjefhteeiheegfedtudduffegjefhkeetudeggffhkeenucevlhhu
    shhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehkrhhishhtohhffh
    gvrhhhrghughhssggrkhhksehfrghsthhmrghilhdrtghomhdpnhgspghrtghpthhtohep
    iedpmhhouggvpehsmhhtphhouhhtpdhrtghpthhtohepghhithesvhhgvghrrdhkvghrnh
    gvlhdrohhrghdprhgtphhtthhopegtohguvgeskhhhrghughhssggrkhhkrdhnrghmvgdp
    rhgtphhtthhopehphhhilhhlihhprdifohhougesughunhgvlhhmrdhorhhgrdhukhdprh
    gtphhtthhopehgihhtshhtvghrsehpohgsohigrdgtohhmpdhrtghpthhtohepsggvnhgt
    vgesfhgvrhguihhnrghnugihrdgtohhmpdhrtghpthhtohepkhgrrhhthhhikhdrudekke
    esghhmrghilhdrtghomh
X-ME-Proxy: <xmx:5bwOZyAevXDkWVMR9zCLCwQzaxsaniwwkiJs9Uo8mGcbjeryBdyl1w>
    <xmx:5bwOZ_hXWqvkq--1TJSL8Ca0ZNh39Eadqt3-V6ntYMNJpdZoLPNobg>
    <xmx:5bwOZ-rgBsoIxYqRyXJ4gvmT191vlSMN2Sbb_o3SSIbx9nP6GByWSQ>
    <xmx:5bwOZyiRVel3aRC8nbjaBzbl_7kQkW9TKT8XScJInznjfFimiDAAdQ>
    <xmx:5bwOZ6VCGJW_jmLKZNgZ260tSRadfzxsdDa4tqz3qwyjN1HQS9j8Fw5V>
Feedback-ID: i8b11424c:Fastmail
Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue,
 15 Oct 2024 15:05:07 -0400 (EDT)
From: kristofferhaugsbakk@fastmail.com
To: git@vger.kernel.org
Cc: Kristoffer Haugsbakk <code@khaugsbakk.name>,
	phillip.wood@dunelm.org.uk,
	gitster@pobox.com,
	bence@ferdinandy.com,
	karthik.188@gmail.com
Subject: [PATCH 2/6] doc: update-ref: remove safety paragraphs
Date: Tue, 15 Oct 2024 21:03:11 +0200
Message-ID: 
 <c4bc0553a30ac16bd242edf387280eea37aa3a07.1729017728.git.code@khaugsbakk.name>
X-Mailer: git-send-email 2.46.1.641.g54e7913fcb6
In-Reply-To: <cover.1729017728.git.code@khaugsbakk.name>
References: 
 <CAOLa=ZQJy1ZkQqBoWwJJvL0f+NCP=3SAfyeSNuztgApzNH1mGg@mail.gmail.com>
 <cover.1729017728.git.code@khaugsbakk.name>
Precedence: bulk
X-Mailing-List: git@vger.kernel.org
List-Id: <git.vger.kernel.org>
List-Subscribe: <mailto:git+subscribe@vger.kernel.org>
List-Unsubscribe: <mailto:git+unsubscribe@vger.kernel.org>
MIME-Version: 1.0
X-Commit-Hash: c4bc0553a30ac16bd242edf387280eea37aa3a07

From: Kristoffer Haugsbakk <code@khaugsbakk.name>

Remove paragraphs which explain that using this command is safer than
echoing the branch name into `HEAD`.

These paragraphs have been part of the documentation since the
documentation was created in 129056370ab (Add missing documentation.,
2005-10-04), back when the command synopsis was a lot simpler:

    `git-update-ref` <ref> <newvalue> [<oldvalue>]

These paragraphs don’t interrupt the flow of the document on that
revision since it is at the end.  Now though it is placed after the
description of `--no-deref` and before `-d` and `--stdin`.  Covering all
the options is more generally interesting than a safety note about a
naïve `HEAD` management.

Such a safety warning is also much less relevant now, considering that
everyone who isn’t intentionally poking at the internal implementation
is using porcelain commands to manage `HEAD`.

Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
---
 Documentation/git-update-ref.txt | 15 ---------------
 1 file changed, 15 deletions(-)

diff --git a/Documentation/git-update-ref.txt b/Documentation/git-update-ref.txt
index fe5967234e9..ec268b1426d 100644
--- a/Documentation/git-update-ref.txt
+++ b/Documentation/git-update-ref.txt
@@ -40,21 +40,6 @@ somewhere else with a regular filename).
 If --no-deref is given, <ref> itself is overwritten, rather than
 the result of following the symbolic pointers.
 
-In general, using
-
-	git update-ref HEAD "$head"
-
-should be a _lot_ safer than doing
-
-	echo "$head" > "$GIT_DIR/HEAD"
-
-both from a symlink following standpoint *and* an error checking
-standpoint.  The "refs/" rule for symlinks means that symlinks
-that point to "outside" the tree are safe: they'll be followed
-for reading but not for writing (so we'll never write through a
-ref symlink to some other tree, if you have copied a whole
-archive by creating a symlink tree).
-
 With `-d`, it deletes the named <ref> after verifying it
 still contains <old-oid>.
 

From patchwork Tue Oct 15 19:03:12 2024
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-Patchwork-Submitter: Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
X-Patchwork-Id: 13836985
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 6DCFF1F80CC
	for <git@vger.kernel.org>; Tue, 15 Oct 2024 19:05:13 +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=1729019115; cv=none;
 b=Z+9NblTeGylJs8iE769lWsPQkkjWDNUIr/X6e+c2cqq4qqHKhTBMB/B4NZbU807fMBvc+Tyj+V6MnvJt0Fe14JspH5K7F/tpgcz/br9ur2VPyxUYVOOYO0dbHl5T/mXPTIrMghz9u2zb8VsnSBVuX4gO0J/uNXI/Kde19li22Ns=
ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org;
	s=arc-20240116; t=1729019115; c=relaxed/simple;
	bh=mQWXbJCo3ZthSAMX1YkIYlCRwPG5xAphUX33efYRg00=;
	h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References:
	 MIME-Version:Content-Type;
 b=jQLJUkgMh1N5aDZb1wGmM02vA9u1wSJQMqNx+qezg59uBnMhjUlTgoIJWaFQW99jZJZMLDttGZLXHpFXEbu6prmpZrqv8Kp9c/xrA4vjQC8/DTIJZeZwcRROlk0OvIAIZSj6TH1NjQiHmXcjruH3++tATJAEotU0GFsO5oMrq1M=
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=LYU3L5xU;
 dkim=pass (2048-bit key) header.d=messagingengine.com
 header.i=@messagingengine.com
 header.b=oKafn06U; 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="LYU3L5xU";
	dkim=pass (2048-bit key) header.d=messagingengine.com
 header.i=@messagingengine.com header.b="oKafn06U"
Received: from phl-compute-07.internal (phl-compute-07.phl.internal
 [10.202.2.47])
	by mailfout.phl.internal (Postfix) with ESMTP id 9093A138010C;
	Tue, 15 Oct 2024 15:05:12 -0400 (EDT)
Received: from phl-mailfrontend-02 ([10.202.2.163])
  by phl-compute-07.internal (MEProxy); Tue, 15 Oct 2024 15:05:12 -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=fm2; t=1729019112;
	 x=1729105512; bh=8npD8EdiYf6ydygU9OnYqaJXF5OLp1GzMK34kNOvddw=; b=
	LYU3L5xUChjimRr5ZYFNkwVoHSsGXa+xR2iRUye8VIfMNEVF7kOHtqaFWCnWSyMk
	tihj7c/0dnmNN7Tp6bcCbmq+w2V18T5m4NszEQ6Fd7de0yE+gbMeWF3PQxqvqa/Q
	Nh8G6Q2i5qWMLgAUtDOfjS5xgi8CT9t8MJ9kvC/tFDSfmYfH6fTDFiibnsHYKaYD
	5iRpIqGSaT/r24UajNLBuLVwx8jnRod1BktTJkweibntlzfgz+e0ZU4zES54ars4
	AyT4zL4CnHeV0ZO/jufcjTsLeS+ryRob56kYUx07TVy0mdJLVhY0VhOLEK/wvSrN
	uaStBmHEUZJs4QiMWXZE9Q==
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=fm2; t=1729019112; x=
	1729105512; bh=8npD8EdiYf6ydygU9OnYqaJXF5OLp1GzMK34kNOvddw=; b=o
	Kafn06ULqp6/5DU2MAK4ZFCoWI3PLENWNdi2nAhJ7HqTJCXAHaK3hopC3udSFY31
	4Bv3U9gVcnmCq1M+FL2Ed40Q1DDQrunKave9nqnT2s495GBpqu6fWVI2HUF3zalb
	trja54FNms2anHNMFrHp2y1PX4jTUgzozA/JW+HWyQ4520q8foJByoxxVtlNZ5G7
	sc/5v8jjWDEPMV7Py29YM3VWXSd6JL1pMSfTrrnRz9FcmKHc/GVp+/YczDMk/sEn
	Foac/hSOakHxIbTeginB9qleWKxEHJQUSUoTP3aMSxCwXaFMgo6BLJ28ARwKeOh9
	WB4QlKo0f2307W+/AkFsg==
X-ME-Sender: <xms:6LwOZ_FKSX9vbTQ94AL5WImxtBNloUb4yJ9AUs_0eQBAYeRp6-AZ5Y4>
    <xme:6LwOZ8WKq2eOMmz_BsUR9Cw-0tnt3WWbFGuo0aLW6wpAu02GWb5HfYBQgBToqVc5D
    BcPcRbFCPgIlLk2nA>
X-ME-Received: 
 <xmr:6LwOZxJss_30ReqlxPUMUPNPaAl7PNF7epvtBUmwXTQxuz6Ng38cxFalZYoYe5eab-uQgTzkU3iCLB48xeO1S--YRHl4mv-KthKOCVKRIw>
X-ME-Proxy-Cause: 
 gggruggvucftvghtrhhoucdtuddrgeeftddrvdegjedgudefvdcutefuodetggdotefrod
    ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp
    uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvve
    fufffkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhh
    rghughhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpefhgf
    eglefhjeekgfetleetjefhteeiheegfedtudduffegjefhkeetudeggffhkeenucevlhhu
    shhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehkrhhishhtohhffh
    gvrhhhrghughhssggrkhhksehfrghsthhmrghilhdrtghomhdpnhgspghrtghpthhtohep
    iedpmhhouggvpehsmhhtphhouhhtpdhrtghpthhtohepghhithesvhhgvghrrdhkvghrnh
    gvlhdrohhrghdprhgtphhtthhopegtohguvgeskhhhrghughhssggrkhhkrdhnrghmvgdp
    rhgtphhtthhopehphhhilhhlihhprdifohhougesughunhgvlhhmrdhorhhgrdhukhdprh
    gtphhtthhopehgihhtshhtvghrsehpohgsohigrdgtohhmpdhrtghpthhtohepsggvnhgt
    vgesfhgvrhguihhnrghnugihrdgtohhmpdhrtghpthhtohepkhgrrhhthhhikhdrudekke
    esghhmrghilhdrtghomh
X-ME-Proxy: <xmx:6LwOZ9Gb-LkAO7eR2aT4MjX37jfhRR0KKadOOkApXuV0zopa6WOdSg>
    <xmx:6LwOZ1Xix6lFx8vM29R4w9ZkCySO_OCNb5S7HoQYfYsJVn294Nm8vg>
    <xmx:6LwOZ4NYtrxIHfgiNrbQjnNJxP0X7OKaL2f3vZUHabx7YJS-9K3Pew>
    <xmx:6LwOZ03zitLANGV68RmMvAZ-DIwWR_m45wYQC4gN2cHBmg5GP5Sd4g>
    <xmx:6LwOZ3JO0-RxgvnSCCM-emjOGMeCw8-IiPmXuDGSEL_3Y0NhBjz_Y5WH>
Feedback-ID: i8b11424c:Fastmail
Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue,
 15 Oct 2024 15:05:11 -0400 (EDT)
From: kristofferhaugsbakk@fastmail.com
To: git@vger.kernel.org
Cc: Kristoffer Haugsbakk <code@khaugsbakk.name>,
	phillip.wood@dunelm.org.uk,
	gitster@pobox.com,
	bence@ferdinandy.com,
	karthik.188@gmail.com
Subject: [PATCH 3/6] doc: update-ref: demote symlink to last section
Date: Tue, 15 Oct 2024 21:03:12 +0200
Message-ID: 
 <3f43ddfed24e89ab9931b83e549f0eb8bc829928.1729017728.git.code@khaugsbakk.name>
X-Mailer: git-send-email 2.46.1.641.g54e7913fcb6
In-Reply-To: <cover.1729017728.git.code@khaugsbakk.name>
References: 
 <CAOLa=ZQJy1ZkQqBoWwJJvL0f+NCP=3SAfyeSNuztgApzNH1mGg@mail.gmail.com>
 <cover.1729017728.git.code@khaugsbakk.name>
Precedence: bulk
X-Mailing-List: git@vger.kernel.org
List-Id: <git.vger.kernel.org>
List-Subscribe: <mailto:git+subscribe@vger.kernel.org>
List-Unsubscribe: <mailto:git+unsubscribe@vger.kernel.org>
MIME-Version: 1.0
X-Commit-Hash: 3f43ddfed24e89ab9931b83e549f0eb8bc829928

From: Kristoffer Haugsbakk <code@khaugsbakk.name>

Move the discussion of file system symbolic links to a new “Notes”
section (inspired by the one in git-symbolic-ref(1)) since this is
mostly of historical note at this point, not something that is needed in
the main section of the documentation.

Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
---
 Documentation/git-update-ref.txt | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/Documentation/git-update-ref.txt b/Documentation/git-update-ref.txt
index ec268b1426d..c03e65404e8 100644
--- a/Documentation/git-update-ref.txt
+++ b/Documentation/git-update-ref.txt
@@ -29,14 +29,6 @@ It also allows a "ref" file to be a symbolic pointer to another
 ref file by starting with the four-byte header sequence of
 "ref:".
 
-More importantly, it allows the update of a ref file to follow
-these symbolic pointers, whether they are symlinks or these
-"regular file symbolic refs".  It follows *real* symlinks only
-if they start with "refs/": otherwise it will just try to read
-them and update them as a regular file (i.e. it will allow the
-filesystem to follow them, but will overwrite such a symlink to
-somewhere else with a regular filename).
-
 If --no-deref is given, <ref> itself is overwritten, rather than
 the result of following the symbolic pointers.
 
@@ -185,6 +177,17 @@ An update will fail (without changing <ref>) if the current user is
 unable to create a new log file, append to the existing log file
 or does not have committer information available.
 
+NOTES
+-----
+
+Symbolic refs were initially implemented using symbolic links.  This is
+now deprecated since not all filesystems support symbolic links.
+
+This command follows *real* symlinks only if they start with "refs/":
+otherwise it will just try to read them and update them as a regular
+file (i.e. it will allow the filesystem to follow them, but will
+overwrite such a symlink to somewhere else with a regular filename).
+
 GIT
 ---
 Part of the linkgit:git[1] suite

From patchwork Tue Oct 15 19:03:13 2024
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-Patchwork-Submitter: Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
X-Patchwork-Id: 13836986
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 7674F1F80D6
	for <git@vger.kernel.org>; Tue, 15 Oct 2024 19:05:16 +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=1729019118; cv=none;
 b=GpD8JMPjHlHhVOf34gw1zKEJwIh7+CXxvkwrd20YsAMXIQYRSFPlaILjNrMSbYL5PNADe7WPrpimbffj+xWDGx4NlnQZlCc6Hx0dWiu9jDHX2E0DseAAJjDymGXl+HDygxxIceUwta8alS5A/Drwny0NYAheSP9I2OxSPnaZoXU=
ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org;
	s=arc-20240116; t=1729019118; c=relaxed/simple;
	bh=XH03Q/6S5f3+U1XDnnPSNOAJM2a3z899KznDiJkvdnk=;
	h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References:
	 MIME-Version:Content-Type;
 b=She/S6dI3O8p576412Lwexg+ghwf8DELcUsMdhR0tCwk42mpIBG4awPwDlQxEzPRcXa8glM0/6vzdyCZsGAvLwLYY8perGdc7QIkkzuK8c6aGbudMXg5WSWTvXMe3jyqKeipzDG3FHvFd6PCvfki1rvI6g3+2Mkt7QGQNJAPsLc=
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=pxQztXoF;
 dkim=pass (2048-bit key) header.d=messagingengine.com
 header.i=@messagingengine.com
 header.b=JsfcLQDf; 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="pxQztXoF";
	dkim=pass (2048-bit key) header.d=messagingengine.com
 header.i=@messagingengine.com header.b="JsfcLQDf"
Received: from phl-compute-02.internal (phl-compute-02.phl.internal
 [10.202.2.42])
	by mailfout.phl.internal (Postfix) with ESMTP id AB177138010C;
	Tue, 15 Oct 2024 15:05:15 -0400 (EDT)
Received: from phl-mailfrontend-02 ([10.202.2.163])
  by phl-compute-02.internal (MEProxy); Tue, 15 Oct 2024 15:05:15 -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=fm2; t=1729019115;
	 x=1729105515; bh=feCi2vp98FKxMXpE9+R2KruHO6AoQLoZqk3bBDpY0xg=; b=
	pxQztXoF9h0RJP1q/gTPUZi7esuH1I+ubje3dp26Qhtzgl3EXzBGqj5JkGAQ8VTt
	umlBobkTp4BCPFnuyHadfJxg8CcX6ETxbXD02VAW/GDDZwKxsJDpDckIjS0BT+V3
	/Wgo+zVcLFnvSVOjll6yIrTKZU6WY/uRkzeawkfwjwjg3TWP+O0CIHg9+S2a0ifI
	4O4zjt1E98FD2pFpAAh7BkXmCVsQRYN5/O1/Rc7LLZlkDOuV2NxOa0gci7z+MvBW
	2dnFtxVg5Sj0GEAO6W4E21FzkeGFiYxX9GyZu0gbxUsmlQim3tNcvBH1tS54NmZa
	kNSgsVkyRHAkACvGUT2ZcQ==
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=fm2; t=1729019115; x=
	1729105515; bh=feCi2vp98FKxMXpE9+R2KruHO6AoQLoZqk3bBDpY0xg=; b=J
	sfcLQDf9FK+fJ7uHB2i8At0FDI7xqGNI/mxylnG+y4S3DQWIXmoGRUDv51WJ9jXT
	FXoMNS9gy+5HNkPLv27VIg7xD2ud6xQG76lv+OyR7A3iewjvZ/xkN2q+vYzvuy0G
	Tgvecdz8yrkBn+oA6NiJfnYdIPvJS9uKV8PC0SxHi11FwuufQZn8ttWSo0cA3m8K
	fi4a10ad/zVFuJdX/khVFSKVIONM/AyQ2dUp1+9pBlNn43p7ao49QUkpL07KB+UW
	Wo1hZ4F10XY/7ZCnT5sWB72err5EA2pHmkjv7i+/rK05UdP+CHdgq59et4XqSmBY
	BFIwcIA/MoWxEG1K2oRCg==
X-ME-Sender: <xms:67wOZ5480YLAyhrPKcDUupgz9-1bxAq6Q2PCGy9oui1eZ0mkgRR9DTs>
    <xme:67wOZ27fKt0WkoBE1i8l1bZn5Rzbt7XxFaR0RveXCF6dFRbhyOctyda0qmFRqIZtc
    k46lznqcL9ftOrsEw>
X-ME-Received: 
 <xmr:67wOZwdOxgRbENyZFCwMLqAzweRAiTRjkOLoXblJ1WsAFCJd_5R5BfP41JUOoqZHPSak9jSmh_baffo2avPkh7D5DvQooHNv_VbIQ_vvrA>
X-ME-Proxy-Cause: 
 gggruggvucftvghtrhhoucdtuddrgeeftddrvdegjedgudefvdcutefuodetggdotefrod
    ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp
    uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvve
    fufffkofgjfhggtgfgsehtkeertdertdejnecuhfhrohhmpehkrhhishhtohhffhgvrhhh
    rghughhssggrkhhksehfrghsthhmrghilhdrtghomhenucggtffrrghtthgvrhhnpefhgf
    eglefhjeekgfetleetjefhteeiheegfedtudduffegjefhkeetudeggffhkeenucevlhhu
    shhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehkrhhishhtohhffh
    gvrhhhrghughhssggrkhhksehfrghsthhmrghilhdrtghomhdpnhgspghrtghpthhtohep
    iedpmhhouggvpehsmhhtphhouhhtpdhrtghpthhtohepghhithesvhhgvghrrdhkvghrnh
    gvlhdrohhrghdprhgtphhtthhopegtohguvgeskhhhrghughhssggrkhhkrdhnrghmvgdp
    rhgtphhtthhopehphhhilhhlihhprdifohhougesughunhgvlhhmrdhorhhgrdhukhdprh
    gtphhtthhopehgihhtshhtvghrsehpohgsohigrdgtohhmpdhrtghpthhtohepsggvnhgt
    vgesfhgvrhguihhnrghnugihrdgtohhmpdhrtghpthhtohepkhgrrhhthhhikhdrudekke
    esghhmrghilhdrtghomh
X-ME-Proxy: <xmx:67wOZyLv4HeuEbwfZoP51ErV-CaiHfRIBMp6zgHdkrgfmuPViNSe9Q>
    <xmx:67wOZ9IhOk1sh86uiidKTai0lhQQ6YS2snosTPy3vNmbsO9CySKg2w>
    <xmx:67wOZ7yuoebSLCrbAQqRD_KCMUmiEm4YCSdOIyb46sovuBTXZDULCg>
    <xmx:67wOZ5LfwQVNwJq_fOJDmlN_StozQhJTO5ZyPIekQsnPPPZ9jyE9LA>
    <xmx:67wOZ18Fnzw89nC2e2TEgnpWPXHH2rrU33RqKMHPgzhbR3CbuW3xs_Kz>
Feedback-ID: i8b11424c:Fastmail
Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue,
 15 Oct 2024 15:05:14 -0400 (EDT)
From: kristofferhaugsbakk@fastmail.com
To: git@vger.kernel.org
Cc: Kristoffer Haugsbakk <code@khaugsbakk.name>,
	phillip.wood@dunelm.org.uk,
	gitster@pobox.com,
	bence@ferdinandy.com,
	karthik.188@gmail.com
Subject: [PATCH 4/6] doc: update-ref: remove confusing paragraph
Date: Tue, 15 Oct 2024 21:03:13 +0200
Message-ID: 
 <dec48e2d37cc4edafb51476284ce3fece4718ce7.1729017728.git.code@khaugsbakk.name>
X-Mailer: git-send-email 2.46.1.641.g54e7913fcb6
In-Reply-To: <cover.1729017728.git.code@khaugsbakk.name>
References: 
 <CAOLa=ZQJy1ZkQqBoWwJJvL0f+NCP=3SAfyeSNuztgApzNH1mGg@mail.gmail.com>
 <cover.1729017728.git.code@khaugsbakk.name>
Precedence: bulk
X-Mailing-List: git@vger.kernel.org
List-Id: <git.vger.kernel.org>
List-Subscribe: <mailto:git+subscribe@vger.kernel.org>
List-Unsubscribe: <mailto:git+unsubscribe@vger.kernel.org>
MIME-Version: 1.0
X-Commit-Hash: dec48e2d37cc4edafb51476284ce3fece4718ce7

From: Kristoffer Haugsbakk <code@khaugsbakk.name>

This paragraph interrupts the flow of this section by going into detail
about what a symbolic ref file is and how it is implemented.  It is not
clear what the purpose is since symbolic refs were already mentioned
prior (“possibly dereferencing the symbolic refs”).  Worse, it can
confuse the reader about what argument can be a symbolic ref since it
just says “it” and not which of the parameters; in turn the reader can
be lead to try `<new-oid>` and then get a confusing error since
update-ref will just say that it is not a valid SHA1.

Reported-by: Bence Ferdinandy <bence@ferdinandy.com>
Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
---

Notes (series):
    This paragraph is also from the initial documentation: 129056370ab (Add
    missing documentation., 2005-10-04).

 Documentation/git-update-ref.txt | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/Documentation/git-update-ref.txt b/Documentation/git-update-ref.txt
index c03e65404e8..4bb3389cc7c 100644
--- a/Documentation/git-update-ref.txt
+++ b/Documentation/git-update-ref.txt
@@ -25,10 +25,6 @@ value is <old-oid>.  You can specify 40 "0" or an empty string
 as <old-oid> to make sure that the ref you are creating does
 not exist.
 
-It also allows a "ref" file to be a symbolic pointer to another
-ref file by starting with the four-byte header sequence of
-"ref:".
-
 If --no-deref is given, <ref> itself is overwritten, rather than
 the result of following the symbolic pointers.
 

From patchwork Tue Oct 15 19:03:14 2024
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
X-Patchwork-Submitter: Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
X-Patchwork-Id: 13836987
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 AB0481F80A1
	for <git@vger.kernel.org>; Tue, 15 Oct 2024 19:05:20 +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=1729019122; cv=none;
 b=RUE2F87P7wkw624dufpxY7YwdHCWoVEUbjQw1cYUPdAx28bJ203d5+biN9N8BpKfS1dY/mjKp8OsK71jxA8k2txJr4huejWKNY3Qh4AnFXatUop52uAGoduo+zhc90LonhbWmKAaKnYyIGc/9zZeNE+f7kej+HXQfFEiDyBznVE=
ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org;
	s=arc-20240116; t=1729019122; c=relaxed/simple;
	bh=hrEBwSkmBH4Pl87bGsFVTj/TtxwPZtdIfNLZkdI16Bg=;
	h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References:
	 MIME-Version;
 b=g0b3I3O2rq3wVtK31BJ58tuR+4NrLYt5vy5i6WIfsZYLtxpLvve6bSHkXLv9Dqkg4n38065ORCo8v8trgiO9nAGreDNgG1UNs83t4SwL1ePKihXungwcHI2ODQT9GOy8b3a1pPinrdPDRwRN8FVfiI0ptd7QMexgG0mnFmvo2Ag=
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=eFMyGaD8;
 dkim=pass (2048-bit key) header.d=messagingengine.com
 header.i=@messagingengine.com
 header.b=c44MH0xg; 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="eFMyGaD8";
	dkim=pass (2048-bit key) header.d=messagingengine.com
 header.i=@messagingengine.com header.b="c44MH0xg"
Received: from phl-compute-04.internal (phl-compute-04.phl.internal
 [10.202.2.44])
	by mailfout.phl.internal (Postfix) with ESMTP id D9B2813801D1;
	Tue, 15 Oct 2024 15:05:19 -0400 (EDT)
Received: from phl-mailfrontend-01 ([10.202.2.162])
  by phl-compute-04.internal (MEProxy); Tue, 15 Oct 2024 15:05:19 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.com; h=
	cc:cc:content-transfer-encoding:content-type:date:date:from:from
	:in-reply-to:in-reply-to:message-id:mime-version:references
	:reply-to:subject:subject:to:to; s=fm2; t=1729019119; x=
	1729105519; bh=oLCurpmci9ZYyRJPPg8VCPSSLuFxgquCsUUO00AlJss=; b=e
	FMyGaD8YER4Q4tiNu8/etWCc1x6JnFItC5N9PRnHCRZrFFR7TFKDCEQtdbfip4r9
	zXBSVSJNpqBMD54dbiZZ4zAFZyTWYQsCfXxnGJ51J3PgTa8aGJ1Tj21+u/cqvgZl
	1R6Cjt/Q0ZXfWb5Sgft+asT3w7YjObArxK4RhfvDbHWpEv78Tnv9Xgu6vOvIfRVQ
	JtgVTpZ4eeXrz9EeMnxgEo5QHKbsBgTJNH5nkQQv2iPU4OdtqWGy90VMP5zlIj5Z
	gKHcq89R/WB8NWSmTGb6U3laeNAm0bLcoziho94qET2Jhq7QsIpDESPRbf661jD3
	XzwWJxRPgXKcjeI/SXzSw==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=
	messagingengine.com; h=cc:cc:content-transfer-encoding
	: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=fm2; t=1729019119; x=
	1729105519; bh=oLCurpmci9ZYyRJPPg8VCPSSLuFxgquCsUUO00AlJss=; b=c
	44MH0xghjFwPeslmgaJqp0AenZ8jTqcTGyAaTXI45d+KnLjqandTvejCF30mykGM
	SvR0nka9WgTNxVV0RTJ9XOueNlV93XlJfSka+pfk3TXR9J/E7ZnppVXbz5DkjKGc
	YDkBBcWLA+yF687Xv69IpJLT7/PbBK/hUsHRxR/uCQyYfBq0F8JdEZHkZ+gS8VFn
	Ni7ex9lzZ80wGPtx9ljwzXNM4nCehQeRPDK9+lVZv9w57Ru3mqj0w7EXwgJX5apL
	ZIeDYwdoPXySXDksXoGudPSyKBdyKRaA8FSTvZXbBocLPoy/wryxgMJsRSE6blgS
	zgbCgdmQt+aEg7pvLz3wA==
X-ME-Sender: <xms:77wOZ5mC_D2KayBTDlbW54a6OxDUp9YUsgEhaWiZgXqw_spRvr6boUA>
    <xme:77wOZ00t25wBWLVR85CpKSa5oXo74p8NZ9IoE2qB5mGq6uevxHVUSYA2Ri67u93uL
    Dx8yZ03_ijuGsdcYQ>
X-ME-Received: 
 <xmr:77wOZ_rPYTRVgnXeHwYeAnmy4eDTIi_EAjg5xHEFajpIXNWQRVyrgCopG_5IK7xqw6SDZEIWrmUm9g5Li3zUwksUDCrJ-xu-mkPhshBR6Q>
X-ME-Proxy-Cause: 
 gggruggvucftvghtrhhoucdtuddrgeeftddrvdegjedgudeffecutefuodetggdotefrod
    ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp
    uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvve
    fufffkofgjfhgggfestdekredtredttdenucfhrhhomhepkhhrihhsthhofhhfvghrhhgr
    uhhgshgsrghkkhesfhgrshhtmhgrihhlrdgtohhmnecuggftrfgrthhtvghrnhepfeehte
    ekfedtieffvdejteeutefhuefgtefgtdevhefhveffuefftdehiedtfedunecuvehluhhs
    thgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepkhhrihhsthhofhhfvg
    hrhhgruhhgshgsrghkkhesfhgrshhtmhgrihhlrdgtohhmpdhnsggprhgtphhtthhopeei
    pdhmohguvgepshhmthhpohhuthdprhgtphhtthhopehgihhtsehvghgvrhdrkhgvrhhnvg
    hlrdhorhhgpdhrtghpthhtoheptghouggvsehkhhgruhhgshgsrghkkhdrnhgrmhgvpdhr
    tghpthhtohepphhhihhllhhiphdrfihoohguseguuhhnvghlmhdrohhrghdruhhkpdhrtg
    hpthhtohepghhithhsthgvrhesphhosghogidrtghomhdprhgtphhtthhopegsvghntggv
    sehfvghrughinhgrnhguhidrtghomhdprhgtphhtthhopehkrghrthhhihhkrddukeekse
    hgmhgrihhlrdgtohhm
X-ME-Proxy: <xmx:77wOZ5mV2_mB0tTKaZc_wGBj8M4V5r-svCZuv00DuI8hTlt4sf4t7g>
    <xmx:77wOZ33sNX7FkXfyBrar9TQ8QQH8L5UsOk85GbRkE6d5CTOFU80iSA>
    <xmx:77wOZ4ubkBniCnWDZhV8Vo4nrsAth0NHmb7lSMijjk1HzfPHUKrbDQ>
    <xmx:77wOZ7WtEi9hw9fsI30NGgG9PzdMpEnImUQA0mSQceMnykK0zpVQeg>
    <xmx:77wOZxrA4-54YIeTA1DfM580-wk_WDEQqFhzLdXx_8ExXCb7YoZ1nUMR>
Feedback-ID: i8b11424c:Fastmail
Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue,
 15 Oct 2024 15:05:18 -0400 (EDT)
From: kristofferhaugsbakk@fastmail.com
To: git@vger.kernel.org
Cc: Kristoffer Haugsbakk <code@khaugsbakk.name>,
	phillip.wood@dunelm.org.uk,
	gitster@pobox.com,
	bence@ferdinandy.com,
	karthik.188@gmail.com
Subject: [PATCH 5/6] doc: update-ref: discuss symbolic links
Date: Tue, 15 Oct 2024 21:03:14 +0200
Message-ID: 
 <3575fb48c932f50b2a3f6fb0e582b3c2a9b087af.1729017728.git.code@khaugsbakk.name>
X-Mailer: git-send-email 2.46.1.641.g54e7913fcb6
In-Reply-To: <cover.1729017728.git.code@khaugsbakk.name>
References: 
 <CAOLa=ZQJy1ZkQqBoWwJJvL0f+NCP=3SAfyeSNuztgApzNH1mGg@mail.gmail.com>
 <cover.1729017728.git.code@khaugsbakk.name>
Precedence: bulk
X-Mailing-List: git@vger.kernel.org
List-Id: <git.vger.kernel.org>
List-Subscribe: <mailto:git+subscribe@vger.kernel.org>
List-Unsubscribe: <mailto:git+unsubscribe@vger.kernel.org>
MIME-Version: 1.0
X-Commit-Hash: 3575fb48c932f50b2a3f6fb0e582b3c2a9b087af

From: Kristoffer Haugsbakk <code@khaugsbakk.name>

Add a paragraph which just emphasizes that the command without any
options does not support refs in the final arguments.  This is
clear already from the names `<new-oid>` and `<old-oid>` but the right
balance of redundancy makes documentation robust to stray
interpretation.

This is also a good place to mention why `--stdin` has those `symref-*`
commands.

Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
---
 Documentation/git-update-ref.txt | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/Documentation/git-update-ref.txt b/Documentation/git-update-ref.txt
index 4bb3389cc7c..623c4d860eb 100644
--- a/Documentation/git-update-ref.txt
+++ b/Documentation/git-update-ref.txt
@@ -25,6 +25,12 @@ value is <old-oid>.  You can specify 40 "0" or an empty string
 as <old-oid> to make sure that the ref you are creating does
 not exist.
 
+The final arguments are object names; this command without any options
+does not support updating a symbolic ref to point to another ref (see
+linkgit:git-symbolic-ref[1]).  But `git update-ref --stdin` does have
+the the `symref-*` commands so that regular refs and symbolic refs can
+be committed in the same transaction.
+
 If --no-deref is given, <ref> itself is overwritten, rather than
 the result of following the symbolic pointers.
 

From patchwork Tue Oct 15 19:03:15 2024
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
X-Patchwork-Submitter: Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
X-Patchwork-Id: 13836988
Received: from fhigh-a3-smtp.messagingengine.com
 (fhigh-a3-smtp.messagingengine.com [103.168.172.154])
	(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 E6C1B1F80BE
	for <git@vger.kernel.org>; Tue, 15 Oct 2024 19:05:23 +0000 (UTC)
Authentication-Results: smtp.subspace.kernel.org;
 arc=none smtp.client-ip=103.168.172.154
ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;
	t=1729019125; cv=none;
 b=GH3Eht0NvGiEl5t/kX7R0KwV+WglsYh0JWaZU+wL5d5XGduNwXass/+oDzuq6n8oNO+mWKV/YxJVfR6tnyjHDI0K6j/OmXBLWLUNjGga+mIPX5RsQZvIeBx9kLC8MOGeXqLxzhhELTiNuqyD7CEQM8ivLNYMXMArgUCv3422Jds=
ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org;
	s=arc-20240116; t=1729019125; c=relaxed/simple;
	bh=UcnBd3KrRvc+4zn86MnnS8dzfmZrfLy9i+7Mv9nonXY=;
	h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References:
	 MIME-Version;
 b=Sb9nRZ4lcqTeCOkaKYmMBRIRu6UU9kthEDFlzuhaHK8pQibau8knCYcjXeiuwnnrCbbUkyuM2dVuB8/owWdLDq/tOHLZCi4NjjKvmNN1USJEre2tjnKt3y9Fq1oci69j/ud7az0r2WH8cw6H7zr3XG9ALQwyRCaYa4iJdvhnqN8=
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=QxehqqnI;
 dkim=pass (2048-bit key) header.d=messagingengine.com
 header.i=@messagingengine.com
 header.b=JvU0W7kP; arc=none smtp.client-ip=103.168.172.154
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="QxehqqnI";
	dkim=pass (2048-bit key) header.d=messagingengine.com
 header.i=@messagingengine.com header.b="JvU0W7kP"
Received: from phl-compute-08.internal (phl-compute-08.phl.internal
 [10.202.2.48])
	by mailfhigh.phl.internal (Postfix) with ESMTP id EF3911140171;
	Tue, 15 Oct 2024 15:05:22 -0400 (EDT)
Received: from phl-mailfrontend-01 ([10.202.2.162])
  by phl-compute-08.internal (MEProxy); Tue, 15 Oct 2024 15:05:22 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.com; h=
	cc:cc:content-transfer-encoding:content-type:date:date:from:from
	:in-reply-to:in-reply-to:message-id:mime-version:references
	:reply-to:subject:subject:to:to; s=fm2; t=1729019122; x=
	1729105522; bh=euVLyTwTqc6KsprarD+LHCM2P4KxVfrVcpGVKfJu6gI=; b=Q
	xehqqnIuz3OgG+1ijJsu35t3KHnGN6lOkHEovQeERwdslmXfrh+GwPfDNQfZSFOP
	+MXDd3xyqqU9PkXICezHhCsRkp1KIAFgSPvEqguwT4RWsLUZNKpjqV0ORjuatPM5
	01xksUmDDx/DHqG2elfu2wRSDUWfojg/JP2Ho2w/ntyye8SjeAuByX2GMZsq4Kat
	lUyWoUeWplu/OJexQzDkWAK/Dn/QgBvYe97dEcY0qerVr5AddRRy6vj4xaGZSPZZ
	GzotXbVcEP0cVLDkyhnnHlBGheWpHj2xLOJQSYa28zJz4NndvB4exBCsTju9VIdx
	qCJO5J6y+SreYuiUhCaNg==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=
	messagingengine.com; h=cc:cc:content-transfer-encoding
	: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=fm2; t=1729019122; x=
	1729105522; bh=euVLyTwTqc6KsprarD+LHCM2P4KxVfrVcpGVKfJu6gI=; b=J
	vU0W7kPMRn/BIVyV3/mlWioVHNHX+MDWZwe2aq0KdFCcx5tOzu4gjUCwuiEHxc7p
	JDr8M4z1Q3IY2woAisOmLQDLMeIhRr9eBGGMgS5IGUGgD0QQBm9BfSjB71H8QiaG
	yyEkcmWJhDXu+7zaK5zGO1s7tcYrkBFszS/GX+AYWOCvgVzhn7Sm7IPwfol0pbBw
	pdbApdUJkfEQ81+RkPr4jHZyGQisDJLjkUEKeLa49SSsfY3T8BWT/trJjzJ8FGHv
	DzZF8wl1UuemRHexq3PJrfjTeCV5U9jkJUGJWhdMecjbOg0ZW7BWuRX6X0J+nLBB
	YQo3vYjvvVO7QwW0FZo/Q==
X-ME-Sender: <xms:8rwOZz1MtRAhlcWDDtL2Pe38_2PmaDS1m0s7rV57PSSjBktze9pVMUY>
    <xme:8rwOZyFg4nXtVawj28orD4qvN3gJ2HQitl0SWh9j1WExSz9Zl8AMeX2XUD6FXG0oc
    _yJa6jAX1lucj9aow>
X-ME-Received: 
 <xmr:8rwOZz7sjMcaKqt6QkF94yDTnN8TnfcewnePKmDkCxY1mublAd1EIaXrlnduYSsMSeufTa0vjN48WlDfJcjCSY7N2eIppKxGwOxqgHRWqQ>
X-ME-Proxy-Cause: 
 gggruggvucftvghtrhhoucdtuddrgeeftddrvdegjedgudefvdcutefuodetggdotefrod
    ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp
    uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvve
    fufffkofgjfhgggfestdekredtredttdenucfhrhhomhepkhhrihhsthhofhhfvghrhhgr
    uhhgshgsrghkkhesfhgrshhtmhgrihhlrdgtohhmnecuggftrfgrthhtvghrnhepfeehte
    ekfedtieffvdejteeutefhuefgtefgtdevhefhveffuefftdehiedtfedunecuvehluhhs
    thgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepkhhrihhsthhofhhfvg
    hrhhgruhhgshgsrghkkhesfhgrshhtmhgrihhlrdgtohhmpdhnsggprhgtphhtthhopeei
    pdhmohguvgepshhmthhpohhuthdprhgtphhtthhopehgihhtsehvghgvrhdrkhgvrhhnvg
    hlrdhorhhgpdhrtghpthhtoheptghouggvsehkhhgruhhgshgsrghkkhdrnhgrmhgvpdhr
    tghpthhtohepphhhihhllhhiphdrfihoohguseguuhhnvghlmhdrohhrghdruhhkpdhrtg
    hpthhtohepghhithhsthgvrhesphhosghogidrtghomhdprhgtphhtthhopegsvghntggv
    sehfvghrughinhgrnhguhidrtghomhdprhgtphhtthhopehkrghrthhhihhkrddukeekse
    hgmhgrihhlrdgtohhm
X-ME-Proxy: <xmx:8rwOZ422S2VEEPYSl3CnL7z4CpgV6cHFTxDMXY4Rkf2dzzpZOqjtOw>
    <xmx:8rwOZ2Esf_Me6P-4U9POg0WM-S9HBrgWaciYbKsoljt7ggCJ8TvgWQ>
    <xmx:8rwOZ5-nV3dAcjmohfEoOe56mtoSkofmbp5uVg8Cz1RH2n5mxKtm_g>
    <xmx:8rwOZznKHGwP4RTxS6gmPeqthwZMAopqbPu-ZuALCVlmFyVHx-rzQA>
    <xmx:8rwOZ500mJRS6ROeNdoSNF59C--XSMPNzs_n2IVt3jSRNNQYQyk6YoYp>
Feedback-ID: i8b11424c:Fastmail
Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue,
 15 Oct 2024 15:05:21 -0400 (EDT)
From: kristofferhaugsbakk@fastmail.com
To: git@vger.kernel.org
Cc: Kristoffer Haugsbakk <code@khaugsbakk.name>,
	phillip.wood@dunelm.org.uk,
	gitster@pobox.com,
	bence@ferdinandy.com,
	karthik.188@gmail.com
Subject: [PATCH 6/6] doc: mutually link update-ref and symbolic-ref
Date: Tue, 15 Oct 2024 21:03:15 +0200
Message-ID: 
 <9e775a65eb3ff49ded231aeeeddd59ccdce3c8a8.1729017728.git.code@khaugsbakk.name>
X-Mailer: git-send-email 2.46.1.641.g54e7913fcb6
In-Reply-To: <cover.1729017728.git.code@khaugsbakk.name>
References: 
 <CAOLa=ZQJy1ZkQqBoWwJJvL0f+NCP=3SAfyeSNuztgApzNH1mGg@mail.gmail.com>
 <cover.1729017728.git.code@khaugsbakk.name>
Precedence: bulk
X-Mailing-List: git@vger.kernel.org
List-Id: <git.vger.kernel.org>
List-Subscribe: <mailto:git+subscribe@vger.kernel.org>
List-Unsubscribe: <mailto:git+unsubscribe@vger.kernel.org>
MIME-Version: 1.0
X-Commit-Hash: 9e775a65eb3ff49ded231aeeeddd59ccdce3c8a8

From: Kristoffer Haugsbakk <code@khaugsbakk.name>

These two commands are similar enough to acknowledge each other on their
documentation pages.

See the previous commit where we discussed that option-less update-ref
does not support updating symbolic refs but symbolic-ref does.

Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
---
 Documentation/git-symbolic-ref.txt | 4 ++++
 Documentation/git-update-ref.txt   | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/Documentation/git-symbolic-ref.txt b/Documentation/git-symbolic-ref.txt
index 761b154bcbb..33ca381fde0 100644
--- a/Documentation/git-symbolic-ref.txt
+++ b/Documentation/git-symbolic-ref.txt
@@ -73,6 +73,10 @@ default.
 symbolic ref were printed correctly, with status 1 if the requested
 name is not a symbolic ref, or 128 if another error occurs.
 
+SEE ALSO
+--------
+linkgit:git-update-ref[1]
+
 GIT
 ---
 Part of the linkgit:git[1] suite
diff --git a/Documentation/git-update-ref.txt b/Documentation/git-update-ref.txt
index 623c4d860eb..fada3f670eb 100644
--- a/Documentation/git-update-ref.txt
+++ b/Documentation/git-update-ref.txt
@@ -190,6 +190,10 @@ otherwise it will just try to read them and update them as a regular
 file (i.e. it will allow the filesystem to follow them, but will
 overwrite such a symlink to somewhere else with a regular filename).
 
+SEE ALSO
+--------
+linkgit:git-symbolic-ref[1]
+
 GIT
 ---
 Part of the linkgit:git[1] suite