nodegit
diff --git a/‎lib/reference.js‎
Lines changed: 14 additions & 4 deletions b/‎lib/reference.js‎
Lines changed: 14 additions & 4 deletions
@@ -6,7 +6,7 @@ var git = require('../'),
  *
  * @constructor
  * @param {git.raw.Repo} rawRepo
- * @param {git.raw.Reference|null} rawReference
+ * @param {git.raw.Reference} [rawReference = new git.raw.Reference()]
  */
 var Reference = function(rawRepo, rawReference) {
   if (!(rawRepo instanceof git.raw.Repo)) {
@@ -24,10 +24,15 @@ var Reference = function(rawRepo, rawReference) {
 /**
  * Lookup the reference with the given name.
  *
- * @param  {String}   name
- * @param  {Function} callback
+ * @param {String} name
+ * @param {Reference~lookupCallback} callback
  */
 Reference.prototype.lookup = function(name, callback) {
+  /**
+   * @callback Reference~lookupCallback Callback executed on lookup completion.
+   * @param {GitError|null} error An Error or null if successful.
+   * @param {Reference|null} reference Retrieved reference object or null.
+   */
   var self = this;
   self.rawReference.lookup(self.rawRepo, name, function referenceLookup(error, rawReference) {
     if (!success(error, callback)) {
@@ -41,9 +46,14 @@ Reference.prototype.lookup = function(name, callback) {
 /**
  * Get the Oid representing this reference.
  *
- * @param  {Function} callback
+ * @param {Reference~oidCallback} callback
  */
 Reference.prototype.oid = function(callback) {
+  /**
+   * @callback Reference~oidCallback Callback executed on oid retrieval.
+   * @param {GitError|null} error An Error or null if successful.
+   * @param {Oid|null} oid Retrieved Oid object or null.
+   */
   this.rawReference.oid(function referenceOid(error, rawOid) {
     if (success(error, callback)) {
       callback(null, new git.oid(rawOid));