adding doc for vid and audio file arrays for issue #346

Author: lauren mccarthy

lib/addons/p5.dom.js

@@ -74,8 +74,18 @@ var p5DOM = (function(){
    * Removes all elements created by p5, except any canvas / graphics
    * elements created by createCanvas or createGraphics.
    * Event handlers are removed, and element is removed from the DOM.
-   *
    * @method removeElements
+   * <div class='norender'><code>
+   * function setup() {
+   *   createCanvas(100, 100);
+   *   createDiv('this is some text');
+   *   createP('this is a paragraph'); 
+   * }
+   * function mousePressed() {
+   *   removeElements(); // this will remove the div and p, not canvas
+   * }
+   * </code></div>
+   *
    */
   p5.prototype.removeElements = function (e) {
     for (var i=0; i<this._elements.length; i++) {
@@ -280,7 +290,12 @@ var p5DOM = (function(){
    * Creates an HTML5 &lt;video&gt; element in the DOM for simple playback
    * of audio/video. Shown by default, can be hidden with .hide()
    * and drawn into canvas using video(). Appends to the container
-   * node if one is specified, otherwise appends to body.
+   * node if one is specified, otherwise appends to body. The first parameter
+   * can be either a single string path to a video file, or an array of string
+   * paths to different formats of the same video. This is useful for ensuring
+   * that your video can play across different browsers, as each supports 
+   * different formats. See <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Supported_media_formats">this
+   * page for further information about supported formats.
    * 
    * @method createVideo
    * @param  {String|Array} src  path to a video file, or array of paths for
@@ -302,7 +317,12 @@ var p5DOM = (function(){
   /**
    * Creates a hidden HTML5 &lt;audio&gt; element in the DOM for simple audio 
    * playback. Appends to the container node if one is specified, 
-   * otherwise appends to body.
+   * otherwise appends to body. The first parameter
+   * can be either a single string path to a audio file, or an array of string
+   * paths to different formats of the same audio. This is useful for ensuring
+   * that your audio can play across different browsers, as each supports 
+   * different formats. See <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Supported_media_formats">this
+   * page for further information about supported formats.
    * 
    * @method createAudio
    * @param  {String|Array} src  path to an audio file, or array of paths for
@@ -657,8 +677,12 @@ var p5DOM = (function(){
 
   /**
    * Removes the element and deregisters all listeners.
-   * 
    * @method remove
+   * @example
+   * <div class='norender'><code>
+   * var myDiv = createDiv('this is some text');
+   * myDiv.remove();
+   * </code></div>
    */
   p5.Element.prototype.remove = function() {
     // deregister events

lib/p5.js

@@ -1,4 +1,4 @@
-/*! p5.js v0.3.5 September 05, 2014 */
+/*! p5.js v0.3.5 September 06, 2014 */
 var shim = function (require) {
     window.requestDraw = function () {
       return window.requestAnimationFrame || window.webkitRequestAnimationFrame || window.mozRequestAnimationFrame || window.oRequestAnimationFrame || window.msRequestAnimationFrame || function (callback, element) {

lib/p5.min.js

@@ -298,7 +298,26 @@ define(function (require) {
     }.bind(this);
 
     /**
+     * Removes the entire p5 sketch. This will remove the canvas and any 
+     * elements created by p5.js. It will also stop the draw loop and unbind 
+     * any properties or methods from the window global scope. It will
+     * leave a variable p5 in case you wanted to create a new p5 sketch. 
+     * If you like, you can set p5 = null to erase it.
      * @method remove
+     * @example
+     * <div class='norender'><code>
+     * function setup() {
+     *   createCanvas(200, 200);
+     * }
+     * 
+     * function draw() {
+     *   ellipse(width/2, height/2, 0, 0);
+     * }
+     * 
+     * function mousePressed() {
+     *   remove(); // remove whole sketch on mouse press
+     * }
+     * </code></div>
      */
     this.remove = function() {
       if (this._curElement) {