From owner-freebsd-doc  Sun Jul 23 15:40: 6 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
	by hub.freebsd.org (Postfix) with ESMTP id 729BC37BD15
	for <freebsd-doc@freebsd.org>; Sun, 23 Jul 2000 15:40:00 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id PAA67689;
	Sun, 23 Jul 2000 15:40:00 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: from mail.ruhr.de (in-ruhr2.ruhr.de [141.39.224.60])
	by hub.freebsd.org (Postfix) with SMTP id 7738337BADB
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 23 Jul 2000 15:33:33 -0700 (PDT)
	(envelope-from ue@nathan.ruhr.de)
Received: (qmail 31097 invoked by alias); 23 Jul 2000 22:35:29 -0000
Received: (from ue@localhost)
	by nathan.ruhr.de (8.9.3/8.9.3) id AAA91863;
	Mon, 24 Jul 2000 00:33:45 +0200 (CEST)
	(envelope-from ue)
Message-Id: <200007232233.AAA91863@nathan.ruhr.de>
Date: Mon, 24 Jul 2000 00:33:45 +0200 (CEST)
From: Udo Erdelhoff <ue@nathan.ruhr.de>
Reply-To: ue@nathan.ruhr.de
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.2
Subject: docs/20130: Entities missing from doc/share/sgml/man-refs.ent
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         20130
>Category:       docs
>Synopsis:       Entities missing from doc/share/sgml/man-refs.ent
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jul 23 15:40:00 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Udo Erdelhoff
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
Association of frustrated authors armed with Perl
>Environment:

doc/share/sgml/man-refs.ent rev. 1.43

>Description:

People writing documentation for the FDP are supposed to use entities
in the form &man.foo.1; to refer to system commands etc.
/usr/share/doc/man contains about 3500 manpages (entities needed),
man-refs.ent contains 220 entities.

>How-To-Repeat:

Try to use &man.ng_ether.4; in a document for the FDP.
Or &man.netgraph.4;
Or &man.ipfw.4; (&man.ipfw.8; works, but I needed a reference to the
kernel interface)

>Fix:

A patch adding the entities from /usr/share/doc can be found at:
http://www.ruhr.de/home/nathan/FreeBSD/entity-diff.gz
The patch was not included because of its size (29 KByte).
MD5 (entity-diff.gz) = 1bdf3722855db56495ce13aeee6a140f

A port containing the perl scripts used to create and sort the entities
will follow in the next days (Where's a port Makefile template when I
need one?)

The distfile is already in place at
http://www.ruhr.de/home/nathan/FreeBSD/met-1.0.tar.gz
MD5 (met-1.0.tar.gz) = 4fadc7c6df1a62491bea7e98f62c125b
(Manual Entity Toolkit)

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


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message