From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from fout-b2-smtp.messagingengine.com (fout-b2-smtp.messagingengine.com [202.12.124.145]) (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 A21A33A0B3E for ; Mon, 30 Mar 2026 21:11:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=202.12.124.145 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1774905115; cv=none; b=QzeW6YndUbvm8He40xkwPsdDRQpo3Vo911RfNyu8CQCv7vxOlWtsS4JMEZBHUoKmpLYryQMpps4JHd+AFRXqqfDnS3trKNnIJQ6NmIG42dG8tlkWakS8ccwKdylKKCgStDozuZufTSvDCkCulDIfC8EimXpNoZ+xfw3XgHTjbCo= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1774905115; c=relaxed/simple; bh=xRWukLetiz8GoLNoWM/3orpg5PbSaeuIPWBVntnx9/k=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=H0yV3Ou33/1+UM86qHChw9xEHP/r+KRX5kfvJ/qi5HUjSDHzWyKIjJugWvid668LXYJIv5OJszJrFZpauwcioSnT3KcCO4/e0Z+CjFMx6eeXMwP7oW1oMc9eHjFf4DONAQoKatwyu/j14E1TPPVhPzzDhT/EDG/mgRy7zfmaxn0= 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=SdBN9ELp; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=WzHjfXw5; arc=none smtp.client-ip=202.12.124.145 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="SdBN9ELp"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="WzHjfXw5" Received: from phl-compute-12.internal (phl-compute-12.internal [10.202.2.52]) by mailfout.stl.internal (Postfix) with ESMTP id A85081D00163; Mon, 30 Mar 2026 17:11:52 -0400 (EDT) Received: from phl-frontend-04 ([10.202.2.163]) by phl-compute-12.internal (MEProxy); Mon, 30 Mar 2026 17:11:53 -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=fm1; t=1774905112; x=1774991512; bh=IzJTUNM01w5ezGCEyvKVQjyeXfdHnbDfAGtlY2kqVgk=; b= SdBN9ELpp2JlUUE31C2G715RB2UuOnKsTHZMfr/MB0H34hS5UDZFQskM+YAUl0QZ +ATwz7RfYeJpT4JSe61FQLXOGbWc8o5CepIG4xKnbWbeG3veqcCamAbXhpVM5HHl FPklB6OrlLidhymFJnXDKwBVX4FrVD2vLOHRs6oJxhv2w8OCmR+mUMNiHZWFyXbU XOIxQ0H7DVuq7L+W/5437qfdZ3zboWeG7KprGrV2fkwJvNu2UacVvUMLjM6vilBx Eob2L0ta9JisHJLRKe3UOQcTYpQwf0fIshOSA9VcHfpZc9xrndwJNHQkp/8YJkJe 5CERYvx1HTj3lAAnhrI/EQ== 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=fm1; t=1774905112; x= 1774991512; bh=IzJTUNM01w5ezGCEyvKVQjyeXfdHnbDfAGtlY2kqVgk=; b=W zHjfXw5hLQm5G9MIl7sq0GbMY4sv6sSwOMrjfb7e2SI1tFXGmgQnrFLhPXV/Wgyj 6dE5ufV4RhekDRwcBuL3fATze1ZWqGtcsjblvKZV/zXy0LyAldez4wmTmKvoJESo 1VUIAOcdEjzeiUSFep5fsMfbsVpsJroba+O3DrePfNXAr5M/H+gCShe4fUm74XiA 4QET7eqLvjsPSoKDTwLiZPii4+UwPqRaUWzUe37Eb3eXd1ZKD89nZ5AeZkLlOVkW wgHri9Bm8GFuRK+OkYu9mNPgfhM2IcUS4hUaEfkv3N19djgmbZELGX5gmncxJgOp FHGrezYEQGk5wQdr1Oy6Q== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefgedrtddtgdefgedttdefucetufdoteggodetrf dotffvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfurfetoffkrfgpnffqhgenuceu rghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmnegfrh hlucfvnfffucdlfeehmdenucfjughrpefhvfevufffkffojghfgggtgfesthekredtredt jeenucfhrhhomhepkhhrihhsthhofhhfvghrhhgruhhgshgsrghkkhesfhgrshhtmhgrih hlrdgtohhmnecuggftrfgrthhtvghrnhephffggeelhfejkefgteelteejhfetieehgeef tdduudffgeejhfektedugefghfeknecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrg hmpehmrghilhhfrhhomhepkhhrihhsthhofhhfvghrhhgruhhgshgsrghkkhesfhgrshht mhgrihhlrdgtohhmpdhnsggprhgtphhtthhopeehpdhmohguvgepshhmthhpohhuthdprh gtphhtthhopehgihhtsehvghgvrhdrkhgvrhhnvghlrdhorhhgpdhrtghpthhtoheptgho uggvsehkhhgruhhgshgsrghkkhdrnhgrmhgvpdhrtghpthhtoheptghhrhhishhtihgrnh drtghouhguvghrsehgmhgrihhlrdgtohhmpdhrtghpthhtohepjhgrtghkmhgrnhgssehg ohhoghhlvgdrtghomhdprhgtphhtthhopehlihhnuhhssehutghlrgdrvgguuh X-ME-Proxy: Feedback-ID: i8b11424c:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Mon, 30 Mar 2026 17:11:50 -0400 (EDT) From: kristofferhaugsbakk@fastmail.com To: git@vger.kernel.org Cc: Kristoffer Haugsbakk , christian.couder@gmail.com, jackmanb@google.com, Linus Arver Subject: [PATCH 0/2] doc: interpret-trailers: explain key format Date: Mon, 30 Mar 2026 23:11:31 +0200 Message-ID: X-Mailer: git-send-email 2.53.0.32.gf6228eaf9cc In-Reply-To: References: Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit From: Kristoffer Haugsbakk Topic name: doc-int-tr-2-key-format Topic summary: Explain the format of trailer keys (alphanum and hyphens). This is important to keep in mind so that metadata is not lost to simple syntax errors. To facilitate this there is a first commit/patch to reorient the introduction towards discussing “key-value pairs”, since that makes it easier to follow up with an explanation of the *key* format. § Cc Linus Arver as the author of the example that this change touches. [1/2] doc: interpret-trailers: stop fixating on RFC 822 [2/2] doc: interpret-trailers: explain key format Documentation/git-interpret-trailers.adoc | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) base-commit: 5361983c075154725be47b65cca9a2421789e410 -- 2.53.0.32.gf6228eaf9cc