diff --git a/src/core/renderers/webgl/WebGLRenderer.js b/src/core/renderers/webgl/WebGLRenderer.js
index 39221c8..97845d9 100644
--- a/src/core/renderers/webgl/WebGLRenderer.js
+++ b/src/core/renderers/webgl/WebGLRenderer.js
@@ -29,7 +29,7 @@
  * @param [options.forceFXAA=false] {boolean} forces FXAA antialiasing to be used over native. FXAA is faster, but may not always lok as great
  * @param [options.resolution=1] {number} the resolution of the renderer retina would be 2
  * @param [options.clearBeforeRender=true] {boolean} This sets if the CanvasRenderer will clear the canvas or
- *      not before the new render pass.
+ *      not before the new render pass. If you wish to set this to false, you *must* set preserveDrawingBuffer to `true`.
  * @param [options.preserveDrawingBuffer=false] {boolean} enables drawing buffer preservation, enable this if
  *      you need to call toDataUrl on the webgl context.
  */

diff --git a/src/core/renderers/webgl/WebGLRenderer.js b/src/core/renderers/webgl/WebGLRenderer.js
index 39221c8..97845d9 100644
--- a/src/core/renderers/webgl/WebGLRenderer.js
+++ b/src/core/renderers/webgl/WebGLRenderer.js
@@ -29,7 +29,7 @@
  * @param [options.forceFXAA=false] {boolean} forces FXAA antialiasing to be used over native. FXAA is faster, but may not always lok as great
  * @param [options.resolution=1] {number} the resolution of the renderer retina would be 2
  * @param [options.clearBeforeRender=true] {boolean} This sets if the CanvasRenderer will clear the canvas or
- *      not before the new render pass.
+ *      not before the new render pass. If you wish to set this to false, you *must* set preserveDrawingBuffer to `true`.
  * @param [options.preserveDrawingBuffer=false] {boolean} enables drawing buffer preservation, enable this if
  *      you need to call toDataUrl on the webgl context.
  */
diff --git a/src/extras/BitmapText.js b/src/extras/BitmapText.js
index 858a8cd..5298760 100644
--- a/src/extras/BitmapText.js
+++ b/src/extras/BitmapText.js
@@ -8,7 +8,7 @@
  *
  * ```js
  * // in this case the font is in a file called 'desyrel.fnt'
- * var bitmapText = new PIXI.BitmapText("text using a fancy font!", {font: "35px Desyrel", align: "right"});
+ * var bitmapText = new PIXI.extras.BitmapText("text using a fancy font!", {font: "35px Desyrel", align: "right"});
  * ```
  *
  *
@@ -124,7 +124,7 @@
      * The tint of the BitmapText object
      *
      * @member {number}
-     * @memberof PIXI.BitmapText#
+     * @memberof PIXI.extras.BitmapText#
      */
     tint: {
         get: function ()
@@ -144,7 +144,7 @@
      *
      * @member {string}
      * @default 'left'
-     * @memberof PIXI.BitmapText#
+     * @memberof PIXI.extras.BitmapText#
      */
     align: {
         get: function ()
@@ -163,7 +163,7 @@
      * The font descriptor of the BitmapText object
      *
      * @member {Font}
-     * @memberof PIXI.BitmapText#
+     * @memberof PIXI.extras.BitmapText#
      */
     font: {
         get: function ()
@@ -195,7 +195,7 @@
      * The text of the BitmapText object
      *
      * @member {string}
-     * @memberof PIXI.BitmapText#
+     * @memberof PIXI.extras.BitmapText#
      */
     text: {
         get: function ()