bin/47392: Fix a comment in makemandb.c to reflect reality

[er.abhinav.upadhyay%gmail.com@localhost]

>Number:         47392
>Category:       bin
>Synopsis:       Fix a comment in makemandb.c to reflect reality
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bin-bug-people
>State:          open
>Class:          sw-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Jan 02 17:10:00 +0000 2013
>Originator:     Abhinav Upadhyay
>Release:        NetBSD-current
>Organization:
>Environment:
NetBSD  6.99.15 NetBSD 6.99.15 (GENERIC) #0: Fri Nov 30 23:27:05 UTC 2012  
builds%b6.netbsd.org@localhost:/home/builds/ab/HEAD/i386/201211301540Z-obj/home/builds/ab/HEAD/src/sys/arch/i386/compile/GENERIC
 i386
>Description:
The comment in makemandb.c at line 943 does not hold true anymore, it is out of 
sync. It should be removed.
>How-To-Repeat:

>Fix:
Index: makemandb.c
===================================================================
RCS file: /cvsroot/src/usr.sbin/makemandb/makemandb.c,v
retrieving revision 1.16
diff -u -r1.16 makemandb.c
--- makemandb.c 8 Nov 2012 19:17:54 -0000       1.16
+++ makemandb.c 2 Jan 2013 17:02:18 -0000
@@ -75,7 +75,7 @@
        secbuff errors; // ERRORS
        char section[2];
 
-       int xr_found;
+       int xr_found; // To track whether a .Xr was seen when parsing a section
 
        /* Fields for mandb_meta table */
        char *md5_hash;
@@ -940,10 +940,6 @@
 static void
 pmdoc_Nd(const struct mdoc_node *n, mandb_rec *rec)
 {
-       /*
-        * A static variable for keeping track of whether a Xr macro was seen
-        * previously.
-        */
        char *buf = NULL;
        char *temp;