From eb5ff6f187fe75f6a07ebd209862ac09bc893b5e Mon Sep 17 00:00:00 2001
From: Nicholas Fox <nick@foxaii.com>
Date: Wed, 2 Jul 2014 18:43:08 +0100
Subject: [PATCH] Add library comments

---
 functions.php | 33 ++++++++++++++++++++-------------
 1 file changed, 20 insertions(+), 13 deletions(-)

diff --git a/functions.php b/functions.php
index d80594c..515a348 100644
--- a/functions.php
+++ b/functions.php
@@ -1,25 +1,32 @@
 <?php
 /**
  * Roots includes
+ *
+ * The $roots_includes array determines the code library included in your theme.
+ * Add or remove files to the array as needed. Supports child theme overrides.
+ *
+ * Please note that missing files will produce a fatal error.
+ *
+ * @link https://github.com/roots/roots/pull/1042
  */
 $roots_includes = array(
-  '/lib/utils.php',           // Utility functions
-  '/lib/init.php',            // Initial theme setup and constants
-  '/lib/wrapper.php',         // Theme wrapper class
-  '/lib/sidebar.php',         // Sidebar class
-  '/lib/config.php',          // Configuration
-  '/lib/activation.php',      // Theme activation
-  '/lib/titles.php',          // Page titles
-  '/lib/nav.php',             // Custom nav modifications
-  '/lib/gallery.php',         // Custom [gallery] modifications
-  '/lib/comments.php',        // Custom comments modifications
-  '/lib/scripts.php',         // Scripts and stylesheets
-  '/lib/extras.php',          // Custom functions
+  'lib/utils.php',           // Utility functions
+  'lib/init.php',            // Initial theme setup and constants
+  'lib/wrapper.php',         // Theme wrapper class
+  'lib/sidebar.php',         // Sidebar class
+  'lib/config.php',          // Configuration
+  'lib/activation.php',      // Theme activation
+  'lib/titles.php',          // Page titles
+  'lib/nav.php',             // Custom nav modifications
+  'lib/gallery.php',         // Custom [gallery] modifications
+  'lib/comments.php',        // Custom comments modifications
+  'lib/scripts.php',         // Scripts and stylesheets
+  'lib/extras.php',          // Custom functions
 );
 
 foreach ($roots_includes as $file) {
   if (!$filepath = locate_template($file)) {
-    trigger_error("Error locating `$file` for inclusion!", E_USER_ERROR);
+    trigger_error(sprintf(__('Error locating %s for inclusion', 'roots'), $file), E_USER_ERROR);
   }
 
   require_once $filepath;