Subject: misc/21124: dig(1) has wrong [nt]roff requests
To: None <gnats-bugs@gnats.netbsd.org>
From: None <sobrado@acm.org>
List: netbsd-bugs
Date: 04/13/2003 08:14:27
>Number:         21124
>Category:       misc
>Synopsis:       dig(1) has wrong [nt]roff requests
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sun Apr 13 08:15:00 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Igor Sobrado
>Release:        1.6
>Organization:
University of Oviedo
>Environment:
NetBSD ns1.localnet 1.6 NetBSD 1.6 (GENERIC) #0: Sun Sep  8 19:43:40 UTC 2002
     autobuild@tgm.daemon.org:/autobuild/i386/OBJ/autobuild/src/sys/arch/i386/compile/GENERIC i386

>Description:
The dig(1) man page has some wrong nroff/troff requests.
This is not a NetBSD-related problem, it happens in other
operating systems (e. g., Linux Slackware) too.  This is
the wrong section in the man page:

    [...]
    it.  As an option, the user may set the environment variable
    LOCALRES to name a file which is to be used instead of
    /etc/resolv.conf standard resolver (LOCALRESis specific to
    the dig resolver and  is  not  referenced  by  the). [...]

Once fixed, it looks:

    [...]
    which use it.  As an option, the user may set the environment
    variable LOCALRES to name a file which is to be used instead
    of /etc/resolv.conf (LOCALRES is specific to the dig resolver
    and is not referenced by the standard resolver).  [...]

>How-To-Repeat:
The problem exists in the man page source code:

    $ nroff -man /usr/share/man/man1/dig.1 | more

>Fix:
--- dig.1       Sun Sep  8 21:31:20 2002
+++ dig.1.new   Sat Apr 12 00:33:10 2003
@@ -130,11 +130,10 @@
 to name a file which is to
 be used instead of 
 .Pa /etc/resolv.conf 
-.Po Ns Ev LOCALRES 
+.Ns Ev (LOCALRES 
 is specific to the 
 .Ic dig
-resolver and is not referenced by the standard resolver
-.Pc .
+resolver and is not referenced by the standard resolver).
 If the 
 .Ev LOCALRES 
 variable is not set or the specified file

>Release-Note:
>Audit-Trail:
>Unformatted: