Figure.basemap: Raise a warning on deprecated parameters "map_scale", "rose", and "compass"

[seisman]

Raise a warning when any one of deprecated parameters map_scale/rose/compass is used:

In [1]: import pygmt

In [2]: fig = pygmt.Figure()

In [3]: fig.basemap(region=[127.5, 128.5, 26, 27], projection="H15c", frame=True, rose="jMC+w5c")
/Users/seisman/OSS/gmt/pygmt/pygmt/helpers/decorators.py:594: FutureWarning: The 'rose' parameter has been deprecated since v0.19.0. Use 'Figure.directional_rose' instead.
  return module_func(*args, **kwargs)

Also improve the docstrings slightly with the help from Codex.

Related to #4239.

Preview: https://pygmt-dev--4477.org.readthedocs.build/en/4477/api/generated/pygmt.Figure.basemap.html