From: Philip Withnall <pwithnall@gnome.org>
Date: Tue, 4 Aug 2026 16:15:23 +0000 (+0100)
Subject: man: Document how to select subkeys with --gpg-sign
X-Git-Tag: archive/raspbian/2026.4-1+rpi1^2~9^2~1^2~5^2~1
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=10285e5b92e86679a68b00e96cd8042b73a41e7b;p=ostree.git

man: Document how to select subkeys with --gpg-sign

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>
---

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>