1 files changed, 5 insertions, 2 deletions
diff --git a/Library/Formula/ruby.rb b/Library/Formula/ruby.rb
index 0d294ce68..a721c44a6 100644
--- a/Library/Formula/ruby.rb
+++ b/Library/Formula/ruby.rb
@@ -60,10 +60,13 @@ class Ruby < Formula
   end
 
   def caveats; <<-EOS.undent
-    NOTE: By default, gem installed binaries will be placed into:
+    By default, gem installed executables will be placed into:
       #{opt_prefix}/bin
 
-    You may want to add this to your PATH.
+    You may want to add this to your PATH. After upgrades, you can run
+      gem pristine --all --only-executables
+
+    to restore binstubs for installed gems.
     EOS
   end
 end