From 10285e5b92e86679a68b00e96cd8042b73a41e7b Mon Sep 17 00:00:00 2001
From: Philip Withnall <pwithnall@gnome.org>
Date: Tue, 4 Aug 2026 17:15:23 +0100
Subject: [PATCH] man: Document how to select subkeys with --gpg-sign
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

See the ‘HOW TO SPECIFY A USER ID’ section of `man 1 gpg`; or
https://stackoverflow.com/a/48240076/2931197.

This will be important when rotating signing subkeys for an OSTree
repository.

Signed-off-by: Philip Withnall <pwithnall@gnome.org>
---
 man/ostree-commit.xml  | 4 ++++
 man/ostree-summary.xml | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/man/ostree-commit.xml b/man/ostree-commit.xml
index a5fd8d28..7de5b0f7 100644
--- a/man/ostree-commit.xml
+++ b/man/ostree-commit.xml
@@ -265,6 +265,10 @@ License along with this library. If not, see <https://www.gnu.org/licenses/>.
 
                 <listitem><para>
                     GPG Key ID with which to sign the commit (if built with GPGME - GNU Privacy Guard Made Easy).
+                </para>
+
+                <para>
+                    To use a specific subkey, pass the subkey’s fingerprint followed by <literal>!</literal>.
                 </para></listitem>
             </varlistentry>
 
diff --git a/man/ostree-summary.xml b/man/ostree-summary.xml
index 19e014ed..222c6b04 100644
--- a/man/ostree-summary.xml
+++ b/man/ostree-summary.xml
@@ -118,6 +118,10 @@ License along with this library. If not, see <https://www.gnu.org/licenses/>.
 
                 <listitem><para>
                     GPG Key ID to sign the summary with.
+                </para>
+
+                <para>
+                    To use a specific subkey, pass the subkey’s fingerprint followed by <literal>!</literal>.
                 </para></listitem>
             </varlistentry>
 
-- 
2.39.5