Date: Wed, 2 Jan 2002 23:54:36 -0200 From: Mario Sergio Fujikawa Ferreira <lioux@FreeBSD.org> To: Nik Clayton <nik@FreeBSD.ORG> Cc: Peter Pentchev <roam@ringlet.net>, doc@FreeBSD.ORG Subject: Re: <filename> -> <port> (<protocol>?) Message-ID: <20020103015458.9740.qmail@exxodus.fedaykin.here> In-Reply-To: <20020102111934.B70243@clan.nothing-going-on.org>; from nik@FreeBSD.ORG on Wed, Jan 02, 2002 at 11:19:34AM %2B0000 References: <20011231100926.A3512@straylight.oblivion.bg> <20020102111934.B70243@clan.nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, Jan 02, 2002 at 11:19:34AM +0000, Nik Clayton wrote: > 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 > > <filename class="port"> > > or > > <filename class="package"> > > mechanism. Or perhaps > > <package category="archivers">unzip</package> > > or even > > <command package="archivers/unzip">unzip</package> I tend to agree. The later mechanisms both are not ambiguous and help in parsing. Now that we mention it. What about a <protocol></protocol> tag? Furthermore, shouldn't we use more <acronym></acronym>? TCP,IRC,FTP are all protocols and acronyms.... Regards, -- Mario S F Ferreira - DF - Brazil - "I guess this is a signature." Computer Science Undergraduate | FreeBSD Committer | CS Developer flames to beloved devnull@someotherworldbeloworabove.org feature, n: a documented bug | bug, n: an undocumented feature To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020103015458.9740.qmail>