docs: Pin jinja2 to < 3.1.0

Jinja2 3.1.0 removed deprecated code that is still used by sphinx
1.8.x, and it looks like our custom sphinx extensions are not working
with more recent versions of sphinx..

See:
- https://github.com/pallets/jinja/issues/1631
- https://github.com/readthedocs/readthedocs.org/issues/9037

and

- https://github.com/PowerDNS/pdns/pull/7712

The exact error is:
```
Extension error:
Could not import extension sphinx.builders.latex (exception: cannot import name 'contextfunction' from 'jinja2' (/dnsdist/pdns/dnsdistdist/.venv/lib/python3.7/site-packages/jinja2/__init__.py))
```

Merge pull request #11436 from rgacogne/ddist-unbreak-optional

dnsdist: Fix compilation by adding a missing <optional> include in misc.cc

dnsdist: Fix compilation by adding a missing <optional> include in misc.cc

Otherwise g++ 11.2.0 complains here:
```
misc.cc: In function ‘int makeIPv6sockaddr(const string&, sockaddr_in6*)’:
misc.cc:711:8: error: ‘optional’ is not a member of ‘std’
  711 |   std::optional<uint16_t> port = std::nullopt;
      |        ^~~~~~~~
misc.cc:61:1: note: ‘std::optional’ is defined in header ‘<optional>’; did you forget to ‘#include <optional>’?
```

Merge pull request #11433 from omoerbeek/dnsdist-include-um

dnsdist: fix build on MacOS and OpenBSD: include <unordered_map>

include <unordered_map>

Merge pull request #11432 from fredmorcos/11429-fix-pem-import-export-on-old-ssl

Enable named curves on ECDSA key generation and import from ISC

Merge pull request #11430 from fredmorcos/get-msg-from-errno-macos-fix

Make getMessageFromErrno work on broken MacOS strerror_r

Enable named curves on ECDSA key generation and import from ISC

Fixes #11429

Co-authored-by: Peter van Dijk <peter.van.dijk@powerdns.com>

strerror_r on MacOS returns int despite _GNU_SOURCE being defined

Merge pull request #11423 from Habbie/auth-rfc-typo

auth docs: fix typo in RFC number

Merge pull request #11414 from fredmorcos/11325-ecdsa-pem

Import and export of ECDSA keys from/to PEM

Merge pull request #11410 from rgacogne/ddist-lua-types

dnsdist: Define types for Lua arrays and associative arrays

Merge pull request #11425 from fredmorcos/add-fred-to-changelog-scripts

Add `fredmorcos` to changelog scripts

Add my username to changelog scripts

Cleanup makeIPv6sockaddr

Formatting makeIPv6sockaddr

Cleanup: uint16_t port value cannot be larger than 65535

Disable the use-trailing-return-type diagnostic from clang-tidy

Add import/export-zone-key-pem to pdnsutil bash completion

Update pdnsutil command-line help

closes: #11321

User documentation of import-zone-key-pem and export-zone-key-pem

User documentation: Typo

Support the export of ECDSA keys to PEM

Part of #11325

Support the import of ECDSA keys from PEM files

- Add support to import ECDSA keys from PEM files.
- Adds a test for ECDSA key import from PEM.
- Instantiate key engine without trial-and-error algorithm search.

Part of #11325

Co-authored-by: Peter van Dijk <peter.van.dijk@powerdns.com>

Add a helper to get errno message in a reasonable way

Cleanup

Formatting

Whitespace

dnsdist: Define types for Lua arrays and associative arrays

That PR defines types for the mapping of Lua arrays and associatives
arrays to C++, improving readability and consistency.

auth docs: fix typo in RFC number

Merge pull request #11421 from Habbie/docs-algoroll

auth docs: add algorithm rolling guide

auth docs: add algorithm rolling guide

Merge pull request #11382 from omoerbeek/rec-forward-docs

rec: Document forward-zones behavior better wrt delegations.

Merge pull request #11401 from fredmorcos/checked-str-int-conversions

Checked conversion from string to signed/unsigned integer

Port values should always be uint16_t

Integral value of an algorithm should always be unsigned

Move most of pdns_stou to Pdns::stoi and Pdns::stou

This also creates the Pdns namespace and renames pdns_stou to Pdns::stou and separates
signed from unsigned conversion (Pdns::stoi and Pdns::stou) which are now implemented in
terms of Pdns::checked_conv and return a generic integer.

Fix printf format string

Formatting

Whitespace

Fix dist doc warning

Enable code documentation for all items

GitIgnore codedocs/html directory

GitIgnore clangd cache dir under recorsor and dist

Merge pull request #11405 from omoerbeek/rec-perm-vs-timeout

rec: Distinguish between unreachable and timeout for throttling

