From owner-freebsd-bugs@FreeBSD.ORG Fri Sep 28 07:50:06 2007 Return-Path: Delivered-To: freebsd-bugs@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3774816A420 for ; Fri, 28 Sep 2007 07:50:06 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 15F3213C4A5 for ; Fri, 28 Sep 2007 07:50:06 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.1/8.14.1) with ESMTP id l8S7o5WU081133 for ; Fri, 28 Sep 2007 07:50:05 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.1/8.14.1/Submit) id l8S7o5F1081132; Fri, 28 Sep 2007 07:50:05 GMT (envelope-from gnats) Resent-Date: Fri, 28 Sep 2007 07:50:05 GMT Resent-Message-Id: <200709280750.l8S7o5F1081132@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-bugs@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Edwin Groothuis Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 52D3E16A419 for ; Fri, 28 Sep 2007 07:47:40 +0000 (UTC) (envelope-from edwin@mavetju.org) Received: from mail5out.barnet.com.au (mail5.barnet.com.au [202.83.178.78]) by mx1.freebsd.org (Postfix) with ESMTP id 1B53B13C478 for ; Fri, 28 Sep 2007 07:47:39 +0000 (UTC) (envelope-from edwin@mavetju.org) Received: by mail5out.barnet.com.au (Postfix, from userid 1001) id F04022219CC0; Fri, 28 Sep 2007 17:47:38 +1000 (EST) Received: from mail5auth.barnet.com.au (mail5.barnet.com.au [202.83.178.78]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by mail5.barnet.com.au (Postfix) with ESMTP id BC30D21B117B for ; Fri, 28 Sep 2007 17:47:38 +1000 (EST) Received: from k7.mavetju (k7.mavetju.org [10.251.1.18]) by mail5auth.barnet.com.au (Postfix) with ESMTP id 536632218E27 for ; Fri, 28 Sep 2007 17:47:38 +1000 (EST) Received: by k7.mavetju (Postfix, from userid 1001) id 2E3F778; Fri, 28 Sep 2007 17:47:40 +1000 (EST) Message-Id: <20070928074740.2E3F778@k7.mavetju> Date: Fri, 28 Sep 2007 17:47:40 +1000 (EST) From: Edwin Groothuis To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: bin/116706: [patch] src/usr.bin/makewhatis/makewhatis.c - teach about .SS X-BeenThere: freebsd-bugs@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Edwin Groothuis List-Id: Bug reports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 28 Sep 2007 07:50:06 -0000 >Number: 116706 >Category: bin >Synopsis: [patch] src/usr.bin/makewhatis/makewhatis.c - teach about .SS >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-bugs >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Fri Sep 28 07:50:05 GMT 2007 >Closed-Date: >Last-Modified: >Originator: Edwin Groothuis >Release: FreeBSD 6.2-RELEASE-p4 i386 >Organization: - >Environment: System: FreeBSD k7.mavetju 6.2-RELEASE-p4 FreeBSD 6.2-RELEASE-p4 #0: Thu Apr 26 17:55:55 UTC 2007 root@i386-builder.daemonology.net:/usr/obj/usr/src/sys/SMP i386 >Description: If you install net-mgmt/net-snmp, your whatis file will be clobbered with rubbish: netsnmp_agent(3), The Net-SNMP agent(3) - The snmp agent responds to SNMP queries from management stations. "Modules" +1c -1c "Net-SNMP Agent handler and extensibility API" "The basic theory goes something like this: In the past, with the original mib module api (which derived from the original CMU SNMP code) the underlying mib modules were passed very little information (only the truly most basic information about a request). " +1c -1c "Maintain a registry of MIB subtrees, together with related information regarding mibmodule, sessions, etc" -1c "Trap generation routines for mib modules to use" -1c "net-snmp agent related processing" -1c This should me: netsnmp_agent(3), The Net-SNMP agent(3) - The Net-SNMP agent - The snmp agent responds to SNMP queries from management stations. This is caused by the man pages of net-snmp which don't have proper .SH parts for the SYNOPSIS etc: .SH NAME The Net-SNMP agent \- The snmp agent responds to SNMP queries from management stations. .PP .SS "Modules" makewhatis.c checks for the new sections which start with .SH, but not for new sections which start with .SS: .SH [text for a heading] Set up an unnumbered section heading sticking out to the left. .SS [text for a heading] Set up a secondary, unnumbered section heading. Prints out all By applying the next patch it will teach makewhatis.c to treat .SS with the same severity as .SH. I have run /etc/period/weekly/320.whatis with the old version and with the patched version of makewhatis(1) and the only changes in the output were the man pages of the Net-SNMP port. >How-To-Repeat: >Fix: Index: makewhatis.c =================================================================== RCS file: /home/ncvs/src/usr.bin/makewhatis/makewhatis.c,v retrieving revision 1.10 diff -u -r1.10 makewhatis.c --- makewhatis.c 5 Dec 2005 14:22:12 -0000 1.10 +++ makewhatis.c 28 Sep 2007 07:46:25 -0000 @@ -726,6 +726,8 @@ case STATE_MANSTYLE: if (strncmp(line, ".SH", 3) == 0) break; + if (strncmp(line, ".SS", 3) == 0) + break; trim_rhs(line); if (strcmp(line, ".") == 0) continue; >Release-Note: >Audit-Trail: >Unformatted: