Expand on problems checked by bundle-doctor

1 files changed, 13 insertions, 6 deletions

diff --git a/man/bundle-doctor.ronn b/man/bundle-doctor.ronn
index 5c1b1e993c..f28f2f4f98 100644
--- a/man/bundle-doctor.ronn
+++ b/man/bundle-doctor.ronn
@@ -1,5 +1,5 @@
-bundle-doctor(1) -- Checks for missing OS dependencies
-======================================================
+bundle-doctor(1) -- Checks the bundle for common problems
+=========================================================
 
 ## SYNOPSIS
 
@@ -8,10 +8,17 @@ bundle-doctor(1) -- Checks for missing OS dependencies
 
 ## DESCRIPTION
 
-Scan the OS dependencies of each of the gems requested in your
-Gemfile(5). If missing OS dependencies are detected, Bundler prints
-them and exists status 1. Otherwise, Bundler prints a success message
-and exists status 0.
+Checks your Gemfile and gem environment for common problems. If issues
+are detected, Bundler prints them and exists status 1. Otherwise,
+Bundler prints a success message and exists status 0.
+
+Examples of common problems caught by bundle-doctor include:
+
+* Invalid Bundler settings
+* Mismatched Ruby versions
+* Mismatched platforms
+* Uninstalled gems
+* Missing dependencies
 
 ## OPTIONS