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

Documentation: Fail to generate screen on Mac Mojave (PyGame) #374

Open
CaseyFaist opened this issue Oct 4, 2019 · 3 comments

Comments

@CaseyFaist
Copy link

@CaseyFaist CaseyFaist commented Oct 4, 2019

When using Python 3.7 on Mojave, ppb will run but generate a blank window.

This is not an issue with PPB itself, but will trip up a PPB user. The steps to unblock a user are not complicated - I resolved by using pip3 and python3 - but could be difficult to debug for programmers new to PyGame and unfamiliar with the problem. Problems they may face are what should they searching for, why do they need to specify python3 if their .venv specifies python 3.7 and the python repl successfully loads, etc.

Docs in a "Known Issues" section (either on readthedocs, here, or both) could help these users.

Sources:

https://stackoverflow.com/questions/52718921/problems-getting-pygame-to-show-anything-but-a-blank-screen-on-macos-mojave

pygame/pygame#555

@CaseyFaist

This comment has been minimized.

Copy link
Author

@CaseyFaist CaseyFaist commented Oct 4, 2019

I'm happy to write these docs if I can get some direction on where y'all would want them to live 😄

Options:

  • Separate Mojave-specific getting-started.rst + link at the top of the main one
  • Bug-specific blurb in the getting-started.rst or elsewhere
  • Bug specific blurb in a "known issues" section somewhere, with relevant links in getting-started
  • Something I haven't thought of (which is most things)

Let me know! <3

@astronouth7303

This comment has been minimized.

Copy link
Member

@astronouth7303 astronouth7303 commented Oct 4, 2019

To be clear: This is specifically an incompatibility with PyGame1 and MacOS Majove?

Sounds similar to the warnings we've been putting in our release notes about Python 3.8.

@astronouth7303

This comment has been minimized.

Copy link
Member

@astronouth7303 astronouth7303 commented Oct 4, 2019

Yes, a warning early in the docs would be good. The list of incompatibilities is getting long and I'm starting to get grumpy with PyGame as a project.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
2 participants
You can’t perform that action at this time.