Examples: Deprecate examples/js.

docs/manual/en/introduction/Import-via-modules.html

@@ -66,8 +66,8 @@ <h2>Importable Examples</h2>
 		<p>
 			The core of three.js is focused on the most important components of a 3D engine. Many other components like loaders or controls are part of the
 			examples directory. three.js ensures that these files are kept in sync with the core but users have to import them separately if they are required
-			for a project. You can find in the [link:https://github.com/mrdoob/three.js/tree/master/examples/jsm examples/jsm] directory an ES6
-			module version for almost all example files. If you install three.js via npm, you can import them like so:
+			for a project. You can find them in the [link:https://github.com/mrdoob/three.js/tree/master/examples/jsm examples/jsm] directory. If you install three.js
+			via npm, import example files like so:
 		</p>
 		<code>
 		import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';

docs/manual/en/introduction/Loading-3D-models.html

@@ -81,19 +81,10 @@ <h2>Loading</h2>
 
 	<p>
 		Only a few loaders (e.g. [page:ObjectLoader]) are included by default with
-		three.js — others should be added to your page individually. Depending on your
-		preference and comfort with build tools, choose one of the following:
+		three.js — others should be added to your app individually.
 	</p>
 
 	<code>
-		// global script
-		&lt;script src="GLTFLoader.js"&gt;&lt;/script&gt;
-
-		// commonjs
-		var THREE = window.THREE = require('three');
-		require('three/examples/js/loaders/GLTFLoader');
-
-		// ES modules
 		import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader';
 	</code>
 

docs/manual/zh/introduction/Import-via-modules.html

@@ -64,10 +64,10 @@ <h2>导入这个模块</h2>
 
 		<h2>可引入的示例</h2>
 		<p>
-			three.js的核心专注于实现3D引擎中最为重要的组件。其他诸如加载器和控制器等组件，是示例文件夹中的一部分。
-			three.js确保这些文件能够与核心保持同步，但如果在一个项目中这些组件是必要的，用户将必须分别地引入它们。
-			你可以在[link:https://github.com/mrdoob/three.js/tree/master/examples/jsm examples/jsm]文件夹中找到所有示例文件的ES6版本。
-			如果你是通过npm来安装three.js的，那么你可以使用类似下面的代码来引入它们：
+			The core of three.js is focused on the most important components of a 3D engine. Many other components like loaders or controls are part of the
+			examples directory. three.js ensures that these files are kept in sync with the core but users have to import them separately if they are required
+			for a project. You can find them in the [link:https://github.com/mrdoob/three.js/tree/master/examples/jsm examples/jsm] directory. If you install three.js
+			via npm, import example files like so:
 		</p>
 		<code>
 		import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';

docs/manual/zh/introduction/Loading-3D-models.html

@@ -70,18 +70,11 @@ <h2>推荐的工作流程</h2>
 	<h2>加载</h2>
 
 	<p>
-		three.js中默认仅包含了几个加载器（例如：[page:ObjectLoader]）——其它加载器需要你分别地添加到页面中。
-		取决于你对构建工具的偏好，选择以下任意一种方式：
+		Only a few loaders (e.g. [page:ObjectLoader]) are included by default with
+		three.js — others should be added to your app individually.
 	</p>
 
 	<code>
-		// global script
-		&lt;script src="GLTFLoader.js"&gt;&lt;/script&gt;
-
-		// commonjs
-		var THREE = window.THREE = require('three');
-		require('three/examples/js/loaders/GLTFLoader');
-
 		// ES modules
 		import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader';
 	</code>

examples/js/WebGL.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.WebGL: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author alteredq / http://alteredqualia.com/
  * @author mrdoob / http://mrdoob.com/

examples/js/animation/AnimationClipCreator.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.AnimationClipCreator: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  *
  * Creator of typical test AnimationClips / KeyframeTracks

examples/js/animation/CCDIKSolver.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.CCDIKSolver: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author takahiro / https://github.com/takahirox
  *

examples/js/animation/MMDAnimationHelper.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.MMDAnimationHelper: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author takahiro / https://github.com/takahirox
  *

examples/js/animation/MMDPhysics.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.MMDPhysics: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author takahiro / https://github.com/takahirox
  *

examples/js/animation/TimelinerController.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.TimelinerController: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * Controller class for the Timeliner GUI.
  *

examples/js/cameras/CinematicCamera.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.CinematicCamera: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  * @author greggman / http://games.greggman.com/

examples/js/controls/DeviceOrientationControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.DeviceOrientationControls: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author richt / http://richt.me
  * @author WestLangley / https://github.com/WestLangley

examples/js/controls/DragControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.DragControls: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author zz85 / https://github.com/zz85
  * @author mrdoob / http://mrdoob.com

examples/js/controls/FirstPersonControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.FirstPersonControls: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  * @author alteredq / http://alteredqualia.com/

examples/js/controls/FlyControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.FlyControls: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author James Baicoianu / http://www.baicoianu.com/
  */

examples/js/controls/OrbitControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.OrbitControls: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author qiao / https://github.com/qiao
  * @author mrdoob / http://mrdoob.com

examples/js/controls/PointerLockControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.PointerLockControls: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  * @author Mugen87 / https://github.com/Mugen87

examples/js/controls/TrackballControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.TrackballControls: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author Eberhard Graether / http://egraether.com/
  * @author Mark Lundin 	/ http://mark-lundin.com

examples/js/controls/TransformControls.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.TransformControls: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author arodic / https://github.com/arodic
  */

examples/js/curves/CurveExtras.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.CurveExtras: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * A bunch of parametric curves
  * @author zz85

examples/js/curves/NURBSCurve.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.NURBSCurve: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author renej
  * NURBS curve object

examples/js/curves/NURBSSurface.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.NURBSSurface: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author renej
  * NURBS surface object

examples/js/curves/NURBSUtils.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.NURBSUtils: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author renej
  * NURBS utils

examples/js/effects/AnaglyphEffect.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.AnaglyphEffect: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  * @author marklundin / http://mark-lundin.com/

examples/js/effects/AsciiEffect.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.AsciiEffect: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author zz85 / https://github.com/zz85
  *

examples/js/effects/OutlineEffect.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.OutlineEffect: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author takahirox / https://github.com/takahirox/
  *

examples/js/effects/ParallaxBarrierEffect.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.ParallaxBarrierEffect: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  * @author marklundin / http://mark-lundin.com/

examples/js/effects/PeppersGhostEffect.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.PeppersGhostEffect: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * Created by tpowellmeto on 29/10/2015.
  *

examples/js/effects/StereoEffect.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.StereoEffect: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author alteredq / http://alteredqualia.com/
  * @authod mrdoob / http://mrdoob.com/

examples/js/exporters/ColladaExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.ColladaExporter: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author Garrett Johnson / http://gkjohnson.github.io/
  * https://github.com/gkjohnson/collada-exporter-js

examples/js/exporters/DRACOExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.DRACOExporter: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * Export draco compressed files from threejs geometry objects.
  *

examples/js/exporters/GLTFExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.GLTFExporter: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author fernandojsg / http://fernandojsg.com
  * @author Don McCurdy / https://www.donmccurdy.com

examples/js/exporters/MMDExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.MMDExporter: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author takahiro / https://github.com/takahirox
  *

examples/js/exporters/OBJExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.OBJExporter: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  */

examples/js/exporters/PLYExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.PLYExporter: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author Garrett Johnson / http://gkjohnson.github.io/
  * https://github.com/gkjohnson/ply-exporter-js

examples/js/exporters/STLExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.STLExporter: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author kovacsv / http://kovacsv.hu/
  * @author mrdoob / http://mrdoob.com/

examples/js/exporters/TypedGeometryExporter.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.TypedGeometryExporter: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  */

examples/js/geometries/BoxLineGeometry.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.BoxLineGeometry: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author mrdoob / http://mrdoob.com/
  */

examples/js/geometries/ConvexGeometry.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.ConvexGeometry: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author Mugen87 / https://github.com/Mugen87
  */

examples/js/geometries/DecalGeometry.js

@@ -1,3 +1,4 @@
+console.warn( "THREE.DecalGeometry: Importing from 'examples/js' is now deprecated. Please import ES6 modules from 'examples/jsm' instead. Refer to the announcement and documentation, or reach out on the forums if you need guidance with this change. Announcement: TODO. Documentation: https://threejs.org/docs/index.html#manual/en/introduction/Import-via-modules." );
 /**
  * @author Mugen87 / https://github.com/Mugen87
  * @author spite / https://github.com/spite