rubygems/rubygems — pull request #989 by jasonrclark (2014-08-14 18:52:41+00:00)
Title: Clearer wording for --source option

When trying to use the gem command against a private rubygems server, I was
surprised when --source seemed to have no effect. My gem (which exists on both
rubygems.org and the private server) was always found on rubygems.org first,
and the source I added seemed ignored.

This led me into the code where I discovered --clear-sources and realized that
my source was there, but just at *end* of the list instead of replacing and/or
taking precedence.

After talking with @drbrain it's clear this behavior can't change, but slightly
different wording in the help would have led me to understand what was
happening without requiring digging into the code.

I'm also intending to write up a Rubygems Guide page about using sources.