Skip to content

Sort the alias lists in docstrings alphabetically - #4855

Merged
seisman merged 1 commit into
mainfrom
doc/alias-order
Aug 25, 2026
Merged

Sort the alias lists in docstrings alphabetically#4855
seisman merged 1 commit into
mainfrom
doc/alias-order

Conversation

@seisman

@seisman seisman commented Aug 24, 2026

Copy link
Copy Markdown
Member

The Aliases list in docstrings is sorted by GMT option, with uppercase options first
and lowercase ones after. Seven docstrings had entries out of order:

Module Out of order
Figure.choropleth R/N and W/V
Figure.legend D/B
Figure.solar t/p
pygmt.grd2cpt Z/V
pygmt.makecpt Z/V
pygmt.project W/V
pygmt.sph2grd r/i

This is a docstring-only change: the entries themselves are untouched, only reordered.

I checked all 65 alias lists under pygmt/. Three others come up as "unsorted" but are
left as they are on purpose: Figure.basemap, Figure.grdview and Figure.plot3d list
Jz before JZ, which matches GMT's own -Jz|Z documentation order and the
zscale/zsize parameter order in those signatures.

🤖 Generated with Claude Code

The "Aliases" list in docstrings is sorted by GMT option, uppercase options
first, then lowercase ones. Seven docstrings had entries out of order:

- Figure.choropleth: R/N and W/V
- Figure.legend: D/B
- Figure.solar: t/p
- pygmt.grd2cpt: Z/V
- pygmt.makecpt: Z/V
- pygmt.project: W/V
- pygmt.sph2grd: r/i

Docstring-only change; the entries themselves are unchanged.

Note that Figure.basemap, Figure.grdview and Figure.plot3d intentionally list
'Jz' before 'JZ', matching GMT's own '-Jz|Z' documentation order, so they are
left as they are.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@seisman seisman added maintenance Boring but important stuff for the core devs skip-changelog Skip adding Pull Request to changelog labels Aug 24, 2026
@seisman seisman added this to the 0.20.0 milestone Aug 24, 2026
@seisman seisman added final review call This PR requires final review and approval from a second reviewer and removed final review call This PR requires final review and approval from a second reviewer labels Aug 24, 2026
@seisman
seisman merged commit bd8a377 into main Aug 25, 2026
29 of 30 checks passed
@seisman
seisman deleted the doc/alias-order branch August 25, 2026 02:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

maintenance Boring but important stuff for the core devs skip-changelog Skip adding Pull Request to changelog

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant