Add examples for sq key subkey adopt.

src/cli/key.rs

@@ -1174,6 +1174,29 @@ User ID."
     pub binary: bool,
 }
 
+const ADOPT_EXAMPLES: Actions = Actions {
+    actions: &[
+        Action::Example(Example {
+            comment: "\
+Import Alice's old key and new key.",
+            command: &[
+                "sq", "key", "import",
+                "alice-secret.pgp", "alice-new-secret.pgp",
+            ],
+        }),
+        Action::Example(Example {
+            comment: "\
+Have the new certificate adopt Alice's old authentication subkey.",
+            command: &[
+                "sq", "key", "adopt",
+                "--cert", "C5999E8191BF7B503653BE958B1F7910D01F86E5",
+                "--key", "0D45C6A756A038670FDFD85CB1C82E8D27DB23A1",
+            ],
+        }),
+    ]
+};
+test_examples!(sq_key_adopt, ADOPT_EXAMPLES);
+
 #[derive(Debug, Args)]
 #[clap(
     name = "adopt",
@@ -1195,6 +1218,7 @@ feasible.
 $ sq key adopt --keyring juliet-old.pgp --key 0123456789ABCDEF \\
      juliet-new.pgp
 ",
+    after_help = ADOPT_EXAMPLES,
 )]
 #[clap(group(ArgGroup::new("cert_input").args(&["cert_file", "cert"]).required(true)))]
 pub struct AdoptCommand {

tests/data/examples/alice-new-secret.pgp

@@ -0,0 +1,43 @@
+-----BEGIN PGP PRIVATE KEY BLOCK-----
+Comment: C599 9E81 91BF 7B50 3653  BE95 8B1F 7910 D01F 86E5
+Comment: Alice <alice@example.org>
+
+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
+=engl
+-----END PGP PRIVATE KEY BLOCK-----