From: Miek Gieben <miekg@NLnetLabs.nl>
Date: Tue, 10 Jan 2006 10:45:44 +0000 (+0000)
Subject: doc updates
X-Git-Tag: release-1.1.0~453
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e76b8cf83f6da7d2625768bedbb6f08fc890d34c;p=thirdparty%2Fldns.git

doc updates
---

diff --git a/TODO b/TODO
index 6df7dcd3..bc1d574b 100644
--- a/TODO
+++ b/TODO
@@ -35,3 +35,36 @@ DONE:
 ------
         o Fix what needs to be fixed
 
+
+drill:
+sometimes we don't get a correct answer from the omval:
+% LD_LIBRARY_PATH=../.libs ./drill  -T www.ripe.net
+Warning: Trace enabled, ignoring any <type> arguments
+(null)
+;; Received 436 bytes from 213.154.224.17#53(omval.tednet.nl.) in 19 ms
+
+net.    172800  IN      NS      a.gtld-servers.net.
+net.    172800  IN      NS      g.gtld-servers.net.
+net.    172800  IN      NS      h.gtld-servers.net.
+net.    172800  IN      NS      c.gtld-servers.net.
+net.    172800  IN      NS      i.gtld-servers.net.
+net.    172800  IN      NS      b.gtld-servers.net.
+net.    172800  IN      NS      d.gtld-servers.net.
+net.    172800  IN      NS      l.gtld-servers.net.
+net.    172800  IN      NS      f.gtld-servers.net.
+net.    172800  IN      NS      j.gtld-servers.net.
+net.    172800  IN      NS      k.gtld-servers.net.
+net.    172800  IN      NS      e.gtld-servers.net.
+net.    172800  IN      NS      m.gtld-servers.net.
+;; Received 487 bytes from 193.0.14.129#53(k.root-servers.net.) in 14 ms
+
+ripe.net.       172800  IN      NS      ns-ext.isc.org.
+ripe.net.       172800  IN      NS      ns-pri.ripe.net.
+ripe.net.       172800  IN      NS      ns3.nic.fr.
+ripe.net.       172800  IN      NS      sec3.apnic.net.
+ripe.net.       172800  IN      NS      sunic.sunet.se.
+;; Received 216 bytes from 192.35.51.30#53(f.gtld-servers.net.) in 153 ms
+
+www.ripe.net.   600     IN      CNAME   kite-www.ripe.net.
+kite-www.ripe.net.      172800  IN      A       193.0.0.214
+;; Received 69 bytes from 202.12.28.140#53(karashi.apnic.net.) in 252 ms
diff --git a/examples/README b/examples/README
index a9d31dbc..03fc21b4 100644
--- a/examples/README
+++ b/examples/README
@@ -3,5 +3,3 @@ systems and will not be supported as such.
 
 Compilation:
 autoreconf && ./configure --with-ldns=../ && make
-
-compiles the examples.
diff --git a/examples/ldns-zcat.1 b/examples/ldns-zcat.1
index 2a8b242f..9c4054df 100644
--- a/examples/ldns-zcat.1
+++ b/examples/ldns-zcat.1
@@ -1,13 +1,22 @@
 .TH ldns-zcat 1 "15 Dec 2005"
 .SH NAME
-ldns-zcat \- reunite split up a zone files
+ldns-zcat \- reunite (z)split up a zone files
 .SH SYNOPSIS
 .B ldns-zcat
 .IR zonefiles
 
 .SH DESCRIPTION
+.B ldns-zcat
+will read in a bunch of (z)split up zonefiles and creates a new larger
+zone file. The SOA record in the first part is used as the SOA record
+in the generated zone.
+.PP
+The resulted zone file is printed to standard output.
 
 .SH OPTIONS
+.TP
+.B -o ORIGIN
+use ORIGIN when reading in the zone
 
 .SH AUTHOR
 Written by the ldns team as an example for ldns usage.
diff --git a/examples/ldns-zsplit.1 b/examples/ldns-zsplit.1
index ca0e546f..8e64668f 100644
--- a/examples/ldns-zsplit.1
+++ b/examples/ldns-zsplit.1
@@ -3,11 +3,29 @@
 ldns-zsplit \- split up a zone file
 .SH SYNOPSIS
 .B ldns-zsplit
+[
+.IR OPTIONS
+]
 .IR zonefile
 
 .SH DESCRIPTION
 
 .SH OPTIONS
+.TP
+.B -n NUMBER
+Split after NUMBER RRs, \fBldns-zsplit\fR will not split in
+the middle of an RRs.
+.PP
+Each part is saved with a numerical suffix, starting with .000. The
+largest suffix is thus .999.
+
+.TP
+.B -o ORIGIN
+use ORIGIN as origin when reading the zonefile.
+
+.TP
+.B -z
+Sort the zone before splitting.
 
 .SH AUTHOR
 Written by the ldns team as an example for ldns usage.