Option order made deprecated

HISTORY.md

@@ -14,6 +14,7 @@ http://visjs.org
   rather than when the Timeline is actually resized.
 - Fixed `select` event fired repeatedly when clicking an empty place on the
   Timeline, deselecting selected items).
+- Option `order` is now deprecated. This was needed for performance improvements.
 - Minor bug fixes.
 - More examples added.
 

docs/timeline.html

@@ -456,6 +456,7 @@ var options = {
   </td>
 </tr>
 
+<!-- TODO: cleanup option order
 <tr>
   <td>order</td>
   <td>Function</td>
@@ -466,6 +467,7 @@ var options = {
     `vis.components.items.Item`.
   </td>
 </tr>
+-->
 
 <tr>
   <td>orientation</td>

src/timeline/Timeline.js

@@ -315,6 +315,11 @@ Timeline.prototype.setOptions = function (options) {
     }
   }
 
+  // TODO: remove deprecation error one day (deprecated since version 0.8.0)
+  if (options && options.order) {
+    throw new Error('Option order is deprecated. There is no replacement for this feature.');
+  }
+
   // repaint everything
   this.rootPanel.repaint();
 };