Skip to content

Correct https git URIs in documentation #9648

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

Merged
merged 1 commit into from
Nov 1, 2017

Conversation

mastbaum
Copy link
Contributor

@mastbaum mastbaum commented Nov 1, 2017

Fix a few instances in the documentation where http(s):// git URIs contained a : rather than a / to separate the host from the path.

Using a colon is malformed, and results in an error (at least on my git 2.13.3, perhaps other versions try harder to guess):

$ git clone https://github.com:matplotlib/matplotlib.git
Cloning into 'matplotlib'...
fatal: unable to access 'https://github.com:matplotlib/matplotlib.git/':
Port number ended with 'm'

PR Summary

PR Checklist

  • Has Pytest style unit tests
  • Code is PEP 8 compliant
  • New features are documented, with examples if plot related
  • Documentation is sphinx and numpydoc compliant
  • Added an entry to doc/users/next_whats_new/ if major new feature (follow instructions in README.rst there)
  • Documented in doc/api/api_changes.rst if API changed in a backward-incompatible way

Fix a few instances in the documentation where http(s):// git
URIs contained a colon rather than a slash to separate the host
from the path.

Using a colon is malformed, and results in an error (at least on
my git 2.13.3, perhaps other versions try harder to guess):

```
$ git clone https://github.com:matplotlib/matplotlib.git
Cloning into 'matplotlib'...
fatal: unable to access 'https://github.com:matplotlib/matplotlib.git/':
Port number ended with 'm'
```
@anntzer
Copy link
Contributor

anntzer commented Nov 1, 2017

No, the form with a colon is correct, you should not specify https but (literally)

git clone github.com:matplotlib/matplotlib.git

Conversely the form with a slash needs explicitly https:// -- we just need to settle on one. However I would strongly suggest opening the issue at https://github.com/matthew-brett/gitwash instead, which is where these files get generated from.

There is indeed a typo in gith hub that needs to be fixed.

@QuLogic
Copy link
Member

QuLogic commented Nov 1, 2017

It's already written with http:// though, so the colon is incorrect. github.com:matplotlib/matplotlib.git is also wrong in that it doesn't specify the user name. Since that would require setting up SSH keys, I don't think we want to prescribe that and https is the way to go.

However, I do agree that this should be sent to gitwash as well.

@anntzer
Copy link
Contributor

anntzer commented Nov 1, 2017

oh is it just for me or does github render https://github.com/matplotlib/matplotlib/pull/9648/files stripping the 'https://'? (looking at https://github.com/matplotlib/matplotlib/commit/4bcf44940644979a06a2c8a220d95668590a1fd2.patch the patch is clearly correct indeed).

@tacaswell tacaswell added this to the v2.1.0-doc milestone Nov 1, 2017
Copy link
Member

@dstansby dstansby left a comment

Choose a reason for hiding this comment

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

👍 thanks a lot!

@dstansby dstansby merged commit 663e30f into matplotlib:master Nov 1, 2017
QuLogic added a commit that referenced this pull request Nov 3, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants