path: root/lib/rubygems/commands/sources_command.rb
diff options
Diffstat (limited to 'lib/rubygems/commands/sources_command.rb')
1 files changed, 47 insertions, 0 deletions
diff --git a/lib/rubygems/commands/sources_command.rb b/lib/rubygems/commands/sources_command.rb
index 810b45d7c0..60d96c5828 100644
--- a/lib/rubygems/commands/sources_command.rb
+++ b/lib/rubygems/commands/sources_command.rb
@@ -97,6 +97,53 @@ Do you want to add this insecure source?
+ def description # :nodoc:
+ <<-EOF
+RubyGems fetches gems from the sources you have configured (stored in your
+The default source is, but you may have older sources
+configured. This guide will help you update your sources or configure
+yourself to use your own gem server.
+Without any arguments the sources lists your currently configured sources:
+ $ gem sources
+This may list multiple sources or non-rubygems sources. You probably
+configured them before or have an old `~/.gemrc`. If you have sources you
+do not recognize you should remove them.
+RubyGems has been configured to serve gems via the following URLs through
+its history:
+* (RubyGems 1.3.6 and earlier)
+* (RubyGems 1.3.7 through 1.8.25)
+* (RubyGems 2.0.1 and newer)
+Since all of these sources point to the same set of gems you only need one
+of them in your list. is recommended as it brings the
+protections of an SSL connection to gem downloads.
+To add a source use the --add argument:
+ $ gem sources --add
+ added to sources
+RubyGems will check to see if gems can be installed from the source given
+before it is added.
+To remove a source use the --remove argument:
+ $ gem sources --remove
+ removed from sources
+ end
def list # :nodoc:
say "*** CURRENT SOURCES ***"