Specifically state this is a render flag only phaserjs#4574

Author: photonstorm

src/gameobjects/components/Flip.js

@@ -16,8 +16,10 @@ var Flip = {
 
     /**
      * The horizontally flipped state of the Game Object.
+     * 
      * A Game Object that is flipped horizontally will render inversed on the horizontal axis.
      * Flipping always takes place from the middle of the texture and does not impact the scale value.
+     * If this Game Object has a physics body, it will not change the body. This is a rendering toggle only.
      * 
      * @name Phaser.GameObjects.Components.Flip#flipX
      * @type {boolean}
@@ -28,8 +30,10 @@ var Flip = {
 
     /**
      * The vertically flipped state of the Game Object.
+     * 
      * A Game Object that is flipped vertically will render inversed on the vertical axis (i.e. upside down)
      * Flipping always takes place from the middle of the texture and does not impact the scale value.
+     * If this Game Object has a physics body, it will not change the body. This is a rendering toggle only.
      * 
      * @name Phaser.GameObjects.Components.Flip#flipY
      * @type {boolean}
@@ -41,6 +45,10 @@ var Flip = {
     /**
      * Toggles the horizontal flipped state of this Game Object.
      * 
+     * A Game Object that is flipped horizontally will render inversed on the horizontal axis.
+     * Flipping always takes place from the middle of the texture and does not impact the scale value.
+     * If this Game Object has a physics body, it will not change the body. This is a rendering toggle only.
+     * 
      * @method Phaser.GameObjects.Components.Flip#toggleFlipX
      * @since 3.0.0
      * 
@@ -71,6 +79,10 @@ var Flip = {
     /**
      * Sets the horizontal flipped state of this Game Object.
      * 
+     * A Game Object that is flipped horizontally will render inversed on the horizontal axis.
+     * Flipping always takes place from the middle of the texture and does not impact the scale value.
+     * If this Game Object has a physics body, it will not change the body. This is a rendering toggle only.
+     * 
      * @method Phaser.GameObjects.Components.Flip#setFlipX
      * @since 3.0.0
      *
@@ -105,6 +117,10 @@ var Flip = {
     /**
      * Sets the horizontal and vertical flipped state of this Game Object.
      * 
+     * A Game Object that is flipped will render inversed on the flipped axis.
+     * Flipping always takes place from the middle of the texture and does not impact the scale value.
+     * If this Game Object has a physics body, it will not change the body. This is a rendering toggle only.
+     * 
      * @method Phaser.GameObjects.Components.Flip#setFlip
      * @since 3.0.0
      *