From a85662122051b72334c33ecb12d7e98a80712fac Mon Sep 17 00:00:00 2001
From: Gershom Bazerman <gershom@arista.com>
Date: Tue, 20 Sep 2022 14:29:44 -0400
Subject: [PATCH] changelog/docs

---
 changelog.d/pr-8358   | 10 ++++++++++
 doc/cabal-project.rst |  5 +++++
 2 files changed, 15 insertions(+)
 create mode 100644 changelog.d/pr-8358

diff --git a/changelog.d/pr-8358 b/changelog.d/pr-8358
new file mode 100644
index 00000000000..928ff1dd043
--- /dev/null
+++ b/changelog.d/pr-8358
@@ -0,0 +1,10 @@
+synopsis: Update and sdist now only check for compiler when project file has conditionals
+packages: cabal-install
+prs: #8358
+issues: #8352
+
+description: {
+
+- Cabal update and sdist will not require a ghc in path unless the project has conditionals that require it
+
+}
diff --git a/doc/cabal-project.rst b/doc/cabal-project.rst
index b9c925913b2..a816ed91b06 100644
--- a/doc/cabal-project.rst
+++ b/doc/cabal-project.rst
@@ -63,6 +63,11 @@ freeze files. As a usage example:
 
     import: /absolutepath/some-project.project
 
+Using conditionals will force cabal to find a ghc to derive
+architecture and version information from, which will force some
+commands (update, sdist) to require ghc present where otherwise it
+would not be necessitated.
+
 Specifying the local packages
 -----------------------------