Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document the environment variables that can affect the behavior of PyGMT #3432

Merged
merged 12 commits into from
Sep 23, 2024

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.

doc/techref/environment_variables.md Outdated Show resolved Hide resolved
pygmt/clib/loading.py Outdated Show resolved Hide resolved
pygmt/src/x2sys_init.py Outdated Show resolved Hide resolved
doc/techref/environment_variables.md Outdated Show resolved Hide resolved
doc/techref/environment_variables.md Outdated Show resolved Hide resolved
Co-authored-by: Yvonne Fröhlich <94163266+yvonnefroehlich@users.noreply.github.com>
@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
20 checks passed
@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.

2 participants