From owner-freebsd-doc  Thu Jan 31 12:15:16 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from rwcrmhc53.attbi.com (rwcrmhc53.attbi.com [204.127.198.39])
	by hub.freebsd.org (Postfix) with ESMTP id E21FD37B400
	for <doc@FreeBSD.ORG>; Thu, 31 Jan 2002 12:15:13 -0800 (PST)
Received: from bmah.dyndns.org ([12.233.149.189]) by rwcrmhc53.attbi.com
          (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP
          id <20020131201513.FGSF10199.rwcrmhc53.attbi.com@bmah.dyndns.org>;
          Thu, 31 Jan 2002 20:15:13 +0000
Received: (from bmah@localhost)
	by bmah.dyndns.org (8.11.6/8.11.6) id g0VKFDI33034;
	Thu, 31 Jan 2002 12:15:13 -0800 (PST)
	(envelope-from bmah)
Message-Id: <200201312015.g0VKFDI33034@bmah.dyndns.org>
X-Mailer: exmh version 2.5 07/13/2001 with nmh-1.0.4
To: Hiten Pandya <hitmaster2k@yahoo.com>
Cc: Ceri <setantae@submonkey.net>, doc@FreeBSD.ORG
Subject: Re: Entities for manpages installed by ports 
In-reply-to: <20020131195933.627.qmail@web21103.mail.yahoo.com> 
References: <20020131195933.627.qmail@web21103.mail.yahoo.com>
Comments: In-reply-to Hiten Pandya <hitmaster2k@yahoo.com>
   message dated "Thu, 31 Jan 2002 11:59:33 -0800."
From: "Bruce A. Mah" <bmah@FreeBSD.ORG>
Reply-To: bmah@FreeBSD.ORG
X-Face: g~c`.{#4q0"(V*b#g[i~rXgm*w;:nMfz%_RZLma)UgGN&=j`5vXoU^@n5<Pi&akO)o^8;[r
 %l(8ZHlbF`dD>v4:OO)c["!w)nD/!!~e4Sj7LiT'6*wZ83454H""lb{CC%T37O!!'S$S&D}sem7I[A
 2V%N&+
X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif
X-Url: http://www.employees.org/~bmah/
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Date: Thu, 31 Jan 2002 12:15:12 -0800
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

If memory serves me right, Hiten Pandya wrote:

> I am saying we should make a new tag called <man> or
> something like <manref>.
>
> For example:
> 
> <manref section="8" name="sysinstall" 
>         base="FREEBSD44-REL">

We don't need another element to make us even more gratuitously
different from the rest of the DocBook-using world.  citerefentry does
the job quite well, and, most importantly, it's what we use now.  An
attribute to citerefentry can help the HTML stylesheet figure out the
appropriate parameters to use for the man.cgi gateway (which already
claims a section for manpages from ports...I haven't a clue how this is
generated though).

The current system isn't broken...it just needs a little help.

Bruce.



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