highcharts 6.1.1 → 6.2.0

package/js/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 = {
@@ -26,12 +31,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
      */
 
@@ -39,14 +44,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...',
 
@@ -54,10 +76,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',
@@ -68,9 +90,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',
@@ -80,7 +102,7 @@ H.defaultOptions = {
         /**
          * An array containing the weekday names.
          *
-         * @type {Array<String>}
+         * @type    {Array<string>}
          * @default ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday",
          *          "Friday", "Saturday"]
          */
@@ -93,10 +115,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
          */
 
@@ -104,18 +127,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: '.',
@@ -126,13 +167,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'],
 
@@ -141,19 +183,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',
@@ -161,8 +202,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',
@@ -176,9 +215,8 @@ H.defaultOptions = {
          *
          * The default is a single space.
          *
-         * @type {String}
-         * @default
-         * @since 1.2.2
+         * @default \u0020
+         * @since   1.2.2
          */
         thousandsSep: ' '
     },
@@ -207,10 +245,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
      */
 
@@ -220,7 +259,8 @@ H.defaultOptions = {
      * per chart.
      *
      * @deprecated
-     * @type {Boolean}
+     *
+     * @type      {boolean}
      * @apioption global.useUTC
      */
 
@@ -230,8 +270,9 @@ H.defaultOptions = {
      * per chart.
      *
      * @deprecated
-     * @type {Object}
-     * @product highcharts highstock
+     *
+     * @type      {Function}
+     * @product   highcharts highstock
      * @apioption global.Date
      */
 
@@ -241,8 +282,9 @@ H.defaultOptions = {
      * individual time settings per chart.
      *
      * @deprecated
-     * @type {Function}
-     * @product highcharts highstock
+     *
+     * @type      {Function}
+     * @product   highcharts highstock
      * @apioption global.getTimezoneOffset
      */
 
@@ -252,8 +294,9 @@ H.defaultOptions = {
      * settings per chart.
      *
      * @deprecated
-     * @type {String}
-     * @product highcharts highstock
+     *
+     * @type      {string}
+     * @product   highcharts highstock
      * @apioption global.timezone
      */
 
@@ -263,21 +306,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
@@ -292,21 +358,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
@@ -329,13 +395,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/
@@ -346,7 +411,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
          */
 
@@ -354,7 +421,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
          */
 
@@ -372,11 +439,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
          */
 
@@ -397,8 +467,6 @@ H.defaultOptions = {
          *     )
          * }</pre>
          *
-         * @type {Function}
-         * @context Chart
          * @sample {highcharts} highcharts/chart/events-click/
          *         Alert coordinates on click
          * @sample {highcharts} highcharts/chart/events-container/
@@ -411,7 +479,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
          */
 
@@ -425,14 +496,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
          */
 
@@ -442,8 +514,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/
@@ -451,7 +521,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
          */
 
@@ -459,9 +532,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
          */
 
@@ -495,7 +568,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/
@@ -505,6 +577,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
          */
 
@@ -519,13 +593,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
          */
 
@@ -534,14 +607,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
          */
 
@@ -550,15 +624,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
          */
 
@@ -567,15 +641,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
          */
 
@@ -584,14 +658,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
          */
 
@@ -602,11 +676,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
          */
 
         /**
@@ -618,12 +692,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
          */
 
@@ -637,25 +712,28 @@ 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,
+
         
 
         /**
@@ -665,21 +743,20 @@ H.defaultOptions = {
          * [...] `highcharts-color-9`. The equivalent in non-styled mode
          * is to set colors using the [colors](#colors) setting.
          *
-         * @type {Number}
-         * @default 10
-         * @since 5.0.0
+         * @since      5.0.0
          */
         colorCount: 10,
+
         
 
         /**
          * 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',
@@ -691,7 +768,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/
@@ -702,9 +778,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,
 
@@ -720,13 +796,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
          */
 
@@ -737,17 +814,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: {
 
@@ -755,15 +831,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
              */
 
             /**
@@ -773,11 +850,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: {
@@ -792,44 +869,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
             }
@@ -838,13 +909,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
          */
 
@@ -853,13 +926,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
          */
 
@@ -877,10 +952,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
          */
 
@@ -888,9 +963,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/
@@ -899,8 +975,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
          */
 
@@ -910,7 +988,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/
@@ -923,6 +1000,8 @@ H.defaultOptions = {
          *         Object reference
          * @sample {highstock} stock/chart/renderto-jquery/
          *         Object reference through jQuery
+         *
+         * @type      {string|Highcharts.SVGDOMElement}
          * @apioption chart.renderTo
          */
 
@@ -930,11 +1009,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
          */
 
@@ -944,13 +1024,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
          */
 
@@ -959,11 +1041,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
          */
 
@@ -972,15 +1057,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
          */
 
@@ -989,15 +1075,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
          */
 
@@ -1006,7 +1093,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/
@@ -1015,8 +1101,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
          */
 
@@ -1025,7 +1113,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/
@@ -1035,8 +1122,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
          */
 
@@ -1045,7 +1134,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/
@@ -1056,7 +1144,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
          */
 
@@ -1064,49 +1154,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,
 
@@ -1121,7 +1229,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/
@@ -1130,7 +1237,8 @@ H.defaultOptions = {
          *         Chart with explicit size
          * @sample highcharts/chart/height-percent/
          *         Highcharts with percentage height
-         * @default null
+         *
+         * @type {number|string|null}
          */
         height: null
 
@@ -1141,7 +1249,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: {
 
@@ -1149,14 +1258,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
          */
 
@@ -1167,21 +1278,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
          */
 
@@ -1190,29 +1306,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
          */
 
@@ -1221,24 +1339,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',
 
@@ -1246,16 +1367,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',
 
@@ -1263,14 +1383,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,
@@ -1279,10 +1398,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
@@ -1295,7 +1413,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: {
 
@@ -1303,13 +1422,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
          */
 
@@ -1319,7 +1439,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/
@@ -1330,16 +1449,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
          */
 
@@ -1347,28 +1469,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
          */
 
@@ -1377,22 +1500,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/
@@ -1404,14 +1524,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',
 
@@ -1419,11 +1538,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
@@ -1440,27 +1559,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
          */
 
@@ -1473,18 +1590,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'
         }
     },
@@ -1494,9 +1617,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
@@ -1508,40 +1630,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,
 
@@ -1553,15 +1687,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',
 
@@ -1579,12 +1713,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
          */
 
@@ -1595,8 +1733,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/
@@ -1609,7 +1745,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',
 
@@ -1617,39 +1754,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
          */
 
@@ -1659,25 +1801,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
          */
 
@@ -1687,14 +1829,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;
@@ -1706,11 +1849,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
          */
 
@@ -1719,12 +1866,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
          */
 
@@ -1732,45 +1881,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: {
 
@@ -1780,13 +1930,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
              */
 
@@ -1794,13 +1945,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
              */
 
@@ -1809,27 +1961,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
              */
 
@@ -1839,13 +1993,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
          */
 
@@ -1853,13 +2008,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
          */
 
@@ -1867,10 +2024,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
          */
 
@@ -1878,11 +2037,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
          */
 
@@ -1891,10 +2051,22 @@ H.defaultOptions = {
         /**
          * 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,
@@ -1904,8 +2076,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,
@@ -1918,12 +2088,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
          */
 
@@ -1931,11 +2102,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
          */
 
@@ -1947,34 +2122,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.
          *
-         * @type {Boolean}
-         * @default false
+         * Prior to 4.1.7, when using HTML, [legend.navigation](
+         * #legend.navigation) was disabled.
+         *
+         * @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
          */
 
@@ -1982,9 +2160,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,
 
@@ -2000,16 +2177,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,
 
         /**
@@ -2017,9 +2196,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,
@@ -2029,11 +2208,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,
@@ -2041,21 +2222,24 @@ 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
              */
 
             
+
         }
     },
 
@@ -2068,29 +2252,33 @@ 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
          */
+
         
     },
 
@@ -2098,16 +2286,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/
@@ -2116,7 +2302,8 @@ H.defaultOptions = {
          *         Styled tooltip
          * @sample {highmaps} maps/tooltip/background-border/
          *         Background and border demo
-         * @default null
+         *
+         * @type      {Highcharts.ColorString}
          * @apioption tooltip.borderColor
          */
 
@@ -2125,11 +2312,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
          */
 
@@ -2142,25 +2331,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
          */
 
@@ -2223,7 +2418,6 @@ H.defaultOptions = {
          *
          * </dl>
          *
-         * @type {Function}
          * @sample {highcharts} highcharts/tooltip/formatter-simple/
          *         Simple string formatting
          * @sample {highcharts} highcharts/tooltip/formatter-shared/
@@ -2232,6 +2426,8 @@ H.defaultOptions = {
          *         Formatting with shared tooltip
          * @sample {highmaps} maps/tooltip/formatter/
          *         String formatting
+         *
+         * @type      {Function}
          * @apioption tooltip.formatter
          */
 
@@ -2239,9 +2435,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
          */
 
@@ -2254,11 +2450,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
          */
 
@@ -2267,9 +2464,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
          */
 
@@ -2283,25 +2480,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"`.
          *
-         * @type {String}
-         * @default callout
+         * 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
+         * @since      4.0
          * @validvalue ["callout", "square"]
-         * @since 4.0
-         * @apioption tooltip.shape
+         * @apioption  tooltip.shape
          */
 
         /**
@@ -2315,17 +2518,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
          */
 
@@ -2340,12 +2545,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
          */
 
@@ -2355,14 +2562,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
          */
 
@@ -2371,12 +2580,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
          */
 
@@ -2384,12 +2594,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
          */
 
@@ -2397,12 +2608,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
          */
 
@@ -2411,44 +2623,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,
 
@@ -2459,22 +2680,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',
@@ -2492,7 +2701,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: '',
@@ -2500,9 +2711,7 @@ H.defaultOptions = {
         /**
          * Padding inside the tooltip, in pixels.
          *
-         * @type {Number}
-         * @default 8
-         * @since 5.0.0
+         * @since      5.0.0
          */
         padding: 8,
 
@@ -2516,20 +2725,26 @@ 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,
+
         
+
         headerFormat: '<span class="highcharts-header">{point.key}</span><br/>',
+
         pointFormat: '<span class="highcharts-color-{point.colorIndex}">' +
             '\u25CF</span> {series.name}: <span class="highcharts-strong">' +
             '{point.y}</span><br/>'
+
         
     },
 
@@ -2540,37 +2755,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: {
@@ -2579,16 +2827,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,
 
@@ -2596,19 +2839,16 @@ 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
+
         },
+
         
 
         /**
@@ -2619,12 +2859,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'
+
     }
 };
 
@@ -2632,12 +2873,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) {
 
@@ -2657,6 +2902,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;
@@ -2667,7 +2916,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));
 
 /**
@@ -2682,13 +2938,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);