docs: BIND backend - improve formatting of output status

Before this change it was hard to distinguish the three possible statuses
due to the styling of the inline-monospaced text without contrast in the
background for the current Sphinx theme.

docs: Add '(or zone transfer)' in sentence on BIND backend

If zones would never be reloaded without a regular non-AXFR DNS request,
the BIND backend would not be usable in a hidden master setup for example.

Als remove superfluous period after link to setting.

docs: fix several typos

docs: Change occurrences of "note" to admonition

docs: Hide the toctree on 'Backends' index page

Effectively, all the backends are listed in the nicely formatted table
already.

docs: fix links in 'Adding new DNS record types'

nested markup for monospaced text on link is not possible, see
https://stackoverflow.com/q/4743845/1254292

docs: Emphasize no data should return in example

The line with just a '$' confused be until I've read the sentence above it
again.

docs: Use 'sudo' to install packages

This also fixes the rendering of the shell command - was highlighted as
comment.

docs: formatting fixes for 'Dynamic DNS Update' page

* Fix a broken link to the domain metadata.
* Prettify method listing paragraph.

docs: HTTP API tsigkeys example shows wrong body

Two errors fixed:
* The JSON body parameter key 'key' was provided twice. I think it should
  have been the 'name' key.
* One value wasn't terminated with a double quote.

The HTTP code block parser warned about this in the sphinx-build output.

docs: Other minor fixes

* Make sentence actually part of the 'versionchanged' directive on the
  settings page. Fixes sphinx-build warning.
* LDAP backend formatting changes so that ldap:// URIs don't get
  linkified.
* Fix sphinx-build warning about under and over underlined sections.

docs: Fix link in Lua2 backend

docs: Fix formatting of Lua2 backend API

Without a blank line between the paragraphs in the descriptions of
RST description lists [1], the list items will not render as list items,
but as a long single paragraph.

[1]: http://docutils.sourceforge.net/docs/user/rst/quickref.html#definition-lists

docs: fix link in Lua backend

Two problems with the existing link:
* target was non-existent (anchor is different in Sphinx)
* nested markup for monospaced text on link is not possible, see
  https://stackoverflow.com/q/4743845/1254292

docs: reword sentence in DNSSEC intro

"confirmation can be gotten" sounds weird to me.

docs: Fix formatting of some code blocks

docs: Add 'hidden master' approach in DNSSEC security

This approach is referred to in the public domain as well as once in the
PowerDNS changelog, but not described in any way before this change.

docs: fix formatting of 'PKCS#11 support' page

Also:
* slightly reword some things where necessary
* Ubuntu 12.nothing/14.nothing do not exist, added assumed '.04'.

docs: remove unintentional blockquotes in HTML

Having leading spaces in either:
* Lists
* RST directives, such as
  .. toctree::

will lead to the listing being wrapped in an HTML <blockquote> element with
also the styling as such. This is probably unintentional and at least
inconsistent with other occurrences.

docs: align meta-data -> metadata

This occurrence was the only one spelled like 'meta-data', all others are
spelled as 'metadata'.

docs: Improve "BIND-mode operation" for DNSSEC

Also:
* Mention that not just keys are part of this database, but also DNSSEC
  domain metadata.
* Link to the pdns.conf setting.

Merge pull request #7677 from rgacogne/dnsdist-logging-facility

dnsdist: Add 'setSyslogFacility()'

Merge pull request #7649 from rgacogne/per-threads-cpu-stats

rec: This provides CPU usage statistics per thread (worker & distributor).

Merge pull request #7658 from Habbie/uuid-for-everyone

always link in uuid-utils because webserver logging needs it now

Merge pull request #7674 from Habbie/dnsdist-libcrypto-includes

dnsdist: honor libcrypto include path

Merge pull request #7679 from rgacogne/dnsdist-missing-overrides

dnsdist: Add missing overrides

Merge pull request #7629 from jsoref/dns-docs

dnssec clarifications

Merge pull request #7671 from Habbie/epel-python3

centos builds: ask for any python3

dnsdist: Add missing overrides

dnsdist: Add 'setSyslogFacility()'

dnsdist: honor libcrypto include path

Merge pull request #7668 from Habbie/boost-1.42

bump boost requirement to 1.42 unconditionally

Merge pull request #7559 from rgacogne/dnsdist-tcp-refactor-clean

dnsdist: Refactoring of the TCP stack

Merge pull request #7670 from Habbie/kill-addlua

dnsdist: remove addLuaAction and addLuaResponseAction

dnsdist: Add more TCP metrics

Keep, for each frontend and backend:
- the number of concurrent TCP connections
- the average number of queries per connection
- the average duration of a connection

centos builds: ask for any python3

dnsdist: remove addLuaAction and addLuaResponseAction

bump boost requirement to 1.42 unconditionally

dnsdist: Apply suggestions from chbruyand's reviews (thanks!)

dnsdist: Try reading from the TCP backend right away

Instead of waiting for the socket to be readable, as it might
already be, so we save a multiplexer trip, and prevent an issue
if we ever add a TLS layer between dnsdist and the backends.

