Fix write-ghc-environment-files documentation

Fix ForeignLibs test for Windows

make cabal-install integration tests hermetic

They were using the user's config, which is a problem if they don't
have one or if it contains settings that interfere with tests
(such as `documentation: True`).

I'm not entirely certain of this, but it seems to work here. It's
a bit of a hack, though.

Fix Windows tests

Document `program-options`

Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>

ci(validate.yml): Allow workflow_dispatch with no allow-newer or constraints

Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>

Type `Dependency` is an instance of `Ord`, from `Cabal-syntax-3.10.1.0`.

Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>

* CI: don't allow-newer for GHC 9.10

* allow-newer base for rere

* buildinfo-reference-generator: bump base bound

* cabal-testsuite: bump base bound

Lookup main-is C sources in hs-source-dirs

In the 2decb0e7 refactor we stopped
looking for non-Haskell `main-is` files in the hs-source-dirs and other
appropriate directories. This commit fixes that oversight.

Even if it is not intuitive that main-is-C-sources are searched in the
hs-source-dirs, we don't wish to break users relying on this behaviour
as there does not exist that strong of a motivation to do so.

Fixes #10168

Co-authored-by: sheaf <sam.derbyshire@gmail.com>

fix non-POSIX [[ ]]

Otherwise CI prints `validate.sh: 332: [[: not found` and the line
does nothing (but `validate.sh` continues to run), unless the
system shell is `ksh` / `bash` / `zsh`. This may explain
https://github.com/haskell/cabal/pull/10114#issuecomment-2178163927.

* missed the two changelog pointers

* Apply suggestions from code review

fixup! missed the two changelog pointers

Co-authored-by: ffaf1 <fa-ml@ariis.it>

* squash! and the other two changelogs

---------

Co-authored-by: ffaf1 <fa-ml@ariis.it>
(cherry picked from commit 82cad891)

Co-authored-by: brandon s allbery kf8nh <allbery.b@gmail.com>
Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>

copy: Take into account extra-dyn-lib-flavours when copying bundled library

This fixes the DynWay case to match the other cases which take into
account extra-dyn-lib-flavours.

haddock-project: added `--all` switch

This matches the installation logic for the validate jobs.

Improve online docs for `includes:` field

Bases:
* https://downloads.haskell.org/~ghc/6.10.1/docs/html/users_guide/release-6-10-1.html
* https://hackage.haskell.org/package/Cabal-2.0.0.2/changelog
* https://github.com/haskell/cabal/commit/e1c39fc9ff4bf4eb8e956e2ee77da95d6cc73bbe

Added `--all` (`--haddock-all`) switches for compatibility with
`haddock` command.  `--haddock-all` alias is added, since that's what is
suggested by some warning messages.

Fixes #10051