manual page warning fix.

git-svn-id: file:///svn/unbound/trunk@608 be551aaa-1e26-0410-a405-d3ace91eadb9

diff --git a/doc/Changelog b/doc/Changelog
index da6cb1e78ae27d577cee538867b409391734700c..8f041ba2dccee1504a05056a1f60e81806a16ec5 100644 (file)
--- a/doc/Changelog
+++ b/doc/Changelog
@@ -1,3 +1,6 @@
+12 September 2007: Wouter
+       - fixup of manual page warnings.
+
 6 September 2007: Wouter
        - fixup to find libevent on mac port install.
        - fixup size_t vs unsigned portability in validator/sigcrypt.

diff --git a/doc/unbound.8 b/doc/unbound.8
index 09369323037909a23a82d34b49b2d2f13b018f57..6431c3ba64c478fc92a251d5b6762b9a17dfab49 100644 (file)
--- a/doc/unbound.8
+++ b/doc/unbound.8
@@ -17,7 +17,6 @@ unbound
 .Op Fl d
 .Op Fl v
 .Op Fl c Ar cfgfile
-
 .Sh DESCRIPTION
 .Ic Unbound 
 is an implementation of a DNS resolver, that does caching and 
@@ -25,27 +24,21 @@ DNSSEC validation.
 .Pp
 The available options are:
 .Bl -tag -width indent
-
 .It Fl h
 Show the version and commandline option help.
-
 .It Fl c Ar cfgfile
 Set the config file to read with settings for unbound. The syntax is
 described in 
 .Xr unbound.conf 5 .
-
 .It Fl d
 Debug flag, do not fork into the background, but stay attached to the
 console.
-
 .It Fl v
 Increase verbosity. If given multiple times, more information is logged.
 This is in addition to the verbosity (if any) from the config file.
-
 .El
 .Sh SEE ALSO
 .Xr unbound.conf 5 .
-
 .Sh AUTHORS
 .Ic Unbound
 developers are mentioned in the CREDITS file in the distribution.

diff --git a/doc/unbound.conf.5 b/doc/unbound.conf.5
index d8fddc3eef29ea48788dfea3535961ecb88a559a..c7d0793e3d40aee34a54668d1b9409564b5dd7a0 100644 (file)
--- a/doc/unbound.conf.5
+++ b/doc/unbound.conf.5
@@ -20,11 +20,9 @@ is used to configure
 .Xr unbound 8 .
 The file format has attributes and values. Some attributes have attributes inside them.
 The notation is: attribute: value.
-
+.Pp
 Comments start with # and last to the end of line. Empty lines are
 ignored as is whitespace at the beginning of a line.
-
-.El
 .Sh EXAMPLE
 An example config file is shown below. Copy this to /etc/unbound/unbound.conf
 and start the server with:
@@ -37,7 +35,6 @@ Most settings are the defaults. Stop the server with:
 .fi
 Below is a minimal config file. The source distribution contains an extensive
 example.conf file with all the options.
-
 .nf
 # unbound.conf(5) config file for unbound(8).
 server:
@@ -48,19 +45,15 @@ server:
        pidfile: "/etc/unbound/unbound.pid"
        # verbosity: 1          # uncomment and increase to get more logging.
 .fi
-
-.El
 .Sh FILE FORMAT
 There must be whitespace between keywords. Attribute keywords end with a colon ':'. An attribute
 is followed by its containing attributes, or a value.
-
 .Pp
 Files can be included using the
 .Ic include:
 directive. It can appear anywhere, and takes a single filename as an argument.
 Processing continues as if the text from the included file was copied into
 the config file at that point.
-
 .Ss Server Options
 There may only be one 
 .Ic server:
@@ -140,7 +133,7 @@ If given a chroot is done to the given directory. The default is none ("").
 .It \fBusername:\fR <name>
 If given, after binding the port the user privileges are dropped. Default is
 not to change user, username: "". 
-
+.Pp
 If this user is not capable of binding the
 port, reloads (by signal HUP) will still retain the opened ports.
 If you change the port number in the config file, and that new port number 
@@ -169,13 +162,13 @@ version is returned.
 Set the target fetch policy used by unbound to determine if it should fetch
 nameserver target addresses opportunistically. The policy is described per
 dependency depth. 
-
+.Pp
 The number of values determines the maximum dependency depth
 that unbound will pursue in answering a query.  
 A value of -1 means to fetch all targets opportunistically for that dependency
 depth. A value of 0 means to fetch on demand only. A positive value fetches
 that many targets opportunistically. 
-
+.Pp
 Enclose the list between quotes ("") and put spaces between numbers.
 The default is "3 2 1 0 0". Setting all zeroes, "0 0 0 0 0" gives behaviour
 closer to that of BIND 9, while setting "-1 -1 -1 -1 -1" gives behaviour 
@@ -246,7 +239,6 @@ Number of slabs in the key cache. Slabs reduce lock contention by threads.
 Must be set to a power of 2. Setting (close) to the number of cpus is a 
 reasonable guess.
 .El
-
 .Ss Stub Zone Options
 There may be multiple
 .Ic stub-zone:
@@ -261,7 +253,6 @@ Name of stub zone nameserver. Is itself resolved before it is used.
 IP address of stub zone nameserver. Can be IP 4 or IP 6.
 To use a nondefault port for DNS communication append '@' with the port number.
 .El
-
 .Ss Forward Zone Options
 There may be multiple
 .Ic forward-zone:
@@ -279,7 +270,6 @@ Name of server to forward to. Is itself resolved before it is used.
 IP address of server to forward to. Can be IP 4 or IP 6.
 To use a nondefault port for DNS communication append '@' with the port number.
 .El
-
 .Sh MEMORY CONTROL EXAMPLE
 In the example config settings below memory usage is reduced. Some service
 levels are lower, notable very large data and a high TCP load are no longer
@@ -287,8 +277,8 @@ supported. Very large data and high TCP loads are exceptional for the DNS.
 DNSSEC validation is enabled, just add trust anchors.
 If you do not have to worry about programs using more than 1 meg of memory,
 the below example is not for you. Use the defaults to receive full service.
+.Pp
 .nf
-
 # example settings that reduce memory usage
 server:
        num-threads: 1
@@ -310,9 +300,6 @@ server:
        harden-short-bufsize: "yes"
        do-ip6: no      # save a bit of memory if not used.
 .fi
-
-.El
-
 .Sh FILES
 .Bl -tag -width indent
 .It Pa /etc/unbound