From d4d4dcea7634636b940809d5b3c06c081765eb64 Mon Sep 17 00:00:00 2001 From: JP Mens Date: Sat, 27 Jul 2019 20:37:41 +0200 Subject: [PATCH] YAML backend it appears this is called, or at least a.k.a., the YAML backend, so let's say that. Also fixes some typos and formatting I noticed This page could use a lot of extra comprehension love, IMO. --- docs/backends/geoip.rst | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/backends/geoip.rst b/docs/backends/geoip.rst index 4b3811d67..402809a89 100644 --- a/docs/backends/geoip.rst +++ b/docs/backends/geoip.rst @@ -11,7 +11,7 @@ GeoIP backend * Module name: geoip * Launch name: ``geoip`` -This backend allows visitors to be sent to a server closer to them, with +This backend (which is a.k.a. the YAML backend) allows visitors to be sent to a server closer to them, with no appreciable delay, as would otherwise be incurred with a protocol level redirect. Additionally, the Geo Backend can be used to provide service over several clusters, any of which can be taken out of use @@ -25,13 +25,13 @@ Prerequisites To compile the backend, you need libyaml-cpp 0.5 or later and libgeoip. -You must have geoip database available. As of writing, on debian/ubuntu -systems, you can use apt-get install geoip-database to get one, and the +You must have a geoip database available. As of this writing, on debian/ubuntu +systems, you can use ``apt-get install geoip-database`` to get one, and the backend is configured to use the location where these files are installed as source. On other systems you might need to alter the -database-file and database-file6 attribute. If you don't need ipv4 or +``database-file`` and ``database-file6`` attribute. If you don't need ipv4 or ipv6 support, set the respective setting to "". Leaving it unset leaves -it pointing to default location, preventing the software from starting +it pointing to a default location, preventing the software from starting up. Since v4.2.0 libgeoip is optional. You can use also libmaxminddb, but @@ -42,8 +42,8 @@ Configuration Parameters ------------------------ These are the configuration file parameters that are available for the -GeoIP backend. geoip-zones-files is the only thing you must set, if the -defaults suite you. +GeoIP backend. ``geoip-zones-files`` is the only thing you must set, if the +defaults suit you. .. _setting-geoip-database-files: @@ -62,7 +62,7 @@ to generate your own. For MMDB files, see `MaxMind's getting started guide `__. -Since v4.2.0, database type is determined by file suffix, or you can use new syntax. +Since v4.2.0, database type is determined by file suffix, or you can use the new syntax. New syntax is ``[driver:]path[;options]``. Drivers and options @@ -109,7 +109,7 @@ flags and active/disabled state encoded in the key filenames. Zonefile format --------------- -Zone configuration file uses YAML syntax. Here is simple example. Note +Zone configuration files use YAML syntax. Here is simple example. Note that the ``‐`` before certain keys is part of the syntax. .. code-block:: yaml -- 2.49.0