From 54afd6a5f2b11def8cf7ac7a797200fb268cee97 Mon Sep 17 00:00:00 2001
From: "LINUXexpert.org" <51408202+LINUXexpert-org@users.noreply.github.com>
Date: Thu, 22 Jan 2026 11:18:43 -0700
Subject: [PATCH] Update README with details on plan mode

Clarify the note about plan mode and its effects on the system.
---
 README.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 0ccd1fe..125e248 100644
--- a/README.md
+++ b/README.md
@@ -57,7 +57,11 @@ Plan mode simulates the APT changes and writes a log under `/var/log/ubuntu-to-m
 sudo bash ubuntu-to-mint-convert-v3.sh plan --edition cinnamon
 ```
 
-> Note: plan mode expects the Mint repo keyring to exist. If you haven’t run `convert` before, install the key or run convert on a test machine first.
+Plan mode simulates APT changes using a **temporary APT environment** (it does not modify your system’s APT sources).
+It will fetch the Linux Mint repository signing key into a **temporary keyring** for the simulation.
+
+> Note: If `gnupg`/`dirmngr` are missing, plan mode may install them so it can import and dearmor the Mint signing key.
+> No repository files on your system are changed by plan mode.
 
 ### 3) Run conversion