Skip to content

Docs: Rewrite the plot -A documentation - #9284

Merged
Esteban82 merged 1 commit into
masterfrom
docs-line-draw-short-way
Oct 30, 2026
Merged

Esteban82 merged 1 commit into
masterfrom
docs-line-draw-short-way

Conversation

@Esteban82

Copy link
Copy Markdown
Member

Explain better how plot/plot3d should connect geographic points.

This describes the intended behavior, not the current one (e.g., the bug to be fixed in #9276).

After carefully reviewing the code and analyzing the different cases with Claude, I think this description explains well how it should work. It will be used as a guide for future changes to the code.

Since this defines how -A is meant to behave, please read it carefully before approving, and feel free to propose alternatives if you think a different behavior makes more sense.

Explain how geographic points are connected: without -A along the
shorter great circle arc (antipodal points cause an error), with -A by
straight lines on the map that depend on -R and -J and are not split at
the map edges.  Also fix the 'gragraphic' typo.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Esteban82
Esteban82 requested review from a team, joa-quim and seisman October 30, 2026 20:00
@Esteban82 Esteban82 added the documentation Improve documentation label Oct 30, 2026

@remkos remkos left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a very good improvement of the description. It is fully correct.
The history behind this was that @PaulWessel had introduced -A long time ago, which (if I remember well) did first longitude then latitude. I added the x|y because I needed it to be the other way around for some application. Clearly, the manual could have been much better and also all the cases better experimented with.
Good job!

@Esteban82
Esteban82 merged commit 5e20d7c into master Oct 30, 2026
17 checks passed
@Esteban82
Esteban82 deleted the docs-line-draw-short-way branch October 30, 2026 21:41
@Esteban82

Copy link
Copy Markdown
Member Author

Thanks @remkos!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improve documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants