From mboxrd@z Thu Jan 1 00:00:00 1970 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 0391F250C18 for ; Thu, 1 May 2025 21:34:57 +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=1746135300; cv=none; b=FDgD61rKMWUo9D5jLjW38sLdQmB3qFuXR2KestMVt5YJbxSzZDD6ZNf3R+9HaQAvQfgx6MZ2/KIb6bmK64w4hv0LqJA9BSpfzieVxez7758WvFRf1HNMW4Fm3EmjWxRQ31tiNOjSxsTeX6DdjcqDkISx8yZF0irCQ+R3k0iyCO8= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1746135300; c=relaxed/simple; bh=WmXs1wabU+HCbkrNVt/8r4mVvZvJcmN71Cs9K5T102A=; h=From:To:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=C4c+vw9th8JlCTqV9FAZpY285cmg5zTt/srzCVtdThtd5RrpKIve3VGpm4mlgGlrUHZkWXlR6WJKZkfuHmls+eTkr2onvtdOCtrFs0BHZpm6FEltqJh4Csl2D2p8v6Wya9XZ5/j0oiexvk/U7lNM69ZDAvKGYN5E29wmZb6XO4A= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=pobox.com; spf=pass smtp.mailfrom=pobox.com; dkim=pass (2048-bit key) header.d=pobox.com header.i=@pobox.com header.b=QCfOYWZ6; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=YqMD9wZ6; arc=none smtp.client-ip=103.168.172.149 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=pobox.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=pobox.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=pobox.com header.i=@pobox.com header.b="QCfOYWZ6"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="YqMD9wZ6" Received: from phl-compute-06.internal (phl-compute-06.phl.internal [10.202.2.46]) by mailfout.phl.internal (Postfix) with ESMTP id 0BC061380F96; Thu, 1 May 2025 17:34:57 -0400 (EDT) Received: from phl-frontend-02 ([10.202.2.161]) by phl-compute-06.internal (MEProxy); Thu, 01 May 2025 17:34:57 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=pobox.com; h=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=1746135297; x= 1746221697; bh=U0dCZRDrFkvyjE4nny7l18JaLXNAHB9rIiZLGeKykp4=; b=Q CfOYWZ6MWm08stEpkCBFy6KcVfhPtmMfsfufplpma2Psp3ERSNvEOhLVcv16BT6q cdYJJrSucQxlJto6I8J5GZivcvTHXgi4t7mUnAJ9AP8IoQ5DtbEdIpwb5VrDQ5Ms AX+/da/J23+RVU/MC3svd7soxVVenlGsBWtW8dZ/fAOx15+bj99Mc72z+8Nl3A53 yYnh1ybap2xChM/oYejwxFgDA/3sC8OFbzv/DwZKQch2cT6l4iX2CQ0LYV3h3Gn5 koQOQEg7XT5oxOdmrcqUz9B2DzJRefKaxXxFFAQzmoQu9HRB68TUmvJwK8/lN9I5 wtv7Qrk1G8KfjX5f+AWuQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=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-sender:x-me-sender:x-sasl-enc; s= fm3; t=1746135297; x=1746221697; bh=U0dCZRDrFkvyjE4nny7l18JaLXNA HB9rIiZLGeKykp4=; b=YqMD9wZ6NbAuhOAJ83RoM4asbWFYFgMg+GLu/eJnHvVh OQvrBPgNvNoWIJRkHG0HIxcVAgr8XStrJDV6Y1MKNBcnJxQzL89upnbg4L0/Uyr7 Cl7VLHoJ0bG6Dw+3DDhv/XKGk2Rni8jcZLPxFhqFchM0cr6TsLEwYzt4C9u4ShPP 1YwF2D/HzOsCi9GsOrHeVNi7vF0IAm750UNClrGOacGYmSKbXW9ucERoBaMYL0aD KpTScA7hoxMk0sVcigWKeLuSDEHfvGqxkOTttfhROXlCjxj7BET5BLH8Ib/TEA3p yafrCmR2ACO+YoCtVbmla5dZ8+Sl6+nqnN3QAlE2iQ== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefvddrtddtgddvjedtieekucetufdoteggodetrf dotffvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdggtfgfnhhsuhgsshgtrhhisggv pdfurfetoffkrfgpnffqhgenuceurghilhhouhhtmecufedttdenucenucfjughrpefhvf fufffkofgjfhgggfestdekredtredttdenucfhrhhomheplfhunhhiohcuvecujfgrmhgr nhhouceoghhithhsthgvrhesphhosghogidrtghomheqnecuggftrfgrthhtvghrnheple evieefieeuffeugefhveeugefgfeevvdefleevuedvfedvudefkeehtdeftdegnecuvehl uhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepghhithhsthgvrh esphhosghogidrtghomhdpnhgspghrtghpthhtohepvddpmhhouggvpehsmhhtphhouhht pdhrtghpthhtohepghhithesvhhgvghrrdhkvghrnhgvlhdrohhrghdprhgtphhtthhope hgihhtshhtvghrsehpohgsohigrdgtohhm X-ME-Proxy: Feedback-ID: if26b431b:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Thu, 1 May 2025 17:34:56 -0400 (EDT) From: Junio C Hamano To: git@vger.kernel.org Subject: [PATCH 2/2] whatchanged: require --i-still-use-this Date: Thu, 1 May 2025 14:34:52 -0700 Message-ID: <20250501213452.370729-3-gitster@pobox.com> X-Mailer: git-send-email 2.49.0-599-gc9a5c860a0 In-Reply-To: <20250501213452.370729-1-gitster@pobox.com> References: <20250501213452.370729-1-gitster@pobox.com> Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit The documentation of "git whatchanged" is pretty explicit that this has retained for historical reasons to help those whose fingers cannot be retrained. Let's see if they still are finding it hard to type "git log --raw" instead of "git whatchanged" by marking the command as "nominated for removal", and require "--i-still-use-this" on the command line. While at it, update the documentation page to use the new [synopsis] facility to mark-up the SYNOPSIS part. Signed-off-by: Junio C Hamano --- Documentation/git-whatchanged.adoc | 10 ++++++++-- builtin/log.c | 13 +++++++++++++ t/t4013-diff-various.sh | 17 +++++++++++++++-- 3 files changed, 36 insertions(+), 4 deletions(-) diff --git a/Documentation/git-whatchanged.adoc b/Documentation/git-whatchanged.adoc index 8e55e0bb1e..d21484026f 100644 --- a/Documentation/git-whatchanged.adoc +++ b/Documentation/git-whatchanged.adoc @@ -8,8 +8,14 @@ git-whatchanged - Show logs with differences each commit introduces SYNOPSIS -------- -[verse] -'git whatchanged'