From owner-freebsd-doc  Wed Jan  2  4:57:48 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 3886037B421
	for <doc@FreeBSD.org>; Wed,  2 Jan 2002 04:57:37 -0800 (PST)
Received: (from nik@localhost)
	by nothing-going-on.demon.co.uk (8.11.6/8.11.6) id g02BJYm94508;
	Wed, 2 Jan 2002 11:19:34 GMT
	(envelope-from nik)
Date: Wed, 2 Jan 2002 11:19:34 +0000
From: Nik Clayton <nik@freebsd.org>
To: Peter Pentchev <roam@ringlet.net>
Cc: doc@FreeBSD.org
Subject: Re: <filename> -> <port>
Message-ID: <20020102111934.B70243@clan.nothing-going-on.org>
References: <20011231100926.A3512@straylight.oblivion.bg>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-md5;
	protocol="application/pgp-signature"; boundary="eJnRUKwClWJh1Khz"
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20011231100926.A3512@straylight.oblivion.bg>; from roam@ringlet.net on Mon, Dec 31, 2001 at 10:09:26AM +0200
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


--eJnRUKwClWJh1Khz
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Mon, Dec 31, 2001 at 10:09:26AM +0200, Peter Pentchev wrote:
> Is there a reason to use <filename> instead of <port> when referring
> to a port?  If not, how about the attached patch?

I'm still uneasy about <port>.  Apart from the ambiguous name:

    <para>The webserver listens on port <port>80</port>.</para>

    <para>The printer is connected to <port>lpt0</port>.</para>

the rest of the world prefers the 'package' nomenclature.

I'd be more comfortable with a=20

    <filename class=3D"port">

or

    <filename class=3D"package">

mechanism.  Or perhaps

    <package category=3D"archivers">unzip</package>

or even

    <command package=3D"archivers/unzip">unzip</package>

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 ---

--eJnRUKwClWJh1Khz
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

iEYEARECAAYFAjwy7MUACgkQk6gHZCw343UMegCfZiGiEIBcIGo42TNp/UmxX4KV
sfcAn2S/VmGf0DAqw63Tr89uRyhrNk+Z
=5uLA
-----END PGP SIGNATURE-----

--eJnRUKwClWJh1Khz--

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