Merge pull request #11397 from omoerbeek/rec-clean-tcp

rec: Wrong task was used to clean outgoing TCP

Merge pull request #11376 from omoerbeek/rec-refresh-qm-ns-interaction

rec: Be more careful using refresh mode only for the record asked.

typo

Co-authored-by: Remi Gacogne <github@coredump.fr>

Merge pull request #11377 from fredmorcos/documentation-devenv

Documentation for a PowerDNS development environment based on a language server

Add instructions to use `compiledb`.

Documentation: Add section about minimal Emacs devenv with Eglot

Documentation: Add section on debugging

Documentation: Add document about devenv with a language server

Also adds documentation on setting up Emacs to work with `clangd` and
`clang-tidy` using `lsp-mode`.

Documentation: Add section on code checkers and `clang-tidy`

Merge pull request #11415 from Habbie/dnsdist-newserver-default-port

dnsdist: more useful default ports for DoT/DoH backends

Documentation: Small cleanup of the `clang-format` section

dnsdist: more useful default ports for DoT/DoH backends

Merge pull request #11411 from tykling/patch-1

Fix small typo in docs/domainmetadata.rst, s/recording/record/

tweak wording some more

Fix small typo, s/recording/record/

While recordings are also fun I think the intended word here is "record" :)

Merge pull request #11389 from Habbie/auth-api-fetch-rrset

auth API: fetch individual rrsets

Distinguish between unreachable and timeout for throttling

Git history shows this was converted wrongly when hardcoded values were replaced by enum values

Reinstate refresh mode for {C,D}NAME cache lookups

Merge pull request #11372 from aerique/feature/add-rec-47-to-repo-script

Add rec-47 to repo test script.

Merge pull request #11398 from omoerbeek/deprecate-xpf

Document that XPF is deprecated and wil be removed

Merge pull request #11314 from mind04/auth-stats

auth: fix proxy protocol query statistics

Merge pull request #11403 from jacobbunk/fix-typo-in-query-description

Fix query description to say "first" when searching for first ordername.

auth /zones/example.com.?rrset_name=www.example.com.&rrset_type=A

ws-auth: small refactor to pass full req to fillZone

Merge pull request #11388 from Habbie/dnsdist-log-timestamps

dnsdist: add --log-timestamps flag

auth, rec, dnsdist: check strftime return value for logging timestamps

dnsdist: add --log-timestamps flag

Fix query description to say "first" when searching for first ordername.

Merge pull request #11375 from rgacogne/ddist-check-interval-timeouts

dnsdist: The check interval applies to health-check, not timeouts

Merge pull request #11374 from rgacogne/ddist-release-udp-state

dnsdist: Properly release UDP states when using random IDs

Merge pull request #11395 from Habbie/launch-wait

auth deb test: upstream more lenient startup wait

Document that XPF is deprecated and wil be removed.

Wrong task was used

auth deb test: upstream more lenient startup wait

Merge pull request #11385 from stirnim/patch-1

fix doc of SVCParams alpn description

fix doc of SVCParams alpn description

"doh" is not a valid alpn value. it's likely a typo and is meant to say "dot"

Document forward-zones behavior better wrt delegations.

Merge pull request #11365 from omoerbeek/rec-find-not-boolean

rec: string::find(char) returns a size_type, not a boolean; coverity CID 1475294

Merge pull request #11379 from Habbie/manual-package-builds

GH actions: add manual dispatch for package building

GH actions: add manual dispatch for package building

Be more careful using refresh mode only for the record asked.
Otherwise we get bad interaction with QM, as newly discovered
delegation points are stored in the cache, but not seen the QM
algorithm. Might/should fix #11371.

dnsdist: The check interval applies to health-check, not timeouts

dnsdist: Properly release UDP states when using random IDs

Add rec-47 to repo test script.

Merge pull request #11355 from omoerbeek/rec-prep-4.7.0-alpha1

rec: Prep for rec-4.7.0-alpha1

Documentation: Formatting

GitIgnore .gdb_history

Merge pull request #11364 from omoerbeek/rec-dnsheader-align

rec: Introduce dnsheader_aligned: a helper class to access dnsheader data

string::find(char) returns a size_type, not a bool; coverity CID 1475294

Apply suggestions from code review

Co-authored-by: Josh Soref <2119212+jsoref@users.noreply.github.com>

Merge pull request #11353 from rgacogne/ddist-doc-fixes

dnsdist: Fix typos in the documentation

Prep for rec-4.7.0-alpha1

Merge pull request #11351 from PowerDNS/mention-C++17-support-instead-of-c++11

Update README.md for c++17 support

Fix FreeBSD part

Introduce dnsheader_aligned: a help class to access dnsheaders data
in a potentially unaligned buffer