old_contents: /**
   * ZIP Format Plugin
   *
   * @module plugins/zip
   * @license [MIT]{@link https://github.com/archiverjs/node-archiver/blob/master/LICENSE}
   * @copyright (c) 2012-2014 Chris Talkington, contributors.
   */
  var engine = require('zip-stream');
  var util = require('archiver-utils');
  
  /**
   * @constructor
   * @param {Object} [options]
   * @param {String} [options.comment] Sets the zip archive comment.
   * @param {Boolean} [options.forceLocalTime=false] Forces the archive to contain local file times instead of UTC.
   * @param {Boolean} [options.forceZip64=false] Forces the archive to contain ZIP64 headers.
   * @param {Boolean} [options.store=false] Sets the compression method to STORE.
   * @param {Object} [options.zlib] Passed to [zlib]{@link https://nodejs.org/api/zlib.html#zlib_class_options}
   */
  var Zip = function(options) {
    if (!(this instanceof Zip)) {
      return new Zip(options);
    }
  
    options = this.options = util.defaults(options, {
      comment: '',
      forceUTC: false,
      store: false
    });
  
    this.supports = {
      directory: true
    };
  
    this.engine = new engine(options);
  };
  
  /**
   * @param  {(Buffer|Stream)} source
   * @param  {ZipEntryData} data
   * @param  {String} data.name Sets the entry name including internal path.
   * @param  {(String|Date)} [data.date=NOW()] Sets the entry date.
   * @param  {Number} [data.mode=D:0755/F:0644] Sets the entry permissions.
   * @param  {String} [data.prefix] Sets a path prefix for the entry name. Useful
   * when working with methods like `directory` or `glob`.
   * @param  {fs.Stats} [data.stats] Sets the fs stat data for this entry allowing
   * for reduction of fs stat calls when stat data is already known.
   * @param  {Boolean} [data.store=ZipOptions.store] Sets the compression method to STORE.
   * @param  {Function} callback
   * @return void
   */
  Zip.prototype.append = function(source, data, callback) {
    this.engine.entry(source, data, callback);
  };
  
  /**
   * @return void
   */
  Zip.prototype.finalize = function() {
    this.engine.finalize();
  };
  
  /**
   * @return this.engine
   */
  Zip.prototype.on = function() {
    return this.engine.on.apply(this.engine, arguments);
  };
  
  /**
   * @return this.engine
   */
  Zip.prototype.pipe = function() {
    return this.engine.pipe.apply(this.engine, arguments);
  };
  
  /**
   * @return this.engine
   */
  Zip.prototype.unpipe = function() {
    return this.engine.unpipe.apply(this.engine, arguments);
  };
  
  module.exports = Zip;
  
  /**
   * @typedef {Object} ZipEntryData
   * @global
   *
   */
new_contents: /**
   * ZIP Format Plugin
   *
   * @module plugins/zip
   * @license [MIT]{@link https://github.com/archiverjs/node-archiver/blob/master/LICENSE}
   * @copyright (c) 2012-2014 Chris Talkington, contributors.
   */
  var engine = require('zip-stream');
  var util = require('archiver-utils');
  
  /**
   * @constructor
   * @param {Object} [options]
   * @param {String} [options.comment] Sets the zip archive comment.
   * @param {Boolean} [options.forceLocalTime=false] Forces the archive to contain local file times instead of UTC.
   * @param {Boolean} [options.forceZip64=false] Forces the archive to contain ZIP64 headers.
   * @param {Boolean} [options.store=false] Sets the compression method to STORE.
   * @param {Object} [options.zlib] Passed to [zlib]{@link https://nodejs.org/api/zlib.html#zlib_class_options}
   */
  var Zip = function(options) {
    if (!(this instanceof Zip)) {
      return new Zip(options);
    }
  
    options = this.options = util.defaults(options, {
      comment: '',
      forceUTC: false,
      store: false
    });
  
    this.supports = {
      directory: true
    };
  
    this.engine = new engine(options);
  };
  
  /**
   * @param  {(Buffer|Stream)} source
   * @param  {ZipEntryData} data
   * @param  {String} data.name Sets the entry name including internal path.
   * @param  {(String|Date)} [data.date=NOW()] Sets the entry date.
   * @param  {Number} [data.mode=D:0755/F:0644] Sets the entry permissions.
   * @param  {String} [data.prefix] Sets a path prefix for the entry name. Useful
   * when working with methods like `directory` or `glob`.
   * @param  {fs.Stats} [data.stats] Sets the fs stat data for this entry allowing
   * for reduction of fs stat calls when stat data is already known.
   * @param  {Boolean} [data.store=ZipOptions.store] Sets the compression method to STORE.
   * @param  {Function} callback
   * @return void
   */
  Zip.prototype.append = function(source, data, callback) {
    this.engine.entry(source, data, callback);
  };
  
  /**
   * @return void
   */
  Zip.prototype.finalize = function() {
    this.engine.finalize();
  };
  
  /**
   * @return this.engine
   */
  Zip.prototype.on = function() {
    return this.engine.on.apply(this.engine, arguments);
  };
  
  /**
   * @return this.engine
   */
  Zip.prototype.pipe = function() {
    return this.engine.pipe.apply(this.engine, arguments);
  };
  
  /**
   * @return this.engine
   */
  Zip.prototype.unpipe = function() {
    return this.engine.unpipe.apply(this.engine, arguments);
  };
  
  module.exports = Zip;
  
  /**
   * @typedef {Object} ZipOptions
   * @global
   * @property {String} [comment] Sets the zip archive comment.
   * @param {Boolean} [forceLocalTime=false] Forces the archive to contain local file times instead of UTC.
   * @param {Boolean} [forceZip64=false] Forces the archive to contain ZIP64 headers.
   * @property {Boolean} [store=false] Sets the compression method to STORE.
   * @property {Object} [zlib] Passed to [zlib]{@link https://nodejs.org/api/zlib.html#zlib_class_options}
   * to control compression.
   * @property {*} [*] See [zip-stream]{@link https://archiverjs.com/zip-stream/ZipStream.html} documentation for additional properties.
   */
  
  /**
   * @typedef {Object} ZipEntryData
   * @global
   * @property {String} name Sets the entry name including internal path.
   * @property {(String|Date)} [date=NOW()] Sets the entry date.
   * @property {Number} [mode=D:0755/F:0644] Sets the entry permissions.
   * @property {String} [prefix] Sets a path prefix for the entry name. Useful
   * when working with methods like `directory` or `glob`.
   * @property {fs.Stats} [stats] Sets the fs stat data for this entry allowing
   * for reduction of fs stat calls when stat data is already known.
   * @property {Boolean} [store=ZipOptions.store] Sets the compression method to STORE.
   */
subject: update zip docs.