Improve JSDoc output.

* Switch from the obsolete SyntaxHighlighter to Prism, to allow inline syntax highlighting
* Use syntax-highlighting for default values
* Fix generated HTML for `@deprecated`.
* Fix incorrect HTML escaping in code examples.

Author: shunter

Source/Widgets/Animation/Animation.js

@@ -315,7 +315,7 @@ define([
      *
      * @example
      * // In HTML head, include a link to Animation.css stylesheet,
-     * // and in the body, include: <div id="animationContainer"></div>
+     * // and in the body, include: <div id="animationContainer"></div>
      *
      * var clock = new Cesium.Clock();
      * var clockViewModel = new Cesium.ClockViewModel(clock);

Source/Widgets/BaseLayerPicker/BaseLayerPicker.js

@@ -48,8 +48,8 @@ define([
      *
      * @example
      * // In HTML head, include a link to the BaseLayerPicker.css stylesheet,
-     * // and in the body, include: <div id="baseLayerPickerContainer"
-     * //   style="position:absolute;top:24px;right:24px;width:38px;height:38px;"></div>
+     * // and in the body, include: <div id="baseLayerPickerContainer"
+     * //   style="position:absolute;top:24px;right:24px;width:38px;height:38px;"></div>
      *
      * //Create the list of available providers we would like the user to select from.
      * //This example uses 3, OpenStreetMap, The Black Marble, and a single, non-streaming world image.

Source/Widgets/CesiumWidget/CesiumWidget.js

@@ -113,7 +113,7 @@ define([
      *
      * @example
      * // For each example, include a link to CesiumWidget.css stylesheet in HTML head,
-     * // and in the body, include: <div id="cesiumContainer"></div>
+     * // and in the body, include: <div id="cesiumContainer"></div>
      *
      * //Widget with no terrain and default Bing Maps imagery provider.
      * var widget = new Cesium.CesiumWidget('cesiumContainer');

Source/Widgets/NavigationHelpButton/NavigationHelpButton.js

@@ -33,13 +33,13 @@ define([
      *
      * @example
      * // In HTML head, include a link to the NavigationHelpButton.css stylesheet,
-     * // and in the body, include: <div id="navigationHelpButtonContainer"></div>
+     * // and in the body, include: <div id="navigationHelpButtonContainer"></div>
      *
      * var navigationHelpButton = new Cesium.NavigationHelpButton({
      *     container : 'navigationHelpButtonContainer'
      * });
      */
-    var NavigationHelpButton = function (options) {
+    var NavigationHelpButton = function(options) {
         //>>includeStart('debug', pragmas.debug);
         if (!defined(options) || !defined(options.container)) {
             throw new DeveloperError('options.container is required.');
@@ -107,7 +107,7 @@ cesiumSvgPath: { path: _svgPath, width: 32, height: 32 }');
         this._viewModel = viewModel;
         this._wrapper = wrapper;
 
-        this._closeInstructions = function (e) {
+        this._closeInstructions = function(e) {
             if (!wrapper.contains(e.target)) {
                 viewModel.showInstructions = false;
             }
@@ -124,8 +124,8 @@ cesiumSvgPath: { path: _svgPath, width: 32, height: 32 }');
          *
          * @type {Element}
          */
-        container: {
-            get: function () {
+        container : {
+            get : function() {
                 return this._container;
             }
         },
@@ -136,8 +136,8 @@ cesiumSvgPath: { path: _svgPath, width: 32, height: 32 }');
          *
          * @type {NavigationHelpButtonViewModel}
          */
-        viewModel: {
-            get: function () {
+        viewModel : {
+            get : function() {
                 return this._viewModel;
             }
         }
@@ -147,7 +147,7 @@ cesiumSvgPath: { path: _svgPath, width: 32, height: 32 }');
      * @memberof NavigationHelpButton
      * @returns {Boolean} true if the object has been destroyed, false otherwise.
      */
-    NavigationHelpButton.prototype.isDestroyed = function () {
+    NavigationHelpButton.prototype.isDestroyed = function() {
         return false;
     };
 
@@ -156,7 +156,7 @@ cesiumSvgPath: { path: _svgPath, width: 32, height: 32 }');
      * removing the widget from layout.
      * @memberof NavigationHelpButton
      */
-    NavigationHelpButton.prototype.destroy = function () {
+    NavigationHelpButton.prototype.destroy = function() {
         document.removeEventListener('mousedown', this._closeInstructions, true);
         document.removeEventListener('touchstart', this._closeInstructions, true);
 

Source/Widgets/SceneModePicker/SceneModePicker.js

@@ -45,10 +45,9 @@ define([
      *
      * @example
      * // In HTML head, include a link to the SceneModePicker.css stylesheet,
-     * // and in the body, include: <div id="sceneModePickerContainer"></div>
-     * // Note: This code assumed you already have a Scene instance.
+     * // and in the body, include: <div id="sceneModePickerContainer"></div>
+     * // Note: This code assumes you already have a Scene instance.
      *
-     * var scene = viewer.scene;
      * var sceneModePicker = new Cesium.SceneModePicker('sceneModePickerContainer', scene);
      */
     var SceneModePicker = function(container, scene, duration) {

Tools/jsdoc/cesium_template/static/javascript/cesiumDoc.js

@@ -1,7 +1,5 @@
 (function() {
 
-    SyntaxHighlighter.all();
-
     var filterType = document.getElementById('filterType');
     var classFilter = document.getElementById('ClassFilter');
     var classList = document.getElementById('ClassList');

Tools/jsdoc/cesium_template/static/javascript/prism.js

@@ -393,7 +393,7 @@ h4
     color: #A35A00;
 }
 
-h5, .container-overview .subsection-title
+h5, .container-overview .subsection-title, .details-header
 {
     font-size: 120%;
     font-weight: bold;