From 9bc391fc7c946a94b4818e4ad6bd301937617ad0 Mon Sep 17 00:00:00 2001
From: Paul Schaub <vanitasvitae@fsfe.org>
Date: Mon, 17 Apr 2023 13:07:54 +0200
Subject: [PATCH] Add note discouraging reuse of subcommand objects

---
 sop-java/src/main/java/sop/SOP.java | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/sop-java/src/main/java/sop/SOP.java b/sop-java/src/main/java/sop/SOP.java
index 7ce617a..7b87a30 100644
--- a/sop-java/src/main/java/sop/SOP.java
+++ b/sop-java/src/main/java/sop/SOP.java
@@ -20,6 +20,11 @@ import sop.operation.Version;
 
 /**
  * Stateless OpenPGP Interface.
+ * This class provides a stateless interface to various OpenPGP related operations.
+ * <br>
+ * Note: Subcommand objects acquired by calling any method of this interface are not intended for reuse.
+ * If you for example need to generate multiple keys, make a dedicated call to {@link #generateKey()} once per
+ * key generation.
  */
 public interface SOP {