Date: Fri, 25 Apr 2003 01:37:04 +0200 From: "Simon L. Nielsen" <simon@nitro.dk> To: freebsd-doc@freebsd.org Cc: Ruslan Ermilov <ru@freebsd.org> Subject: .Xr references to ports in man pages Message-ID: <20030424233703.GB48527@nitro.dk>
next in thread | raw e-mail | index | archive | help
--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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030424233703.GB48527>