From owner-freebsd-doc Fri Jan 4 7:55:10 2002 Delivered-To: freebsd-doc@freebsd.org Received: from straylight.ringlet.net (discworld.nanolink.com [217.75.135.248]) by hub.freebsd.org (Postfix) with SMTP id 59F2537B416 for ; Fri, 4 Jan 2002 07:55:00 -0800 (PST) Received: (qmail 50239 invoked by uid 1000); 4 Jan 2002 15:53:45 -0000 Date: Fri, 4 Jan 2002 17:53:45 +0200 From: Peter Pentchev To: Tom Rhodes Cc: "Bruce A. Mah" , Mario Sergio Fujikawa Ferreira , Nik Clayton , doc@FreeBSD.ORG Subject: Re: -> (?) Message-ID: <20020104175345.F328@straylight.oblivion.bg> Mail-Followup-To: Tom Rhodes , "Bruce A. Mah" , Mario Sergio Fujikawa Ferreira , Nik Clayton , doc@FreeBSD.ORG 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> <3C35CE4A.40904@pittgoth.com> <20020104174942.E328@straylight.oblivion.bg> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20020104174942.E328@straylight.oblivion.bg>; from roam@ringlet.net on Fri, Jan 04, 2002 at 05:49:42PM +0200 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 On Fri, Jan 04, 2002 at 05:49:42PM +0200, Peter Pentchev wrote: > On Fri, Jan 04, 2002 at 10:46:18AM -0500, Tom Rhodes wrote: > > Peter Pentchev wrote: > > > > > > 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. > > Errr... I believe that Nik's original objection was not to the > tag in general (as something which marks a port and adds a hyperlink > to the port's description and stuff), but to the poor choice of naming > (as something which introduces a semantical conflict with the lot of > other uses of the word 'port' WRT computer science). Just removing > the tags would not make things better in any way, IMHO; replacing > the tags with something more appropriately named and more easily > extensible (see PR docs/32478 for an example of how the tag is Make that docs/32468. I wonder how I managed to mess up typing a perfect sequence of even digits. > currently unable to link to a description file which is not named pkg-descr) > would help us all move one step closer to a perfectly documented world :) > Oh, and I guess I need to go get another Coke and start writing in > reasonably-sized sentences.. This one still applies :) G'luck, Peter -- Nostalgia ain't what it used to be. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message