Improve function signatures to use positional-only, positional-or-keyword, or keyword-only parameter

[seisman]

Previously mentioned in many places:

• pygmt.which: Fix the bug when passing multiple files #2726 (comment)
• Wrap triangulate #731 (comment)
• Support tab completion in Jupyter by inserting aliases into the method signature #1282 (comment)

Related PEPs:

• https://peps.python.org/pep-0457/
• https://peps.python.org/pep-0570/
• https://peps.python.org/pep-3102/

In short, the new function definition will be like:

def f(pos1, pos2, /, pos_or_kwd, *, kwd1, kwd2):
      -----------    ----------     ----------
        |             |                  |
        |        Positional or keyword   |
        |                                - Keyword only
         -- Positional only

Note: Enable ruff's flake8-boolean-trap (FBT) after finishing this request.