highcharts 6.1.1 → 6.2.0

package/es-modules/parts/Options.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -18,6 +18,11 @@ var color = H.color,
  * Handle the options                                                         *
  *****************************************************************************/
 /**
+ * Global default settings.
+ *
+ * @name Highcharts.defaultOptions
+ * @type {Highcharts.Options}
+ *//**
  * @optionparent
  */
 H.defaultOptions = {
@@ -48,8 +53,10 @@ H.defaultOptions = {
      * <pre>colors: ['#4572A7', '#AA4643', '#89A54E', '#80699B', '#3D96AE',
      *    '#DB843D', '#92A8CD', '#A47D7C', '#B5CA92']</pre>
      *
-     * @type {Array<Color>}
-     * @sample {highcharts} highcharts/chart/colors/ Assign a global color theme
+     * @sample {highcharts} highcharts/chart/colors/
+     *         Assign a global color theme
+     *
+     * @type    {Array<Highcharts.ColorString>}
      * @default ["#7cb5ec", "#434348", "#90ed7d", "#f7a35c", "#8085e9",
      *          "#f15c80", "#e4d354", "#2b908f", "#f45b5b", "#91e8e1"]
      */
@@ -59,12 +66,12 @@ H.defaultOptions = {
 
     /**
      * Styled mode only. Configuration object for adding SVG definitions for
-     * reusable elements. See [gradients, shadows and patterns](http://www.
-     * highcharts.com/docs/chart-design-and-style/gradients-shadows-and-
-     * patterns) for more information and code examples.
+     * reusable elements. See [gradients, shadows and
+     * patterns](https://www.highcharts.com/docs/chart-design-and-style/gradients-shadows-and-patterns)
+     * for more information and code examples.
      *
-     * @type {Object}
-     * @since 5.0.0
+     * @type      {*}
+     * @since     5.0.0
      * @apioption defs
      */
 
@@ -72,14 +79,31 @@ H.defaultOptions = {
      * @ignore-option
      */
     symbols: ['circle', 'diamond', 'square', 'triangle', 'triangle-down'],
+
+    /**
+     * The language object is global and it can't be set on each chart
+     * initiation. Instead, use `Highcharts.setOptions` to set it before any
+     * chart is initialized.
+     *
+     * <pre>Highcharts.setOptions({
+     *     lang: {
+     *         months: [
+     *             'Janvier', 'Février', 'Mars', 'Avril',
+     *             'Mai', 'Juin', 'Juillet', 'Août',
+     *             'Septembre', 'Octobre', 'Novembre', 'Décembre'
+     *         ],
+     *         weekdays: [
+     *             'Dimanche', 'Lundi', 'Mardi', 'Mercredi',
+     *             'Jeudi', 'Vendredi', 'Samedi'
+     *         ]
+     *     }
+     * });</pre>
+     */
     lang: {
 
         /**
          * The loading text that appears when the chart is set into the loading
          * state following a call to `chart.showLoading`.
-         *
-         * @type {String}
-         * @default Loading...
          */
         loading: 'Loading...',
 
@@ -87,10 +111,10 @@ H.defaultOptions = {
          * An array containing the months names. Corresponds to the `%B` format
          * in `Highcharts.dateFormat()`.
          *
-         * @type {Array<String>}
-         * @default [ "January" , "February" , "March" , "April" , "May" ,
-         *          "June" , "July" , "August" , "September" , "October" ,
-         *          "November" , "December"]
+         * @type    {Array<string>}
+         * @default ["January", "February", "March", "April", "May", "June",
+         *          "July", "August", "September", "October", "November",
+         *          "December"]
          */
         months: [
             'January', 'February', 'March', 'April', 'May', 'June', 'July',
@@ -101,9 +125,9 @@ H.defaultOptions = {
          * An array containing the months names in abbreviated form. Corresponds
          * to the `%b` format in `Highcharts.dateFormat()`.
          *
-         * @type {Array<String>}
-         * @default [ "Jan" , "Feb" , "Mar" , "Apr" , "May" , "Jun" ,
-         *          "Jul" , "Aug" , "Sep" , "Oct" , "Nov" , "Dec"]
+         * @type    {Array<string>}
+         * @default ["Jan", "Feb", "Mar", "Apr", "May", "Jun",
+         *          "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"]
          */
         shortMonths: [
             'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul',
@@ -113,7 +137,7 @@ H.defaultOptions = {
         /**
          * An array containing the weekday names.
          *
-         * @type {Array<String>}
+         * @type    {Array<string>}
          * @default ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday",
          *          "Friday", "Saturday"]
          */
@@ -126,10 +150,11 @@ H.defaultOptions = {
          * Short week days, starting Sunday. If not specified, Highcharts uses
          * the first three letters of the `lang.weekdays` option.
          *
-         * @type {Array<String>}
          * @sample highcharts/lang/shortweekdays/
          *         Finnish two-letter abbreviations
-         * @since 4.2.4
+         *
+         * @type      {Array<string>}
+         * @since     4.2.4
          * @apioption lang.shortWeekdays
          */
 
@@ -137,18 +162,36 @@ H.defaultOptions = {
          * What to show in a date field for invalid dates. Defaults to an empty
          * string.
          *
-         * @type {String}
-         * @since 4.1.8
-         * @product highcharts highstock
+         * @type      {string}
+         * @since     4.1.8
+         * @product   highcharts highstock
          * @apioption lang.invalidDate
          */
 
+        /**
+         * The title appearing on hovering the zoom in button. The text itself
+         * defaults to "+" and can be changed in the button options.
+         *
+         * @type      {string}
+         * @default   Zoom in
+         * @product   highmaps
+         * @apioption lang.zoomIn
+         */
+
+        /**
+         * The title appearing on hovering the zoom out button. The text itself
+         * defaults to "-" and can be changed in the button options.
+         *
+         * @type      {string}
+         * @default   Zoom out
+         * @product   highmaps
+         * @apioption lang.zoomOut
+         */
+
         /**
          * The default decimal point used in the `Highcharts.numberFormat`
          * method unless otherwise specified in the function arguments.
          *
-         * @type {String}
-         * @default .
          * @since 1.2.2
          */
         decimalPoint: '.',
@@ -159,13 +202,14 @@ H.defaultOptions = {
          * positions with `null` causes the full number to be written. Setting
          * `numericSymbols` to `null` disables shortening altogether.
          *
-         * @type {Array<String>}
          * @sample {highcharts} highcharts/lang/numericsymbols/
          *         Replacing the symbols with text
          * @sample {highstock} highcharts/lang/numericsymbols/
          *         Replacing the symbols with text
-         * @default [ "k" , "M" , "G" , "T" , "P" , "E"]
-         * @since 2.3.0
+         *
+         * @type    {Array<string>}
+         * @default ["k", "M", "G", "T", "P", "E"]
+         * @since   2.3.0
          */
         numericSymbols: ['k', 'M', 'G', 'T', 'P', 'E'],
 
@@ -174,19 +218,18 @@ H.defaultOptions = {
          * Use 10000 for Japanese, Korean and various Chinese locales, which
          * use symbols for 10^4, 10^8 and 10^12.
          *
-         * @type {Number}
          * @sample highcharts/lang/numericsymbolmagnitude/
          *         10000 magnitude for Japanese
-         * @default 1000
-         * @since 5.0.3
+         *
+         * @type      {number}
+         * @default   1000
+         * @since     5.0.3
          * @apioption lang.numericSymbolMagnitude
          */
 
         /**
          * The text for the label appearing when a chart is zoomed.
          *
-         * @type {String}
-         * @default Reset zoom
          * @since 1.2.4
          */
         resetZoom: 'Reset zoom',
@@ -194,8 +237,6 @@ H.defaultOptions = {
         /**
          * The tooltip title for the label appearing when a chart is zoomed.
          *
-         * @type {String}
-         * @default Reset zoom level 1:1
          * @since 1.2.4
          */
         resetZoomTitle: 'Reset zoom level 1:1',
@@ -209,9 +250,8 @@ H.defaultOptions = {
          *
          * The default is a single space.
          *
-         * @type {String}
-         * @default
-         * @since 1.2.2
+         * @default \u0020
+         * @since   1.2.2
          */
         thousandsSep: ' '
     },
@@ -240,10 +280,11 @@ H.defaultOptions = {
      * our site, you can install canvas-tools.js on your own server and
      * change this option accordingly.
      *
-     * @type {String}
      * @deprecated
-     * @default http://code.highcharts.com/{version}/modules/canvas-tools.js
-     * @product highcharts highmaps
+     *
+     * @type      {string}
+     * @default   http://code.highcharts.com/{version}/modules/canvas-tools.js
+     * @product   highcharts highmaps
      * @apioption global.canvasToolsURL
      */
 
@@ -253,7 +294,8 @@ H.defaultOptions = {
      * per chart.
      *
      * @deprecated
-     * @type {Boolean}
+     *
+     * @type      {boolean}
      * @apioption global.useUTC
      */
 
@@ -263,8 +305,9 @@ H.defaultOptions = {
      * per chart.
      *
      * @deprecated
-     * @type {Object}
-     * @product highcharts highstock
+     *
+     * @type      {Function}
+     * @product   highcharts highstock
      * @apioption global.Date
      */
 
@@ -274,8 +317,9 @@ H.defaultOptions = {
      * individual time settings per chart.
      *
      * @deprecated
-     * @type {Function}
-     * @product highcharts highstock
+     *
+     * @type      {Function}
+     * @product   highcharts highstock
      * @apioption global.getTimezoneOffset
      */
 
@@ -285,8 +329,9 @@ H.defaultOptions = {
      * settings per chart.
      *
      * @deprecated
-     * @type {String}
-     * @product highcharts highstock
+     *
+     * @type      {string}
+     * @product   highcharts highstock
      * @apioption global.timezone
      */
 
@@ -296,21 +341,44 @@ H.defaultOptions = {
      * time settings per chart.
      *
      * @deprecated
-     * @type {Number}
-     * @product highcharts highstock
+     *
+     * @type      {number}
+     * @product   highcharts highstock
      * @apioption global.timezoneOffset
      */
-    global: {},
 
+    global: {},
 
     time: H.Time.prototype.defaultOptions,
 
     /**
      * General options for the chart.
-     * @type {Object}
      */
     chart: {
 
+        /**
+         * Default `mapData` for all series. If set to a string, it functions
+         * as an index into the `Highcharts.maps` array. Otherwise it is
+         * interpreted s map data.
+         *
+         * @see [mapData](#series.map.mapData)
+         *
+         * @type      {string|Array<*>}
+         * @since     5.0.0
+         * @product   highmaps
+         * @apioption chart.map
+         */
+
+        /**
+         * Set lat/lon transformation definitions for the chart. If not defined,
+         * these are extracted from the map data.
+         *
+         * @type      {*}
+         * @since     5.0.0
+         * @product   highmaps
+         * @apioption chart.mapTransforms
+         */
+
         /**
          * When using multiple axis, the ticks of two or more opposite axes
          * will automatically be aligned by adding ticks to the axis or axes
@@ -325,21 +393,21 @@ H.defaultOptions = {
          *
          * Disabled for logarithmic axes.
          *
-         * @type      {Boolean}
-         * @sample    {highcharts} highcharts/chart/alignticks-true/
-         *            True by default
-         * @sample    {highcharts} highcharts/chart/alignticks-false/
-         *            False
-         * @sample    {highstock} stock/chart/alignticks-true/
-         *            True by default
-         * @sample    {highstock} stock/chart/alignticks-false/
-         *            False
+         * @sample {highcharts} highcharts/chart/alignticks-true/
+         *         True by default
+         * @sample {highcharts} highcharts/chart/alignticks-false/
+         *         False
+         * @sample {highstock} stock/chart/alignticks-true/
+         *         True by default
+         * @sample {highstock} stock/chart/alignticks-false/
+         *         False
+         *
+         * @type      {boolean}
          * @default   true
-         * @product   highcharts highstock
+         * @product   highcharts highstock gantt
          * @apioption chart.alignTicks
          */
 
-
         /**
          * Set the overall animation for all chart updating. Animation can be
          * disabled throughout the chart by setting it to false here. It can
@@ -362,13 +430,12 @@ H.defaultOptions = {
          * <dt>easing</dt>
          *
          * <dd>A string reference to an easing function set on the `Math`
-         * object. See [the easing demo](
-         * http://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/plotoptions/series-animation-easing/).
+         * object. See [the easing
+         * demo](https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/plotoptions/series-animation-easing/).
          * </dd>
          *
          * </dl>
          *
-         * @type {Boolean|Object}
          * @sample {highcharts} highcharts/chart/animation-none/
          *         Updating with no animation
          * @sample {highcharts} highcharts/chart/animation-duration/
@@ -379,7 +446,9 @@ H.defaultOptions = {
          *         Updating with no animation
          * @sample {highmaps} maps/chart/animation-duration/
          *         With a longer duration
-         * @default true
+         *
+         * @type      {boolean|Highcharts.AnimationOptionsObject}
+         * @default   true
          * @apioption chart.animation
          */
 
@@ -387,7 +456,7 @@ H.defaultOptions = {
          * A CSS class name to apply to the charts container `div`, allowing
          * unique CSS styling for each chart.
          *
-         * @type {String}
+         * @type      {string}
          * @apioption chart.className
          */
 
@@ -405,11 +474,14 @@ H.defaultOptions = {
          * passed to the `addSeries` method. Returning false prevents the series
          * from being added.
          *
-         * @type {Function}
-         * @context Chart
-         * @sample {highcharts} highcharts/chart/events-addseries/ Alert on add series
-         * @sample {highstock} stock/chart/events-addseries/ Alert on add series
-         * @since 1.2.0
+         * @sample {highcharts} highcharts/chart/events-addseries/
+         *         Alert on add series
+         * @sample {highstock} stock/chart/events-addseries/
+         *         Alert on add series
+         *
+         * @type      {Function}
+         * @since     1.2.0
+         * @context   Highcharts.Chart
          * @apioption chart.events.addSeries
          */
 
@@ -430,8 +502,6 @@ H.defaultOptions = {
          *     )
          * }</pre>
          *
-         * @type {Function}
-         * @context Chart
          * @sample {highcharts} highcharts/chart/events-click/
          *         Alert coordinates on click
          * @sample {highcharts} highcharts/chart/events-container/
@@ -444,7 +514,10 @@ H.defaultOptions = {
          *         Record coordinates on click
          * @sample {highmaps} highcharts/chart/events-container/
          *         Alternatively, attach event to container
-         * @since 1.2.0
+         *
+         * @type      {Function}
+         * @since     1.2.0
+         * @context   Highcharts.Chart
          * @apioption chart.events.click
          */
 
@@ -458,14 +531,15 @@ H.defaultOptions = {
          * There is also a second parameter to the chart constructor where a
          * callback function can be passed to be executed on chart.load.
          *
-         * @type {Function}
-         * @context Chart
          * @sample {highcharts} highcharts/chart/events-load/
          *         Alert on chart load
          * @sample {highstock} stock/chart/events-load/
          *         Alert on chart load
          * @sample {highmaps} maps/chart/events-load/
          *         Add series on chart load
+         *
+         * @type      {Function}
+         * @context   Highcharts.Chart
          * @apioption chart.events.load
          */
 
@@ -475,8 +549,6 @@ H.defaultOptions = {
          * the `redraw` option set to true. One parameter, `event`, is passed to
          * the function, containing common event information.
          *
-         * @type {Function}
-         * @context Chart
          * @sample {highcharts} highcharts/chart/events-redraw/
          *         Alert on chart redraw
          * @sample {highstock} stock/chart/events-redraw/
@@ -484,7 +556,10 @@ H.defaultOptions = {
          *         zoomed range
          * @sample {highmaps} maps/chart/events-redraw/
          *         Set subtitle on chart redraw
-         * @since 1.2.0
+         *
+         * @type      {Function}
+         * @since     1.2.0
+         * @context   Highcharts.Chart
          * @apioption chart.events.redraw
          */
 
@@ -492,9 +567,9 @@ H.defaultOptions = {
          * Fires after initial load of the chart (directly after the `load`
          * event), and after each redraw (directly after the `redraw` event).
          *
-         * @type {Function}
-         * @context Chart
-         * @since 5.0.7
+         * @type      {Function}
+         * @since     5.0.7
+         * @context   Highcharts.Chart
          * @apioption chart.events.render
          */
 
@@ -528,7 +603,6 @@ H.defaultOptions = {
          *     console.log(event.yAxis[0].min, event.yAxis[0].max);
          * }</pre>
          *
-         * @type {Function}
          * @sample {highcharts} highcharts/chart/events-selection/
          *         Report on selection and reset
          * @sample {highcharts} highcharts/chart/events-selection-points/
@@ -538,6 +612,8 @@ H.defaultOptions = {
          * @sample {highstock} highcharts/chart/events-selection-points/
          *         Select a range of points through a drag selection
          *         (Highcharts)
+         *
+         * @type      {Function}
          * @apioption chart.events.selection
          */
 
@@ -552,13 +628,12 @@ H.defaultOptions = {
          * subtitle and legend in addition to the `spacingTop`, `spacingRight`,
          * `spacingBottom` and `spacingLeft` options.
          *
-         * @type {Array}
          * @sample {highcharts} highcharts/chart/margins-zero/
          *         Zero margins
          * @sample {highstock} stock/chart/margin-zero/
          *         Zero margins
          *
-         * @defaults {all} null
+         * @type      {number|Array<number>}
          * @apioption chart.margin
          */
 
@@ -567,14 +642,15 @@ H.defaultOptions = {
          * area. Use this to set a fixed pixel value for the margin as opposed
          * to the default dynamic margin. See also `spacingBottom`.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/chart/marginbottom/
          *         100px bottom margin
          * @sample {highstock} stock/chart/marginbottom/
          *         100px bottom margin
          * @sample {highmaps} maps/chart/margin/
          *         100px margins
-         * @since 2.0
+         *
+         * @type      {number}
+         * @since     2.0
          * @apioption chart.marginBottom
          */
 
@@ -583,15 +659,15 @@ H.defaultOptions = {
          * area. Use this to set a fixed pixel value for the margin as opposed
          * to the default dynamic margin. See also `spacingLeft`.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/chart/marginleft/
          *         150px left margin
          * @sample {highstock} stock/chart/marginleft/
          *         150px left margin
          * @sample {highmaps} maps/chart/margin/
          *         100px margins
-         * @default null
-         * @since 2.0
+         *
+         * @type      {number}
+         * @since     2.0
          * @apioption chart.marginLeft
          */
 
@@ -600,15 +676,15 @@ H.defaultOptions = {
          * area. Use this to set a fixed pixel value for the margin as opposed
          * to the default dynamic margin. See also `spacingRight`.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/chart/marginright/
          *         100px right margin
          * @sample {highstock} stock/chart/marginright/
          *         100px right margin
          * @sample {highmaps} maps/chart/margin/
          *         100px margins
-         * @default null
-         * @since 2.0
+         *
+         * @type      {number}
+         * @since     2.0
          * @apioption chart.marginRight
          */
 
@@ -617,14 +693,14 @@ H.defaultOptions = {
          * Use this to set a fixed pixel value for the margin as opposed to
          * the default dynamic margin. See also `spacingTop`.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/chart/margintop/ 100px top margin
          * @sample {highstock} stock/chart/margintop/
          *         100px top margin
          * @sample {highmaps} maps/chart/margin/
          *         100px margins
-         * @default null
-         * @since 2.0
+         *
+         * @type      {number}
+         * @since     2.0
          * @apioption chart.marginTop
          */
 
@@ -635,11 +711,11 @@ H.defaultOptions = {
          * properties of the click event argument (`event.altKey`,
          * `event.ctrlKey`, `event.metaKey` and `event.shiftKey`).
          *
-         * @validvalue [null, "alt", "ctrl", "meta", "shift"]
-         * @type {String}
-         * @since 4.0.3
-         * @product highcharts
-         * @apioption chart.panKey
+         * @type       {string}
+         * @since      4.0.3
+         * @product    highcharts gantt
+         * @validvalue ["alt", "ctrl", "meta", "shift"]
+         * @apioption  chart.panKey
          */
 
         /**
@@ -651,12 +727,13 @@ H.defaultOptions = {
          * requires two fingers. To allow panning with one finger, set
          * `followTouchMove` to `false`.
          *
-         * @type {Boolean}
          * @sample {highcharts} highcharts/chart/pankey/ Zooming and panning
-         * @default {highcharts} false
-         * @default {highstock} true
-         * @since 4.0.3
-         * @product highcharts highstock
+         *
+         * @type      {boolean}
+         * @default   {highcharts} false
+         * @default   {highstock} true
+         * @since     4.0.3
+         * @product   highcharts highstock gantt
          * @apioption chart.panning
          */
 
@@ -670,35 +747,38 @@ H.defaultOptions = {
          * #tooltip.followTouchMove) is true, pinchType only applies to
          * two-finger touches.
          *
-         * @validvalue [null, "x", "y", "xy"]
-         * @type {String}
-         * @default {highcharts} null
-         * @default {highstock} x
-         * @since 3.0
-         * @product highcharts highstock
-         * @apioption chart.pinchType
+         * @type       {string}
+         * @default    {highcharts} undefined
+         * @default    {highstock} x
+         * @since      3.0
+         * @product    highcharts highstock gantt
+         * @validvalue ["x", "y", "xy"]
+         * @apioption  chart.pinchType
          */
 
         /**
          * The corner radius of the outer chart border.
          *
-         * @type {Number}
-         * @sample {highcharts} highcharts/chart/borderradius/ 20px radius
-         * @sample {highstock} stock/chart/border/ 10px radius
-         * @sample {highmaps} maps/chart/border/ Border options
-         * @default 0
+         * @sample {highcharts} highcharts/chart/borderradius/
+         *         20px radius
+         * @sample {highstock} stock/chart/border/
+         *         10px radius
+         * @sample {highmaps} maps/chart/border/
+         *         Border options
+         *
          */
         borderRadius: 0,
+
         
 
         /**
          * Alias of `type`.
          *
-         * @validvalue ["line", "spline", "column", "area", "areaspline", "pie"]
-         * @type {String}
+         * @sample {highcharts} highcharts/chart/defaultseriestype/
+         *         Bar
+         *
          * @deprecated
-         * @sample {highcharts} highcharts/chart/defaultseriestype/ Bar
-         * @default line
+         *
          * @product highcharts
          */
         defaultSeriesType: 'line',
@@ -710,7 +790,6 @@ H.defaultOptions = {
          * within the stack is hidden, the rest of the stack will close in
          * around it even if the axis is not affected.
          *
-         * @type {Boolean}
          * @sample {highcharts} highcharts/chart/ignorehiddenseries-true/
          *         True by default
          * @sample {highcharts} highcharts/chart/ignorehiddenseries-false/
@@ -721,9 +800,9 @@ H.defaultOptions = {
          *         True by default
          * @sample {highstock} stock/chart/ignorehiddenseries-false/
          *         False
-         * @default true
-         * @since 1.2.0
-         * @product highcharts highstock
+         *
+         * @since   1.2.0
+         * @product highcharts highstock gantt
          */
         ignoreHiddenSeries: true,
 
@@ -739,13 +818,14 @@ H.defaultOptions = {
          * are no cartesian series in the chart, or if the chart is
          * [polar](#chart.polar).
          *
-         * @type {Boolean}
          * @sample {highcharts} highcharts/chart/inverted/
          *         Inverted line
          * @sample {highstock} stock/navigator/inverted/
          *         Inverted stock chart
-         * @default false
-         * @product highcharts highstock
+         *
+         * @type      {boolean}
+         * @default   false
+         * @product   highcharts highstock gantt
          * @apioption chart.inverted
          */
 
@@ -756,17 +836,16 @@ H.defaultOptions = {
          * respectively. Use the options spacingTop, spacingRight, spacingBottom
          * and spacingLeft options for shorthand setting of one option.
          *
-         * @type {Array<Number>}
-         * @see [chart.margin](#chart.margin)
+         * @type    {Array<number>}
+         * @see     [chart.margin](#chart.margin)
          * @default [10, 10, 15, 10]
-         * @since 3.0.6
+         * @since   3.0.6
          */
         spacing: [10, 10, 15, 10],
 
         /**
          * The button that appears after a selection zoom, allowing the user
          * to reset zoom.
-         *
          */
         resetZoomButton: {
 
@@ -774,15 +853,16 @@ H.defaultOptions = {
              * What frame the button should be placed related to. Can be either
              * `plot` or `chart`
              *
-             * @validvalue ["plot", "chart"]
-             * @type {String}
              * @sample {highcharts} highcharts/chart/resetzoombutton-relativeto/
              *         Relative to the chart
              * @sample {highstock} highcharts/chart/resetzoombutton-relativeto/
              *         Relative to the chart
-             * @default plot
-             * @since 2.2
-             * @apioption chart.resetZoomButton.relativeTo
+             *
+             * @type       {string}
+             * @default    plot
+             * @since      2.2
+             * @validvalue ["plot", "chart"]
+             * @apioption  chart.resetZoomButton.relativeTo
              */
 
             /**
@@ -792,11 +872,11 @@ H.defaultOptions = {
              * CSS properties for the text. Equivalent attributes for the hover
              * state are given in `theme.states.hover`.
              *
-             * @type {Object}
              * @sample {highcharts} highcharts/chart/resetzoombutton-theme/
              *         Theming the button
              * @sample {highstock} highcharts/chart/resetzoombutton-theme/
              *         Theming the button
+             *
              * @since 2.2
              */
             theme: {
@@ -811,44 +891,38 @@ H.defaultOptions = {
             /**
              * The position of the button.
              *
-             * @type {Object}
              * @sample {highcharts} highcharts/chart/resetzoombutton-position/
              *         Above the plot area
              * @sample {highstock} highcharts/chart/resetzoombutton-position/
              *         Above the plot area
              * @sample {highmaps} highcharts/chart/resetzoombutton-position/
              *         Above the plot area
+             *
              * @since 2.2
              */
             position: {
 
                 /**
                  * The horizontal alignment of the button.
-                 *
-                 * @type {String}
                  */
                 align: 'right',
 
                 /**
                  * The horizontal offset of the button.
-                 *
-                 * @type {Number}
                  */
                 x: -10,
 
                 /**
                  * The vertical alignment of the button.
                  *
+                 * @type       {string}
+                 * @default    top
                  * @validvalue ["top", "middle", "bottom"]
-                 * @type {String}
-                 * @default top
-                 * @apioption chart.resetZoomButton.position.verticalAlign
+                 * @apioption  chart.resetZoomButton.position.verticalAlign
                  */
 
                 /**
                  * The vertical offset of the button.
-                 *
-                 * @type {Number}
                  */
                 y: 10
             }
@@ -857,13 +931,15 @@ H.defaultOptions = {
         /**
          * The pixel width of the plot area border.
          *
-         * @type {Number}
-         * @sample {highcharts} highcharts/chart/plotborderwidth/ 1px border
+         * @sample {highcharts} highcharts/chart/plotborderwidth/
+         *         1px border
          * @sample {highstock} stock/chart/plotborder/
          *         2px border
          * @sample {highmaps} maps/chart/plotborder/
          *         Plot border options
-         * @default 0
+         *
+         * @type      {number}
+         * @default   0
          * @apioption chart.plotBorderWidth
          */
 
@@ -872,13 +948,15 @@ H.defaultOptions = {
          * plotBackgroundColor be set. The shadow can be an object configuration
          * containing `color`, `offsetX`, `offsetY`, `opacity` and `width`.
          *
-         * @type {Boolean|Object}
-         * @sample {highcharts} highcharts/chart/plotshadow/ Plot shadow
+         * @sample {highcharts} highcharts/chart/plotshadow/
+         *         Plot shadow
          * @sample {highstock} stock/chart/plotshadow/
          *         Plot shadow
          * @sample {highmaps} maps/chart/plotborder/
          *         Plot border options
-         * @default false
+         *
+         * @type      {boolean|Highcharts.CSSObject}
+         * @default   false
          * @apioption chart.plotShadow
          */
 
@@ -896,10 +974,10 @@ H.defaultOptions = {
          * @sample {highcharts} highcharts/parallel-coordinates/polar/
          *         Star plot, multivariate data in a polar chart
          *
-         * @type {Boolean}
-         * @default false
-         * @since 2.3.0
-         * @product highcharts
+         * @type      {boolean}
+         * @default   false
+         * @since     2.3.0
+         * @product   highcharts
          * @apioption chart.polar
          */
 
@@ -907,9 +985,10 @@ H.defaultOptions = {
          * Whether to reflow the chart to fit the width of the container div
          * on resizing the window.
          *
-         * @type {Boolean}
-         * @sample {highcharts} highcharts/chart/reflow-true/ True by default
-         * @sample {highcharts} highcharts/chart/reflow-false/ False
+         * @sample {highcharts} highcharts/chart/reflow-true/
+         *         True by default
+         * @sample {highcharts} highcharts/chart/reflow-false/
+         *         False
          * @sample {highstock} stock/chart/reflow-true/
          *         True by default
          * @sample {highstock} stock/chart/reflow-false/
@@ -918,8 +997,10 @@ H.defaultOptions = {
          *         True by default
          * @sample {highmaps} maps/chart/reflow-false/
          *         False
-         * @default true
-         * @since 2.1
+         *
+         * @type      {boolean}
+         * @default   true
+         * @since     2.1
          * @apioption chart.reflow
          */
 
@@ -929,7 +1010,6 @@ H.defaultOptions = {
          * by direct reference, or as the first argument of the chart
          * constructor, in which case the option is not needed.
          *
-         * @type {String|Object}
          * @sample {highcharts} highcharts/chart/reflow-true/
          *         String
          * @sample {highcharts} highcharts/chart/renderto-object/
@@ -942,6 +1022,8 @@ H.defaultOptions = {
          *         Object reference
          * @sample {highstock} stock/chart/renderto-jquery/
          *         Object reference through jQuery
+         *
+         * @type      {string|Highcharts.SVGDOMElement}
          * @apioption chart.renderTo
          */
 
@@ -949,11 +1031,12 @@ H.defaultOptions = {
          * The background color of the marker square when selecting (zooming
          * in on) an area of the chart.
          *
-         * @type {Color}
          * @see In styled mode, the selection marker fill is set with the
-         * `.highcharts-selection-marker` class.
-         * @default rgba(51,92,173,0.25)
-         * @since 2.1.7
+         *      `.highcharts-selection-marker` class.
+         *
+         * @type      {Highcharts.ColorString}
+         * @default   rgba(51,92,173,0.25)
+         * @since     2.1.7
          * @apioption chart.selectionMarkerFill
          */
 
@@ -963,13 +1046,15 @@ H.defaultOptions = {
          * configuration containing `color`, `offsetX`, `offsetY`, `opacity` and
          * `width`.
          *
-         * @type {Boolean|Object}
-         * @sample {highcharts} highcharts/chart/shadow/ Shadow
+         * @sample {highcharts} highcharts/chart/shadow/
+         *         Shadow
          * @sample {highstock} stock/chart/shadow/
          *         Shadow
          * @sample {highmaps} maps/chart/border/
          *         Chart border and shadow
-         * @default false
+         *
+         * @type      {boolean|Highcharts.CSSObject}
+         * @default   false
          * @apioption chart.shadow
          */
 
@@ -978,11 +1063,14 @@ H.defaultOptions = {
          * where series are added dynamically, as axes are automatically added
          * to cartesian series.
          *
-         * @type {Boolean}
-         * @sample {highcharts} highcharts/chart/showaxes-false/ False by default
-         * @sample {highcharts} highcharts/chart/showaxes-true/ True
-         * @since 1.2.5
-         * @product highcharts
+         * @sample {highcharts} highcharts/chart/showaxes-false/
+         *         False by default
+         * @sample {highcharts} highcharts/chart/showaxes-true/
+         *         True
+         *
+         * @type      {boolean}
+         * @since     1.2.5
+         * @product   highcharts gantt
          * @apioption chart.showAxes
          */
 
@@ -991,15 +1079,16 @@ H.defaultOptions = {
          * area, axis title and labels, title, subtitle or legend in top
          * position).
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/chart/spacingbottom/
          *         Spacing bottom set to 100
          * @sample {highstock} stock/chart/spacingbottom/
          *         Spacing bottom set to 100
          * @sample {highmaps} maps/chart/spacing/
          *         Spacing 100 all around
-         * @default 15
-         * @since 2.1
+         *
+         * @type      {number}
+         * @default   15
+         * @since     2.1
          * @apioption chart.spacingBottom
          */
 
@@ -1008,15 +1097,16 @@ H.defaultOptions = {
          * area, axis title and labels, title, subtitle or legend in top
          * position).
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/chart/spacingleft/
          *         Spacing left set to 100
          * @sample {highstock} stock/chart/spacingleft/
          *         Spacing left set to 100
          * @sample {highmaps} maps/chart/spacing/
          *         Spacing 100 all around
-         * @default 10
-         * @since 2.1
+         *
+         * @type      {number}
+         * @default   10
+         * @since     2.1
          * @apioption chart.spacingLeft
          */
 
@@ -1025,7 +1115,6 @@ H.defaultOptions = {
          * area, axis title and labels, title, subtitle or legend in top
          * position).
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/chart/spacingright-100/
          *         Spacing set to 100
          * @sample {highcharts} highcharts/chart/spacingright-legend/
@@ -1034,8 +1123,10 @@ H.defaultOptions = {
          *         Spacing set to 100
          * @sample {highmaps} maps/chart/spacing/
          *         Spacing 100 all around
-         * @default 10
-         * @since 2.1
+         *
+         * @type      {number}
+         * @default   10
+         * @since     2.1
          * @apioption chart.spacingRight
          */
 
@@ -1044,7 +1135,6 @@ H.defaultOptions = {
          * area, axis title and labels, title, subtitle or legend in top
          * position).
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/chart/spacingtop-100/
          *         A top spacing of 100
          * @sample {highcharts} highcharts/chart/spacingtop-10/
@@ -1054,8 +1144,10 @@ H.defaultOptions = {
          *         A top spacing of 100
          * @sample {highmaps} maps/chart/spacing/
          *         Spacing 100 all around
-         * @default 10
-         * @since 2.1
+         *
+         * @type      {number}
+         * @default   10
+         * @since     2.1
          * @apioption chart.spacingTop
          */
 
@@ -1064,7 +1156,6 @@ H.defaultOptions = {
          * that since the default font styles are applied in the renderer, it
          * is ignorant of the individual chart options and must be set globally.
          *
-         * @type {CSSObject}
          * @see    In styled mode, general chart styles can be set with the
          *         `.highcharts-root` class.
          * @sample {highcharts} highcharts/chart/style-serif-font/
@@ -1075,7 +1166,9 @@ H.defaultOptions = {
          *         Using a serif type font
          * @sample {highmaps} maps/chart/style-serif-font/
          *         Using a serif type font
-         * @default {"fontFamily":"\"Lucida Grande\", \"Lucida Sans Unicode\", Verdana, Arial, Helvetica, sans-serif","fontSize":"12px"}
+         *
+         * @type      {Highcharts.CSSObject}
+         * @default   {"fontFamily": "\"Lucida Grande\", \"Lucida Sans Unicode\", Verdana, Arial, Helvetica, sans-serif","fontSize":"12px"}
          * @apioption chart.style
          */
 
@@ -1083,49 +1176,67 @@ H.defaultOptions = {
          * The default series type for the chart. Can be any of the chart types
          * listed under [plotOptions](#plotOptions).
          *
-         * @validvalue ["line", "spline", "column", "bar", "area", "areaspline", "pie", "arearange", "areasplinerange", "boxplot", "bubble", "columnrange", "errorbar", "funnel", "gauge", "heatmap", "polygon", "pyramid", "scatter", "solidgauge", "treemap", "waterfall"]
-         * @type {String}
-         * @sample {highcharts} highcharts/chart/type-bar/ Bar
+         * @sample {highcharts} highcharts/chart/type-bar/
+         *         Bar
          * @sample {highstock} stock/chart/type/
          *         Areaspline
          * @sample {highmaps} maps/chart/type-mapline/
          *         Mapline
-         * @default {highcharts} line
-         * @default {highstock} line
-         * @default {highmaps} map
-         * @since 2.1.0
-         * @apioption chart.type
+         *
+         * @type       {string}
+         * @default    {highcharts} line
+         * @default    {highstock} line
+         * @default    {highmaps} map
+         * @since      2.1.0
+         * @validvalue ["line", "spline", "column", "bar", "area", "areaspline",
+         *             "pie", "arearange", "areasplinerange", "boxplot",
+         *             "bubble", "columnrange", "errorbar", "funnel", "gauge",
+         *             "heatmap", "polygon", "pyramid", "scatter", "solidgauge",
+         *             "treemap", "waterfall"]
+         * @apioption  chart.type
          */
 
         /**
          * Decides in what dimensions the user can zoom by dragging the mouse.
          * Can be one of `x`, `y` or `xy`.
          *
-         * @validvalue [null, "x", "y", "xy"]
-         * @type {String}
          * @see [panKey](#chart.panKey)
-         * @default  null
-         * @sample {highcharts} highcharts/chart/zoomtype-none/ None by default
-         * @sample {highcharts} highcharts/chart/zoomtype-x/ X
-         * @sample {highcharts} highcharts/chart/zoomtype-y/ Y
-         * @sample {highcharts} highcharts/chart/zoomtype-xy/ Xy
-         * @sample {highstock} stock/demo/basic-line/ None by default
-         * @sample {highstock} stock/chart/zoomtype-x/ X
-         * @sample {highstock} stock/chart/zoomtype-y/ Y
-         * @sample {highstock} stock/chart/zoomtype-xy/ Xy
-         * @product highcharts highstock
-         * @apioption chart.zoomType
+         *
+         * @sample {highcharts} highcharts/chart/zoomtype-none/
+         *         None by default
+         * @sample {highcharts} highcharts/chart/zoomtype-x/
+         *         X
+         * @sample {highcharts} highcharts/chart/zoomtype-y/
+         *         Y
+         * @sample {highcharts} highcharts/chart/zoomtype-xy/
+         *         Xy
+         * @sample {highstock} stock/demo/basic-line/
+         *         None by default
+         * @sample {highstock} stock/chart/zoomtype-x/
+         *         X
+         * @sample {highstock} stock/chart/zoomtype-y/
+         *         Y
+         * @sample {highstock} stock/chart/zoomtype-xy/
+         *         Xy
+         *
+         * @type       {string}
+         * @product    highcharts highstock gantt
+         * @validvalue ["x", "y", "xy"]
+         * @apioption  chart.zoomType
          */
 
         /**
          * An explicit width for the chart. By default (when `null`) the width
          * is calculated from the offset width of the containing element.
          *
-         * @type {Number}
-         * @sample {highcharts} highcharts/chart/width/ 800px wide
-         * @sample {highstock} stock/chart/width/ 800px wide
-         * @sample {highmaps} maps/chart/size/ Chart with explicit size
-         * @default null
+         * @sample {highcharts} highcharts/chart/width/
+         *         800px wide
+         * @sample {highstock} stock/chart/width/
+         *         800px wide
+         * @sample {highmaps} maps/chart/size/
+         *         Chart with explicit size
+         *
+         * @type {number|null}
          */
         width: null,
 
@@ -1140,7 +1251,6 @@ H.defaultOptions = {
          * height of the containing element, or 400 pixels if the containing
          * element's height is 0.
          *
-         * @type {Number|String}
          * @sample {highcharts} highcharts/chart/height/
          *         500px height
          * @sample {highstock} stock/chart/height/
@@ -1149,7 +1259,8 @@ H.defaultOptions = {
          *         Chart with explicit size
          * @sample highcharts/chart/height-percent/
          *         Highcharts with percentage height
-         * @default null
+         *
+         * @type {number|string|null}
          */
         height: null,
 
@@ -1158,39 +1269,48 @@ H.defaultOptions = {
         /**
          * The color of the outer chart border.
          *
-         * @type {Color}
-         * @see    In styled mode, the stroke is set with the
-         *         `.highcharts-background` class.
-         * @sample {highcharts} highcharts/chart/bordercolor/ Brown border
-         * @sample {highstock} stock/chart/border/ Brown border
-         * @sample {highmaps} maps/chart/border/ Border options
-         * @default #335cad
+         * @see In styled mode, the stroke is set with the
+         *      `.highcharts-background` class.
+         *
+         * @sample {highcharts} highcharts/chart/bordercolor/
+         *         Brown border
+         * @sample {highstock} stock/chart/border/
+         *         Brown border
+         * @sample {highmaps} maps/chart/border/
+         *         Border options
+         *
+         * @type {Highcharts.ColorString}
          */
         borderColor: '#335cad',
 
         /**
          * The pixel width of the outer chart border.
          *
-         * @type {Number}
-         * @see    In styled mode, the stroke is set with the
-         *         `.highcharts-background` class.
-         * @sample {highcharts} highcharts/chart/borderwidth/ 5px border
+         * @see In styled mode, the stroke is set with the
+         *      `.highcharts-background` class.
+         *
+         * @sample {highcharts} highcharts/chart/borderwidth/
+         *         5px border
          * @sample {highstock} stock/chart/border/
          *         2px border
          * @sample {highmaps} maps/chart/border/
          *         Border options
-         * @default 0
+         *
+         * @type      {number}
+         * @default   0
          * @apioption chart.borderWidth
          */
 
         /**
          * The background color or gradient for the outer chart area.
          *
-         * @type {Color}
-         * @see    In styled mode, the background is set with the
-         *         `.highcharts-background` class.
-         * @sample {highcharts} highcharts/chart/backgroundcolor-color/ Color
-         * @sample {highcharts} highcharts/chart/backgroundcolor-gradient/ Gradient
+         * @see In styled mode, the background is set with the
+         *      `.highcharts-background` class.
+         *
+         * @sample {highcharts} highcharts/chart/backgroundcolor-color/
+         *         Color
+         * @sample {highcharts} highcharts/chart/backgroundcolor-gradient/
+         *         Gradient
          * @sample {highstock} stock/chart/backgroundcolor-color/
          *         Color
          * @sample {highstock} stock/chart/backgroundcolor-gradient/
@@ -1199,16 +1319,17 @@ H.defaultOptions = {
          *         Color
          * @sample {highmaps} maps/chart/backgroundcolor-gradient/
          *         Gradient
-         * @default #FFFFFF
+         *
+         * @type {Highcharts.ColorString}
          */
         backgroundColor: '#ffffff',
 
         /**
          * The background color or gradient for the plot area.
          *
-         * @type {Color}
-         * @see    In styled mode, the plot background is set with the
-         *         `.highcharts-plot-background` class.
+         * @see In styled mode, the plot background is set with the
+         *      `.highcharts-plot-background` class.
+         *
          * @sample {highcharts} highcharts/chart/plotbackgroundcolor-color/
          *         Color
          * @sample {highcharts} highcharts/chart/plotbackgroundcolor-gradient/
@@ -1221,40 +1342,48 @@ H.defaultOptions = {
          *         Color
          * @sample {highmaps} maps/chart/plotbackgroundcolor-gradient/
          *         Gradient
-         * @default null
+         *
+         * @type      {Highcharts.ColorString}
          * @apioption chart.plotBackgroundColor
          */
 
-
         /**
          * The URL for an image to use as the plot background. To set an image
          * as the background for the entire chart, set a CSS background image
          * to the container element. Note that for the image to be applied to
          * exported charts, its URL needs to be accessible by the export server.
          *
-         * @type {String}
          * @see In styled mode, a plot background image can be set with the
-         * `.highcharts-plot-background` class and a [custom pattern](http://www.
-         * highcharts.com/docs/chart-design-and-style/gradients-shadows-and-
-         * patterns).
-         * @sample {highcharts} highcharts/chart/plotbackgroundimage/ Skies
-         * @sample {highstock} stock/chart/plotbackgroundimage/ Skies
-         * @default null
+         *      `.highcharts-plot-background` class and a [custom pattern](
+         *      https://www.highcharts.com/docs/chart-design-and-style/
+         *      gradients-shadows-and-patterns).
+         *
+         * @sample {highcharts} highcharts/chart/plotbackgroundimage/
+         *         Skies
+         * @sample {highstock} stock/chart/plotbackgroundimage/
+         *         Skies
+         *
+         * @type      {string}
          * @apioption chart.plotBackgroundImage
          */
 
         /**
          * The color of the inner chart or plot area border.
          *
-         * @type {Color}
          * @see In styled mode, a plot border stroke can be set with the
          *      `.highcharts-plot-border` class.
-         * @sample {highcharts} highcharts/chart/plotbordercolor/ Blue border
-         * @sample {highstock} stock/chart/plotborder/ Blue border
-         * @sample {highmaps} maps/chart/plotborder/ Plot border options
-         * @default #cccccc
+         *
+         * @sample {highcharts} highcharts/chart/plotbordercolor/
+         *         Blue border
+         * @sample {highstock} stock/chart/plotborder/
+         *         Blue border
+         * @sample {highmaps} maps/chart/plotborder/
+         *         Plot border options
+         *
+         * @type {Highcharts.ColorString}
          */
         plotBorderColor: '#cccccc'
+
         
 
     },
@@ -1262,7 +1391,8 @@ H.defaultOptions = {
     /**
      * The chart's main title.
      *
-     * @sample {highmaps} maps/title/title/ Title options demonstrated
+     * @sample {highmaps} maps/title/title/
+     *         Title options demonstrated
      */
     title: {
 
@@ -1270,14 +1400,16 @@ H.defaultOptions = {
          * When the title is floating, the plot area will not move to make space
          * for it.
          *
-         * @type {Boolean}
-         * @sample {highcharts} highcharts/chart/zoomtype-none/ False by default
+         * @sample {highcharts} highcharts/chart/zoomtype-none/
+         *         False by default
          * @sample {highcharts} highcharts/title/floating/
          *         True - title on top of the plot area
          * @sample {highstock} stock/chart/title-floating/
          *         True - title on top of the plot area
-         * @default false
-         * @since 2.1
+         *
+         * @type      {boolean}
+         * @default   false
+         * @since     2.1
          * @apioption title.floating
          */
 
@@ -1288,21 +1420,26 @@ H.defaultOptions = {
          * In styled mode, the title style is given in the `.highcharts-title`
          * class.
          *
-         * @type {CSSObject}
-         * @sample {highcharts} highcharts/title/style/ Custom color and weight
-         * @sample {highstock} stock/chart/title-style/ Custom color and weight
-         * @sample highcharts/css/titles/ Styled mode
-         * @default {highcharts|highmaps} { "color": "#333333", "fontSize": "18px" }
-         * @default {highstock} { "color": "#333333", "fontSize": "16px" }
+         * @sample {highcharts} highcharts/title/style/
+         *         Custom color and weight
+         * @sample {highstock} stock/chart/title-style/
+         *         Custom color and weight
+         * @sample highcharts/css/titles/
+         *         Styled mode
+         *
+         * @type      {Highcharts.CSSObject}
+         * @default   {highcharts|highmaps} { "color": "#333333", "fontSize": "18px" }
+         * @default   {highstock} { "color": "#333333", "fontSize": "16px" }
          * @apioption title.style
          */
 
         /**
-         * Whether to [use HTML](http://www.highcharts.com/docs/chart-concepts/labels-
-         * and-string-formatting#html) to render the text.
+         * Whether to
+         * [use HTML](https://www.highcharts.com/docs/chart-concepts/labels-and-string-formatting#html)
+         * to render the text.
          *
-         * @type {Boolean}
-         * @default false
+         * @type      {boolean}
+         * @default   false
          * @apioption title.useHTML
          */
 
@@ -1311,29 +1448,31 @@ H.defaultOptions = {
          * `"middle"` and `"bottom"`. When a value is given, the title behaves
          * as if [floating](#title.floating) were `true`.
          *
-         * @validvalue ["top", "middle", "bottom"]
-         * @type {String}
          * @sample {highcharts} highcharts/title/verticalalign/
          *         Chart title in bottom right corner
          * @sample {highstock} stock/chart/title-verticalalign/
          *         Chart title in bottom right corner
-         * @since 2.1
-         * @apioption title.verticalAlign
+         *
+         * @type       {string}
+         * @since      2.1
+         * @validvalue ["top", "middle", "bottom"]
+         * @apioption  title.verticalAlign
          */
 
         /**
          * The x position of the title relative to the alignment within
          * `chart.spacingLeft` and `chart.spacingRight`.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/title/align/
          *         Aligned to the plot area (x = 70px = margin left - spacing
          *         left)
          * @sample {highstock} stock/chart/title-align/
          *         Aligned to the plot area (x = 50px = margin left - spacing
          *         left)
-         * @default 0
-         * @since 2.0
+         *
+         * @type      {number}
+         * @default   0
+         * @since     2.0
          * @apioption title.x
          */
 
@@ -1342,24 +1481,27 @@ H.defaultOptions = {
          * [chart.spacingTop](#chart.spacingTop) and [chart.spacingBottom](
          * #chart.spacingBottom). By default it depends on the font size.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/title/y/
          *         Title inside the plot area
          * @sample {highstock} stock/chart/title-verticalalign/
          *         Chart title in bottom right corner
-         * @since 2.0
+         *
+         * @type      {number}
+         * @since     2.0
          * @apioption title.y
          */
 
         /**
          * The title of the chart. To disable the title, set the `text` to
-         * `null`.
+         * `undefined`.
+         *
+         * @sample {highcharts} highcharts/title/text/
+         *         Custom title
+         * @sample {highstock} stock/chart/title-text/
+         *         Custom title
          *
-         * @type {String}
-         * @sample {highcharts} highcharts/title/text/ Custom title
-         * @sample {highstock} stock/chart/title-text/ Custom title
          * @default {highcharts|highmaps} Chart title
-         * @default {highstock} null
+         * @default {highstock} undefined
          */
         text: 'Chart title',
 
@@ -1367,16 +1509,15 @@ H.defaultOptions = {
          * The horizontal alignment of the title. Can be one of "left", "center"
          * and "right".
          *
-         * @validvalue ["left", "center", "right"]
-         * @type {String}
          * @sample {highcharts} highcharts/title/align/
          *         Aligned to the plot area (x = 70px = margin left - spacing
          *         left)
          * @sample {highstock} stock/chart/title-align/
          *         Aligned to the plot area (x = 50px = margin left - spacing
          *         left)
-         * @default center
-         * @since 2.0
+         *
+         * @since      2.0
+         * @validvalue ["left", "center", "right"]
          */
         align: 'center',
 
@@ -1384,14 +1525,13 @@ H.defaultOptions = {
          * The margin between the title and the plot area, or if a subtitle
          * is present, the margin between the subtitle and the plot area.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/title/margin-50/
          *         A chart title margin of 50
          * @sample {highcharts} highcharts/title/margin-subtitle/
          *         The same margin applied with a subtitle
          * @sample {highstock} stock/chart/title-margin/
          *         A chart title margin of 50
-         * @default 15
+         *
          * @since 2.1
          */
         margin: 15,
@@ -1400,10 +1540,9 @@ H.defaultOptions = {
          * Adjustment made to the title width, normally to reserve space for
          * the exporting burger menu.
          *
-         * @type {Number}
          * @sample highcharts/title/widthadjust/
          *         Wider menu, greater padding
-         * @default -44
+         *
          * @since 4.2.5
          */
         widthAdjust: -44
@@ -1416,7 +1555,8 @@ H.defaultOptions = {
      * subtitle can be updated after chart initialization through the
      * `Chart.setTitle` method.
      *
-     * @sample {highmaps} maps/title/subtitle/ Subtitle options demonstrated
+     * @sample {highmaps} maps/title/subtitle/
+     *         Subtitle options demonstrated
      */
     subtitle: {
 
@@ -1424,13 +1564,14 @@ H.defaultOptions = {
          * When the subtitle is floating, the plot area will not move to make
          * space for it.
          *
-         * @type {Boolean}
          * @sample {highcharts} highcharts/subtitle/floating/
          *         Floating title and subtitle
          * @sample {highstock} stock/chart/subtitle-footnote
          *         Footnote floating at bottom right of plot area
-         * @default false
-         * @since 2.1
+         *
+         * @type      {boolean}
+         * @default   false
+         * @since     2.1
          * @apioption subtitle.floating
          */
 
@@ -1440,7 +1581,6 @@ H.defaultOptions = {
          * In styled mode, the subtitle style is given in the
          * `.highcharts-subtitle` class.
          *
-         * @type {CSSObject}
          * @sample {highcharts} highcharts/subtitle/style/
          *         Custom color and weight
          * @sample {highcharts} highcharts/css/titles/
@@ -1451,16 +1591,19 @@ H.defaultOptions = {
          *         Styled mode
          * @sample {highmaps} highcharts/css/titles/
          *         Styled mode
-         * @default { "color": "#666666" }
+         *
+         * @type      {Highcharts.CSSObject}
+         * @default   {"color": "#666666"}
          * @apioption subtitle.style
          */
 
         /**
-         * Whether to [use HTML](http://www.highcharts.com/docs/chart-concepts/labels-
-         * and-string-formatting#html) to render the text.
+         * Whether to
+         * [use HTML](https://www.highcharts.com/docs/chart-concepts/labels-and-string-formatting#html)
+         * to render the text.
          *
-         * @type {Boolean}
-         * @default false
+         * @type      {boolean}
+         * @default   false
          * @apioption subtitle.useHTML
          */
 
@@ -1468,28 +1611,29 @@ H.defaultOptions = {
          * The vertical alignment of the title. Can be one of "top", "middle"
          * and "bottom". When a value is given, the title behaves as floating.
          *
-         * @validvalue ["top", "middle", "bottom"]
-         * @type {String}
          * @sample {highcharts} highcharts/subtitle/verticalalign/
          *         Footnote at the bottom right of plot area
          * @sample {highstock} stock/chart/subtitle-footnote
          *         Footnote at the bottom right of plot area
-         * @default
-         * @since 2.1
-         * @apioption subtitle.verticalAlign
+         *
+         * @type       {string}
+         * @since      2.1
+         * @validvalue ["top", "middle", "bottom"]
+         * @apioption  subtitle.verticalAlign
          */
 
         /**
          * The x position of the subtitle relative to the alignment within
          * `chart.spacingLeft` and `chart.spacingRight`.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/subtitle/align/
          *         Footnote at right of plot area
          * @sample {highstock} stock/chart/subtitle-footnote
          *         Footnote at the bottom right of plot area
-         * @default 0
-         * @since 2.0
+         *
+         * @type      {number}
+         * @default   0
+         * @since     2.0
          * @apioption subtitle.x
          */
 
@@ -1498,22 +1642,19 @@ H.defaultOptions = {
          * `chart.spacingTop` and `chart.spacingBottom`. By default the subtitle
          * is laid out below the title unless the title is floating.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/subtitle/verticalalign/
          *         Footnote at the bottom right of plot area
          * @sample {highstock} stock/chart/subtitle-footnote
          *         Footnote at the bottom right of plot area
-         * @default {highcharts}  null
-         * @default {highstock}  null
-         * @default {highmaps}
-         * @since 2.0
+         *
+         * @type      {number}
+         * @since     2.0
          * @apioption subtitle.y
          */
 
         /**
          * The subtitle of the chart.
          *
-         * @type {String}
          * @sample {highcharts|highstock} highcharts/subtitle/text/
          *         Custom subtitle
          * @sample {highcharts|highstock} highcharts/subtitle/text-formatted/
@@ -1525,14 +1666,13 @@ H.defaultOptions = {
          * The horizontal alignment of the subtitle. Can be one of "left",
          *  "center" and "right".
          *
-         * @validvalue ["left", "center", "right"]
-         * @type {String}
          * @sample {highcharts} highcharts/subtitle/align/
          *         Footnote at right of plot area
          * @sample {highstock} stock/chart/subtitle-footnote
          *         Footnote at bottom right of plot area
-         * @default center
-         * @since 2.0
+         *
+         * @since      2.0
+         * @validvalue ["left", "center", "right"]
          */
         align: 'center',
 
@@ -1540,11 +1680,11 @@ H.defaultOptions = {
          * Adjustment made to the subtitle width, normally to reserve space
          * for the exporting burger menu.
          *
-         * @type {Number}
          * @see [title.widthAdjust](#title.widthAdjust)
+         *
          * @sample highcharts/title/widthadjust/
          *         Wider menu, greater padding
-         * @default -44
+         *
          * @since 4.2.5
          */
         widthAdjust: -44
@@ -1561,27 +1701,25 @@ H.defaultOptions = {
      * type are given in the plotOptions of that type, for example
      * `plotOptions.line`. Next, options for one single series are given in
      * [the series array](#series).
-     *
      */
     plotOptions: {},
 
     /**
      * HTML labels that can be positioned anywhere in the chart area.
-     *
      */
     labels: {
 
         /**
-         * A HTML label that can be positioned anywhere in the chart area.
+         * An HTML label that can be positioned anywhere in the chart area.
          *
-         * @type {Array<Object>}
+         * @type      {Array<*>}
          * @apioption labels.items
          */
 
         /**
          * Inner HTML or text for the label.
          *
-         * @type {String}
+         * @type      {string}
          * @apioption labels.items.html
          */
 
@@ -1594,18 +1732,24 @@ H.defaultOptions = {
          *     top: '100px'
          * }</pre>
          *
-         * @type {CSSObject}
+         * @type      {Highcharts.CSSObject}
          * @apioption labels.items.style
          */
 
         /**
          * Shared CSS styles for all labels.
          *
-         * @type {CSSObject}
-         * @default { "color": "#333333" }
+         * @type    {Highcharts.CSSObject}
+         * @default {"color": "#333333", "position": "absolute"}
          */
         style: {
+            /**
+             * @ignore
+             */
             position: 'absolute',
+            /**
+             * @ignore
+             */
             color: '#333333'
         }
     },
@@ -1615,9 +1759,8 @@ H.defaultOptions = {
      * item or point item in the chart. Each series (or points in case
      * of pie charts) is represented by a symbol and its name in the legend.
      *
-     * It is possible to override the symbol creator function and
-     * create [custom legend symbols](http://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/studies/legend-
-     * custom-symbol/).
+     * It is possible to override the symbol creator function and create
+     * [custom legend symbols](https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/studies/legend-custom-symbol/).
      *
      * @productdesc {highmaps}
      * A Highmaps legend by default contains one legend item per series, but if
@@ -1629,40 +1772,52 @@ H.defaultOptions = {
         /**
          * The background color of the legend.
          *
-         * @type {Color}
          * @see In styled mode, the legend background fill can be applied with
-         * the `.highcharts-legend-box` class.
+         *      the `.highcharts-legend-box` class.
+         *
          * @sample {highcharts} highcharts/legend/backgroundcolor/
          *         Yellowish background
-         * @sample {highstock} stock/legend/align/ Various legend options
+         * @sample {highstock} stock/legend/align/
+         *         Various legend options
          * @sample {highmaps} maps/legend/border-background/
          *         Border and background options
+         *
+         * @type      {Highcharts.ColorString}
          * @apioption legend.backgroundColor
          */
 
         /**
          * The width of the drawn border around the legend.
          *
-         * @type {Number}
          * @see In styled mode, the legend border stroke width can be applied
-         * with the `.highcharts-legend-box` class.
-         * @sample {highcharts} highcharts/legend/borderwidth/ 2px border width
-         * @sample {highstock} stock/legend/align/ Various legend options
+         *      with the `.highcharts-legend-box` class.
+         *
+         * @sample {highcharts} highcharts/legend/borderwidth/
+         *         2px border width
+         * @sample {highstock} stock/legend/align/
+         *         Various legend options
          * @sample {highmaps} maps/legend/border-background/
          *         Border and background options
-         * @default 0
+         *
+         * @type      {number}
+         * @default   0
          * @apioption legend.borderWidth
          */
 
         /**
-         * Enable or disable the legend.
+         * Enable or disable the legend. There is also a series-specific option,
+         * [showInLegend](#plotOptions.series.showInLegend), that can hide the
+         * series from the legend. In some series types this is `false` by
+         * default, so it must set to `true` in order to show the legend for the
+         * series.
          *
-         * @type {Boolean}
          * @sample {highcharts} highcharts/legend/enabled-false/ Legend disabled
          * @sample {highstock} stock/legend/align/ Various legend options
          * @sample {highmaps} maps/legend/enabled-false/ Legend disabled
+         *
          * @default {highstock} false
          * @default {highmaps} true
+         * @default {gantt} false
          */
         enabled: true,
 
@@ -1674,15 +1829,15 @@ H.defaultOptions = {
          * `layout` option will determine whether to place it above/below
          * or on the side of the plot area.
          *
-         * @validvalue ["left", "center", "right"]
-         * @type {String}
          * @sample {highcharts} highcharts/legend/align/
          *         Legend at the right of the chart
          * @sample {highstock} stock/legend/align/
          *         Various legend options
          * @sample {highmaps} maps/legend/alignment/
          *         Legend alignment
-         * @since 2.0
+         *
+         * @since      2.0
+         * @validvalue ["left", "center", "right"]
          */
         align: 'center',
 
@@ -1700,12 +1855,16 @@ H.defaultOptions = {
          * When the legend is floating, the plot area ignores it and is allowed
          * to be placed below it.
          *
-         * @type {Boolean}
-         * @sample {highcharts} highcharts/legend/floating-false/ False by default
-         * @sample {highcharts} highcharts/legend/floating-true/ True
-         * @sample {highmaps} maps/legend/alignment/ Floating legend
-         * @default false
-         * @since 2.1
+         * @sample {highcharts} highcharts/legend/floating-false/
+         *         False by default
+         * @sample {highcharts} highcharts/legend/floating-true/
+         *         True
+         * @sample {highmaps} maps/legend/alignment/
+         *         Floating legend
+         *
+         * @type      {boolean}
+         * @default   false
+         * @since     2.1
          * @apioption legend.floating
          */
 
@@ -1716,8 +1875,6 @@ H.defaultOptions = {
          * except in inverted charts or when the legend position doesn't allow
          * it.
          *
-         * @validvalue ["horizontal", "vertical", "proximate"]
-         * @type {String}
          * @sample {highcharts} highcharts/legend/layout-horizontal/
          *         Horizontal by default
          * @sample {highcharts} highcharts/legend/layout-vertical/
@@ -1730,7 +1887,8 @@ H.defaultOptions = {
          *         Vertical with data classes
          * @sample {highmaps} maps/legend/layout-vertical/
          *         Vertical with color axis gradient
-         * @default horizontal
+         *
+         * @validvalue ["horizontal", "vertical", "proximate"]
          */
         layout: 'horizontal',
 
@@ -1738,39 +1896,44 @@ H.defaultOptions = {
          * In a legend with horizontal layout, the itemDistance defines the
          * pixel distance between each item.
          *
-         * @type {Number}
-         * @sample {highcharts} highcharts/legend/layout-horizontal/ 50px item distance
-         * @sample {highstock} highcharts/legend/layout-horizontal/ 50px item distance
-         * @default {highcharts} 20
-         * @default {highstock} 20
-         * @default {highmaps} 8
-         * @since 3.0.3
+         * @sample {highcharts} highcharts/legend/layout-horizontal/
+         *         50px item distance
+         * @sample {highstock} highcharts/legend/layout-horizontal/
+         *         50px item distance
+         *
+         * @type      {number}
+         * @default   {highcharts} 20
+         * @default   {highstock} 20
+         * @default   {highmaps} 8
+         * @since     3.0.3
          * @apioption legend.itemDistance
          */
 
         /**
          * The pixel bottom margin for each legend item.
          *
-         * @type {Number}
          * @sample {highcharts|highstock} highcharts/legend/padding-itemmargin/
          *         Padding and item margins demonstrated
          * @sample {highmaps} maps/legend/padding-itemmargin/
          *         Padding and item margins demonstrated
-         * @default 0
-         * @since 2.2.0
+         *
+         * @type      {number}
+         * @default   0
+         * @since     2.2.0
          * @apioption legend.itemMarginBottom
          */
 
         /**
          * The pixel top margin for each legend item.
          *
-         * @type {Number}
          * @sample {highcharts|highstock} highcharts/legend/padding-itemmargin/
          *         Padding and item margins demonstrated
          * @sample {highmaps} maps/legend/padding-itemmargin/
          *         Padding and item margins demonstrated
-         * @default 0
-         * @since 2.2.0
+         *
+         * @type      {number}
+         * @default   0
+         * @since     2.2.0
          * @apioption legend.itemMarginTop
          */
 
@@ -1780,25 +1943,25 @@ H.defaultOptions = {
          * are laid out across two rows or more, they will be vertically aligned
          * depending on the [legend.alignColumns](legend.alignColumns) option.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/legend/itemwidth-default/
-         *         Null by default
+         *         Undefined by default
          * @sample {highcharts} highcharts/legend/itemwidth-80/
          *         80 for aligned legend items
-         * @default null
-         * @since 2.0
+         *
+         * @type      {number}
+         * @since     2.0
          * @apioption legend.itemWidth
          */
 
         /**
-         * A [format string](
-         * https://www.highcharts.com/docs/chart-concepts/labels-and-string-formatting)
-         * for each legend label. Available variables relates to properties on
-         * the series, or the point in case of pies.
+         * A [format string](https://www.highcharts.com/docs/chart-concepts/
+         * labels-and-string-formatting) for each legend label. Available
+         * variables relates to properties on the series, or the point in case
+         * of pies.
          *
-         * @type {String}
-         * @default {name}
-         * @since 1.3
+         * @type      {string}
+         * @default   {name}
+         * @since     1.3
          * @apioption legend.labelFormat
          */
 
@@ -1808,14 +1971,15 @@ H.defaultOptions = {
          * of pie charts. By default the series or point name is printed.
          *
          * @productdesc {highmaps}
-         *              In Highmaps the context can also be a data class in case
-         *              of a `colorAxis`.
+         * In Highmaps the context can also be a data class in case of a
+         * `colorAxis`.
+         *
+         * @sample {highcharts} highcharts/legend/labelformatter/
+         *         Add text
+         * @sample {highmaps} maps/legend/labelformatter/
+         *         Data classes with label formatter
          *
-         * @type    {Function}
-         * @sample  {highcharts} highcharts/legend/labelformatter/ Add text
-         * @sample  {highmaps} maps/legend/labelformatter/
-         *          Data classes with label formatter
-         * @context {Series|Point}
+         * @context {Highcharts.Series|Highcharts.Point}
          */
         labelFormatter: function () {
             return this.name;
@@ -1827,11 +1991,15 @@ H.defaultOptions = {
          * and the padding between items using `itemMarginTop` and
          * `itemMarginBottom`.
          *
-         * @type {Number}
-         * @sample {highcharts} highcharts/legend/lineheight/ Setting padding
-         * @default 16
-         * @since 2.0
-         * @product highcharts
+         * @sample {highcharts} highcharts/legend/lineheight/
+         *         Setting padding
+         *
+         * @deprecated
+         *
+         * @type      {number}
+         * @default   16
+         * @since     2.0
+         * @product   highcharts gantt
          * @apioption legend.lineHeight
          */
 
@@ -1840,12 +2008,14 @@ H.defaultOptions = {
          * is not floating, the legend margin is the space between the legend
          * and the axis labels or plot area.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/legend/margin-default/
          *         12 pixels by default
-         * @sample {highcharts} highcharts/legend/margin-30/ 30 pixels
-         * @default 12
-         * @since 2.1
+         * @sample {highcharts} highcharts/legend/margin-30/
+         *         30 pixels
+         *
+         * @type      {number}
+         * @default   12
+         * @since     2.1
          * @apioption legend.margin
          */
 
@@ -1853,45 +2023,46 @@ H.defaultOptions = {
          * Maximum pixel height for the legend. When the maximum height is
          * extended, navigation will show.
          *
-         * @type {Number}
-         * @default undefined
-         * @since 2.3.0
+         * @type      {number}
+         * @since     2.3.0
          * @apioption legend.maxHeight
          */
 
         /**
          * The color of the drawn border around the legend.
          *
-         * @type {Color}
-         * @see In styled mode, the legend border stroke can be applied with
-         * the `.highcharts-legend-box` class.
-         * @sample {highcharts} highcharts/legend/bordercolor/ Brown border
-         * @sample {highstock} stock/legend/align/ Various legend options
+         * @see In styled mode, the legend border stroke can be applied with the
+         *      `.highcharts-legend-box` class.
+         *
+         * @sample {highcharts} highcharts/legend/bordercolor/
+         *         Brown border
+         * @sample {highstock} stock/legend/align/
+         *         Various legend options
          * @sample {highmaps} maps/legend/border-background/
          *         Border and background options
-         * @default #999999
+         *
+         * @type {Highcharts.ColorString}
          */
         borderColor: '#999999',
 
         /**
          * The border corner radius of the legend.
          *
-         * @type {Number}
-         * @sample {highcharts} highcharts/legend/borderradius-default/ Square by default
-         * @sample {highcharts} highcharts/legend/borderradius-round/ 5px rounded
+         * @sample {highcharts} highcharts/legend/borderradius-default/
+         *         Square by default
+         * @sample {highcharts} highcharts/legend/borderradius-round/
+         *         5px rounded
          * @sample {highmaps} maps/legend/border-background/
          *         Border and background options
-         * @default 0
          */
         borderRadius: 0,
 
         /**
          * Options for the paging or navigation appearing when the legend
          * is overflown. Navigation works well on screen, but not in static
-         * exported images. One way of working around that is to [increase
-         * the chart height in export](http://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/legend/navigation-
-         * enabled-false/).
-         *
+         * exported images. One way of working around that is to
+         * [increase the chart height in
+         * export](https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/legend/navigation-enabled-false/).
          */
         navigation: {
 
@@ -1901,13 +2072,14 @@ H.defaultOptions = {
              * `chart.animation` option. Additional options can be given as an
              * object containing values for easing and duration.
              *
-             * @type {Boolean|Object}
              * @sample {highcharts} highcharts/legend/navigation/
              *         Legend page navigation demonstrated
              * @sample {highstock} highcharts/legend/navigation/
              *         Legend page navigation demonstrated
-             * @default true
-             * @since 2.2.4
+             *
+             * @type      {boolean|Highcharts.AnimationObject}
+             * @default   true
+             * @since     2.2.4
              * @apioption legend.navigation.animation
              */
 
@@ -1915,13 +2087,14 @@ H.defaultOptions = {
              * The pixel size of the up and down arrows in the legend paging
              * navigation.
              *
-             * @type {Number}
              * @sample {highcharts} highcharts/legend/navigation/
              *         Legend page navigation demonstrated
              * @sample {highstock} highcharts/legend/navigation/
              *         Legend page navigation demonstrated
-             * @default 12
-             * @since 2.2.4
+             *
+             * @type      {number}
+             * @default   12
+             * @since     2.2.4
              * @apioption legend.navigation.arrowSize
              */
 
@@ -1930,27 +2103,29 @@ H.defaultOptions = {
              * the navigation results in an unwanted overflow.
              *
              * See also the [adapt chart to legend](
-             * https://www.highcharts.com/plugin-registry/single/8/Adapt-Chart-To-Legend)
+             * https://www.highcharts.com/products/plugin-registry/single/8/Adapt-Chart-To-Legend)
              * plugin for a solution to extend the chart height to make room for
              * the legend, optionally in exported charts only.
              *
-             * @type {Boolean}
-             * @default true
-             * @since 4.2.4
+             * @type      {boolean}
+             * @default   true
+             * @since     4.2.4
              * @apioption legend.navigation.enabled
              */
 
             /**
              * Text styles for the legend page navigation.
              *
-             * @type {CSSObject}
              * @see In styled mode, the navigation items are styled with the
-             * `.highcharts-legend-navigation` class.
+             *      `.highcharts-legend-navigation` class.
+             *
              * @sample {highcharts} highcharts/legend/navigation/
              *         Legend page navigation demonstrated
              * @sample {highstock} highcharts/legend/navigation/
              *         Legend page navigation demonstrated
-             * @since 2.2.4
+             *
+             * @type      {Highcharts.CSSObject}
+             * @since     2.2.4
              * @apioption legend.navigation.style
              */
 
@@ -1960,14 +2135,15 @@ H.defaultOptions = {
              * The color for the active up or down arrow in the legend page
              * navigation.
              *
-             * @type {Color}
-             * @see     In styled mode, the active arrow be styled with the
-             *          `.highcharts-legend-nav-active` class.
+             * @see In styled mode, the active arrow be styled with the
+             *      `.highcharts-legend-nav-active` class.
+             *
              * @sample  {highcharts} highcharts/legend/navigation/
              *          Legend page navigation demonstrated
              * @sample  {highstock} highcharts/legend/navigation/
              *          Legend page navigation demonstrated
-             * @default #003399
+             *
+             * @type  {Highcharts.ColorString}
              * @since 2.2.4
              */
             activeColor: '#003399',
@@ -1976,16 +2152,15 @@ H.defaultOptions = {
              * The color of the inactive up or down arrow in the legend page
              * navigation. .
              *
-             * @type {Color}
              * @see In styled mode, the inactive arrow be styled with the
              *      `.highcharts-legend-nav-inactive` class.
+             *
              * @sample {highcharts} highcharts/legend/navigation/
              *         Legend page navigation demonstrated
              * @sample {highstock} highcharts/legend/navigation/
              *         Legend page navigation demonstrated
-             * @default {highcharts} #cccccc
-             * @default {highstock} #cccccc
-             * @default {highmaps} ##cccccc
+             *
+             * @type  {Highcharts.ColorString}
              * @since 2.2.4
              */
             inactiveColor: '#cccccc'
@@ -1995,13 +2170,14 @@ H.defaultOptions = {
         /**
          * The inner padding of the legend box.
          *
-         * @type {Number}
          * @sample {highcharts|highstock} highcharts/legend/padding-itemmargin/
          *         Padding and item margins demonstrated
          * @sample {highmaps} maps/legend/padding-itemmargin/
          *         Padding and item margins demonstrated
-         * @default 8
-         * @since 2.2.0
+         *
+         * @type      {number}
+         * @default   8
+         * @since     2.2.0
          * @apioption legend.padding
          */
 
@@ -2009,13 +2185,15 @@ H.defaultOptions = {
          * Whether to reverse the order of the legend items compared to the
          * order of the series or points as defined in the configuration object.
          *
-         * @type {Boolean}
          * @see [yAxis.reversedStacks](#yAxis.reversedStacks),
          *      [series.legendIndex](#series.legendIndex)
+         *
          * @sample {highcharts} highcharts/legend/reversed/
          *         Stacked bar with reversed legend
-         * @default false
-         * @since 1.2.5
+         *
+         * @type      {boolean}
+         * @default   false
+         * @since     1.2.5
          * @apioption legend.reversed
          */
 
@@ -2023,10 +2201,12 @@ H.defaultOptions = {
          * Whether to show the symbol on the right side of the text rather than
          * the left side. This is common in Arabic and Hebraic.
          *
-         * @type {Boolean}
-         * @sample {highcharts} highcharts/legend/rtl/ Symbol to the right
-         * @default false
-         * @since 2.2
+         * @sample {highcharts} highcharts/legend/rtl/
+         *         Symbol to the right
+         *
+         * @type      {boolean}
+         * @default   false
+         * @since     2.2
          * @apioption legend.rtl
          */
 
@@ -2034,11 +2214,12 @@ H.defaultOptions = {
          * CSS styles for the legend area. In the 1.x versions the position
          * of the legend area was determined by CSS. In 2.x, the position is
          * determined by properties like `align`, `verticalAlign`, `x` and `y`,
-         *  but the styles are still parsed for backwards compatibility.
+         * but the styles are still parsed for backwards compatibility.
          *
-         * @type {CSSObject}
          * @deprecated
-         * @product highcharts highstock
+         *
+         * @type      {Highcharts.CSSObject}
+         * @product   highcharts highstock
          * @apioption legend.style
          */
 
@@ -2047,20 +2228,37 @@ H.defaultOptions = {
         /**
          * CSS styles for each legend item. Only a subset of CSS is supported,
          * notably those options related to text. The default `textOverflow`
-         * property makes long texts truncate. Set it to `null` to wrap text
-         * instead. A `width` property can be added to control the text width.
+         * property makes long texts truncate. Set it to `undefined` to wrap
+         * text instead. A `width` property can be added to control the text
+         * width.
          *
-         * @type {CSSObject}
          * @see In styled mode, the legend items can be styled with the
-         * `.highcharts-legend-item` class.
-         * @sample {highcharts} highcharts/legend/itemstyle/ Bold black text
-         * @sample {highmaps} maps/legend/itemstyle/ Item text styles
-         * @default { "color": "#333333", "cursor": "pointer", "fontSize": "12px", "fontWeight": "bold", "textOverflow": "ellipsis" }
+         *      `.highcharts-legend-item` class.
+         *
+         * @sample {highcharts} highcharts/legend/itemstyle/
+         *         Bold black text
+         * @sample {highmaps} maps/legend/itemstyle/
+         *         Item text styles
+         *
+         * @type    {Highcharts.CSSObject}
+         * @default {"color": "#333333", "cursor": "pointer", "fontSize": "12px", "fontWeight": "bold", "textOverflow": "ellipsis"}
          */
         itemStyle: {
+            /**
+             * @ignore
+             */
             color: '#333333',
+            /**
+             * @ignore
+             */
             fontSize: '12px',
+            /**
+             * @ignore
+             */
             fontWeight: 'bold',
+            /**
+             * @ignore
+             */
             textOverflow: 'ellipsis'
         },
 
@@ -2069,14 +2267,21 @@ H.defaultOptions = {
          * CSS is supported, notably those options related to text. Properties
          * are inherited from `style` unless overridden here.
          *
-         * @type {CSSObject}
          * @see In styled mode, the hovered legend items can be styled with
-         * the `.highcharts-legend-item:hover` pesudo-class.
-         * @sample {highcharts} highcharts/legend/itemhoverstyle/ Red on hover
-         * @sample {highmaps} maps/legend/itemstyle/ Item text styles
-         * @default { "color": "#000000" }
+         *      the `.highcharts-legend-item:hover` pesudo-class.
+         *
+         * @sample {highcharts} highcharts/legend/itemhoverstyle/
+         *         Red on hover
+         * @sample {highmaps} maps/legend/itemstyle/
+         *         Item text styles
+         *
+         * @type    {Highcharts.CSSObject}
+         * @default {"color": "#000000"}
          */
         itemHoverStyle: {
+            /**
+             * @ignore
+             */
             color: '#000000'
         },
 
@@ -2086,14 +2291,19 @@ H.defaultOptions = {
          * options related to text. Properties are inherited from `style`
          * unless overridden here.
          *
-         * @type {CSSObject}
          * @see In styled mode, the hidden legend items can be styled with
-         * the `.highcharts-legend-item-hidden` class.
+         *      the `.highcharts-legend-item-hidden` class.
+         *
          * @sample {highcharts} highcharts/legend/itemhiddenstyle/
          *         Darker gray color
-         * @default { "color": "#cccccc" }
+         *
+         * @type    {Highcharts.CSSObject}
+         * @default {"color": "#cccccc"}
          */
         itemHiddenStyle: {
+            /**
+             * @ignore
+             */
             color: '#cccccc'
         },
 
@@ -2103,25 +2313,38 @@ H.defaultOptions = {
          * an object configuration containing `color`, `offsetX`, `offsetY`,
          * `opacity` and `width`.
          *
-         * @type {Boolean|Object}
          * @sample {highcharts} highcharts/legend/shadow/
          *         White background and drop shadow
          * @sample {highstock} stock/legend/align/
          *         Various legend options
          * @sample {highmaps} maps/legend/border-background/
          *         Border and background options
-         * @default false
+         *
+         * @type {boolean|Highcharts.CSSObject}
          */
         shadow: false,
+
         
 
         /**
          * Default styling for the checkbox next to a legend item when
          * `showCheckbox` is true.
+         *
+         * @type {Highcharts.CSSObject}
+         * @default {"width": "13px", "height": "13px", "position":"absolute"}
          */
         itemCheckboxStyle: {
+            /**
+             * @ignore
+             */
             position: 'absolute',
+            /**
+             * @ignore
+             */
             width: '13px', // for IE precision
+            /**
+             * @ignore
+             */
             height: '13px'
         },
         // itemWidth: undefined,
@@ -2131,8 +2354,6 @@ H.defaultOptions = {
          * the symbol height, which in turn defaults to the font size of the
          * legend items.
          *
-         * @type {Boolean}
-         * @default true
          * @since 5.0.0
          */
         squareSymbol: true,
@@ -2145,12 +2366,13 @@ H.defaultOptions = {
          * In Highmaps, when the symbol is the gradient of a vertical color
          * axis, the height defaults to 200.
          *
-         * @type {Number}
          * @sample {highmaps} maps/legend/layout-vertical-sized/
          *         Sized vertical gradient
          * @sample {highmaps} maps/legend/padding-itemmargin/
          *         No distance between data classes
-         * @since 3.0.8
+         *
+         * @type      {number}
+         * @since     3.0.8
          * @apioption legend.symbolHeight
          */
 
@@ -2158,11 +2380,15 @@ H.defaultOptions = {
          * The border radius of the symbol for series types that use a rectangle
          * in the legend. Defaults to half the `symbolHeight`.
          *
-         * @type {Number}
-         * @sample {highcharts} highcharts/legend/symbolradius/ Round symbols
-         * @sample {highstock} highcharts/legend/symbolradius/ Round symbols
-         * @sample {highmaps} highcharts/legend/symbolradius/ Round symbols
-         * @since 3.0.8
+         * @sample {highcharts} highcharts/legend/symbolradius/
+         *         Round symbols
+         * @sample {highstock} highcharts/legend/symbolradius/
+         *         Round symbols
+         * @sample {highmaps} highcharts/legend/symbolradius/
+         *         Round symbols
+         *
+         * @type      {number}
+         * @since     3.0.8
          * @apioption legend.symbolRadius
          */
 
@@ -2174,34 +2400,37 @@ H.defaultOptions = {
          * In Highmaps, when the symbol is the gradient of a horizontal color
          * axis, the width defaults to 200.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/legend/symbolwidth/
          *         Greater symbol width and padding
          * @sample {highmaps} maps/legend/padding-itemmargin/
          *         Padding and item margins demonstrated
          * @sample {highmaps} maps/legend/layout-vertical-sized/
          *         Sized vertical gradient
+         *
+         * @type      {number}
          * @apioption legend.symbolWidth
          */
 
         /**
-         * Whether to [use HTML](http://www.highcharts.com/docs/chart-concepts/labels-
-         * and-string-formatting#html) to render the legend item texts. Prior
-         * to 4.1.7, when using HTML, [legend.navigation](#legend.navigation)
-         * was disabled.
+         * Whether to [use HTML](https://www.highcharts.com/docs/chart-concepts/
+         * labels-and-string-formatting#html) to render the legend item texts.
+         *
+         * Prior to 4.1.7, when using HTML, [legend.navigation](
+         * #legend.navigation) was disabled.
          *
-         * @type {Boolean}
-         * @default false
+         * @type      {boolean}
+         * @default   false
          * @apioption legend.useHTML
          */
 
         /**
          * The width of the legend box.
          *
-         * @type {Number}
-         * @sample {highcharts} highcharts/legend/width/ Aligned to the plot area
-         * @default null
-         * @since 2.0
+         * @sample {highcharts} highcharts/legend/width/
+         *         Aligned to the plot area
+         *
+         * @type      {number}
+         * @since     2.0
          * @apioption legend.width
          */
 
@@ -2209,9 +2438,8 @@ H.defaultOptions = {
          * The pixel padding between the legend item symbol and the legend
          * item text.
          *
-         * @type {Number}
-         * @sample {highcharts} highcharts/legend/symbolpadding/ Greater symbol width and padding
-         * @default 5
+         * @sample {highcharts} highcharts/legend/symbolpadding/
+         *         Greater symbol width and padding
          */
         symbolPadding: 5,
 
@@ -2227,16 +2455,18 @@ H.defaultOptions = {
          * When the [layout](#legend.layout) option is `proximate`, the
          * `verticalAlign` option doesn't apply.
          *
-         * @validvalue ["top", "middle", "bottom"]
-         * @type {String}
          * @sample {highcharts} highcharts/legend/verticalalign/
          *         Legend 100px from the top of the chart
-         * @sample {highstock} stock/legend/align/ Various legend options
-         * @sample {highmaps} maps/legend/alignment/ Legend alignment
-         * @default bottom
-         * @since 2.0
+         * @sample {highstock} stock/legend/align/
+         *         Various legend options
+         * @sample {highmaps} maps/legend/alignment/
+         *         Legend alignment
+         *
+         * @since      2.0
+         * @validvalue ["top", "middle", "bottom"]
          */
         verticalAlign: 'bottom',
+
         // width: undefined,
 
         /**
@@ -2244,9 +2474,9 @@ H.defaultOptions = {
          * `align` within chart.spacingLeft and chart.spacingRight. Negative
          * x moves it to the left, positive x moves it to the right.
          *
-         * @type {Number}
-         * @sample {highcharts} highcharts/legend/width/ Aligned to the plot area
-         * @default 0
+         * @sample {highcharts} highcharts/legend/width/
+         *         Aligned to the plot area
+         *
          * @since 2.0
          */
         x: 0,
@@ -2256,11 +2486,13 @@ H.defaultOptions = {
          * `verticalAlign` within chart.spacingTop and chart.spacingBottom.
          *  Negative y moves it up, positive y moves it down.
          *
-         * @type {Number}
-         * @sample {highcharts} highcharts/legend/verticalalign/ Legend 100px from the top of the chart
-         * @sample {highstock} stock/legend/align/ Various legend options
-         * @sample {highmaps} maps/legend/alignment/ Legend alignment
-         * @default 0
+         * @sample {highcharts} highcharts/legend/verticalalign/
+         *         Legend 100px from the top of the chart
+         * @sample {highstock} stock/legend/align/
+         *         Various legend options
+         * @sample {highmaps} maps/legend/alignment/
+         *         Legend alignment
+         *
          * @since 2.0
          */
         y: 0,
@@ -2268,17 +2500,19 @@ H.defaultOptions = {
         /**
          * A title to be added on top of the legend.
          *
-         * @sample {highcharts} highcharts/legend/title/ Legend title
-         * @sample {highmaps} maps/legend/alignment/ Legend with title
+         * @sample {highcharts} highcharts/legend/title/
+         *         Legend title
+         * @sample {highmaps} maps/legend/alignment/
+         *         Legend with title
+         *
          * @since 3.0
          */
         title: {
             /**
              * A text or HTML string for the title.
              *
-             * @type {String}
-             * @default null
-             * @since 3.0
+             * @type      {string}
+             * @since     3.0
              * @apioption legend.title.text
              */
 
@@ -2287,16 +2521,22 @@ H.defaultOptions = {
             /**
              * Generic CSS styles for the legend title.
              *
-             * @type {CSSObject}
              * @see In styled mode, the legend title is styled with the
-             * `.highcharts-legend-title` class.
-             * @default {"fontWeight":"bold"}
-             * @since 3.0
+             *      `.highcharts-legend-title` class.
+             *
+             * @type    {Highcharts.CSSObject}
+             * @default {"fontWeight": "bold"}
+             * @since   3.0
              */
             style: {
+                /**
+                 * @ignore
+                 */
                 fontWeight: 'bold'
             }
+
             
+
         }
     },
 
@@ -2309,45 +2549,62 @@ H.defaultOptions = {
      * is going on, for example while retrieving new data via an XHR connection.
      * The "Loading..." text itself is not part of this configuration
      * object, but part of the `lang` object.
-     *
      */
     loading: {
 
         /**
          * The duration in milliseconds of the fade out effect.
          *
-         * @type {Number}
-         * @sample highcharts/loading/hideduration/ Fade in and out over a second
-         * @default 100
-         * @since 1.2.0
+         * @sample highcharts/loading/hideduration/
+         *         Fade in and out over a second
+         *
+         * @type      {number}
+         * @default   100
+         * @since     1.2.0
          * @apioption loading.hideDuration
          */
 
         /**
          * The duration in milliseconds of the fade in effect.
          *
-         * @type {Number}
-         * @sample highcharts/loading/hideduration/ Fade in and out over a second
-         * @default 100
-         * @since 1.2.0
+         * @sample highcharts/loading/hideduration/
+         *         Fade in and out over a second
+         *
+         * @type      {number}
+         * @default   100
+         * @since     1.2.0
          * @apioption loading.showDuration
          */
+
         
 
         /**
          * CSS styles for the loading label `span`.
          *
-         * @type {CSSObject}
          * @see In styled mode, the loading label is styled with the
-         * `.highcharts-loading-inner` class.
-         * @sample {highcharts|highmaps} highcharts/loading/labelstyle/ Vertically centered
-         * @sample {highstock} stock/loading/general/ Label styles
-         * @default { "fontWeight": "bold", "position": "relative", "top": "45%" }
-         * @since 1.2.0
+         *      `.highcharts-loading-inner` class.
+         *
+         * @sample {highcharts|highmaps} highcharts/loading/labelstyle/
+         *         Vertically centered
+         * @sample {highstock} stock/loading/general/
+         *         Label styles
+         *
+         * @type    {Highcharts.CSSObject}
+         * @default {"fontWeight": "bold", "position": "relative", "top": "45%"}
+         * @since   1.2.0
          */
         labelStyle: {
+            /**
+             * @ignore
+             */
             fontWeight: 'bold',
+            /**
+             * @ignore
+             */
             position: 'relative',
+            /**
+             * @ignore
+             */
             top: '45%'
         },
 
@@ -2357,18 +2614,31 @@ H.defaultOptions = {
          * In styled mode, the loading label is styled with the
          * `.highcharts-loading` class.
          *
-         * @type    {CSSObject}
          * @sample  {highcharts|highmaps} highcharts/loading/style/
          *          Gray plot area, white text
          * @sample  {highstock} stock/loading/general/
          *          Gray plot area, white text
-         * @default { "position": "absolute", "backgroundColor": "#ffffff", "opacity": 0.5, "textAlign": "center" }
-         * @since 1.2.0
+         *
+         * @type    {Highcharts.CSSObject}
+         * @default {"position": "absolute", "backgroundColor": "#ffffff", "opacity": 0.5, "textAlign": "center"}
+         * @since   1.2.0
          */
         style: {
+            /**
+             * @ignore
+             */
             position: 'absolute',
+            /**
+             * @ignore
+             */
             backgroundColor: '#ffffff',
+            /**
+             * @ignore
+             */
             opacity: 0.5,
+            /**
+             * @ignore
+             */
             textAlign: 'center'
         }
         
@@ -2378,16 +2648,14 @@ H.defaultOptions = {
     /**
      * Options for the tooltip that appears when the user hovers over a
      * series or point.
-     *
      */
     tooltip: {
 
 
         /**
-         * The color of the tooltip border. When `null`, the border takes the
-         * color of the corresponding series or point.
+         * The color of the tooltip border. When `undefined`, the border takes
+         * the color of the corresponding series or point.
          *
-         * @type {Color}
          * @sample {highcharts} highcharts/tooltip/bordercolor-default/
          *         Follow series by default
          * @sample {highcharts} highcharts/tooltip/bordercolor-black/
@@ -2396,7 +2664,8 @@ H.defaultOptions = {
          *         Styled tooltip
          * @sample {highmaps} maps/tooltip/background-border/
          *         Background and border demo
-         * @default null
+         *
+         * @type      {Highcharts.ColorString}
          * @apioption tooltip.borderColor
          */
 
@@ -2405,11 +2674,13 @@ H.defaultOptions = {
          * in order for a better separation from the tooltip. See
          * [xAxis.crosshair](#xAxis.crosshair)<a>.</a>
          *
-         * @type {Mixed}
-         * @deprecated
          * @sample {highcharts} highcharts/tooltip/crosshairs-x/
          *         Enable a crosshair for the x value
-         * @default true
+         *
+         * @deprecated
+         *
+         * @type      {*}
+         * @default   true
          * @apioption tooltip.crosshairs
          */
 
@@ -2422,25 +2693,31 @@ H.defaultOptions = {
          * For touch moves to behave the same way, [followTouchMove](
          * #tooltip.followTouchMove) must be `true` also.
          *
-         * @type {Boolean}
-         * @default {highcharts} false
-         * @default {highstock} false
-         * @default {highmaps} true
-         * @since 3.0
+         * @type      {boolean}
+         * @default   {highcharts} false
+         * @default   {highstock} false
+         * @default   {highmaps} true
+         * @since     3.0
          * @apioption tooltip.followPointer
          */
 
         /**
-         * Whether the tooltip should follow the finger as it moves on a touch
+         * Whether the tooltip should update as the finger moves on a touch
          * device. If this is `true` and [chart.panning](#chart.panning) is
          * set,`followTouchMove` will take over one-finger touches, so the user
          * needs to use two fingers for zooming and panning.
          *
-         * @type {Boolean}
-         * @default {highcharts} true
-         * @default {highstock} true
-         * @default {highmaps} false
-         * @since 3.0.1
+         * Note the difference to [followPointer](#tooltip.followPointer) that
+         * only defines the _position_ of the tooltip. If `followPointer` is
+         * false in for example a column series, the tooltip will show above or
+         * below the column, but as `followTouchMove` is true, the tooltip will
+         * jump from column to column as the user swipes across the plot area.
+         *
+         * @type      {boolean}
+         * @default   {highcharts} true
+         * @default   {highstock} true
+         * @default   {highmaps} false
+         * @since     3.0.1
          * @apioption tooltip.followTouchMove
          */
 
@@ -2503,7 +2780,6 @@ H.defaultOptions = {
          *
          * </dl>
          *
-         * @type {Function}
          * @sample {highcharts} highcharts/tooltip/formatter-simple/
          *         Simple string formatting
          * @sample {highcharts} highcharts/tooltip/formatter-shared/
@@ -2512,6 +2788,8 @@ H.defaultOptions = {
          *         Formatting with shared tooltip
          * @sample {highmaps} maps/tooltip/formatter/
          *         String formatting
+         *
+         * @type      {Function}
          * @apioption tooltip.formatter
          */
 
@@ -2519,9 +2797,9 @@ H.defaultOptions = {
          * The number of milliseconds to wait until the tooltip is hidden when
          * mouse out from a point or chart.
          *
-         * @type {Number}
-         * @default 500
-         * @since 3.0
+         * @type      {number}
+         * @default   500
+         * @since     3.0
          * @apioption tooltip.hideDelay
          */
 
@@ -2534,11 +2812,12 @@ H.defaultOptions = {
          * overlaid on the page, allowing the tooltip to be aligned inside the
          * page itself.
          *
-         * @type {Boolean}
          * @sample highcharts/tooltip/outside
          *         Small charts with tooltips outside
-         * @default false
-         * @since 6.1.1
+         *
+         * @type      {boolean}
+         * @default   false
+         * @since     6.1.1
          * @apioption tooltip.outside
          */
 
@@ -2547,9 +2826,9 @@ H.defaultOptions = {
          * in the tooltip. Like the `pointFormat` string, but with more
          * flexibility.
          *
-         * @type {Function}
-         * @context Point
-         * @since 4.1.0
+         * @type      {Function}
+         * @since     4.1.0
+         * @context   Highcharts.Point
          * @apioption tooltip.pointFormatter
          */
 
@@ -2563,25 +2842,31 @@ H.defaultOptions = {
          * The return should be an object containing x and y values, for example
          * `{ x: 100, y: 100 }`.
          *
-         * @type {Function}
          * @sample {highcharts} highcharts/tooltip/positioner/
          *         A fixed tooltip position
          * @sample {highstock} stock/tooltip/positioner/
          *         A fixed tooltip position on top of the chart
          * @sample {highmaps} maps/tooltip/positioner/
          *         A fixed tooltip position
-         * @since 2.2.4
+         *
+         * @type      {Function}
+         * @since     2.2.4
          * @apioption tooltip.positioner
          */
 
         /**
-         * The name of a symbol to use for the border around the tooltip.
+         * The name of a symbol to use for the border around the tooltip. Can
+         * be one of: `"callout"`, `"circle"` or `"square"`.
+         *
+         * Custom callbacks for symbol path generation can also be added to
+         * `Highcharts.SVGRenderer.prototype.symbols` the same way as for
+         * [series.marker.symbol](plotOptions.line.marker.symbol).
          *
-         * @type {String}
-         * @default callout
+         * @type       {string}
+         * @default    callout
+         * @since      4.0
          * @validvalue ["callout", "square"]
-         * @since 4.0
-         * @apioption tooltip.shape
+         * @apioption  tooltip.shape
          */
 
         /**
@@ -2595,17 +2880,19 @@ H.defaultOptions = {
          * charts with many series, especially line-type series. The
          * `tooltip.split` option takes precedence over `tooltip.shared`.
          *
-         * @type {Boolean}
          * @sample {highcharts} highcharts/tooltip/shared-false/
          *         False by default
-         * @sample {highcharts} highcharts/tooltip/shared-true/ True
+         * @sample {highcharts} highcharts/tooltip/shared-true/
+         *         True
          * @sample {highcharts} highcharts/tooltip/shared-x-crosshair/
          *         True with x axis crosshair
          * @sample {highcharts} highcharts/tooltip/shared-true-mixed-types/
          *         True with mixed series types
-         * @default false
-         * @since 2.1
-         * @product highcharts highstock
+         *
+         * @type      {boolean}
+         * @default   false
+         * @since     2.1
+         * @product   highcharts highstock
          * @apioption tooltip.shared
          */
 
@@ -2620,12 +2907,14 @@ H.defaultOptions = {
          * and multiple panes, making split tooltips the preferred layout over
          * the previous `shared` tooltip.
          *
-         * @type {Boolean}
-         * @sample highcharts/tooltip/split/ Split tooltip
-         * @default {highcharts} false
-         * @default {highstock} true
-         * @product highcharts highstock
-         * @since 5.0.0
+         * @sample highcharts/tooltip/split/
+         *         Split tooltip
+         *
+         * @type      {boolean}
+         * @default   {highcharts} false
+         * @default   {highstock} true
+         * @since     5.0.0
+         * @product   highcharts highstock
          * @apioption tooltip.split
          */
 
@@ -2635,14 +2924,16 @@ H.defaultOptions = {
          * tooltip. It is also recommended for rtl languages as it works around
          * rtl bugs in early Firefox.
          *
-         * @type {Boolean}
          * @sample {highcharts|highstock} highcharts/tooltip/footerformat/
          *         A table for value alignment
          * @sample {highcharts|highstock} highcharts/tooltip/fullhtml/
          *         Full HTML tooltip
-         * @sample {highmaps} maps/tooltip/usehtml/ Pure HTML tooltip
-         * @default false
-         * @since 2.2
+         * @sample {highmaps} maps/tooltip/usehtml/
+         *         Pure HTML tooltip
+         *
+         * @type      {boolean}
+         * @default   false
+         * @since     2.2
          * @apioption tooltip.useHTML
          */
 
@@ -2651,12 +2942,13 @@ H.defaultOptions = {
          * overridable in each series' tooltip options object. The default is to
          * preserve all decimals.
          *
-         * @type {Number}
          * @sample {highcharts|highstock} highcharts/tooltip/valuedecimals/
          *         Set decimals, prefix and suffix for the value
          * @sample {highmaps} maps/tooltip/valuedecimals/
          *         Set decimals, prefix and suffix for the value
-         * @since 2.2
+         *
+         * @type      {number}
+         * @since     2.2
          * @apioption tooltip.valueDecimals
          */
 
@@ -2664,12 +2956,13 @@ H.defaultOptions = {
          * A string to prepend to each series' y value. Overridable in each
          * series' tooltip options object.
          *
-         * @type {String}
          * @sample {highcharts|highstock} highcharts/tooltip/valuedecimals/
          *         Set decimals, prefix and suffix for the value
          * @sample {highmaps} maps/tooltip/valuedecimals/
          *         Set decimals, prefix and suffix for the value
-         * @since 2.2
+         *
+         * @type      {string}
+         * @since     2.2
          * @apioption tooltip.valuePrefix
          */
 
@@ -2677,12 +2970,13 @@ H.defaultOptions = {
          * A string to append to each series' y value. Overridable in each
          * series' tooltip options object.
          *
-         * @type {String}
          * @sample {highcharts|highstock} highcharts/tooltip/valuedecimals/
          *         Set decimals, prefix and suffix for the value
          * @sample {highmaps} maps/tooltip/valuedecimals/
          *         Set decimals, prefix and suffix for the value
-         * @since 2.2
+         *
+         * @type      {string}
+         * @since     2.2
          * @apioption tooltip.valueSuffix
          */
 
@@ -2691,44 +2985,53 @@ H.defaultOptions = {
          * datetime axis. The default is a best guess based on the smallest
          * distance between points in the chart.
          *
-         * @type {String}
-         * @sample {highcharts} highcharts/tooltip/xdateformat/ A different format
-         * @product highcharts highstock
+         * @sample {highcharts} highcharts/tooltip/xdateformat/
+         *         A different format
+         *
+         * @type      {string}
+         * @product   highcharts highstock gantt
          * @apioption tooltip.xDateFormat
          */
 
+        /**
+         * How many decimals to show for the `point.change` value when the
+         * `series.compare` option is set. This is overridable in each series'
+         * tooltip options object. The default is to preserve all decimals.
+         *
+         * @type      {number}
+         * @since     1.0.1
+         * @product   highstock
+         * @apioption tooltip.changeDecimals
+         */
+
         /**
          * Enable or disable the tooltip.
          *
-         * @type {Boolean}
-         * @sample {highcharts} highcharts/tooltip/enabled/ Disabled
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-point-events-mouseover/
+         * @sample {highcharts} highcharts/tooltip/enabled/
+         *         Disabled
+         * @sample {highcharts} highcharts/plotoptions/series-point-events-mouseover/
          *         Disable tooltip and show values on chart instead
-         * @default true
          */
         enabled: true,
 
         /**
          * Enable or disable animation of the tooltip.
          *
-         * @type {Boolean}
-         * @default true
-         * @since 2.3.0
+         * @type       {boolean}
+         * @default    true
+         * @since      2.3.0
          */
         animation: svg,
 
         /**
          * The radius of the rounded border corners.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/tooltip/bordercolor-default/
          *         5px by default
          * @sample {highcharts} highcharts/tooltip/borderradius-0/
          *         Square borders
          * @sample {highmaps} maps/tooltip/background-border/
          *         Background and border demo
-         * @default 3
          */
         borderRadius: 3,
 
@@ -2739,22 +3042,10 @@ H.defaultOptions = {
          * each unit. For an overview of the replacement codes, see
          * [dateFormat](/class-reference/Highcharts#dateFormat).
          *
-         * Defaults to:
-         *
-         * <pre>{
-         *     millisecond:"%A, %b %e, %H:%M:%S.%L",
-         *     second:"%A, %b %e, %H:%M:%S",
-         *     minute:"%A, %b %e, %H:%M",
-         *     hour:"%A, %b %e, %H:%M",
-         *     day:"%A, %b %e, %Y",
-         *     week:"Week from %A, %b %e, %Y",
-         *     month:"%B %Y",
-         *     year:"%Y"
-         * }</pre>
-         *
-         * @type {Object}
          * @see [xAxis.dateTimeLabelFormats](#xAxis.dateTimeLabelFormats)
-         * @product highcharts highstock
+         *
+         * @type    {Highcharts.Dictionary<string>}
+         * @product highcharts highstock gantt
          */
         dateTimeLabelFormats: {
             millisecond: '%A, %b %e, %H:%M:%S.%L',
@@ -2772,7 +3063,9 @@ H.defaultOptions = {
          *
          * @sample {highcharts} highcharts/tooltip/footerformat/
          *         A table for value alignment
-         * @sample {highmaps} maps/tooltip/format/ Format demo
+         * @sample {highmaps} maps/tooltip/format/
+         *         Format demo
+         *
          * @since 2.2
          */
         footerFormat: '',
@@ -2780,9 +3073,7 @@ H.defaultOptions = {
         /**
          * Padding inside the tooltip, in pixels.
          *
-         * @type {Number}
-         * @default 8
-         * @since 5.0.0
+         * @since      5.0.0
          */
         padding: 8,
 
@@ -2796,15 +3087,18 @@ H.defaultOptions = {
          * is `true` (default) and when the tooltip is [shared](#tooltip.shared)
          * or [split](#tooltip.split).
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/tooltip/bordercolor-default/
          *         10 px by default
-         * @sample {highcharts} highcharts/tooltip/snap-50/ 50 px on graph
+         * @sample {highcharts} highcharts/tooltip/snap-50/
+         *         50 px on graph
+         *
+         * @type    {number}
          * @default 10/25
-         * @since 1.2.0
+         * @since   1.2.0
          * @product highcharts highstock
          */
         snap: isTouchDevice ? 25 : 10,
+
         
 
         /**
@@ -2813,21 +3107,22 @@ H.defaultOptions = {
          * In styled mode, the stroke width is set in the
          * `.highcharts-tooltip-box` class.
          *
-         * @type {Color}
          * @sample {highcharts} highcharts/tooltip/backgroundcolor-solid/
          *         Yellowish background
          * @sample {highcharts} highcharts/tooltip/backgroundcolor-gradient/
          *         Gradient
          * @sample {highcharts} highcharts/css/tooltip-border-background/
          *         Tooltip in styled mode
-         * @sample {highstock} stock/tooltip/general/ Custom tooltip
+         * @sample {highstock} stock/tooltip/general/
+         *         Custom tooltip
          * @sample {highstock} highcharts/css/tooltip-border-background/
          *         Tooltip in styled mode
          * @sample {highmaps} maps/tooltip/background-border/
          *         Background and border demo
          * @sample {highmaps} highcharts/css/tooltip-border-background/
          *         Tooltip in styled mode
-         * @default rgba(247,247,247,0.85)
+         *
+         * @type {Highcharts.ColorString}
          */
         backgroundColor: color('#f7f7f7')
             .setOpacity(0.85).get(),
@@ -2838,7 +3133,6 @@ H.defaultOptions = {
          * In styled mode, the stroke width is set in the
          * `.highcharts-tooltip-box` class.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/tooltip/bordercolor-default/
          *         2px by default
          * @sample {highcharts} highcharts/tooltip/borderwidth/
@@ -2853,7 +3147,6 @@ H.defaultOptions = {
          *         Background and border demo
          * @sample {highmaps} highcharts/css/tooltip-border-background/
          *         Tooltip in styled mode
-         * @default 1
          */
         borderWidth: 1,
 
@@ -2864,14 +3157,15 @@ H.defaultOptions = {
          * objects. The `point.key` variable contains the category name, x
          * value or datetime string depending on the type of axis. For datetime
          * axes, the `point.key` date format can be set using
-         * `tooltip.xDateFormat`.
+         * `tooltip.xDateFormat`. To access the original point use
+         * `point.point`.
          *
-         * @type {String}
          * @sample {highcharts} highcharts/tooltip/footerformat/
-         *         A HTML table in the tooltip
+         *         An HTML table in the tooltip
          * @sample {highstock} highcharts/tooltip/footerformat/
-         *         A HTML table in the tooltip
-         * @sample {highmaps} maps/tooltip/format/ Format demo
+         *         An HTML table in the tooltip
+         * @sample {highmaps} maps/tooltip/format/
+         *         Format demo
          */
         headerFormat: '<span style="font-size: 10px">{point.key}</span><br/>',
 
@@ -2886,11 +3180,11 @@ H.defaultOptions = {
          * In styled mode, the dot is colored by a class name rather
          * than the point color.
          *
-         * @type {String}
          * @sample {highcharts} highcharts/tooltip/pointformat/
          *         A different point format with value suffix
-         * @sample {highmaps} maps/tooltip/format/ Format demo
-         * @default <span style="color:{point.color}">\u25CF</span> {series.name}: <b>{point.y}</b><br/>
+         * @sample {highmaps} maps/tooltip/format/
+         *         Format demo
+         *
          * @since 2.2
          */
         pointFormat: '<span style="color:{point.color}">\u25CF</span> {series.name}: <b>{point.y}</b><br/>',
@@ -2898,14 +3192,12 @@ H.defaultOptions = {
         /**
          * Whether to apply a drop shadow to the tooltip.
          *
-         * @type {Boolean}
          * @sample {highcharts} highcharts/tooltip/bordercolor-default/
          *         True by default
          * @sample {highcharts} highcharts/tooltip/shadow/
          *         False
          * @sample {highmaps} maps/tooltip/positioner/
          *         Fixed tooltip position, border and shadow disabled
-         * @default true
          */
         shadow: true,
 
@@ -2913,17 +3205,33 @@ H.defaultOptions = {
          * CSS styles for the tooltip. The tooltip can also be styled through
          * the CSS class `.highcharts-tooltip`.
          *
-         * @type {CSSObject}
          * @sample {highcharts} highcharts/tooltip/style/
          *         Greater padding, bold text
-         * @default { "color": "#333333", "cursor": "default", "fontSize": "12px", "pointerEvents": "none", "whiteSpace": "nowrap" }
+         *
+         * @type    {Highcharts.CSSObject}
+         * @default {"color": "#333333", "cursor": "default", "fontSize": "12px", "pointerEvents": "none", "whiteSpace": "nowrap"}
          */
         style: {
+            /**
+             * @ignore
+             */
             color: '#333333',
+            /**
+             * @ignore
+             */
             cursor: 'default',
+            /**
+             * @ignore
+             */
             fontSize: '12px',
-            // #1686 http://caniuse.com/#feat=pointer-events
+            /**
+             * @ignore
+             */
             pointerEvents: 'none',
+            // #1686 http://caniuse.com/#feat=pointer-events
+            /**
+             * @ignore
+             */
             whiteSpace: 'nowrap'
         }
         
@@ -2936,37 +3244,70 @@ H.defaultOptions = {
      */
     credits: {
 
+        /**
+         * Credits for map source to be concatenated with conventional credit
+         * text. By default this is a format string that collects copyright
+         * information from the map if available.
+         *
+         * @see [mapTextFull](#credits.mapTextFull)
+         * @see [text](#credits.text)
+         *
+         * @type      {string}
+         * @default   \u00a9 <a href="{geojson.copyrightUrl}">{geojson.copyrightShort}</a>
+         * @since     4.2.2
+         * @product   highmaps
+         * @apioption credits.mapText
+         */
+
+        /**
+         * Detailed credits for map source to be displayed on hover of credits
+         * text. By default this is a format string that collects copyright
+         * information from the map if available.
+         *
+         * @see [mapText](#credits.mapText)
+         * @see [text](#credits.text)
+         *
+         * @type      {string}
+         * @default   {geojson.copyright}
+         * @since     4.2.2
+         * @product   highmaps
+         * @apioption credits.mapTextFull
+         */
+
         /**
          * Whether to show the credits text.
          *
-         * @type {Boolean}
-         * @sample {highcharts} highcharts/credits/enabled-false/ Credits disabled
-         * @sample {highstock} stock/credits/enabled/ Credits disabled
-         * @sample {highmaps} maps/credits/enabled-false/ Credits disabled
-         * @default true
+         * @sample {highcharts} highcharts/credits/enabled-false/
+         *         Credits disabled
+         * @sample {highstock} stock/credits/enabled/
+         *         Credits disabled
+         * @sample {highmaps} maps/credits/enabled-false/
+         *         Credits disabled
          */
         enabled: true,
 
         /**
          * The URL for the credits label.
          *
-         * @type {String}
-         * @sample {highcharts} highcharts/credits/href/ Custom URL and text
-         * @sample {highmaps} maps/credits/customized/ Custom URL and text
-         * @default {highcharts} http://www.highcharts.com
-         * @default {highstock} "http://www.highcharts.com"
-         * @default {highmaps} http://www.highcharts.com
+         * @sample {highcharts} highcharts/credits/href/
+         *         Custom URL and text
+         * @sample {highmaps} maps/credits/customized/
+         *         Custom URL and text
          */
-        href: 'http://www.highcharts.com',
+        href: 'https://www.highcharts.com',
 
         /**
          * Position configuration for the credits label.
          *
-         * @type {Object}
-         * @sample {highcharts} highcharts/credits/position-left/ Left aligned
-         * @sample {highcharts} highcharts/credits/position-left/ Left aligned
-         * @sample {highmaps} maps/credits/customized/ Left aligned
-         * @sample {highmaps} maps/credits/customized/ Left aligned
+         * @sample {highcharts} highcharts/credits/position-left/
+         *         Left aligned
+         * @sample {highcharts} highcharts/credits/position-left/
+         *         Left aligned
+         * @sample {highmaps} maps/credits/customized/
+         *         Left aligned
+         * @sample {highmaps} maps/credits/customized/
+         *         Left aligned
+         *
          * @since 2.1
          */
         position: {
@@ -2975,16 +3316,11 @@ H.defaultOptions = {
              * Horizontal alignment of the credits.
              *
              * @validvalue ["left", "center", "right"]
-             * @type {String}
-             * @default right
              */
             align: 'right',
 
             /**
              * Horizontal pixel offset of the credits.
-             *
-             * @type {Number}
-             * @default -10
              */
             x: -10,
 
@@ -2992,35 +3328,42 @@ H.defaultOptions = {
              * Vertical alignment of the credits.
              *
              * @validvalue ["top", "middle", "bottom"]
-             * @type {String}
-             * @default bottom
              */
             verticalAlign: 'bottom',
 
             /**
              * Vertical pixel offset of the credits.
-             *
-             * @type {Number}
-             * @default -5
              */
             y: -5
+
         },
+
         
 
         /**
          * CSS styles for the credits label.
          *
-         * @type {CSSObject}
          * @see In styled mode, credits styles can be set with the
-         * `.highcharts-credits` class.
-         * @default { "cursor": "pointer", "color": "#999999", "fontSize": "10px" }
+         *      `.highcharts-credits` class.
+         *
+         * @type    {Highcharts.CSSObject}
+         * @default {"cursor": "pointer", "color": "#999999", "fontSize": "10px"}
          */
         style: {
-
+            /**
+             * @ignore
+             */
             cursor: 'pointer',
+            /**
+             * @ignore
+             */
             color: '#999999',
+            /**
+             * @ignore
+             */
             fontSize: '9px'
         },
+
         
 
         /**
@@ -3031,12 +3374,13 @@ H.defaultOptions = {
          * `Highcharts @ {map-credits}`. Otherwise, it defaults to
          * `Highcharts.com`.
          *
-         * @type {String}
-         * @sample {highcharts} highcharts/credits/href/ Custom URL and text
-         * @sample {highmaps} maps/credits/customized/ Custom URL and text
-         * @default {highcharts|highstock} Highcharts.com
+         * @sample {highcharts} highcharts/credits/href/
+         *         Custom URL and text
+         * @sample {highmaps} maps/credits/customized/
+         *         Custom URL and text
          */
         text: 'Highcharts.com'
+
     }
 };
 
@@ -3044,12 +3388,16 @@ H.defaultOptions = {
  * Merge the default options with custom options and return the new options
  * structure. Commonly used for defining reusable templates.
  *
- * @function #setOptions
- * @memberof Highcharts
  * @sample highcharts/global/useutc-false Setting a global option
  * @sample highcharts/members/setoptions Applying a global theme
- * @param {Object} options The new custom chart options.
- * @returns {Object} Updated options.
+ *
+ * @function Highcharts.setOptions
+ *
+ * @param {Highcharts.Options} options
+ *        The new custom chart options.
+ *
+ * @return {Highcharts.Options}
+ *         Updated options.
  */
 H.setOptions = function (options) {
 
@@ -3069,6 +3417,10 @@ H.setOptions = function (options) {
  * Get the updated default options. Until 3.0.7, merely exposing defaultOptions
  * for outside modules wasn't enough because the setOptions method created a new
  * object.
+ *
+ * @function Highcharts.getOptions
+ *
+ * @return {Highcharts.Options}
  */
 H.getOptions = function () {
     return H.defaultOptions;
@@ -3079,7 +3431,14 @@ H.getOptions = function () {
 H.defaultPlotOptions = H.defaultOptions.plotOptions;
 
 
-// Time utilities
+/**
+ * Global `Time` object with default options. Since v6.0.5, time settings can be
+ * applied individually for each chart. If no individual settings apply, this
+ * `Time` object is shared by all instances.
+ *
+ * @name Highcharts.time
+ * @type {Highcharts.Time}
+ */
 H.time = new H.Time(merge(H.defaultOptions.global, H.defaultOptions.time));
 
 /**
@@ -3094,13 +3453,20 @@ H.time = new H.Time(merge(H.defaultOptions.global, H.defaultOptions.time));
  * `Highcharts.dateFormat` function only reflects global time settings set with
  * `setOptions`.
  *
- * @function #dateFormat
- * @memberof Highcharts
- * @param {String} format - The desired format where various time
- *        representations are prefixed with %.
- * @param {Number} timestamp - The JavaScript timestamp.
- * @param {Boolean} [capitalize=false] - Upper case first letter in the return.
- * @returns {String} The formatted date.
+ * @function Highcharts.dateFormat
+ *
+ * @param {string} format
+ *        The desired format where various time representations are prefixed
+ *        with `%`.
+ *
+ * @param {number} timestamp
+ *        The JavaScript timestamp.
+ *
+ * @param {boolean} [capitalize=false]
+ *        Upper case first letter in the return.
+ *
+ * @return {string}
+ *         The formatted date.
  */
 H.dateFormat = function (format, timestamp, capitalize) {
     return H.time.dateFormat(format, timestamp, capitalize);