{"action":"reopened","issue":{"url":"https://api.github.com/repos/npm/npm/issues/10071","labels_url":"https://api.github.com/repos/npm/npm/issues/10071/labels{/name}","comments_url":"https://api.github.com/repos/npm/npm/issues/10071/comments","events_url":"https://api.github.com/repos/npm/npm/issues/10071/events","html_url":"https://github.com/npm/npm/issues/10071","id":112701443,"number":10071,"title":"npm online documentation is incomplete for npmrc file format","user":{"login":"spikegrobstein","id":45886,"avatar_url":"https://avatars.githubusercontent.com/u/45886?v=3","gravatar_id":"","url":"https://api.github.com/users/spikegrobstein","html_url":"https://github.com/spikegrobstein","followers_url":"https://api.github.com/users/spikegrobstein/followers","following_url":"https://api.github.com/users/spikegrobstein/following{/other_user}","gists_url":"https://api.github.com/users/spikegrobstein/gists{/gist_id}","starred_url":"https://api.github.com/users/spikegrobstein/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/spikegrobstein/subscriptions","organizations_url":"https://api.github.com/users/spikegrobstein/orgs","repos_url":"https://api.github.com/users/spikegrobstein/repos","events_url":"https://api.github.com/users/spikegrobstein/events{/privacy}","received_events_url":"https://api.github.com/users/spikegrobstein/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-10-21T23:47:33Z","updated_at":"2015-12-28T17:53:45Z","closed_at":null,"body":"the documentation for the `.npmrc` file format is incomplete in several ways.\r\n\r\n 1. It doesn't define what character(s) to use for commenting out a line\r\n 2. it doesn't describe special, per-registry configuration options.\r\n\r\nSolving 1 seems pretty easy, so no need to describe.\r\n\r\nNumber 2, above, needs an explanation. I currently have several npm registries configured, each with different authentication requirements (some with `always-auth` to true, others with a different username, for example). It *appears* that there is a way to do something like the following, but I haven't been able to find any documentation around it, nor am I even sure that this is working as expected, since it's pretty difficult to test and the `--verbose` flag doesn't report enough information...\r\n\r\n```\r\nregistry=myregistry.example.com\r\nalways-auth=true\r\n//some-other-npm.example.com:always-auth=false\r\n```\r\n\r\nwhere the `//` line is defining a config for the registry with that particular hostname. I've seen this format in my local `~/.npmrc` but I have no idea where it came from. Is this even valid? Initially I thought it was commented out lines with a description of what config it came from, but after removing the lines and watching something break, I think it just means any protocol (ie: `http` or `https`)."}}