From owner-freebsd-doc  Fri Feb  1  5:58:58 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from nothing-going-on.demon.co.uk (pc-62-31-42-140-hy.blueyonder.co.uk [62.31.42.140])
	by hub.freebsd.org (Postfix) with ESMTP id 45CC037B400
	for <doc@FreeBSD.ORG>; Fri,  1 Feb 2002 05:58:51 -0800 (PST)
Received: (from nik@localhost)
	by nothing-going-on.demon.co.uk (8.11.6/8.11.6) id g11DhFd07880;
	Fri, 1 Feb 2002 13:43:15 GMT
	(envelope-from nik)
Date: Fri, 1 Feb 2002 13:43:15 +0000
From: Nik Clayton <nik@freebsd.org>
To: Ceri <setantae@submonkey.net>
Cc: Szilveszter Adam <sziszi@bsd.hu>, doc@FreeBSD.ORG
Subject: Re: Entities for manpages installed by ports
Message-ID: <20020201134315.J82801@clan.nothing-going-on.org>
References: <20020130193036.GA88555@rhadamanth> <20020130211743.GB40491@fonix.adamsfamily.xx> <20020131113226.GA2309@rhadamanth>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-md5;
	protocol="application/pgp-signature"; boundary="451BZW+OUuJBCAYj"
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20020131113226.GA2309@rhadamanth>; from setantae@submonkey.net on Thu, Jan 31, 2002 at 11:32:26AM +0000
Organization: FreeBSD Project <URL:http://www.freebsd.org/>
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


--451BZW+OUuJBCAYj
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Thu, Jan 31, 2002 at 11:32:26AM +0000, Ceri wrote:
> How do I deal with references to manual pages installed by ports ?
> Someone.  Please.  Help.

The message from me at

    http://www.freebsd.org/cgi/getmsg.cgi?fetch=3D167716+0+/usr/local/www/d=
b/text/2001/freebsd-doc/20010527.freebsd-doc

has some suggestions about how we handle non-FreeBSD manpage references
in the documentation.

Comments?

For the specific examples of ports man pages, I think something like:

    &man.ports.net.isc-dhcp3.dhcpd.5;

is going to be necessary.  This could then expand to something like:

    <citerefentry>
      <refentrytitle>dhcpd</refentrytitle>
      <manvolnum>5</manvolnum>
    </citerefentry><footnote>
      <para>From <filename class=3D"port">net/isc-dhcp3</filename></para>
    </footnote>

N
--=20
FreeBSD: The Power to Serve      http://www.freebsd.org/               (__)
FreeBSD Documentation Project    http://www.freebsd.org/docproj/    \\\'',)
                                                                      \/  \=
 ^
   --- 15B8 3FFC DDB4 34B0 AA5F  94B7 93A8 0764 2C37 E375 ---         .\._/=
_)

--451BZW+OUuJBCAYj
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (FreeBSD)
Comment: For info see http://www.gnupg.org

iEYEARECAAYFAjxam3IACgkQk6gHZCw343UD5wCfds7BWLCIJywNlJaOqbOBm3yJ
iB8AnAgUtakAaKsGobjQEkM9ol4hb75s
=9ZHu
-----END PGP SIGNATURE-----

--451BZW+OUuJBCAYj--

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