Date: Fri, 4 Jan 2002 13:27:09 -0800 (PST) From: Hiten Pandya <hitmaster2k@yahoo.com> To: doc@FreeBSD.org Subject: Re: <filename> -> <port> (<protocol>?) Message-ID: <20020104212709.3086.qmail@web21106.mail.yahoo.com> In-Reply-To: <3C35CE4A.40904@pittgoth.com>
index | next in thread | previous in thread | raw e-mail
hi,
I am sure there is a <systemitem> tag which has a lot
of functionality. Maybe what we can do , is add more
attribute values to it, rather than making whole new
tags.
<systemitem class="osname"
"resource" (good for URLs)
/>
and other values to the 'class' attribute, we can add
port, protocol, and other ones like them... what do
you
think?
regards,
- Hiten
- <hiten@uk.FreeBSD.org>
--- Tom Rhodes <darklogik@pittgoth.com> wrote:
> Peter Pentchev wrote:
>
> > On Wed, Jan 02, 2002 at 07:48:02PM -0800, Bruce A.
> Mah wrote:
> >
> >>If memory serves me right, Mario Sergio Fujikawa
> Ferreira wrote:
> >>
> >>>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....
> >>>
> >>Waitasecond. I'm a little leery of adding a lot
> of Yet Another Element
> >>as a non-standard FreeBSD extension to the DocBook
> DTD.
> >>
> >>I felt this way when someone introduced
> <port></port> but I didn't say
> >>so at the time. Maybe I should have...although
> it'd be easy to switch
> >>to something like <filename
> class="package"></filename>. Personally,
> >>this is the solution I prefer.
> >>
> >>We should take roam's patch, to get the remaining
> package names into
> >>compliance with our current convention. *Then* we
> should see about
> >>getting rid of <port></port> and replacing it with
> <filename
> >>class="package"> </filename> or some variant
> thereof.
> >>
> >
> > FWIW, I agree with this - and not just because
> it's my patch :)
> > Yes, <port> is misleading; yes, we should think of
> something better;
> > but when we do, it will be much, much easier to do
> a mass-replace
> > of <port>..</port> with <something
> role="better">...</something>,
> > if we are certain that this will catch *all*
> referrals to ports and
> > packages.
> >
> > G'luck,
> > Peter
> >
> >
>
> cat chapter.sgml | sed "s/\<port\>//g" | sed
> "s/\<\\/port\>//g" >
> chapter.sgml.new && mv chapter.sgml chapter.old
>
> then just move chapter.sgml.new to chapter.sgml or
> add another && mv
> command in the section above to do it all in one
> swift stroke. Maywbe
> an awk scrip would do the trick on this also :)
> opinions?
>
> That will just be a quick clean to the
> <port>...</port> reference, I
> used it before in an sgml doc, and noticed that it
> saved me alot of time
> cleaning up and changing tags.
>
> --
> Tom (Darklogik) Rhodes
> www.Pittgoth.com Gothic Liberation Front
> www.FreeBSD.org The Power To Serve
>
>
> To Unsubscribe: send mail to majordomo@FreeBSD.org
> with "unsubscribe freebsd-doc" in the body of the
message
=====
SSH Fingerprint:
1024 45:a5:9c:f2:fb:07:da:70:18:02:0b:f3:63:f1:7a:a6 hitenp@hpdi.ath.cx
__________________________________________________
Do You Yahoo!?
Send your FREE holiday greetings online!
http://greetings.yahoo.com
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020104212709.3086.qmail>