ENH: f2py: add command line option to not use deprecated numpy API.

This has the benefit of silencing lots of build warnings.
f2py itself doesn't use deprecated API, but user code may - hence
this needs to be optional.  See gh-5281 for details.

Note that this feature can be used from setup.py files that use Fortran
sources via ``f2py_options=['--no-deprecated-api']`` in ``add_extension``
or ``add_library``.

Conflicts:
	numpy/f2py/rules.py
MAINT: f2py: put back the NPY_NO_DEPRECATED_API define in fortranobject.c

This cannot be controlled (easily) by the --no-deprecated-api option.
No user code is included without fortranobject.c, so this can't fail.

Tested by compiling Scipy 0.14.0, which would fail because if this didn't
work because it contains deprecated numpy API inside a .pyf file.