From 13cbc2aee4104e4733052db5d57080922c8b4b62 Mon Sep 17 00:00:00 2001
From: Dominic Cleal <dominic@cleal.org>
Date: Mon, 22 Aug 2016 16:12:37 +0100
Subject: [PATCH] Document recommended pins for Ruby 1.8/1.9

---
 README.rdoc | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/README.rdoc b/README.rdoc
index 2b720370..dae624a2 100644
--- a/README.rdoc
+++ b/README.rdoc
@@ -16,6 +16,19 @@ be used alongside the official documentation[http://pubs.vmware.com/vsphere-60/t
 
     gem install rbvmomi
 
+=== Support for older Ruby versions
+
+RbVmomi supports Ruby 1.8.7 and higher, but certain dependencies may need
+pinning to older versions to get a compatible set of gems.
+
+On Ruby 1.8.7:
+
+* use +nokogiri+ 1.5.x (Gemfile: <code>gem 'nokogiri', '< 1.6'</code>)
+
+On both Ruby 1.9 and 1.8.7:
+
+* use +json+ 1.x (Gemfile: <code>gem 'json', '< 2'</code>)
+
 == Usage
 
 A simple example of turning on a VM: