From ece127c86531977c236ce526dba079a8a3a4aff0 Mon Sep 17 00:00:00 2001
From: Jack Danger Canty <gitcommit@6brand.com>
Date: Wed, 10 Dec 2008 13:37:14 -0800
Subject: [PATCH] Adding some comments to transform_pages to explain what's
 going on

---
 lib/jekyll/site.rb | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/jekyll/site.rb b/lib/jekyll/site.rb
index b096dede..7897ec37 100644
--- a/lib/jekyll/site.rb
+++ b/lib/jekyll/site.rb
@@ -92,10 +92,12 @@ module Jekyll
         else
           first3 = File.open(File.join(self.source, dir, f)) { |fd| fd.read(3) }
           
+          # if the file appears to have a YAML header then process it as a page
           if first3 == "---"
             page = Page.new(self.source, dir, f)
             page.add_layout(self.layouts, site_payload)
             page.write(self.dest)
+          # otherwise copy the file without transforming it
           else
             FileUtils.mkdir_p(File.join(self.dest, dir))
             FileUtils.cp(File.join(self.source, dir, f), File.join(self.dest, dir, f))