Complete most of documentation for makecpt

[weiji14]

Description of proposed changes

Finish up aliasing most arguments for makecpt, improving the documentattion to be better than what we currently have at https://www.pygmt.org/v0.2.0/api/generated/pygmt.makecpt.html! For reference, upstream GMT docs is at https://docs.generic-mapping-tools.org/6.1/makecpt.html and https://github.com/GenericMappingTools/gmt/blame/master/doc/rst/source/makecpt.rst.

Live documentation preview is at https://pygmt-git-complete-docs-makecpt.gmt.vercel.app/api/generated/pygmt.makecpt.html

TODO:

Arguments/Aliases to document (see also https://www.generic-mapping-tools.org/GMT.jl/latest/makecpt/). New aliases are highlighted in bold:

• A - transparency
• C - cmap
• D - background/foreground?
• E - data_levels/nlevels?
• F - color_model
• G - truncate
• H - output
• I - reverse
• M - overrule_bg?
• N - no_bg?
• Q - log
• S - auto
• T - series
• V - verbose
• W - categorical
• Ww - cyclic
• Z - continuous

Fixes #

Reminders

• Run make format and make check to make sure the code follows the style guide.
• Add tests for new features or tests that would have caught the bug that you're fixing.
• Add new public functions/methods/classes to doc/api/index.rst.
• Write detailed docstrings for all functions/methods.
• If adding new functionality, add an example to docstrings or tutorials.

Notes

• You can write /format in the first line of a comment to lint the code automatically

[weiji14]

• E - data_levels/nlevels?
• S - auto

These two flags (-E and -S) require a file input (or pandas.DataFrame table), but this isn't implemented in pygmt.makecpt yet. Probably best to leave the implementation to a separate PR?

[seisman]

For makecpt, each option does too many things. Not sure if these are good choices:

D - background/foreground
W - categorical

[weiji14]

For makecpt, each option does too many things. Not sure if these are good choices:

D - background/foreground
W - categorical

Yeah, it does get confusing. I couldn't think of a word that covers background/foreground (and NaN) though. Same with W which could be categorical/wrap/cyclic :/

[seisman]

For -W, we could use categorical (True or False) for -W and cyclic (True or False) for -Ww.

[weiji14]

For -W, we could use categorical (True or False) for -W and cyclic (True or False) for -Ww.

Sure, I did think of that actually, but we'll need an extra check so that categorical (W) and cyclic (Ww) are not used at the same time.