diff --git a/‎lib/diff_list.js‎
Lines changed: 74 additions & 3 deletions b/‎lib/diff_list.js‎
Lines changed: 74 additions & 3 deletions
@@ -3,9 +3,10 @@ var git = require('../'),
 
 /**
  * Convenience diff list class.
- * 
+ *
+ * @constructor
  * @param {git.raw.Repo} rawRepo
- * @param {[type]} rawDiffList [description]
+ * @param {git.raw.DiffList} [rawDiffList = new git.raw.DiffList]  
  */
 var DiffList = function(rawRepo, rawDiffList) {
   if (!(rawRepo instanceof git.raw.Repo)) {
@@ -55,6 +56,14 @@ DiffList.prototype.lineOriginTypes = {
  /** 'B'  */ GIT_DIFF_LINE_BINARY: git.raw.DiffList.lineOriginTypes.GIT_DIFF_LINE_BINARY
 };
 
+/**
+ * Walk the current diff list tree.
+ *
+ * @fires DiffList#delta
+ * @fires DiffList#end
+ * 
+ * @return {EventEmitter} diffListWalkEmitter
+ */
 DiffList.prototype.walk = function() {
   var event = new events.EventEmitter(),
       allFileDeltas = [],
@@ -65,14 +74,30 @@ DiffList.prototype.walk = function() {
       event.emit('end', new git.error(error.message, error.code), null);
     }
     fileDeltas.forEach(function(fileDelta) {
-      event.emit('file', null, fileDelta);
+      /**
+       * Delta event.
+       *
+       * @event DiffList#delta
+       *
+       * @param {GitError|null} error An error object if there was an issue, null otherwise.
+       * @param {FileDelta} fileDelta The file delta object.
+       */
+      event.emit('delta', null, fileDelta);
       allFileDeltas.push(fileDelta);
     });
   }, function hunkCallback(error, diffHunk) {
     /** TO BE IMPLEMENTED */
   }, function lineCallback(error, diffLine) {
     /** TO BE IMPLEMENTED */
   }, function endCallback(error) {
+    /**
+     * End event.
+     *
+     * @event DiffList#end
+     *
+     * @param {GitError|null} error An error object if there was an issue, null otherwise.
+     * @param {FileDelta[]} fileDeltas The file delta objects.
+     */
     event.emit('end', error ? new git.error(error.message, error.code) : null, allFileDeltas);
   });
 
@@ -92,3 +117,49 @@ DiffList.prototype.treeToTree = function(oldSha, newSha, callback) {
 };
 
 exports.diffList = DiffList;
+
+/**
+ * @namespace
+ * @property {Object} oldFile Contains details for the old file state 
+ * @property {String} oldFile.path The path to the old file, relative to the repository 
+ * @property {Object} newFile Contains details for the new file state
+ * @property {String} newFile.path The path to the new file, relative to the repository
+ * @property {Object[]} content Array of context & differences 
+ * @property {Object} content[].range 
+ * @property {Object} content[].range.old
+ * @property {Integer} content[].range.old.start
+ * @property {Integer} content[].range.old.lines
+ * @property {Object} content[].range.new
+ * @property {Integer} content[].range.new.start
+ * @property {Integer} content[].range.new.lines
+ * @property {Object} content[].content Content of the delta
+ * @property {DiffList.lineOriginTypes} content[].lineOrigin
+ * @property {Integer} content[].contentLength
+ * @property {Integer} status Type of delta 
+ */
+var FileDelta = {
+  oldFile: {
+    path: String
+  },
+  newFile: {
+    path: String
+  },
+  content: [
+    {
+      range: { 
+        old: { 
+          start: Number, 
+          lines: Number 
+        }, 
+        'new': { 
+          start: Number, 
+          lines: Number 
+        } 
+      },
+      content: String,
+      lineOrigin: String,
+      contentLength: Number
+    }
+  ],
+  status: Number
+};