diff --git a/bin/nsupdate/nsupdate.8 b/bin/nsupdate/nsupdate.8
index 0a8d1baf75..3ce54b4f0b 100644
--- a/bin/nsupdate/nsupdate.8
+++ b/bin/nsupdate/nsupdate.8
@@ -236,7 +236,9 @@ and
 is provided, only matching resource records will be removed.
 The internet class is assumed if
 \fIclass\fR
-is not supplied.
+is not supplied. The
+\fIttl\fR
+is ignored, and is only allowed for compatibility.
 .TP
 \fB.sp\fR
 Adds a new resource record with the specified
@@ -244,6 +246,8 @@ Adds a new resource record with the specified
 \fIclass\fR
 and
 \fIdata\fR.
+.PP
+Lines beginning with a semicolon are comments, and are ignored.
 .SH "EXAMPLES"
 .PP
 The examples below show how
diff --git a/bin/nsupdate/nsupdate.docbook b/bin/nsupdate/nsupdate.docbook
index 258975e9ee..b353c302d0 100644
--- a/bin/nsupdate/nsupdate.docbook
+++ b/bin/nsupdate/nsupdate.docbook
@@ -16,7 +16,7 @@
  - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 -->
 
-<!-- $Id: nsupdate.docbook,v 1.1 2001/03/31 02:31:16 gson Exp $ -->
+<!-- $Id: nsupdate.docbook,v 1.2 2001/03/31 02:39:51 bwelling Exp $ -->
 
 <refentry>
 <refentryinfo>
@@ -346,6 +346,7 @@ RDATA.
 <cmdsynopsis>
 <command>update delete</command>
 <arg choice="req">domain-name</arg>
+<arg choice="opt">ttl</arg>
 <arg choice="opt">class</arg>
 <arg choice="opt">type <arg choice="opt" rep="repeat">data</arg></arg>
 </cmdsynopsis>
@@ -361,7 +362,9 @@ and
 is provided, only matching resource records will be removed.
 The internet class is assumed if
 <parameter>class</parameter>
-is not supplied.
+is not supplied.  The
+<parameter>ttl</parameter>
+is ignored, and is only allowed for compatibility.
 </para>
 
 <varlistentry><term>
@@ -384,6 +387,11 @@ and
 </para>
 </listitem>
 </variablelist>
+
+<para>
+Lines beginning with a semicolon are comments, and are ignored.
+</para>
+
 </refsect1>
 
 <refsect1>
diff --git a/bin/nsupdate/nsupdate.html b/bin/nsupdate/nsupdate.html
index d5e4261bfa..dbd6a994d3 100644
--- a/bin/nsupdate/nsupdate.html
+++ b/bin/nsupdate/nsupdate.html
@@ -610,7 +610,7 @@ RDATA.</P
 ><B
 CLASS="COMMAND"
 >update delete</B
->  {domain-name} [class] [type  [data...]]</P
+>  {domain-name} [ttl] [class] [type  [data...]]</P
 ></DT
 ><DD
 ><P
@@ -643,7 +643,14 @@ CLASS="PARAMETER"
 >class</I
 ></TT
 >
-is not supplied.</P
+is not supplied.  The
+<TT
+CLASS="PARAMETER"
+><I
+>ttl</I
+></TT
+>
+is ignored, and is only allowed for compatibility.</P
 ></DD
 ><DT
 ><P
@@ -677,12 +684,14 @@ CLASS="PARAMETER"
 ></DD
 ></DL
 ></DIV
-></P
+>&#13;</P
+><P
+>Lines beginning with a semicolon are comments, and are ignored.</P
 ></DIV
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN194"
+NAME="AEN197"
 ></A
 ><H2
 >EXAMPLES</H2
@@ -749,13 +758,11 @@ long-standing rule in RFC1034 that a name must not exist as any other
 record type if it exists as a CNAME.
 (The rule has been updated for DNSSEC in RFC2535 to allow CNAMEs to have
 SIG, KEY and NXT records.)</P
-><P
-></P
 ></DIV
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN208"
+NAME="AEN210"
 ></A
 ><H2
 >FILES</H2
@@ -771,8 +778,6 @@ CLASS="CONSTANT"
 ></DT
 ><DD
 ><P
-></P
-><P
 >used to identify default name server</P
 ></DD
 ><DT
@@ -789,7 +794,7 @@ CLASS="CITEREFENTRY"
 CLASS="REFENTRYTITLE"
 >dnssec-keygen</SPAN
 >(8)</SPAN
->.&#13;</P
+>.</P
 ></DD
 ><DT
 ><TT
@@ -805,7 +810,7 @@ CLASS="CITEREFENTRY"
 CLASS="REFENTRYTITLE"
 >dnssec-keygen</SPAN
 >(8)</SPAN
->.&#13;</P
+>.</P
 ></DD
 ></DL
 ></DIV
@@ -813,7 +818,7 @@ CLASS="REFENTRYTITLE"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN233"
+NAME="AEN234"
 ></A
 ><H2
 >SEE ALSO</H2
@@ -878,7 +883,7 @@ CLASS="REFENTRYTITLE"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN254"
+NAME="AEN255"
 ></A
 ><H2
 >BUGS</H2