From 37ddd6a82e0cac30bdec666a4a13788f25ab1ada Mon Sep 17 00:00:00 2001
From: Christoph Olszowka <christoph@olszowka.de>
Date: Wed, 20 Nov 2013 11:03:53 +0100
Subject: [PATCH] Added example for coverage outside of SimpleCov.root as per
 #221

---
 README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/README.md b/README.md
index 1b5abf3f..29d020ea 100644
--- a/README.md
+++ b/README.md
@@ -294,6 +294,23 @@ Defining your own filters is pretty easy: Just inherit from SimpleCov::Filter an
 the filter, a true return value from this method will result in the removal of the given source_file. The filter_argument method
 is being set in the SimpleCov::Filter initialize method and thus is set to 5 in this example.
 
+## Default root filter and coverage for things outside of it
+
+By default, SimpleCov filters everything outside of the `SimpleCov.root` directory. However, sometimes you may want
+to include coverage reports for things you include as a gem, for example a Rails Engine.
+
+Here's an example by [@lsaffie](https://github.com/lsaffie) from [#221](https://github.com/colszowka/simplecov/issues/221)
+that shows how you can achieve just that:
+
+```ruby
+SimpleCov.start :rails do
+  adapters.delete :root_filter
+  filters.clear
+  add_filter do |src|
+    !(src.filename =~ /^#{SimpleCov.root}/) unless src.filename =~ /my_engine/
+  end
+end
+```
 
 ## Groups