From owner-freebsd-doc Fri Jan 4 7:39:27 2002 Delivered-To: freebsd-doc@freebsd.org Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by hub.freebsd.org (Postfix) with ESMTP id 89B8F37B420; Fri, 4 Jan 2002 07:39:03 -0800 (PST) Received: from pittgoth.com (lcl234.zbzoom.net [208.236.36.234]) by pittgoth.com (8.11.6/8.11.6) with ESMTP id g04FdhD17330; Fri, 4 Jan 2002 10:39:44 -0500 (EST) (envelope-from darklogik@pittgoth.com) Message-ID: <3C35CE4A.40904@pittgoth.com> Date: Fri, 04 Jan 2002 10:46:18 -0500 From: Tom Rhodes Reply-To: darklogik@pittgoth.com User-Agent: Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.7) Gecko/20011221 X-Accept-Language: en-us MIME-Version: 1.0 To: Peter Pentchev Cc: "Bruce A. Mah" , Mario Sergio Fujikawa Ferreira , Nik Clayton , doc@FreeBSD.ORG Subject: Re: -> (?) References: <20011231100926.A3512@straylight.oblivion.bg> <20020102111934.B70243@clan.nothing-going-on.org> <20020103015458.9740.qmail@exxodus.fedaykin.here> <200201030348.g033m3U15483@bmah.dyndns.org> <20020104155516.B328@straylight.oblivion.bg> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org 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 instead of when referring >>>>>to a port? If not, how about the attached patch? >>>>> >>>>I'm still uneasy about . Apart from the ambiguous name: >>>> >>>> The webserver listens on port 80. >>>> >>>> The printer is connected to lpt0. >>>> >>>>the rest of the world prefers the 'package' nomenclature. >>>> >>>>I'd be more comfortable with a >>>> >>>> >>>> >>>>or >>>> >>>> >>>> >>>>mechanism. Or perhaps >>>> >>>> unzip >>>> >>>>or even >>>> >>>> unzip >>>> >>> I tend to agree. The later mechanisms both are not ambiguous >>>and help in parsing. >>> Now that we mention it. What about a >>>tag? >>> Furthermore, shouldn't we use more ? >>> >>> 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 but I didn't say >>so at the time. Maybe I should have...although it'd be easy to switch >>to something like . 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 and replacing it with >class="package"> or some variant thereof. >> > > FWIW, I agree with this - and not just because it's my patch :) > Yes, 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 .. with ..., > if we are certain that this will catch *all* referrals to ports and > packages. > > G'luck, > Peter > > cat chapter.sgml | sed "s/\//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 ... 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