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

haddock-project support public sublibraries

Link test suites & benchmarks from the index.html; Provide the right
`--base-url` flag for them.

`--use-unicode` is added to `cabal haddock` and `cabal haddock-project`.
One cannot simply use `--haddock-option="--use-unicode"` because it
makes haddock to fail when building indexes.

Haddock should know the sublibrary name rather than just the package.
For sublibraries `package_name:sublib_name` is used. The name is
recorded in the `.haddock` file and used when haddock creates the
`index.html` file, e.g. when called by `haddock-project` command.

When running haddock-project `extra-doc-files` should be copied to
a subdirectories of the `argOutputDir` corresponding to the component.
This doesn't affect `haddock` command.

This commit makes haddock-project handle sublibraries.

The commit changes how `cabal haddock` works, changing the layout
in the `dist-newstyle` folder.  With this change `haddock` subcommand
will install `package:sublib` component in a directory `package-sublib`
under `l/sublib/doc/html/`.

The main library must use the package name rather than `UnitId`,
otherwise the links from other sublibraries will not work.

Cabal: Add flag to ignore build tool dependencies