Merge branch 'stable' into rc/v2.11

Author: mpilgrem

doc/pantry.md

@@ -147,6 +147,9 @@ Optionally, you can specify also the Pantry tree information. For example:
     sha256: 614bc0cca76937507ea0a5ccc17a504c997ce458d7f2f9e43b15a10c8eaeb033
 ~~~
 
+A Pantry tree is a list of CAS (content-addressable storage)
+'SHA256 hash'-'size in bytes' keys for each of the files in a package.
+
 The SHA256 hash of the contents of the Cabal file and its size in bytes is
 provided in Stack's lock file. For further information, see the
 [lock files](lock_files.md) documentation. The SHA256 hash and file size

doc/yaml_configuration.md

@@ -208,6 +208,12 @@ extra-deps:
 the configuration means "extra-deps packages in directories
 `/dir1/dir2/my-package` and `/dir1/dir2/dir3/my-other-package`".
 
+!!! note
+
+    A local file path that has the format of a package identifier will be
+    interpreted as a reference to a package on Hackage. Prefix it with `./` to
+    avoid that confusion.
+
 !!! note
 
     A specified extra-dep that does not have the format of a valid Pantry
@@ -468,6 +474,18 @@ of the same name. For further information, see the
 [`stack build` command](build_command.md) documentation and the
 [users guide](GUIDE.md#the-build-command).
 
+### casa-repo-prefix
+
+[:octicons-tag-24: 2.3.1](https://github.com/commercialhaskell/stack/releases/tag/v2.3.1)
+
+Default: `https://casa.fpcomplete.com`
+
+This option specifies the prefix for the URL used to pull information from the
+Casa (content-addressable storage archive) server that is used by Stack to cache
+Cabal files and all other files in packages. For further information, see this
+blog post about
+[Casa and Stack](https://www.fpcomplete.com/blog/casa-and-stack/).
+
 ### color
 
 Command line equivalent (takes precedence): `--color` option