Update documentation.

Cabal/ChangeLog.md

@@ -3,6 +3,10 @@
     `new-sdist`, since they violate key invariants of the new-build
     ecosystem. Use `autogen-modules` and `build-tool-depends` instead.
     ([#5389](https://github.com/haskell/cabal/pull/5389)).
+  * Added `--repl-options` flag to `Setup repl` used to pass flags to the
+    underlying repl without affecting the `LocalBuildInfo`
+    ([#4247](https://github.com/haskell/cabal/issues/4247),
+    [#5287](https://github.com/haskell/cabal/pull/5287))
   * Added `BlockArguments` to `KnownExtension`
     ([#5101](https://github.com/haskell/cabal/issues/5101)).
   * Added `NumericUnderscores` to `KnownExtension`

Cabal/Distribution/Simple/Setup.hs

@@ -1761,7 +1761,7 @@ replCommand progDb = CommandUI
       ++ "    The first component in the package\n"
       ++ "  " ++ pname ++ " repl foo       "
       ++ "    A named component (i.e. lib, exe, test suite)\n"
-      ++ "  " ++ pname ++ " repl --ghc-options=\"-lstdc++\""
+      ++ "  " ++ pname ++ " repl --repl-options=\"-lstdc++\""
       ++ "  Specifying flags for interpreter\n"
 --TODO: re-enable once we have support for module/file targets
 --        ++ "  " ++ pname ++ " repl Foo.Bar   "

cabal-install/changelog

@@ -3,6 +3,10 @@
 2.4.0.0 (current development version)
 	* Add 'new-sdist' command (#5389). Creates stable archives based on
 	  cabal projects in '.zip' and '.tar.gz' formats.
+	* Add '--repl-options' flag to 'cabal repl' and 'cabal new-repl'
+	commands. Passes it's arguments to the invoked repl, bypassing the
+	new-build's cached configurations. This assures they don't trigger
+	useless rebuilds and are always applied within the repl. (#4247,#5287)
 	* Add 'v1-' prefixes for the commands that will be replaced in the 
 	new-build universe, in preparation for it becoming the default. 
 	(#5358)