From owner-freebsd-doc Sun Jul 23 22:50: 4 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 9CE8937B84C for ; Sun, 23 Jul 2000 22:50:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id WAA15046; Sun, 23 Jul 2000 22:50:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Sun, 23 Jul 2000 22:50:01 -0700 (PDT) Message-Id: <200007240550.WAA15046@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Jim Mock Subject: Re: docs/20130: Entities missing from doc/share/sgml/man-refs.ent Reply-To: Jim Mock Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/20130; it has been noted by GNATS. From: Jim Mock To: Udo Erdelhoff Cc: FreeBSD-gnats-submit@FreeBSD.ORG Subject: Re: docs/20130: Entities missing from doc/share/sgml/man-refs.ent Date: Sun, 23 Jul 2000 22:49:26 -0700 On Mon, 24 Jul 2000 at 00:33:45 +0200, Udo Erdelhoff wrote: > >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 [snip..] > >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. I think the major reason for this is that a) stuff that's needed can be added when a document is written, and b) it keeps the file size down. If we add entities for every single man page, chances are, we'll never use at least half of them, so it's kind of overkill to have a huge, bloated man-refs.ent file when it's not necessary. - jim -- /* jim mock - berkeley software design, inc - open source division */ /* documentation manager - jim@FreeBSD.org - jim@luna.osd.bsdi.com */ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message