GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — Improve usetex and pgf troubleshooting docs. by anntzer · Pull Request #30040 · matplotlib/matplotlib

Conversation

@anntzer

@anntzer anntzer commented May 11, 2025

Copy link
Copy Markdown
Contributor
  • Merge "Troubleshooting" and "Possible hangups".
  • Don't list $PATH issues twice.
  • Remove mention of dvipng for pgf (which doesn't use dvipng).
  • Be more generic re: missing latex packages (this applies to all texlive installs, and the required list is given elsewhere).

PR summary

PR checklist

  • "closes #0000" is in the body of the PR description to link the related issue
  • new and changed code is tested
  • Plotting related features are demonstrated in an example
  • New Features and API Changes are noted with a directive and release note
  • Documentation complies with general and docstring guidelines

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
@anntzer anntzer added the Documentation label May 11, 2025
@github-actions github-actions Bot added the Documentation: user guide files in galleries/users_explain or doc/users label May 11, 2025
story645
story645 reviewed May 11, 2025
View reviewed changes
Comment thread galleries/users_explain/text/usetex.py Outdated
Comment on lines +152 to +153
* Some required LaTeX packages, such as type1cm, may be missing from minimalist
TeXLive installs. Required packages are listed at :ref:`tex-dependencies`.

@story645 story645 May 11, 2025

Copy link
Copy Markdown
Member

There was a problem hiding this comment.

Choose a reason for hiding this comment

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

Suggested change
* Some required LaTeX packages, such as type1cm, may be missing from minimalist
TeXLive installs. Required packages are listed at :ref:`tex-dependencies`.
* Some required LaTeX packages, such as type1cm, may be missing from minimalist installs. Required packages are listed at :ref:`tex-dependencies`.

I think minimalist any installs? (like the original issue was from someone on a mac)

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions

@anntzer anntzer May 12, 2025

Copy link
Copy Markdown
Contributor Author

There was a problem hiding this comment.

Choose a reason for hiding this comment

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

Sure, edited.

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
Comment thread galleries/users_explain/text/usetex.py
Comment on lines +135 to +136
* Make sure LaTeX, dvipng, and Ghostscript are each working and on your
:envvar:`PATH`. The :envvar:`PATH` environment variable may need to

@story645 story645 May 11, 2025

Copy link
Copy Markdown
Member

There was a problem hiding this comment.

Choose a reason for hiding this comment

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

can you give an example of what this means, particularly for dvipng?

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions

@anntzer anntzer May 12, 2025 •
edited
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown
Contributor Author

There was a problem hiding this comment.

Choose a reason for hiding this comment

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

I'll claim this text is at least not worse than the previous one, and that a more detailed description of $PATH (probably something like "shutil.which("foo") returns something else than None) should go to environment_variables_faq.rst, but this can be done as a separate PR.

(Also, the dependency on dvipng may be removed soon, see #30039.)

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
@anntzer
Improve usetex and pgf troubleshooting docs.
dd4d635 
- Merge "Troubleshooting" and "Possible hangups".
- Don't list $PATH issues twice.
- Remove mention of dvipng for pgf (which doesn't use dvipng).
- Be more generic re: missing latex packages (this applies to all
  texlive installs, and the required list is given elsewhere).
@anntzer
anntzer force-pushed the td branch from 5f59d14 to dd4d635 Compare May 12, 2025 06:13
timhoffm
timhoffm approved these changes May 12, 2025
View reviewed changes
@timhoffm timhoffm added this to the v3.11.0 milestone May 12, 2025
@timhoffm

timhoffm commented May 12, 2025

Copy link
Copy Markdown
Member

I believe this is good enough.
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@timhoffm
timhoffm merged commit 8cd97bf into matplotlib:main May 12, 2025
@anntzer
anntzer deleted the td branch May 12, 2025 09:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@story645 story645 story645 left review comments
@timhoffm timhoffm timhoffm approved these changes

Uh oh!

There was an error while loading. Please reload this page.

Assignees

No one assigned

Labels

Documentation: user guide files in galleries/users_explain or doc/users Documentation

Projects

None yet

Milestone

v3.11.0

Development

Successfully merging this pull request may close these issues.

Uh oh!

There was an error while loading. Please reload this page.

3 participants

@anntzer @timhoffm @story645
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
You are visitor 01402520 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.