From owner-freebsd-doc  Tue Aug 14  9:47:58 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from axl.seasidesoftware.co.za (axl.seasidesoftware.co.za [196.31.7.201])
	by hub.freebsd.org (Postfix) with ESMTP
	id 2B59737B408; Tue, 14 Aug 2001 09:47:55 -0700 (PDT)
	(envelope-from sheldonh@starjuice.net)
Received: from sheldonh (helo=axl.seasidesoftware.co.za)
	by axl.seasidesoftware.co.za with local-esmtp (Exim 3.31 #1)
	id 15WhNO-0000t8-00; Tue, 14 Aug 2001 18:49:10 +0200
From: Sheldon Hearn <sheldonh@starjuice.net>
To: Ruslan Ermilov <ru@FreeBSD.org>
Cc: Dima Dorfman <dd@FreeBSD.org>, doc@FreeBSD.org,
	Alexey Zelkin <phantom@cris.net>
Subject: Re: mdoc(7) markup for ports (was: Re: cvs commit: doc/share/sgml freebsd.dsl freebsd41.dtd) 
In-reply-to: Your message of "Tue, 14 Aug 2001 19:42:10 +0300."
             <20010814194210.A56842@sunbay.com> 
Date: Tue, 14 Aug 2001 18:49:10 +0200
Message-ID: <3417.997807750@axl.seasidesoftware.co.za>
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



On Tue, 14 Aug 2001 19:42:10 +0300, Ruslan Ermilov wrote:

> Why do we need a special markup for this?  What's wrong with this?
> 
> Xr foo 1 Pq Pa ports/<category>/<port>

I've never been comfortable with providing document processing people
(people who build handbooks or documentation viewing engines) no way to
distinguish between base system manual pages, ones you might find in the
ports tree and ones you'll have to handbuild a package to get.

Ciao,
Sheldon.

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