RE: [PHP-DOC] A question about the ftp_close function

> -----Original Message----- > From: Philip Olson [mailto:philip@cornado.com] > Sent: 08 November 2002 21:32 > To: Ford, Mike [LSS] > > How about instead we use, for example, the <acronym> tag (or > similar) so: > > <acronym>CVS</acronym> > > And in acronyms.xml we would list a definition for such terms. > I don't know if <acronym> is the appropriate tag but the > idea is what's important here. I prefer this method. Yes, this is nice. > > Avenger is translating english to chinese, he knows what CVS > means but wasn't sure about the context. I blame the > note, which shouldn't have been there. But of course your > point is valid. Apologies if I used an inappropriate platform to launch into one of my favourite mini-rants ("Use plain English wherever possible..." "Use plain English wherever possible..." "Use plain English wherever possible..."), but if it gets results... > > There's some other terminology used in various places that's rather > > "techie" and I'd like to see replaced with a more plain-language > > description -- when (or perhaps that should be IF) I have some spare > > time, I'd like to identify these and put some proposals to > the list. > > (And, yes, eventually I'd like to get CVS access and > actively help -- > > I'm especially interested in the structured argument lists and > > CHANGELOG proposals that are currently being discussed.) > > Please list a few other terms, I'm curious. Sometimes these > techie terms are important and if people don't understand them > they shouldn't use the function! Of course I'm being a little > conservative on the idea and can only offer my opinions on a > case-by-case basis :) I look forward to your CVS access to the > phpdoc tree and hope spare time finds its way into your life and > into the php manual. Well, such a list is one of the things I need some spare time for ;) -- at the moment, it's just an impression I've formed from fighting my way through a selection of manual pages. I'll try to be a bit more rigorous about noting such usages as and when I come across them! Cheers! Mike --------------------------------------------------------------------- Mike Ford, Electronic Information Services Adviser, Learning Support Services, Learning & Information Services, JG125, James Graham Building, Leeds Metropolitan University, Beckett Park, LEEDS, LS6 3QS, United Kingdom Email: m.ford@lmu.ac.uk Tel: +44 113 283 2600 extn 4730 Fax: +44 113 283 3211