Merge pull request #818 from mattce/master

Update targetLibrary documentation

Author: bebraw

content/configuration/index.md

@@ -8,6 +8,7 @@ contributors:
   - bondz
   - sricc
   - terinjokes
+  - mattce
 ---
 
 webpack is fed via a configuration object. It is passed in one of two ways depending on how you are using webpack: through the terminal or via Node.js. All the available configuration options are specified below.
@@ -57,12 +58,18 @@ var path = require('path');
     [library](/configuration/output#output-library): "MyLibrary", // string,
     // the name of the exported library
 
-    <details><summary>[libraryTarget](/configuration/output#output-librarytarget): "umd", // enum</summary>
-    [libraryTarget](/configuration/output#output-librarytarget): "commonjs2", // exported with module.exports
-    [libraryTarget](/configuration/output#output-librarytarget): "commonjs", // exported as properties to exports
-    [libraryTarget](/configuration/output#output-librarytarget): "amd", // defined with AMD defined method
-    [libraryTarget](/configuration/output#output-librarytarget): "this", // property set on this
-    [libraryTarget](/configuration/output#output-librarytarget): "var", // variable defined in root scope
+    <details><summary>[libraryTarget](/configuration/output#output-librarytarget): "umd", // universal module definition</summary>
+        [libraryTarget](/configuration/output#output-librarytarget): "umd2", // universal module definition
+        [libraryTarget](/configuration/output#output-librarytarget): "commonjs2", // exported with module.exports
+        [libraryTarget](/configuration/output#output-librarytarget): "commonjs-module", // exports with module.exports
+        [libraryTarget](/configuration/output#output-librarytarget): "commonjs", // exported as properties to exports
+        [libraryTarget](/configuration/output#output-librarytarget): "amd", // defined with AMD defined method
+        [libraryTarget](/configuration/output#output-librarytarget): "this", // property set on this
+        [libraryTarget](/configuration/output#output-librarytarget): "var", // variable defined in root scope
+        [libraryTarget](/configuration/output#output-librarytarget): "assign", // blind assignment
+        [libraryTarget](/configuration/output#output-librarytarget): "window", // property set to window object
+        [libraryTarget](/configuration/output#output-librarytarget): "global", // property set to global object
+        [libraryTarget](/configuration/output#output-librarytarget): "jsonp", // jsonp wrapper
     </details>
     // the type of the exported library
 

content/configuration/output.md

@@ -5,6 +5,7 @@ contributors:
   - sokra
   - skipjack
   - tomasAlabes
+  - mattce
 ---
 
 The top-level `output` key contains set of options instructing webpack on how and where it should output your bundles, assets and anything else you bundle or load with webpack.
@@ -250,7 +251,27 @@ MyLibrary.doSomething(); //if this is window
 ```
 
 
-`libraryTarget: "commonjs"` - When your library is loaded, the return value of your entry point will be part of the exports object. As the name implies, this is used in CommonJS environments:
+`libraryTarget: "window"` - When your library is loaded, **the return value of your entry point** will be part `window` object.
+ 
+ ```javascript
+ window["MyLibrary"] = _entry_return_;
+
+//your users will use your library like:
+window.MyLibrary.doSomething();
+ ```
+
+
+`libraryTarget: "global"` - When your library is loaded, **the return value of your entry point** will be part `global` object.
+ 
+ ```javascript
+ global["MyLibrary"] = _entry_return_;
+
+//your users will use your library like:
+global.MyLibrary.doSomething();
+ ```
+
+
+`libraryTarget: "commonjs"` - When your library is loaded, **the return value of your entry point** will be part of the exports object. As the name implies, this is used in CommonJS environments:
 
 ```javascript
 exports["MyLibrary"] = _entry_return_;
@@ -259,7 +280,8 @@ exports["MyLibrary"] = _entry_return_;
 require("MyLibrary").doSomething();
 ```
 
-`libraryTarget: "commonjs2"` - When your library is loaded, the return value of your entry point will be part of the exports object. As the name implies, this is used in CommonJS environments:
+
+`libraryTarget: "commonjs2"` - When your library is loaded, **the return value of your entry point** will be part of the exports object. As the name implies, this is used in CommonJS environments:
 
 ```javascript
 module.exports = _entry_return_;
@@ -320,7 +342,7 @@ require(["MyLibrary"], function(MyLibrary){
 `libraryTarget: "umd"` - This is a way for your library to work with all the module definitions (and where aren't modules at all). 
 It will work with CommonJS, AMD and as global variable. You can check the [UMD Repository](https://github.com/umdjs/umd) to know more about it. 
 
-In this case, you need the another property to name your module:
+In this case, you need the `library` property to name your module:
 
 ```javascript
 output: {
@@ -347,6 +369,21 @@ And finally the output is:
 
 Module proof library.
 
+
+`libraryTarget: "assign"` - Here webpack will blindly generate an implied global.
+ 
+ ```javascript
+ MyLibrary = _entry_return_;
+ ```
+Be aware that if `MyLibrary` isn't defined earlier your library will be set in global scope.
+
+
+`libraryTarget: "jsonp"` - This will wrap the return value of your entry point into a jsonp wrapper.
+ 
+ ```javascript
+ MyLibrary( _entry_return_ );
+ ```
+
 The dependencies for your library will be defined by the [`externals`](/configuration/externals/) config.