You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by James M Snell <ja...@us.ibm.com> on 2003/01/07 21:12:44 UTC
Another API breaking change
Found another API breaking change that needs to be fixed. This one made
by Russell Butek and involves org.apache.axis.description.ParameterDesc .
An Axis 1.0 constructor was changed in version 1.22.6.2. The appropriate
way to make this change would have been to depreciate the existing
constructor and to create a new one. Russell, can you please go back and
make the appropriate fixes?
- James Snell
IBM Emerging Technologies
jasnell@us.ibm.com
(559) 587-1233 (office)
(700) 544-9035 (t/l)
Programming Web Services With SOAP
O'Reilly & Associates, ISBN 0596000952
Have I not commanded you? Be strong and courageous.
Do not be terrified, do not be discouraged, for the Lord your
God will be with you whereever you go. - Joshua 1:9
Re: Another API breaking change
Posted by Jess Sightler <js...@eximtechnologies.com>.
Agreed... from the dictionary's point of view, I can't say that it
matters one way or another.
>>From javadoc's, AFAIK, it still needs to be "deprecate".
Thanks,
Jess
On Tue, 2003-01-07 at 15:59, Scott Nichol wrote:
> Maybe instead of writing "make sure that you deprecate the method", we
> should write "make sure that you @deprecate the method", and avoid
> thesaurus.com altogether ;-)
>
> Scott Nichol
>
> ----- Original Message -----
> From: "James M Snell" <ja...@us.ibm.com>
> To: <ax...@xml.apache.org>
> Sent: Tuesday, January 07, 2003 3:48 PM
> Subject: Re: Another API breaking change
>
>
> > Source: dictionary.com
> >
> > dep-re-cate
> > 1. To express disapproval of, deplore
> > 2. To belittle, depreciate
> >
> > dep-pre-ci-ate
> > 1. To lessen the price or value of
> > 2. To think or speak of as being of little worth; belittle
> >
> > Usage Note: The first and fully accepted meaning of deprecate is "to
> > express disapproval of." But the word has steadily encroached on the
> > meaning of depreciate. It is now used, almost to the exclusion of
> > depreciate, in the sense "to belittle or mildly disparage," as in He
> > deprecated his own contribution.
> >
> >
> > Source: thesaurus.com
> >
> > Synonyms for deprecate: bemoan, bewail, condemn, deplore,
> **depreciate** ,
> > derogate, detract, disapprove of, discommend, discountenance,
> disesteem,
> > disfavor, disparage, expostulate, frown, lament, mudsling, object,
> pooh
> > pooh, pour mouth, protest against, put down, rip, run down, take down
> > [emphasis added]
> >
> > I say toh-mah-toh, you say tuh-may-toh, who cares it's still a fruit.
> :-)
> >
> > - James Snell
> > IBM Emerging Technologies
> > jasnell@us.ibm.com
> > (559) 587-1233 (office)
> > (700) 544-9035 (t/l)
> > Programming Web Services With SOAP
> > O'Reilly & Associates, ISBN 0596000952
> >
> > Have I not commanded you? Be strong and courageous.
> > Do not be terrified, do not be discouraged, for the Lord your
> > God will be with you whereever you go. - Joshua 1:9
> >
> >
> >
> > Jess Sightler <js...@eximtechnologies.com>
> > 01/07/2003 12:25 PM
> > Please respond to axis-dev
> >
> >
> > To
> > axis-dev@xml.apache.org
> > cc
> > Russell Butek/Austin/IBM@IBMUS, Doug Davis/Raleigh/IBM@IBMUS
> > bcc
> >
> > Subject
> > Re: Another API breaking change
> >
> >
> >
> >
> > > way to make this change would have been to depreciate the existing
> >
> > Deprecate... deprecate... deprecate... deprecate... deprecate... ;-)
> >
> > Ok, no offense, but this one is a pet-peeve of mine. Make sure that
> you
> > deprecate the method. Don't depreciate it.
> >
> > Thanks,
> > Jess
> > 'Cuz-it-ain't-accounting
> >
> >
> >
> > On Tue, 2003-01-07 at 15:12, James M Snell wrote:
> > > Found another API breaking change that needs to be fixed. This one
> made
> > > by Russell Butek and involves
> org.apache.axis.description.ParameterDesc
> > .
> > >
> > > An Axis 1.0 constructor was changed in version 1.22.6.2. The
> > appropriate
> > > way to make this change would have been to depreciate the existing
> > > constructor and to create a new one. Russell, can you please go
> back
> > and
> > > make the appropriate fixes?
> > >
> > > - James Snell
> > > IBM Emerging Technologies
> > > jasnell@us.ibm.com
> > > (559) 587-1233 (office)
> > > (700) 544-9035 (t/l)
> > > Programming Web Services With SOAP
> > > O'Reilly & Associates, ISBN 0596000952
> > >
> > > Have I not commanded you? Be strong and courageous.
> > > Do not be terrified, do not be discouraged, for the Lord your
> > > God will be with you whereever you go. - Joshua 1:9
> > --
> > =======================================
> > Jess Sightler
> > Senior Developer
> > Exim Technologies
> > 131 Falls Street
> > Greenville SC 29601
> > Phone: 864-679-4651
> > =======================================
> >
> >
> >
> >
> >
--
=======================================
Jess Sightler
Senior Developer
Exim Technologies
131 Falls Street
Greenville SC 29601
Phone: 864-679-4651
=======================================
Re: Another API breaking change
Posted by James M Snell <ja...@us.ibm.com>.
Where's the fun in that!? ;-)
- James Snell
IBM Emerging Technologies
jasnell@us.ibm.com
(559) 587-1233 (office)
(700) 544-9035 (t/l)
Programming Web Services With SOAP
O'Reilly & Associates, ISBN 0596000952
Have I not commanded you? Be strong and courageous.
Do not be terrified, do not be discouraged, for the Lord your
God will be with you whereever you go. - Joshua 1:9
Scott Nichol <sn...@scottnichol.com>
01/07/2003 12:59 PM
Please respond to axis-dev
To
axis-dev@xml.apache.org
cc
bcc
Subject
Re: Another API breaking change
Maybe instead of writing "make sure that you deprecate the method", we
should write "make sure that you @deprecate the method", and avoid
thesaurus.com altogether ;-)
Scott Nichol
----- Original Message -----
From: "James M Snell" <ja...@us.ibm.com>
To: <ax...@xml.apache.org>
Sent: Tuesday, January 07, 2003 3:48 PM
Subject: Re: Another API breaking change
> Source: dictionary.com
>
> dep-re-cate
> 1. To express disapproval of, deplore
> 2. To belittle, depreciate
>
> dep-pre-ci-ate
> 1. To lessen the price or value of
> 2. To think or speak of as being of little worth; belittle
>
> Usage Note: The first and fully accepted meaning of deprecate is "to
> express disapproval of." But the word has steadily encroached on the
> meaning of depreciate. It is now used, almost to the exclusion of
> depreciate, in the sense "to belittle or mildly disparage," as in He
> deprecated his own contribution.
>
>
> Source: thesaurus.com
>
> Synonyms for deprecate: bemoan, bewail, condemn, deplore,
**depreciate** ,
> derogate, detract, disapprove of, discommend, discountenance,
disesteem,
> disfavor, disparage, expostulate, frown, lament, mudsling, object,
pooh
> pooh, pour mouth, protest against, put down, rip, run down, take down
> [emphasis added]
>
> I say toh-mah-toh, you say tuh-may-toh, who cares it's still a fruit.
:-)
>
> - James Snell
> IBM Emerging Technologies
> jasnell@us.ibm.com
> (559) 587-1233 (office)
> (700) 544-9035 (t/l)
> Programming Web Services With SOAP
> O'Reilly & Associates, ISBN 0596000952
>
> Have I not commanded you? Be strong and courageous.
> Do not be terrified, do not be discouraged, for the Lord your
> God will be with you whereever you go. - Joshua 1:9
>
>
>
> Jess Sightler <js...@eximtechnologies.com>
> 01/07/2003 12:25 PM
> Please respond to axis-dev
>
>
> To
> axis-dev@xml.apache.org
> cc
> Russell Butek/Austin/IBM@IBMUS, Doug Davis/Raleigh/IBM@IBMUS
> bcc
>
> Subject
> Re: Another API breaking change
>
>
>
>
> > way to make this change would have been to depreciate the existing
>
> Deprecate... deprecate... deprecate... deprecate... deprecate... ;-)
>
> Ok, no offense, but this one is a pet-peeve of mine. Make sure that
you
> deprecate the method. Don't depreciate it.
>
> Thanks,
> Jess
> 'Cuz-it-ain't-accounting
>
>
>
> On Tue, 2003-01-07 at 15:12, James M Snell wrote:
> > Found another API breaking change that needs to be fixed. This one
made
> > by Russell Butek and involves
org.apache.axis.description.ParameterDesc
> .
> >
> > An Axis 1.0 constructor was changed in version 1.22.6.2. The
> appropriate
> > way to make this change would have been to depreciate the existing
> > constructor and to create a new one. Russell, can you please go
back
> and
> > make the appropriate fixes?
> >
> > - James Snell
> > IBM Emerging Technologies
> > jasnell@us.ibm.com
> > (559) 587-1233 (office)
> > (700) 544-9035 (t/l)
> > Programming Web Services With SOAP
> > O'Reilly & Associates, ISBN 0596000952
> >
> > Have I not commanded you? Be strong and courageous.
> > Do not be terrified, do not be discouraged, for the Lord your
> > God will be with you whereever you go. - Joshua 1:9
> --
> =======================================
> Jess Sightler
> Senior Developer
> Exim Technologies
> 131 Falls Street
> Greenville SC 29601
> Phone: 864-679-4651
> =======================================
>
>
>
>
>
Re: Another API breaking change
Posted by Scott Nichol <sn...@scottnichol.com>.
Maybe instead of writing "make sure that you deprecate the method", we
should write "make sure that you @deprecate the method", and avoid
thesaurus.com altogether ;-)
Scott Nichol
----- Original Message -----
From: "James M Snell" <ja...@us.ibm.com>
To: <ax...@xml.apache.org>
Sent: Tuesday, January 07, 2003 3:48 PM
Subject: Re: Another API breaking change
> Source: dictionary.com
>
> dep-re-cate
> 1. To express disapproval of, deplore
> 2. To belittle, depreciate
>
> dep-pre-ci-ate
> 1. To lessen the price or value of
> 2. To think or speak of as being of little worth; belittle
>
> Usage Note: The first and fully accepted meaning of deprecate is "to
> express disapproval of." But the word has steadily encroached on the
> meaning of depreciate. It is now used, almost to the exclusion of
> depreciate, in the sense "to belittle or mildly disparage," as in He
> deprecated his own contribution.
>
>
> Source: thesaurus.com
>
> Synonyms for deprecate: bemoan, bewail, condemn, deplore,
**depreciate** ,
> derogate, detract, disapprove of, discommend, discountenance,
disesteem,
> disfavor, disparage, expostulate, frown, lament, mudsling, object,
pooh
> pooh, pour mouth, protest against, put down, rip, run down, take down
> [emphasis added]
>
> I say toh-mah-toh, you say tuh-may-toh, who cares it's still a fruit.
:-)
>
> - James Snell
> IBM Emerging Technologies
> jasnell@us.ibm.com
> (559) 587-1233 (office)
> (700) 544-9035 (t/l)
> Programming Web Services With SOAP
> O'Reilly & Associates, ISBN 0596000952
>
> Have I not commanded you? Be strong and courageous.
> Do not be terrified, do not be discouraged, for the Lord your
> God will be with you whereever you go. - Joshua 1:9
>
>
>
> Jess Sightler <js...@eximtechnologies.com>
> 01/07/2003 12:25 PM
> Please respond to axis-dev
>
>
> To
> axis-dev@xml.apache.org
> cc
> Russell Butek/Austin/IBM@IBMUS, Doug Davis/Raleigh/IBM@IBMUS
> bcc
>
> Subject
> Re: Another API breaking change
>
>
>
>
> > way to make this change would have been to depreciate the existing
>
> Deprecate... deprecate... deprecate... deprecate... deprecate... ;-)
>
> Ok, no offense, but this one is a pet-peeve of mine. Make sure that
you
> deprecate the method. Don't depreciate it.
>
> Thanks,
> Jess
> 'Cuz-it-ain't-accounting
>
>
>
> On Tue, 2003-01-07 at 15:12, James M Snell wrote:
> > Found another API breaking change that needs to be fixed. This one
made
> > by Russell Butek and involves
org.apache.axis.description.ParameterDesc
> .
> >
> > An Axis 1.0 constructor was changed in version 1.22.6.2. The
> appropriate
> > way to make this change would have been to depreciate the existing
> > constructor and to create a new one. Russell, can you please go
back
> and
> > make the appropriate fixes?
> >
> > - James Snell
> > IBM Emerging Technologies
> > jasnell@us.ibm.com
> > (559) 587-1233 (office)
> > (700) 544-9035 (t/l)
> > Programming Web Services With SOAP
> > O'Reilly & Associates, ISBN 0596000952
> >
> > Have I not commanded you? Be strong and courageous.
> > Do not be terrified, do not be discouraged, for the Lord your
> > God will be with you whereever you go. - Joshua 1:9
> --
> =======================================
> Jess Sightler
> Senior Developer
> Exim Technologies
> 131 Falls Street
> Greenville SC 29601
> Phone: 864-679-4651
> =======================================
>
>
>
>
>
Re: Another API breaking change
Posted by James M Snell <ja...@us.ibm.com>.
Source: dictionary.com
dep-re-cate
1. To express disapproval of, deplore
2. To belittle, depreciate
dep-pre-ci-ate
1. To lessen the price or value of
2. To think or speak of as being of little worth; belittle
Usage Note: The first and fully accepted meaning of deprecate is "to
express disapproval of." But the word has steadily encroached on the
meaning of depreciate. It is now used, almost to the exclusion of
depreciate, in the sense "to belittle or mildly disparage," as in He
deprecated his own contribution.
Source: thesaurus.com
Synonyms for deprecate: bemoan, bewail, condemn, deplore, **depreciate** ,
derogate, detract, disapprove of, discommend, discountenance, disesteem,
disfavor, disparage, expostulate, frown, lament, mudsling, object, pooh
pooh, pour mouth, protest against, put down, rip, run down, take down
[emphasis added]
I say toh-mah-toh, you say tuh-may-toh, who cares it's still a fruit. :-)
- James Snell
IBM Emerging Technologies
jasnell@us.ibm.com
(559) 587-1233 (office)
(700) 544-9035 (t/l)
Programming Web Services With SOAP
O'Reilly & Associates, ISBN 0596000952
Have I not commanded you? Be strong and courageous.
Do not be terrified, do not be discouraged, for the Lord your
God will be with you whereever you go. - Joshua 1:9
Jess Sightler <js...@eximtechnologies.com>
01/07/2003 12:25 PM
Please respond to axis-dev
To
axis-dev@xml.apache.org
cc
Russell Butek/Austin/IBM@IBMUS, Doug Davis/Raleigh/IBM@IBMUS
bcc
Subject
Re: Another API breaking change
> way to make this change would have been to depreciate the existing
Deprecate... deprecate... deprecate... deprecate... deprecate... ;-)
Ok, no offense, but this one is a pet-peeve of mine. Make sure that you
deprecate the method. Don't depreciate it.
Thanks,
Jess
'Cuz-it-ain't-accounting
On Tue, 2003-01-07 at 15:12, James M Snell wrote:
> Found another API breaking change that needs to be fixed. This one made
> by Russell Butek and involves org.apache.axis.description.ParameterDesc
.
>
> An Axis 1.0 constructor was changed in version 1.22.6.2. The
appropriate
> way to make this change would have been to depreciate the existing
> constructor and to create a new one. Russell, can you please go back
and
> make the appropriate fixes?
>
> - James Snell
> IBM Emerging Technologies
> jasnell@us.ibm.com
> (559) 587-1233 (office)
> (700) 544-9035 (t/l)
> Programming Web Services With SOAP
> O'Reilly & Associates, ISBN 0596000952
>
> Have I not commanded you? Be strong and courageous.
> Do not be terrified, do not be discouraged, for the Lord your
> God will be with you whereever you go. - Joshua 1:9
--
=======================================
Jess Sightler
Senior Developer
Exim Technologies
131 Falls Street
Greenville SC 29601
Phone: 864-679-4651
=======================================
Re: Another API breaking change
Posted by Jess Sightler <js...@eximtechnologies.com>.
> way to make this change would have been to depreciate the existing
Deprecate... deprecate... deprecate... deprecate... deprecate... ;-)
Ok, no offense, but this one is a pet-peeve of mine. Make sure that you
deprecate the method. Don't depreciate it.
Thanks,
Jess
'Cuz-it-ain't-accounting
On Tue, 2003-01-07 at 15:12, James M Snell wrote:
> Found another API breaking change that needs to be fixed. This one made
> by Russell Butek and involves org.apache.axis.description.ParameterDesc .
>
> An Axis 1.0 constructor was changed in version 1.22.6.2. The appropriate
> way to make this change would have been to depreciate the existing
> constructor and to create a new one. Russell, can you please go back and
> make the appropriate fixes?
>
> - James Snell
> IBM Emerging Technologies
> jasnell@us.ibm.com
> (559) 587-1233 (office)
> (700) 544-9035 (t/l)
> Programming Web Services With SOAP
> O'Reilly & Associates, ISBN 0596000952
>
> Have I not commanded you? Be strong and courageous.
> Do not be terrified, do not be discouraged, for the Lord your
> God will be with you whereever you go. - Joshua 1:9
--
=======================================
Jess Sightler
Senior Developer
Exim Technologies
131 Falls Street
Greenville SC 29601
Phone: 864-679-4651
=======================================