Add warning message about removing old API.

You can also suppress the warnings on a per-file basis.
Refs #7419
Merge remote-tracking branch 'origin/feature/7419_old_python_api_warning'