doc: update, fix line overflows and add info about fast zone parsing

Change-Id: Ie3e7fab14198c6add9055c9f24eece9c7c123bd1

doc/configuration.texi

@@ -107,7 +107,8 @@ zones @{
     file "example.com"; # relative to 'storage'
     xfr-in master;      # define 'master' for this zone
     notify-in master;   # also allow NOTIFY from 'master'
-    update-in subnet1;  # accept UPDATE msgs from subnet1 and forward to master
+    update-in subnet1;  # accept UPDATE msgs from subnet1 and forward
+                        # to master
   @}
 @}
 @end example

doc/installation.texi

@@ -27,6 +27,8 @@ autoconf >= 2.65
 flex >= 2.5.31
 @item
 bison >= 2.3
+@item
+ragel >= 6.7 (only required for fast zone parsing)
 @end itemize
 
 @node Required libraries
@@ -113,6 +115,10 @@ $ ./configure --help
 If you have trouble with unknown syscalls under valgrind, disable recvmmsg by
 adding a parameter @command{--enable-recvmmsg=no} to configure.
 
+If you want to load huge zone files quickly, enable fast zone parser by
+adding a parameter @command{--enable-fastparser} to configure. In this case
+Ragel compiler is required.
+
 Knot DNS has also support for link time optimizations.
 You can enable it by the configure parameter @command{./configure --enable-lto=yes}.
 It is however disabled by default as it is known to be broken in some compiler

doc/knot.texi

 \input texinfo   @c -*-texinfo-*-
 @setfilename knot.info
 @include version.texi
-@documentencoding utf-8
+@documentencoding UTF-8
 @settitle Knot DNS @value{VERSION}
 
 @paragraphindent 0

doc/running.texi

@@ -22,19 +22,21 @@ If you want to control the daemon directly, use @code{SIGINT} to quit the proces
 Usage: knotc [parameters] <action> [action_args]
 
 Parameters:
- -c [file], --config=[file]     Select configuration file.
- -j [num], --jobs=[num]         Number of parallel tasks to run when compiling.
- -s [server]                    Remote server address (default 127.0.0.1)
- -p [port]                      Remote server port (default 5553)
- -y [hmac:]name:key]            Use key_id specified on the command line.
- -k [file]                      Use key file (as in config section 'keys').
-                                  f.e. echo "knotc-key hmac-md5 Wg==" > knotc.key
- -f, --force                    Force operation - override some checks.
- -v, --verbose                  Verbose mode - additional runtime information.
- -V, --version                  Print knot server version.
- -w, --wait                     Wait for the server to finish start/stop operations.
- -i, --interactive              Interactive mode (do not daemonize).
- -h, --help                     Print help and usage.
+ -c [file], --config=[file] Select configuration file.
+ -s [server]                Remote server address (default 127.0.0.1)
+ -p [port]                  Remote server port (default 5553)
+ -y [[hmac:]name:key]       Use key_id specified on the command line.
+ -k [file]                  Use key file (as in config section 'keys').
+                              Example:
+                              echo "knotc-key hmac-md5 Wg==" > knotc.key
+ -f, --force                Force operation - override some checks.
+ -v, --verbose              Verbose mode - additional runtime
+                            information.
+ -V, --version              Print knot server version.
+ -w, --wait                 Wait for the server to finish start/stop
+                            operations.
+ -i, --interactive          Interactive mode (do not daemonize).
+ -h, --help                 Print help and usage.
 
 Actions:
  start				Start server (no-op if running).

src/knot/ctl/knotc_main.c

@@ -115,9 +115,9 @@ void help(int argc, char **argv)
 	       " -c [file], --config=[file]\tSelect configuration file.\n"
 	       " -s [server]               \tRemote server address (default %s)\n"
 	       " -p [port]                 \tRemote server port (default %d)\n"
-	       " -y [hmac:]name:key]       \tUse key_id specified on the command line.\n"
+	       " -y [[hmac:]name:key]      \tUse key_id specified on the command line.\n"
 	       " -k [file]                 \tUse key file (as in config section 'keys').\n"
-	       "                           \t  f.e. echo \"knotc-key hmac-md5 Wg==\" > knotc.key\n"
+	       "                           \t  Example: echo \"knotc-key hmac-md5 Wg==\" > knotc.key\n"
 	       " -f, --force               \tForce operation - override some checks.\n"
 	       " -v, --verbose             \tVerbose mode - additional runtime information.\n"
 	       " -V, --version             \tPrint %s server version.\n"