From: Paul V. <pa...@vi...> - 2010-08-05 00:08:39
|
Ivan Prenosil wrote: > Whereas in Release Notes, ROWS is presented as alternative to FIRST/SKIP, here > http://www.firebirdsql.org/refdocs/langrefupd21-select.html#langrefupd21-first-skip > is written > "FIRST and SKIP ... Deprecated in: 2.0 use ROWS" > > The word "deprecated" usually means "do not use this feature, because it will > probably be removed in the future". In the LangRef Updates, the term has the standard meaning of advising against it (generally because a better alternative has been implemented). This is explained in the Introduction: http://www.firebirdsql.org/refdocs/langrefupd21-intro-misc.html However, I've never been entirely happy with it, precisely because it may lead some people to think that there are concrete plans for removal. We could also use "discouraged" here, but that may have a similar effect (if the use of a feature is discouraged, there must be something "wrong" with it). What I needed when I wrote the guide was a short expression (preferably a single word, as this is for the headers: Added in... | Changed in... | Deprecated in... | Removed in...) to indicate that feature X is better avoided in new code because feature Y is better or more standard-compliant (and X *may* some day be removed). After weighing a number of alternatives I decided that "deprecated" was the least of all evils - at least of the evils that *I* could think of :-) But if anybody has a better idea, please let us know. Cheers, Paul Vinkenoog [Just back from holiday, hence late reply] |