* Add token authorization for cabal upload

Add token flag. If a token is set ignore the username and password.
The token is passed to Hackage in the  Authorization header.

* Add token flag to upload documentation

* Add token authentication for cabal report

* Update auth token documentation and changelog

* Add token flag to config integration tests

* Add auth token header to plain-http transport

* Add documentation and reduce wildcard usage

Use Nothing in pattern matching instead of wildcards.

* Add auth token headers to wget and powershell

* Fix auth token header for powershell transport

Powershell has to have the Authorization token set in the Header
dictionary parameter. Some headers (e.g. User-Agent) have to be set as
a request parameter.

* Fix code formatting to comply with fourmolu

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Andrea Bedini <andrea@andreabedini.com>

Fix typo in code-generators documentation

Allow bytestring-0.12

* Support text-2.1 in Cabal and Cabal-syntax

* Add changelog entry

* Use tasty-quickcheck 0.10.1.2

This avoid picking a tasty-quickcheck that can have tasty-1.5

* Revert "Use tasty-quickcheck 0.10.1.2"

This reverts commit da03d8d560d6acf6aa62b3b2e5d013974083b642.

Add support for LoongArch 64-bit architecture

gitlab-ci/brew.sh/curl: fail with more noise

fix(Cabal-syntax): Remove left-over file after #8980

Improve error message for empty config file

Otherwise

```
$ CONFIG_FILE= cabal build
Error: cabal-3.10.1.0: Config file not found:
```

looks abrupt and confusing. Now it says

```
Error: cabal: Config file name is empty
```

Add deprecation warnings to Nix integration

https://cabal.readthedocs.io/en/latest/nix-integration.html

Check if ldProgram can create merge objects

Fix use of NumJobs

Update `CONTRIBUTING.md` with Nix developer shell instructions

From `Cabal/src/Distribution/Types/ParStrat.hs`

```
data ParStratX sem
  = -- | Compile in parallel with the given number of jobs (`-jN` or `-j`).
    NumJobs (Maybe Int)
  ...
```

However in `Cabal/src/Distribution/Simple/Program/GHC.hs` show is applied to the `Maybe Int` and we get errors like:

```
ghc-9.9.20230901: on the commandline: malformed integer argument in -jJust 4
```

This change should correct the behavior in `Simple/Program/GHC.hs` to match the comment in `Types/ParStrat.hs`.

Fix inconsistent indentation

* Remaining Cabal Package Exceptions

* Accepting new error output with error code

* Removing commented codes and adding constructor "RawSystemStdOut" in `Utils.hs`

* Included a catch condition for VErboseException CabalException

* Including "GetProgramInvocationException" with a `catch` condition for CabalException.

* Rolling back "GetProgramInvocationException"

---------

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

* Add a config path on Windows in a message

* split lines

Make users-guide buildable from within doc/ subdirectory

Before this commit it is only possible to build the user guide
from the root of the repository. An invocation of "make users-guide"
in the "doc/" subdirectory fails. This commit moves the logic for
building the users-guide from the Makefile at the root of the
repository to the file "doc/Makefile".

From the root of the project only the target "users-guide"
remains, all other targets related to building the users-guide
are only available in the "doc/" subdirectory.

Fixes issue 7977

Fix two dead links in the users guide

Fix two dead links which pointed to Hackage documentation of modules
which moved from cabal to cabal-syntax package.

Fix incorrect conditional block documentation

Remove RPATH workaround

Maybe 7 years ago it was relevant but it seems today it is not needed
anymore.

* Cabal Package Exceptions

* Accepting new format of output with error codes

* Reverting the changes to new error output

* Rebasing branch Subsequent Cabal Package errors

* Added setup-explicit-fail.out

* Delete setup-explicit-fail.out

* Accepting new output with error codes

* Changed to "GetProgramInvocationException" and "SanityCheckForEnableComponents"

* Going back to former die' call in `getProgramInvocationOutout`  function to check on the failing CI test

* Accepted new error output, included cabalexception in handler

* Error code rectification

* Added a handler condition for VerboseException CabalException in `annotaeFailure` function

* Leaving "GetProgramInvocationException" unmodified

* Incorporated review comments

* Updated "nor" in AutoGenModule test case

* Updated "AutogenExposeOther" test case which was dependent on this "nor" change