Minor edits on doc comments.

openpgp-card-sequoia/src/decryptor.rs

@@ -79,17 +79,17 @@ impl<'a> crypto::Decryptor for CardDecryptor<'a> {
         &self.public
     }
 
+    fn decrypt(
+        &mut self,
+        ciphertext: &mpi::Ciphertext,
+        _plaintext_len: Option<usize>,
+    ) -> openpgp::Result<crypto::SessionKey> {
         /// Delegate a decryption operation to the OpenPGP card.
         ///
         /// This fn prepares the data structures that openpgp-card needs to
         /// perform the decryption operation.
         ///
         /// (7.2.11 PSO: DECIPHER)
-    fn decrypt(
-        &mut self,
-        ciphertext: &mpi::Ciphertext,
-        _plaintext_len: Option<usize>,
-    ) -> openpgp::Result<crypto::SessionKey> {
         match (ciphertext, self.public.mpis()) {
             (mpi::Ciphertext::RSA { c: ct }, mpi::PublicKey::RSA { .. }) => {
                 let dm = Cryptogram::RSA(ct.value());

openpgp-card-sequoia/src/sq_util.rs

@@ -1,7 +1,9 @@
 // SPDX-FileCopyrightText: 2021 Heiko Schaefer <heiko@schaefer.name>
 // SPDX-License-Identifier: MIT OR Apache-2.0
 
-//! Simple wrappers for performing very specific tasks with Sequoia PGP
+//! Simple wrappers for performing very specific tasks with Sequoia PGP.
+//!
+//! These helpers are (almost) entirely unrelated to OpenPGP Card.
 
 use anyhow::{anyhow, Context, Result};
 use std::io;

openpgp-card-sequoia/src/util.rs

@@ -38,6 +38,8 @@ use crate::{decryptor, signer, PublicKey};
 /// Create a Cert from the three subkeys on a card.
 /// (Calling this multiple times will result in different Certs!)
 ///
+/// FIXME: contains hardcoded default passwords!
+///
 /// FIXME: make dec/auth keys optional
 ///
 /// FIXME: accept optional metadata for user_id(s)?