From patchwork Tue Dec 3 17:14:34 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kai Koponen X-Patchwork-Id: 13892729 Received: from mail-ed1-f49.google.com (mail-ed1-f49.google.com [209.85.208.49]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7AB811F76A4 for ; Tue, 3 Dec 2024 17:14:49 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.208.49 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1733246091; cv=none; b=up9bwHUYOReoPboDWQCTMvLBK+iba5aQon4P5Vp8DyXnhgORj2ot9qE/ZJQSWgdc/85pM9NovwAnCzUdYyZQZMbN30OUYc3CswlXWxJuumrUG11EJkW6xOAvTuE3+oCQg4le+PD7SFUVdmumRZdvyd3uGw8y/c0va+DlikP/EYs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1733246091; c=relaxed/simple; bh=MEcoFl01Cl2JWNTK/yrg+1NAgI3K39EH0IiXDnPbaDU=; h=MIME-Version:References:In-Reply-To:From:Date:Message-ID:Subject: To:Cc:Content-Type; b=etrnNF/gdILt/G5WoheiDBpg+aiaYRBrxtz4pc3ZhqDxuixqAkZZ8DgdctJxo/OHPlzYyYlOMAp9NyqhuLb2RvmvP9LMlkIbpcI1C8+3OcY93vDNB7VK5H27c9c8jcE/YaXAFRMFaAoXgxoc2q6tm6qWgwDF4fBGi+RBP057/nE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=PfYIJi2n; arc=none smtp.client-ip=209.85.208.49 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=google.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="PfYIJi2n" Received: by mail-ed1-f49.google.com with SMTP id 4fb4d7f45d1cf-5d0c939ab78so9182a12.0 for ; Tue, 03 Dec 2024 09:14:49 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1733246087; x=1733850887; darn=vger.kernel.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=g/RJn1IwZvrcH5i4i/TqcZvoefj3WUsjrdiTTFsGGQk=; b=PfYIJi2nOSNLsllao33OSXVQKdsIgAJ+RLUXKidh8LiTKI/8++PbfkdYgH6B8i1uOA YomVz7T+rcKdM5sQT16u3e7Zh95HytDztK0yx+9554VmPFDiNcbRamCtWV0t7eSV8GII v02nkJc0i0ll3YynTQkWHaC1vO5ryB8z3/wFN2OBs7eNdNHzVl0eLyrRV8hAFbDH+bW5 wOFpcOanPav5hVmdsrta6D4hCKRadgiCeivZwl01oaKEJ67VxwRqJoU1bR5fTjT9SYU9 JFBj5+NPz3ysnh6BbucJuLUnmcvR0jeK8cjtXQTMEkLr2IKhyjpzX19D7bhjTvSapBYZ Plcg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1733246087; x=1733850887; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=g/RJn1IwZvrcH5i4i/TqcZvoefj3WUsjrdiTTFsGGQk=; b=V0eE5F4FJhyzC7RnI9yjGn0DXqZughM7DSHBcqP+AVVIo5n9EUgYTjadRFQbF+yWCr lCe/4rpESRapXX0ufj7kd03QeiGYfqiT2UYDz++br2DUU97zn0LxnzR+1NlKNzvr7hKL U42b7R44q/MInzwSmVf0wbfZtnX3paViCWBlSJOsV+02/2+gdzN1sLB57ojaA94BF6jY fKC8vMUswFZEKhAU0ErrWvByEU0KZ4kVHt1c71O4adgr5qFgDtHZIgUj8n5Vszkz/i72 hakNY29f+RdEj+QBxM2EvfO3ImQ1YdUST6uAtAtYKqTUHWZ4XQGkX3XUM7E351P/VFIU vAng== X-Gm-Message-State: AOJu0YwItSMpvsF3xWhUyaLZkcZMBLnnx+HJsq+Yx428l2so59AHpF0G ghZAJ/GwSsmJNqKL/c8H1/td2td++wZ60UnOQof5WUyTHJOUJIKpiCI54+EDOQiFPh9YsUkPMDw rf2B5U6GD9syC/8EGEtHT15GNDwVrowpb+Keb79JRHohMvzZtOg== X-Gm-Gg: ASbGncvV6sWrCNIIyvRxw6KOMU3WY4WL70TPFkn9SB4HgNausWcDiFW/ZE2HTRq+FrQ 6ht1Cw28Kdfw0q95x0qCnRqkIbk9aY6yxHwy9Mfykkj+vNwO1OjgCjc82Okb/ X-Google-Smtp-Source: AGHT+IGqnsuey8DwkkVYo4z+N+K4y0oiz8nr9Q9phnquzKVAhzwRHjQQtgp0+q2PYdcGLkLlo0oM28ElNavF0FzXFVs= X-Received: by 2002:a05:6402:4c7:b0:5d0:84a6:f1a1 with SMTP id 4fb4d7f45d1cf-5d106a4fce5mr84959a12.6.1733246086919; Tue, 03 Dec 2024 09:14:46 -0800 (PST) Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 References: In-Reply-To: From: Kai Koponen Date: Tue, 3 Dec 2024 12:14:34 -0500 Message-ID: Subject: [PATCH] doc: mention rev-list --ancestry-path restrictions To: git@vger.kernel.org Cc: Elijah Newren , Junio C Hamano The rev-list documentation doesn't mention that the given commit must be in the specified commit range, leading to unexpected results. Signed-off-by: Kai Koponen Signed-off-by: Kai Koponen Signed-off-by: Junio C Hamano --- Documentation/rev-list-options.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) excluded part of the range) as . Can be passed multiple diff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt index 00ccf68744..f0a46f9da5 100644 --- a/Documentation/rev-list-options.txt +++ b/Documentation/rev-list-options.txt @@ -412,7 +412,7 @@ Default mode:: --ancestry-path[=]:: When given a range of commits to display (e.g. 'commit1..commit2' - or 'commit2 {caret}commit1'), only display commits in that range + or 'commit2 {caret}commit1'), and a commit in that range, only display commits in that range that are ancestors of , descendants of , or itself. If no commit is specified, use 'commit1' (the