(from dictionary.com)
dep�re�cate (dpr-kt)
v. tr. de�pre�cat�ed, de�pre�cat�ing, de�pre�cates.
To express disapproval of; deplore.
To belittle; depreciate.
----------------------------------------------------------------------------
----
[Latin dprecr, dprect- to ward off by prayer: d-, de- + precr, to pray; see
prek- in Indo-European Roots.]
---
I think that this really is a good choice of words. Generally when I
deprecate an interface to something, I do not mean supersedes, because I
know that 15% of the people using the interface will continue to use the old
interface, so I actually have to make the old interface work via some ugly
hacks for those people. By deprecating, I am hoping that people will be
scared off by my warning, which I secretly would not really inforce.
When I deprecate something, I am indicating that I disaprove of it.
Disaproval in many instances means that you will allow the action which you
do not approve of continue without support. Maybe @notsupported would be
better, but it doesn't have the same ring that @deprecated does.
Cheers.
���`����,��,����`����,��,�
Matthew MacKenzie
VP Research & Development
XML Global Technologies, Inc.
-----Original Message-----
From: David Bruce [mailto:[EMAIL PROTECTED]]
Sent: October 27, 2000 9:05 AM
To: [EMAIL PROTECTED]
Subject: RE: XML for EDI book: any comments?
I disagree. There are times when people choose words that are over-fancy,
but as it happens... this is not one of them! The use of 'deprecated' may
ORIGINALLY have been a poor choice, but now that millions have gotten used
to it as meaning "this is a method that may not be supported for long", it
is the BEST word to communicate the intended meaning. Something that has
been superceded may not be useable AT ALL. I was not impressed the first
time that I heard "agnostic" used in the context that you are referring to,
but some of the arguments that folks get into resemble the antics of
"religious wars".
As for keeping stupid... "Things should be made as simple as possible, but
not any simpler." - Albert Einstein
David G. Bruce
Senior Sales Engineer
Phone: (905) 855-1889
ObjectSpace, Inc.
The Leader in Business-to-Business Solutions
http://www.objectspace.com
-----Original Message-----
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]]
Sent: Friday, October 27, 2000 10:12 AM
To: [EMAIL PROTECTED]; [EMAIL PROTECTED]
Subject: RE: XML for EDI book: any comments?
This is just another instance of someone wanting to use a fancy word when
another would be more accurate. As Rachel pointed out by quoting the
dictionary definition, "deprecate" has a pejorative context. It bothers me,
too, Rachel. Why use "deprecated" when what you mean is "superseded?"
Another example is the recent trend to use "agnostic" to identify something
that is neutral. Please, people, try to remember K.I.S.S.
Sally
-----Original Message-----
From: Matthew MacKenzie [mailto:[EMAIL PROTECTED]]
Sent: Wednesday, October 25, 2000 8:13 PM
To: [EMAIL PROTECTED]
Subject: RE: XML for EDI book: any comments?
The whole notion of "deprecated" code was derived from a field you can use
in JavaDoc, which is a code-level documentation
format which allows a tool called javadoc to generate API documentation from
raw code.
An example:
/**
* This method stores your name in a file.
* @param Your Name
* @param File Name
* @return void
* @deprecated As if JDK 1.3.0, replaced by {@link #storeName(String,
String)}
*/
public void saveName(String name, String f_name) {
...
}
Cheers!
���`����,��,����`����,��,�
Matthew MacKenzie
VP Research & Development
XML Global Technologies, Inc.
-----Original Message-----
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED]]
Sent: October 25, 2000 4:47 PM
To: [EMAIL PROTECTED]
Cc: [EMAIL PROTECTED]
Subject: RE: XML for EDI book: any comments?
Rachel
In the java world, certain classes and/or methods are replaced with newer,
hopefully better code from time to time. Actually, it happens quite
frequently.
By the time the Ben's ( and other author's ) books are published, the
supplier of the java code that was used as examples in the book has been
replaced and the old code is marked as "deprecated".
As a side note, in my mind this is one reason that I would like to see books
published in an electronic format that will make it to market faster.
Bill
On Wed, 25 October 2000, "Rachel Foerster" wrote:
>
>
> Ben,
>
> I'm glad you saw my compliments about your book. One question....you
> use the term deprecated code. I've seen it used many times elsewhere.
> This may be a dumb question, but what does it mean. The dictionary
> definition of deprecated is
>
> dep�re�cate (d�p"r�-k�t") tr.v. de�pre�cat�ed, de�pre�cat�ing,
> de�pre�cates. 1. To express disapproval of; deplore. 2. To belittle;
> depreciate. --dep"re�cat"ing�ly adv. --dep"re�ca"tion n. --dep"re�ca"
> tor n.
>
>
> Thanks,
>
> Rachel
>
>
> At 08:21 PM 10/24/00, you wrote:
> >I agree wholeheartedly.
> >
> >That was the first XML book I picked up, and even though many of his
> >examples use deprecated code, it provided me with some great examples
> and
> >a good feel for XML programming.
> >
> >Good book!!!
>
> I'm glad you and Rachel find XML by Example useful.
>
> In answer to your comments, I wanted to point out that I tried to
> update
> the obsolete XSL code on the support web site
> (http://www.mcp.com/que/detail_que.cfm?item=0789722429). Some of the
> updates have found their way in recent reprints so if you buy a copy
> today,
> it should contain little deprecated code (hopefully :-).
>
> --ben
> Beno�t Marchal, www.pineapplesoft.com
>
> As eCommerce Grows, Understanding XML Becomes a Key Job Skill
> XML by Example / $24.99 / ISBN 0-7897-2242-9 / www.worth-it.com
> Applied XML Solutions / $44.99 / ISBN 0-6723-2054-1 / www.worth-it.com
>
>
>
> ------ XML/edi Group Discussion List ------
> Homepage =http://www.XMLedi-Group.org
>
> Unsubscribe =send email to: [EMAIL PROTECTED]
> Leave the subject and body of the message blank
>
> Questions/requests: [EMAIL PROTECTED]
>
> To receive only one message per day (digest format)
> send the following message to [EMAIL PROTECTED],
> (leave the subject line blank)
>
> digest xmledi-group your-email-address
>
> To join the XML/edi Group complete the form located at:
> http://www.xmledi-group.org/xmledigroup/mail1.htm
>
>
>
>
>
> ------ XML/edi Group Discussion List ------
> Homepage http://www.XMLedi-Group.org
>
> Unsubscribe send email to: [EMAIL PROTECTED]
> Leave the subject and body of the message blank
>
> Questions/requests: [EMAIL PROTECTED]
>
> To receive only one message per day (digest format)
> send the following message to [EMAIL PROTECTED],
> (leave the subject line blank)
>
> digest xmledi-group your-email-address
>
> To join the XML/edi Group complete the form located at:
> http://www.xmledi-group.org/xmledigroup/mail1.htm
The human mind is the most fertile soil in the
universe.
What are you planting this year?
___________________________________________________
The ALL NEW CS2000 from CompuServe
Better! Faster! More Powerful!
250 FREE hours! Sign-on Now!
http://www.compuserve.com/trycsrv/cs2000/webmail/
------ XML/edi Group Discussion List ------
Homepage = http://www.XMLedi-Group.org
Unsubscribe = send email to: [EMAIL PROTECTED]
Leave the subject and body of the message blank
Questions/requests: [EMAIL PROTECTED]
To receive only one message per day (digest format)
send the following message to [EMAIL PROTECTED],
(leave the subject line blank)
digest xmledi-group your-email-address
To join the XML/edi Group complete the form located at:
http://www.xmledi-group.org/xmledigroup/mail1.htm
------ XML/edi Group Discussion List ------
Homepage = http://www.XMLedi-Group.org
Unsubscribe = send email to: [EMAIL PROTECTED]
Leave the subject and body of the message blank
Questions/requests: [EMAIL PROTECTED]
To receive only one message per day (digest format)
send the following message to [EMAIL PROTECTED],
(leave the subject line blank)
digest xmledi-group your-email-address
To join the XML/edi Group complete the form located at:
http://www.xmledi-group.org/xmledigroup/mail1.htm
------ XML/edi Group Discussion List ------
Homepage = http://www.XMLedi-Group.org
Unsubscribe = send email to: [EMAIL PROTECTED]
Leave the subject and body of the message blank
Questions/requests: [EMAIL PROTECTED]
To receive only one message per day (digest format)
send the following message to [EMAIL PROTECTED],
(leave the subject line blank)
digest xmledi-group your-email-address
To join the XML/edi Group complete the form located at:
http://www.xmledi-group.org/xmledigroup/mail1.htm
------ XML/edi Group Discussion List ------
Homepage
Unsubscribe Leave the subject and body of the message blank
Questions/requests: [EMAIL PROTECTED]
To receive only one message per day (digest format)
send the following message to [EMAIL PROTECTED],
(leave the subject line blank)
digest xmledi-group your-email-address
To join the XML/edi Group complete the form located at:
http://www.xmledi-group.org/xmledigroup/mail1.htm
------ XML/edi Group Discussion List ------
Homepage http://www.XMLedi-Group.org
Unsubscribe send email to: [EMAIL PROTECTED]
Leave the subject and body of the message blank
Questions/requests: [EMAIL PROTECTED]
To receive only one message per day (digest format)
send the following message to [EMAIL PROTECTED],
(leave the subject line blank)
digest xmledi-group your-email-address
To join the XML/edi Group complete the form located at:
http://www.xmledi-group.org/xmledigroup/mail1.htm
