From cbd6fa7c05f8a6d6d4cd7d2f4231ce019abcb2b9 Mon Sep 17 00:00:00 2001
From: Xavier Noria <fxn@hashref.com>
Date: Sun, 19 Jun 2011 11:39:52 +0200
Subject: [PATCH] explains why links are gsub'ed, and changes the regexp
 delimiters

Conflicts:

	Rakefile
---
 Rakefile | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Rakefile b/Rakefile
index ba55e580f4..d18dac0dbd 100755
--- a/Rakefile
+++ b/Rakefile
@@ -61,6 +61,9 @@ RDoc::Task.new do |rdoc|
   # The temporary solution is to have a README.rdoc without backslashes for
   # GitHub, and gsub it to generate the main page of the API.
   #
+  # Also, relative links in GitHub have to point to blobs, whereas in the API
+  # they need to point to files.
+  #
   # The idea for the future is to have totally different files, since the
   # API is no longer a generic entry point to Rails and deserves a
   # dedicated main page specifically thought as an API entry point.
@@ -71,6 +74,7 @@ RDoc::Task.new do |rdoc|
     # since no autolinking happens there and RDoc displays the backslash
     # otherwise.
     rdoc_main.gsub!(/^(?=\S).*?\b(?=Rails)\b/) { "#$&\\" }
+    rdoc_main.gsub!(%r{link:blob/master/(\w+)/README\.rdoc}, "link:files/\\1/README_rdoc.html")
 
     File.open(RDOC_MAIN, 'w') do |f|
       f.write(rdoc_main)