From owner-freebsd-doc@FreeBSD.ORG Thu Apr 24 16:37:06 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0BF6F37B401; Thu, 24 Apr 2003 16:37:06 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4DCF343F85; Thu, 24 Apr 2003 16:37:05 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 1C9BE10BF82; Fri, 25 Apr 2003 01:37:04 +0200 (CEST) Date: Fri, 25 Apr 2003 01:37:04 +0200 From: "Simon L. Nielsen" To: freebsd-doc@freebsd.org Message-ID: <20030424233703.GB48527@nitro.dk> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="KFztAG8eRSV9hGtP" Content-Disposition: inline User-Agent: Mutt/1.5.4i cc: Ruslan Ermilov Subject: .Xr references to ports in man pages X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 24 Apr 2003 23:37:06 -0000 --KFztAG8eRSV9hGtP Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hello I have been looking at fixing bad man references (.Xr) in the FreeBSD man pages. Several system man pages references man pages from ports which of course might not be available. This was also brought up in Oct 2001 by Murray Stokely where Ruslan Ermilov made a patch to support this in the standard .Xr macro. The patch extends .Xr to handled port references like this : =2EXr smb.conf 5 net samba which would be rendered as =2EXr smb.conf 5 =2EBq Pa ports/net/samba and look like (except that the path is underlined) smb.conf(5) [ports/net/samba] What do people think about handling it like this? It could perhaps be rendered diffently but I personally think that the way it is handled in the current patch is fine. Mainly because I think it is rather clear what is meant and it doesn't "conflict" with other "rendering" that I have seen. I would be happy to go through the system man pages and add the apropriate references (I already have a perl script for detecting bad references). The mail from Ruslan with the patch can be found at http://www.freebsd.org/cgi/mid.cgi?id=3D20011008191058.B13684@sunbay.com . I have extracted the patch if anyone wants to try it (it works at least againt a recent CURRENT) : http://simon.nitro.dk/freebsd/files/misc/ru-mdoc-ports.patch . Hope somebody has an opinion about this. --=20 Simon L. Nielsen --KFztAG8eRSV9hGtP Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+qHUf8kocFXgPTRwRAtJYAKDFLo7lsGskUh1RauHbP6nnnXS+rQCgrhut 2x5O0xmpH3DzbUOBzJZ8QJI= =NV0O -----END PGP SIGNATURE----- --KFztAG8eRSV9hGtP--