Skip to content

Conversation

@seisman
Copy link
Member

@seisman seisman commented Sep 9, 2024

This PR adds another page to the "Technical Reference" section. On this page, the environmental variables that PyGMT uses are documented. There are still many other variables that are not documented since they are not explicitly used by PyGMT (e.g., HOME, GMT_SHAREDIR). We may document them later.

Preview:

@seisman seisman added documentation Improvements or additions to documentation needs review This PR has higher priority and needs review. labels Sep 14, 2024
@seisman seisman added this to the 0.14.0 milestone Sep 14, 2024
@seisman seisman changed the title POC: Document the environment variables that can affect the behavior of PyGMT Document the environment variables that can affect the behavior of PyGMT Sep 14, 2024
@seisman seisman marked this pull request as ready for review September 14, 2024 13:44

PyGMT's behavior can be controlled through various environment variables. These variables
can be set either in your shell environment or within your Python script using the
:py:data:`os.environ` dictionary.
Copy link
Member

Choose a reason for hiding this comment

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

Setting the link like this does not work correctly.
highlight_os_environ

I tried :py:func:, :py:class:, :py:, but with no success. Maybe we have to do it like:

Suggested change
:py:data:`os.environ` dictionary.
[`os.environ`](https://docs.python.org/3/library/os.html#os.environ) dictionary.

Copy link
Member Author

Choose a reason for hiding this comment

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

Thanks for catching it. Fixed in 7ed1300. py:data is correct. Just need to use the MyST Markdown syntax, not the ReST syntax.

@seisman seisman requested a review from a team September 16, 2024 14:23
@seisman seisman added final review call This PR requires final review and approval from a second reviewer and removed needs review This PR has higher priority and needs review. labels Sep 22, 2024
@seisman
Copy link
Member Author

seisman commented Sep 22, 2024

will merge in 24 hours if no further comments.

@seisman seisman removed the final review call This PR requires final review and approval from a second reviewer label Sep 23, 2024
@seisman seisman merged commit 2454aa6 into main Sep 23, 2024
@seisman seisman deleted the doc/env branch September 23, 2024 06:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants