From 67f1ff5ab80bb816f0ae8b6ea98a5a18d2ef976d Mon Sep 17 00:00:00 2001
From: Jen Basch <jbasch@apple.com>
Date: Tue, 18 Nov 2025 21:08:03 -0800
Subject: [PATCH] Update CLI docs to clarify that `--version` only applies to
 the root command (#1326)

---
 docs/modules/pkl-cli/pages/index.adoc                 | 11 +++++++++++
 docs/modules/pkl-cli/partials/cli-common-options.adoc |  6 ------
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/docs/modules/pkl-cli/pages/index.adoc b/docs/modules/pkl-cli/pages/index.adoc
index d5ec4932..722db323 100644
--- a/docs/modules/pkl-cli/pages/index.adoc
+++ b/docs/modules/pkl-cli/pages/index.adoc
@@ -788,6 +788,17 @@ The <<command-eval>>, <<command-test>>, <<command-repl>>, <<command-download-pac
 
 include::../../pkl-cli/partials/cli-project-options.adoc[]
 
+[[root-options]]
+=== Root options
+
+The root `pkl` command supports the following options:
+
+.-v, --version
+[%collapsible]
+====
+Display version information.
+====
+
 == Evaluating Modules
 
 Say we have the following module:
diff --git a/docs/modules/pkl-cli/partials/cli-common-options.adoc b/docs/modules/pkl-cli/partials/cli-common-options.adoc
index 5b9a3c89..baf3da6d 100644
--- a/docs/modules/pkl-cli/partials/cli-common-options.adoc
+++ b/docs/modules/pkl-cli/partials/cli-common-options.adoc
@@ -109,12 +109,6 @@ Duration, in seconds, after which evaluation of a source module will be timed ou
 Note that a timeout is treated the same as a program error in that any subsequent source modules will not be evaluated.
 ====
 
-.-v, --version
-[%collapsible]
-====
-Display version information.
-====
-
 .-w, --working-dir
 [%collapsible]
 ====