From owner-freebsd-doc@FreeBSD.ORG Tue May 6 17:50:04 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 41B1837B401 for ; Tue, 6 May 2003 17:50:04 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id C920E43F93 for ; Tue, 6 May 2003 17:50:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h470o3Up001442 for ; Tue, 6 May 2003 17:50:03 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h470o3BR001440; Tue, 6 May 2003 17:50:03 -0700 (PDT) Date: Tue, 6 May 2003 17:50:03 -0700 (PDT) Message-Id: <200305070050.h470o3BR001440@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Jim Brown Subject: Re: docs/51480: Multiple undefined references in the FreeBSD manual pages X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Jim Brown List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 07 May 2003 00:50:04 -0000 The following reply was made to PR docs/51480; it has been noted by GNATS. From: Jim Brown To: freebsd-gnats-submit@FreeBSD.org, dds@aueb.gr Cc: Subject: Re: docs/51480: Multiple undefined references in the FreeBSD manual pages Date: Tue, 6 May 2003 20:45:56 -0400 Hi, I hand checked section 9 of the manual to see if these assertions are correct. My results are shown below. KEY: FOUND = I did find the reference in a man page . Assertion is incorrect. REF? = I could not verify the assertion. Man page likely changed since this PR was filed. MISSING = I did not find the reference in a man page. Assertion is correct. ------------------------------------------------------------------------------------------------------------- FOUND /usr/share/man/man9/VFS_UNMOUNT.9.gz(60): Undefined reference to vflush(9) MISSING /usr/share/man/man9/VFS_CHECKEXP.9.gz(63): Undefined reference to vfs_export_lookup(9) REF? /usr/share/man/man9/VOP_LOOKUP.9.gz(433): Undefined reference to VOP_ABORTOP(9) REF? /usr/share/man/man9/boot.9.gz(83): Undefined reference to at_shutdown(9) FOUND /usr/share/man/man9/crypto.9.gz(211): Undefined reference to ((ipsec) FOUND /usr/share/man/man9/mi_switch.9.gz(87): Undefined reference to issignal(9) FOUND /usr/share/man/man9/namei.9.gz(192): Undefined reference to NDFREE(9) MISSING /usr/share/man/man9/time.9.gz(109): Undefined reference to gettime(9) FOUND /usr/share/man/man9/vnode.9.gz(167): Undefined reference to vhold(9) FOUND /usr/share/man/man9/vnode.9.gz(169): Undefined reference to vdrop(9) FOUND /usr/share/man/man9/vnode.9.gz(177): Undefined reference to getnewvnode(9) MISSING /usr/share/man/man9/vnode.9.gz(178): Undefined reference to vfree(9) MISSING /usr/share/man/man9/vnode.9.gz(180): Undefined reference to vbusy(9) MISSING /usr/share/man/man9/vnode.9.gz(189): Undefined reference to VFS_GET(9) MISSING /usr/share/man/man9/vnode.9.gz(224): Undefined reference to vfs_object_create(9) FOUND /usr/share/man/man9/device.9.gz(55): Undefined reference to device_get_parent(9) MISSING /usr/share/man/man9/device_quiet.9.gz(56): Undefined reference to device_detach(9) FOUND /usr/share/man/man9/BUS_SETUP_INTR.9.gz(60): Undefined reference to BUS_TEARDOWN_INTR(9) MISSING /usr/share/man/man9/bus_generic_map_intr.9.gz(46): Undefined reference to BUS_MAP_INTR(9) REF? /usr/share/man/man9/bus_alloc_resource.9.gz(115): Undefined reference to rman_activate_resource(9) FOUND /usr/share/man/man9/bus_release_resource.9.gz(51): Undefined reference to bus_teardown_intr(9) MISSING /usr/share/man/man9/DEVICE_IDENTIFY.9.gz(49): Undefined reference to BUS_ADD_CHILD(9) FOUND /usr/share/man/man9/DEVICE_IDENTIFY.9.gz(55): Undefined reference to bus_set_resource(9) FOUND /usr/share/man/man9/DEVICE_IDENTIFY.9.gz(90): Undefined reference to device_set_driver(9) FOUND /usr/share/man/man9/sbuf.9.gz(339): Undefined reference to printf(9) ------------------------------------------------------------------------------------------------------------- The large number of FOUND entries causes me to wonder if the tool operates correctly. Three thoughts: 1. Ensure your sources are up to date. Some FOUND entries noted above were right in the directory. Either your sources are incomplete, or the tool doesn't work right. See #2. 2. The tool may not find references that are second or third entries in a man page (such as printf(3) which has printf, fprintf, sprintf, snprintf, asprintf ...) Check the tool for correctness. 3. This PR is too large- you are better off closing this PR and submitting a separate PR for each section. jpb === My uname -a FreeBSD jpb-wks.v6.thrupoint.net 4.8-STABLE FreeBSD 4.8-STABLE #0: Mon Apr 21 15:21:29 EDT 2003 root@jpb-wks.v6.thrupoint.net:/usr/obj/usr/src/sys/JPB02 i386