From owner-freebsd-doc Mon Oct 8 1:32:24 2001 Delivered-To: freebsd-doc@freebsd.org Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65]) by hub.freebsd.org (Postfix) with ESMTP id 9145037B405; Mon, 8 Oct 2001 01:31:29 -0700 (PDT) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.11.6/8.11.2) id f988UwA49722; Mon, 8 Oct 2001 11:30:58 +0300 (EEST) (envelope-from ru) Date: Mon, 8 Oct 2001 11:30:57 +0300 From: Ruslan Ermilov To: Murray Stokely Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Referencing man pages from ports/ Message-ID: <20011008113057.G36543@sunbay.com> References: <20011007214038.E21516@windriver.com> <20011008110956.E36543@sunbay.com> <20011008012121.L21516@windriver.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20011008012121.L21516@windriver.com>; from murray@FreeBSD.ORG on Mon, Oct 08, 2001 at 01:21:21AM -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On Mon, Oct 08, 2001 at 01:21:21AM -0700, Murray Stokely wrote: > On Mon, Oct 08, 2001 at 11:09:56AM +0300, Ruslan Ermilov wrote: > > There isn't one currently. I'm open to any suggestions, and am > > ready to do the implementation part. > > > > We can extend the .Xr macro to support this, or we can roll our > > own .Pxr, whatever looks better. > > How do you intend to display .Pxr? How will it be made clear to the > user that this might not be installed? The only thing I can really > think of is appending "P" or "ports" to the manual section. So > > .Pxr cvsup 1 > > Would be displayed as cvsup(1-ports) or cvsup(1P) or something. A > patch to intro() could then explain this convention. > > Do you have any other ideas? > Yes. The call will look like this: .Pxr cvsup 1 net cvsup And will be rendered like this: .Xr cvsup 1 .Pq Pa ports/net/cvsup Any better suggestions are welcomed. Cheers, -- Ruslan Ermilov Oracle Developer/DBA, ru@sunbay.com Sunbay Software AG, ru@FreeBSD.org FreeBSD committer, +380.652.512.251 Simferopol, Ukraine http://www.FreeBSD.org The Power To Serve http://www.oracle.com Enabling The Information Age To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message