dnsdist: Actually try to read before checking if the socket is readable

We need to because the TLS layer might already have data waiting
for us, while there might not be anything left on the OS-level
buffer associated to the socket.
If we don't ask the TLS layer, we might wait indefinitely for
something to arrive while the client has already sent everything,
and it's just waiting for us because the TLS record has been read.

dnsdist: Better reporting of syscall errors via OpenSSL's libssl

mplexer: Add an accessor to get the number of watched FDs

dnsdist: Add a few more regression tests for DNS over TLS

dnsdist: Update the documentation for the new TCP stack

dnsdist: Fix invalid carbon formatting for TCP stats

dnsdist: Display (and export via API) the frontend type (DoT, ..)

dnsdist: Display backend and frontend TCP metrics in showTCPStats()

dnsdist: Add more TCP metrics

dnsdist: Add a "lots of TCP connections" regression test

dnsdist: Downstream failures only count for fresh TCP connections

dnsdist: Properly handle an I/O error while sending a TCP response

mplexer: Add some unit tests for our multiplexers

mplexer: Keep TTD ordered so we can scan for timeouts efficiently

dnsdist: Handle EAGAIN when reading from the non-blocking TCP pipe

dnsdist: Don't scan for TCP timeouts more than once every second

dnsdist: Make sure that the TCP distribution pipes are non-blocking

dnsdist: Fix outstanding count for TCP connections

dnsdist: Use a unique pointer for the global TCPClientCollection

dnsdist: Remove code duplication between UDP and TCP in the tests

dnsdist: Disable regression tests for invalid AXFR

The new implementation does not try to be too smart about that
anymore.

dnsdist: TCP refactoring using an event-based logic

Only allocate the SSocket buffer when we actually need it, cleanup

Return EINPROGRESS instead of -1 in SConnectWithTimeout wo/ timeout

mplexer: Add support for write timeouts

mplexer: Make it possible to set the read TTD right away

dnsdist: Define empty DNSCrypt-related objects when not enabled

This way the rest of the code can mostly ignore whether DNSCrypt
support is enabled.

dnsdist: Add a function to extract an EDNS0Record from a DNS packet

dnsdist: Refactoring of the response handling path

dnsdist: Python 3 compat fixes for the regression tests

dnsdist: Refactoring to merge the UDP and TCP paths

Merge pull request #7481 from rgacogne/ipcrypt

Add support for encrypting IP addresses #gdpr

Merge pull request #7620 from shane-kerr/readme-link-fixes

Correct dnsdist & recursor information in README

Merge pull request #7652 from Habbie/dnsdist-ednsoptionview

dnsdist, recursor: EDNSOptionView improvements

Merge pull request #7578 from qvr/addtl-gstats

dnsdist: add frontend response statistics

Merge pull request #7343 from rgacogne/dnsdist-dyngroup-smt

dnsdist: Add addDynBlockSMT() support to dynBlockRulesGroup

Merge pull request #7585 from rgacogne/dnsdist-zero-ttl

 dnsdist: Prevent 0-TTL cache hits

Merge pull request #7586 from rgacogne/dnsdist-null-latency-web

dnsdist: Gracefully handle a null latency in the webserver's JS

Merge pull request #7598 from jsoref/spelling

Spelling

Merge pull request #7656 from Habbie/dnsdist-macos-build-nit

dnsdist README: update macOS instructions

always link in uuid-utils because webserver logging needs it now

1-index recursor EDNSOptionView

dnsdist README: update macOS instructions

Merge pull request #7654 from aerique/feature/changelog-and-secpoll-for-rec-4.1.12

Update changelog and secpoll for rec-4.1.12.

simplify vector indexing

adjust indexes in tests

Update changelog and secpoll for rec-4.1.12.

Merge pull request #7631 from omoerbeek/rec-ecs-cache-limit-with-ttl

Rec ecs cache limit with ttl

Lua tables are indexed from 1

count is a method, not an attribute

This provides CPU usage statistics per thread (worker & distributor).

(cherry picked from commit 4ae78615a5a0fb0721ebe1a58a1235e75c47d400)

Merge pull request #7507 from rgacogne/rec-bounded-load-balancing

rec: Use a bounded load-balancing algo to distribute queries

Merge pull request #5932 from pieterlexis/webserver-logging

Improve logging in the webserver

Reformulate condition and comment to make it more clear.

Only apply "do not cache" if both limits are set and satisfied.  Doc tweaks.

rec: Clarify that the server load should be >= to the pondered avg

(cherry picked from commit b476baebdc5a2ab4170476167aef94b7cdb677ab)

rec: Keep track of the number of MTasks in a dedicated variable

(cherry picked from commit 03a5d29ea3456fd3798ca71ed4f0f7ec7980ee2c)

New approach. I spelled out the logic to make it more clear.
Points to keep in mind: > vs >=
What do we do if s_ecscachelimitttl is not set? I chose to let the scope determine
cacheability.

rec: Make sure that distribution-load-factor is >= 1.0 if set

Add tests for ecs-cache-limit-ttl