Fix an incorrect example in the man page.

[hath.git] / doc / man1 / hath.1

diff --git a/doc/man1/hath.1 b/doc/man1/hath.1
index 3050385bdc82fde4cd23318f284910db8e73c1dc..c0d6bc004f8eb5f552049e75004ef6aa562cce8b 100644 (file)
--- a/doc/man1/hath.1
+++ b/doc/man1/hath.1
@@ -23,6 +23,10 @@ Combine small blocks into larger ones. For example, if you have two
 consecutive /24s, they might combine into a larger /23.
 .IP \(bu
 View the result of block combination in a useful way.
+.IP \(bu
+List them.
+.IP \(bu
+Find their associated PTR records.
 .P
 Hath does just that. It takes as its input (via stdin, or a file with
 the -i parameter) a list of CIDR blocks.
@@ -36,9 +40,8 @@ This computes a (Perl-compatible) regular expression matching
 the input CIDR blocks. It's the default mode of operation.
 .P
 .nf
-.I $ hath <<< \(dq10.0.0.0/24 10.0.1.0/24\(dq
-([^\.0-9](10)\.(0)\.(0)\.(0)[^\.0-9]|[^\.0-9](10)\.(0)\.(1)
-\.(0)[^\.0-9])
+.I $ hath <<< \(dq10.0.0.0/29 10.0.0.8/29\(dq
+((10)\.(0)\.(0)\.(0|1|2|3|4|5|6|7|8|9|10|11|12|13|14|15))
 .fi
 .IP \(bu 2
 \fBReduced\fR
@@ -98,13 +101,26 @@ Perform reverse DNS (PTR) lookups on the IP addresses contained within
 the given CIDRs.
 .P
 .nf
-.I $ hath reversed <<< \(dq198.41.0.4\/30\(dq
+.I $ hath reversed <<< \(dq198.41.0.4/30\(dq
 198.41.0.4: a.root-servers.net.
 198.41.0.5:
 198.41.0.6: rs.internic.net.
 198.41.0.7:
 .fi
 .P
+The DNS lookups are usually the bottleneck for this mode, but we can
+perform them in parallel. Simply pass the number of threads to the GHC
+runtime on the command line; for example, the following will perform
+25 lookups in parallel:
+.P
+.nf
+.I $ hath reversed +RTS -N25 <<< \(dq198.41.0.4/24\(dq
+198.41.0.4: a.root-servers.net.
+198.41.0.5:
+198.41.0.6: rs.internic.net.
+\(pc\(pc\(pc
+.fi
+.P
 Each of the modes also supports a present-tense flavor; the following
 are equivalent to their counterparts: \fBregex\fR, \fBreduce\fR,
 \fBdupe\fR, \fBdiff\fR, \fBlist\fR, \fBreverse\fR.