From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-dl1-f66.google.com (mail-dl1-f66.google.com [74.125.82.66]) (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 DEE44800 for ; Wed, 4 Feb 2026 00:01:54 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.82.66 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1770163316; cv=none; b=RCsMuEOFsOi6XWfTwwSbd6+pOq2zOHNhPfuE1zTCr2Q9L5hRMReQeDqhNsYMJ/G5dbDoBFNgPcQJg3GyAKu+evDF+NV8f2U2zHJhu20LTWzCte7Zx5PgQypKezMh7YtCo3ktK6+qxgyRtGh+0s6yF3tsWySaa5UtNmztWRH27ko= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1770163316; c=relaxed/simple; bh=1dDjzFNT7EsxZbp01rxXfctc5Ei3zA50m/Ig3CQJ1iU=; h=From:To:Cc:Subject:In-Reply-To:References:Date:Message-ID: MIME-Version:Content-Type; b=Nh3iLnVtORW4j+bIIEB5j7o9K+JcUe4v29W+mMXHZE0yAjaJ30LOrRIgSP+v7oWziN6BAN6MmsAdQywigYpbxly+ZtKmOs4l8bCNMGR475xz5gc/1iAs3CSF1JQr/RlECUX+7e19PT4rG6SgRaTwB1trQcxwTVf/uTrOp0Ac8r0= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=IvqmcMXC; arc=none smtp.client-ip=74.125.82.66 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="IvqmcMXC" Received: by mail-dl1-f66.google.com with SMTP id a92af1059eb24-124566b6693so4894944c88.0 for ; Tue, 03 Feb 2026 16:01:54 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1770163314; x=1770768114; darn=vger.kernel.org; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=lZN+RUhGXOP8esHjgobyh83hDRnPTvMpLmaVmO4E1Bo=; b=IvqmcMXCCStlB+dz58bADR1ZYxDhe5qjRaP1xIF2oNpcslRtftDYTO8LvSrVmB6tJR GPBtpkReQx98kSM7xfzNHbVFwinGXjTWEuSHnPL7g4d+9tCU+JGY47GXE9sD0web3kSs A98v3HHzSDeRFJnh2ivTpN/Kp66A0jbOy8HG85/Qdw39lx7JZRCtXslU5TIg7RQ7uFJp 30/YKCQsVGa2ftyvkg6obKwn+tGMJHSK0jWrTyCeFjg00HU3E558hpo/R2cP+SRdKdGH dfPip6x0/81kx5C+V1E9kiy1K1mIVxQkqcrDhI2WTDlaaDTE4LbsaIyRskxVssDoH40w GaFw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1770163314; x=1770768114; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject :date:message-id:reply-to; bh=lZN+RUhGXOP8esHjgobyh83hDRnPTvMpLmaVmO4E1Bo=; b=KExbkGklIn7FtDD4ISjREx6JDvZSRHP+SHg0eEPZjQTSKXD2ieTifEKzAUg4459WZt NBq0xeaDfQG4ZA8vX9Yzw15P0PgeB4uA0E48H0xJqWqg/ylWWodqDmQZ5BEyoJ46jaFb XfHY/WwhbZhTlWREG79XvuotR+ttXcEESSgcGUHl84Xa4JkVACZkCMkYwxlQ6lsvqYDm cX/ZT8KxQGBvlOKNK2taoCQzAXN5GiDUeoSbYAbRLI+QaKf6/AWwn89PBQfhs/0NchJz L2fJhuVjw1XoObqkUhOISliMEY8Wxbu95lEXyo1zXegvXv5JxTOFFVAY18KIW/i7JDuf R2FA== X-Forwarded-Encrypted: i=1; AJvYcCUhsfBgXZrJLphq5UvO9+EK99rmLe2/EJRNbQqMuFyKm/f13z1A9eUpDC4jeJjvt37vgxWj0cSjNZxesNQ=@vger.kernel.org X-Gm-Message-State: AOJu0YwJk7BnhQMxha9BU0XGt6wSG5s5SPeYCfYsrGfmWHmVcgMN/agm vDtbcm+JYQaAQ847evqNtZSSugov0ckR3yY50R84ZlRV4ykJU6Rm0ew+ X-Gm-Gg: AZuq6aKhql3nqWvSFGZhuqctIkOYiIXY6+P92sFGUkHZ60ryrUgn4MnFOgheYF5Ce/H wG9OD8kivRl1z5kYJkPrJuRqs3oPWQOh/wz9XH/O8X6Qj0EbfaPRyjyVOcX2g5ejsN/dgADaL/f pFEtxDQDNUcId9AxzRKB74x5Z8wdqLrL/LV1GqatbM8OpAoinZof7hJGXi9NWU6ytgeQIB5zJku fg+RoAtgVbknmkbX1+pDQQlzcYsvEOIYKOZyBJgQVK0+zji6HbeTwHdDJm+3iwS1LrlizGMF61/ TlhHOL+s/+lsklWJBBluqXK+BfYCRtAxGZ5hl/LCtdiLerf27r7fQJUlFNFzLHSSJ9UQw/yTmms 7f0nyAilfwPH0eB8rWLizeNlhadT6rGEqilB7DylKoiGe5ZbLcTcnuY4EGV8sUThx2Orj X-Received: by 2002:a05:7022:418f:b0:123:31dc:e8b5 with SMTP id a92af1059eb24-126f470cbaemr634904c88.0.1770163313983; Tue, 03 Feb 2026 16:01:53 -0800 (PST) Received: from fedora ([2601:646:8081:3770::996e]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-126f5030e22sm742032c88.10.2026.02.03.16.01.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 03 Feb 2026 16:01:53 -0800 (PST) From: Collin Funk To: Alejandro Colomar Cc: linux-man@vger.kernel.org, linux-kernel@vger.kernel.org, Alyssa Ross , Greg KH Subject: Re: [PATCH] CONTRIBUTING.d/: Document format of 'Fixes:' trailer fields In-Reply-To: <3a656e90329f26d743d0904f56ae847951c852c7.1770150003.git.alx@kernel.org> References: <3a656e90329f26d743d0904f56ae847951c852c7.1770150003.git.alx@kernel.org> Date: Tue, 03 Feb 2026 16:01:52 -0800 Message-ID: <87zf5p8jgv.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain Alejandro Colomar writes: > Signed-off-by: Alejandro Colomar > --- > > Hi! > > I hadn't yet documented how to produce the Fixes: trailer fields in the > Linux man-pages project. We require the commit-date to disambiguate > possible hash (and subject) collisions. This documents how to produce > them easily. > > I hope this will be useful to other projects. I've been using this > format for some time, and it has some nice properties: it shows at first > glance the date of a commit (which itself gives an idea of how many > stable versions would need to be fixed). It can also be parsed by a > machine, by having a consistent and simple (unambiguous) format. > > > Have a lovely night! > Alex > > CONTRIBUTING.d/git | 16 ++++++++++++++++ > CONTRIBUTING.d/patches/description | 11 +++++++++++ > 2 files changed, 27 insertions(+) > > diff --git a/CONTRIBUTING.d/git b/CONTRIBUTING.d/git > index 4b7a95472..3f944a23c 100644 > --- a/CONTRIBUTING.d/git > +++ b/CONTRIBUTING.d/git > @@ -43,6 +43,22 @@ Description > $ git config --global \ > sendemail.sendmailcmd 'mutt -H - && true'; > > + Commit references > + 'Fixes:' trailer fields should have the following format. > + > + Fixes: 12-char-hash ([author-date,] commit-date; "subject") > + > + where the author date is optional, and only included if it's > + somehow important. The commit date is often more important, as > + it's sorted, and thus can be used to find (with a binary search) > + a commit whose hash and subject may have collisions. To produce > + such fields, the following git aliases are useful. > + > + $ git config --global alias.ref \ > + "show --no-patch --abbrev=12 --date=short --format=tformat:'%C(auto)%h%C(reset) %C(dim white)(%cd%x3B \"%C(reset)%C(auto)%s%C(reset)%C(dim white)\")%C(reset)'" > + $ git config --global alias.ref2 \ > + "show --no-patch --abbrev=12 --date=short --format=tformat:'%C(auto)%h%C(reset) %C(dim white)(%ad, %cd%x3B \"%C(reset)%C(auto)%s%C(reset)%C(dim white)\")%C(reset)'" > + I would recommend taking a look at the one mentioned in git's SubmittingPatches. It looks fairly similar to yours: $ git ref HEAD d9fb823121b1 (2026-02-02; "maintainer-makefile: propagate MAKEINFO to gendocs") $ git show -s --pretty=reference HEAD d9fb82312 (maintainer-makefile: propagate MAKEINFO to gendocs, 2026-02-02) Collin