Remove warnings from functions deprecated in 2.1.0

[realityexists]

As per the comments in #1994, please remove the warnings from functions deprecated in 2.1.0, at least in cases where the new function was only introduced in 2.1.0.

I don't think it's safe for me to update to the new functions yet, because not all my users may have upgraded to 2.1.0. Meanwhile, those who have upgraded get logs full of spurious warnings.

[robe]

For a 2.1.1 fix I'm planning to keep the function in but just have it not do anything. Basically quiet it. That will allow for people to get back the old beahviro wiht just a new binary.

Then for 2.2.0 since we have come GUC happy either make it a GUC with default being warn and option that people can turn it off or just have it go back to same behavior of warning.

[robe]

Relegating from WARNING to DEBUG notice.

Done for 2.1 at r11964 and for 2.2 at r11962 and r11963

[robe]

oops forgot to actually change function in last commit. Changed for 2.1 at r11965

[strk]

I think this change shouldn't been made. The old signature is gone, you shouldn't use it. If you tried using a deprecated signature in raster you'd get an ERROR. A WARNING is a courtesy we do to the user. If it annoys you, change your code to use the correct signature.

[strk]

After reading the comment in #1994, what I can suggest is that the _postgis_deprecate function checks the version of the deprecation (it gets it as an argument) and if it's at distance 1 it raises a NOTICE, if it is +1 raises a WARNING.

But DEBUG is really way too low IMHO.

[strk]

I've a working version of my version-dependent idea. Will commit shortly.

[strk]

See r11987 -- I've kept DEBUG for the deprecating version and raised to WARNING for any subsequent version. But I still think it should be NOTICE at the very least. Keeping open for comments.

[strk]

r11989 in trunk (which gets you back the WARNING, given you had all of 2.1.x to fix your client code...)

[strk]

Sorry, it's also r11988 in trunk, I messed up with commit logs (r11989 fixes the testsuite)

[realityexists]

The old signature is not "gone" - it still works just fine. And it probably wouldn't take much effort to keep it working for at least a couple of major releases.

The problem with NOTICE is that it's typically on by default, so the message would still flood the logs. But the problem with DEBUG is that it's off by default. :)

Ideally, this would be something the user could control. So by default it might be NOTICE or even WARNING, so that users become aware of deprecated functions. But then the user could say "OK, I know about this now, I'll fix it when I can, but for now I want to turn off this message". Could it be a PostgreSQL setting (eg. "SET postgis_deprecation_log_level = DEBUG") or something similar?

[realityexists]

If this the above is too hard then I'd suggest a 3-stage approach:

Release N adds a DEBUG message, ie. "you should start thinking about fixing it, but you still have time" Release N+1 change it to a WARNING message, ie. "you really should fix this now" Release N+2 removes the function

This way, even if nobody saw the DEBUG message and developers didn't become aware of the deprecation until release N+1, they can still change the code straight-away as long as all the users are no more than 1 major version behind (release N).

[strk]

The patch I committed implements the 3-stage approach already.

[realityexists]

Yes, of course - my bad. :) I think that should work well.