Merge pull request #317 from stephenplusplus/spp--storage-docs-fixes

docs: fix storage jsdoc

Author: stephenplusplus

lib/storage/acl.js

@@ -58,6 +58,8 @@ function Acl(options) {
  *     revision of this file (as opposed to the latest version, the default).
  * @param {function} callback - The callback function.
  *
+ * @alias acl.add
+ *
  * @example
  * myBucket.acl.add({
  *   scope: 'user-useremail@example.com',
@@ -108,13 +110,15 @@ Acl.prototype.add = function(options, callback) {
  *     revision of this file (as opposed to the latest version, the default).
  * @param {function} callback - The callback function.
  *
+ * @alias acl.delete
+ *
  * @example
  * myBucket.acl.delete({
  *   scope: 'user-useremail@example.com'
  * }, function(err) {});
  *
  * //-
- * // For file ACL operations, an options object is also accepted.
+ * // For file ACL operations, you can also specify a `generation` property.
  * //-
  * myFile.acl.delete({
  *   scope: 'user-useremail@example.com',
@@ -146,6 +150,8 @@ Acl.prototype.delete = function(options, callback) {
  * @param {int=} options.generation - **File Objects Only** Select a specific
  *     revision of this file (as opposed to the latest version, the default).
  *
+ * @alias acl.get
+ *
  * @example
  * myBucket.acl.get({
  *   scope: 'user-useremail@example.com'
@@ -164,7 +170,7 @@ Acl.prototype.delete = function(options, callback) {
  * });
  *
  * //-
- * // For file ACL operations, an options object is also accepted.
+ * // For file ACL operations, you can also specify a `generation` property.
  * //-
  * myFile.acl.get({
  *   scope: 'user-useremail@example.com',
@@ -218,6 +224,8 @@ Acl.prototype.get = function(options, callback) {
  *     revision of this file (as opposed to the latest version, the default).
  * @param {function} callback - The callback function.
  *
+ * @alias acl.update
+ *
  * @example
  * var storage = gcloud.storage();
  *
@@ -227,7 +235,7 @@ Acl.prototype.get = function(options, callback) {
  * }, function(err) {});
  *
  * //-
- * // For file ACL operations, an options object is also accepted.
+ * // For file ACL operations, you can also specify a `generation` property.
  * //-
  * myFile.acl.update({
  *   scope: 'user-useremail@example.com',

lib/storage/bucket.js

@@ -146,31 +146,31 @@ function Bucket(storage, name) {
    *
    * @alias acl.default
    */
-  var aclDefault;
+  var aclDefault = true;
 
   /**
    * Maps to {module:storage/bucket#acl.add}.
    * @alias acl.default.add
    */
-  var aclDefaultAdd;
+  var aclDefaultAdd = true;
 
   /**
    * Maps to {module:storage/bucket#acl.delete}.
    * @alias acl.default.delete
    */
-  var aclDefaultDelete;
+  var aclDefaultDelete = true;
 
   /**
    * Maps to {module:storage/bucket#acl.get}.
    * @alias acl.default.get
    */
-  var aclDefaultGet;
+  var aclDefaultGet = true;
 
   /**
    * Maps to {module:storage/bucket#acl.update}.
    * @alias acl.default.update
    */
-  var aclDefaultUpdate;
+  var aclDefaultUpdate = true;
   /* jshint ignore:end */
 }