1 files changed, 60 insertions, 7 deletions
diff --git a/includes/install.inc b/includes/install.inc
index 54bfd4bc4..fd68ed9ab 100644
--- a/includes/install.inc
+++ b/includes/install.inc
@@ -1,21 +1,74 @@
 <?php
 // $Id$
 
+/**
+ * Indicates that a module has not been installed yet.
+ */
 define('SCHEMA_UNINSTALLED', -1);
+
+/**
+ * Indicates that a module has been installed.
+ */
 define('SCHEMA_INSTALLED', 0);
 
+/**
+ * Requirement severity -- Informational message only.
+ */
 define('REQUIREMENT_INFO', -1);
+
+/**
+ * Requirement severity -- Requirement successfully met.
+ */
 define('REQUIREMENT_OK', 0);
+
+/**
+ * Requirement severity -- Warning condition; proceed but flag warning.
+ */
 define('REQUIREMENT_WARNING', 1);
+
+/**
+ * Requirement severity -- Error condition; abort installation.
+ */
 define('REQUIREMENT_ERROR', 2);
 
-define('FILE_EXIST',          1);
-define('FILE_READABLE',       2);
-define('FILE_WRITABLE',       4);
-define('FILE_EXECUTABLE',     8);
-define('FILE_NOT_EXIST',      16);
-define('FILE_NOT_READABLE',   32);
-define('FILE_NOT_WRITABLE',   64);
+/**
+ * File permission check -- File exists.
+ */
+define('FILE_EXIST', 1);
+
+/**
+ * File permission check -- File is readable.
+ */
+define('FILE_READABLE', 2);
+
+/**
+ * File permission check -- File is writable.
+ */
+define('FILE_WRITABLE', 4);
+
+/**
+ * File permission check -- File is executable.
+ */
+define('FILE_EXECUTABLE', 8);
+
+/**
+ * File permission check -- File does not exist.
+ */
+define('FILE_NOT_EXIST', 16);
+
+/**
+ * File permission check -- File is not readable.
+ */
+define('FILE_NOT_READABLE', 32);
+
+/**
+ * File permission check -- File is not writable.
+ */
+define('FILE_NOT_WRITABLE', 64);
+
+/**
+ * File permission check -- File is not executable.
+ */
 define('FILE_NOT_EXECUTABLE', 128);
 
 /**