Index: /trunk/fl5/doc/publishers/embedding.rst
===================================================================
--- /trunk/fl5/doc/publishers/embedding.rst	(revision 1397)
+++ /trunk/fl5/doc/publishers/embedding.rst	(revision 1481)
@@ -498,2 +498,21 @@
 
 This formal **remove()** function will make sure the player stops its streams, the DOM is re-set to its original state and all event listeners are cleaned up.
+
+Flash Window Mode (wmode) Configuration
++++++++++++++++++++++++++++++++++++++++
+
+The JW Player embed script allows publishers to configure the window mode of Flash through the **wmode** configuration parameter. It may be set to any of the `allowed values <http://kb2.adobe.com/cps/127/tn_12701.html>`_  (**window**, **opaque**, or **transparent**). The default window mode used by the embed script is **opaque** as this provides the best performance. 
+
+.. code-block:: html
+    
+    <div id="container">Loading the player ...</div>
+    
+    <script type="text/javascript">
+        jwplayer("container").setup({
+            flashplayer: "/jwplayer/player.swf",
+            file: "/uploads/video.mp4",
+            height: 270,
+            width: 480,
+            wmode: "opaque"
+        });
+    </script>
Index: /trunk/fl5/doc/publishers/options.rst
===================================================================
--- /trunk/fl5/doc/publishers/options.rst	(revision 1238)
+++ /trunk/fl5/doc/publishers/options.rst	(revision 1481)
@@ -83,5 +83,17 @@
    Technically, any playlist item property is also available as an option. In practice though, the properties *author*, *date*, *description*, *link*, *tags* and *title* are not used anywhere if a single media file is loaded.
 
-
+.. describe:: netstreambasepath ( undefined )
+
+   The netstreambasepath should be set to a string reprenting a URL. Introduced in JW Player 5.4, this configuration parameter directs the **video** and **http** media providers to request video files relative to the specified netstreambasepath rather than relative to the player SWF (see below). This will likely cause issues for publishers using the JW Embedder with relative file paths. 
+   
+.. note::
+
+   This does not affect any other URLs (such as skins, playlists, or plugins), but relative URLs contained within a playlist will be calculated relative to this path.
+   
+.. note::
+   
+   The netstreambasepath configuration option exists as a workaround for a technical limitation in Flash. All video in Flash must be loaded using Adobe's NetStream class. For historical reason, relative file paths passed into the NetStream are always resolved relative to the SWF making the request.
+   
+   The JW Player uses the NetStream class to load media for the **video** and **http** media providers. With the introduction of the HTML5 player, it became impossible to consistently reference a video file via a relative path, as in Flash mode would load it relative to the player SWF, while in HTML5 mode it would load relative to the current page. The netstreambasepath is a workaround that allow for a consistent referencing by specifing the original path from which relative URLs should be resolved.
 
 .. _options-layout: