From 995ca37560c6e0971c91ba5861389e35541baf40 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Johannes=20M=C3=BCller?= <straightshoota@gmail.com>
Date: Thu, 25 May 2023 12:46:55 +0200
Subject: [PATCH] Clarify documentation of `--local` flag

---
 docs/shards.adoc | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/shards.adoc b/docs/shards.adoc
index 146a1f5a..0a9340bd 100644
--- a/docs/shards.adoc
+++ b/docs/shards.adoc
@@ -125,7 +125,9 @@ after a command.
   Disables colored output.
 
 --local::
-  Don't update remote repositories, use the local cache only.
+  Do not update remote repository cache. Instead, Shards will use the local copies
+  already present in the cache (see *SHARDS_CACHE_PATH*).
+  The command will fail if a depedency is unavailable in the cache.
 
 -q, --quiet::
   Decreases the log verbosity, printing only warnings and errors.