highcharts 6.1.1 → 6.2.0

package/js/es-modules/parts/Axis.js

@@ -1,9 +1,67 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
+
+/**
+ * Options for crosshairs on axes.
+ *
+ * @typedef {Highcharts.XAxisCrosshairOptions|Highcharts.YAxisCrosshairOptions} Highcharts.AxisCrosshairOptions
+ */
+
+/**
+ * Options for axes.
+ *
+ * @typedef {Highcharts.XAxisOptions|Highcharts.YAxisOptions|Highcharts.ZAxisOptions} Highcharts.AxisOptions
+ */
+
+/**
+ * Position of the axis title.
+ *
+ * @typedef Highcharts.AxisTitlePositionObject
+ *
+ * @property {number} x
+ *           X position.
+ *
+ * @property {number} y
+ *           Y position.
+ */
+
+/**
+ * The returned object literal from the {@link Highcharts.Axis#getExtremes}
+ * function.
+ *
+ * @typedef Highcharts.ExtremesObject
+ *
+ * @property {number} dataMax
+ *           The maximum value of the axis' associated series.
+ *
+ * @property {number} dataMin
+ *           The minimum value of the axis' associated series.
+ *
+ * @property {number} max
+ *           The maximum axis value, either automatic or set manually. If
+ *           the `max` option is not set, `maxPadding` is 0 and `endOnTick`
+ *           is false, this value will be the same as `dataMax`.
+ *
+ * @property {number} min
+ *           The minimum axis value, either automatic or set manually. If
+ *           the `min` option is not set, `minPadding` is 0 and
+ *           `startOnTick` is false, this value will be the same
+ *           as `dataMin`.
+ *
+ * @property {number} userMax
+ *           The user defined maximum, either from the `max` option or from
+ *           a zoom or `setExtremes` action.
+ *
+ * @property {number} userMin
+ *           The user defined minimum, either from the `min` option or from
+ *           a zoom or `setExtremes` action.
+ */
+
 'use strict';
+
 import H from './Globals.js';
 import './Utilities.js';
 import './Color.js';
@@ -62,10 +120,14 @@ var addEvent = H.addEvent,
  * Configuration options for the axes are given in options.xAxis and
  * options.yAxis.
  *
- * @class Highcharts.Axis
- * @memberof Highcharts
- * @param {Highcharts.Chart} chart - The Chart instance to apply the axis on.
- * @param {Object} options - Axis options
+ * @class
+ * @name Highcharts.Axis
+ *
+ * @param {Highcharts.Chart} chart
+ *        The Chart instance to apply the axis on.
+ *
+ * @param {Highcharts.AxisOptions} options
+ *        Axis options.
  */
 var Axis = function () {
     this.init.apply(this, arguments);
@@ -89,39 +151,57 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * @optionparent xAxis
      */
     defaultOptions: {
+
+        /**
+         * When using multiple axis, the ticks of two or more opposite axes
+         * will automatically be aligned by adding ticks to the axis or axes
+         * with the least ticks, as if `tickAmount` were specified.
+         *
+         * This can be prevented by setting `alignTicks` to false. If the grid
+         * lines look messy, it's a good idea to hide them for the secondary
+         * axis by setting `gridLineWidth` to 0.
+         *
+         * If `startOnTick` or `endOnTick` in an Axis options are set to false,
+         * then the `alignTicks ` will be disabled for the Axis.
+         *
+         * Disabled for logarithmic axes.
+         *
+         * @type      {boolean}
+         * @default   true
+         * @product   highcharts highstock gantt
+         * @apioption xAxis.alignTicks
+         */
+
         /**
          * Whether to allow decimals in this axis' ticks. When counting
          * integers, like persons or hits on a web page, decimals should
          * be avoided in the labels.
          *
-         * @type      {Boolean}
-         * @see       [minTickInterval](#xAxis.minTickInterval)
-         * @sample    {highcharts|highstock}
-         *            highcharts/yaxis/allowdecimals-true/
-         *            True by default
-         * @sample    {highcharts|highstock}
-         *            highcharts/yaxis/allowdecimals-false/
-         *            False
+         * @see [minTickInterval](#xAxis.minTickInterval)
+         *
+         * @sample {highcharts|highstock} highcharts/yaxis/allowdecimals-true/
+         *         True by default
+         * @sample {highcharts|highstock} highcharts/yaxis/allowdecimals-false/
+         *         False
+         *
+         * @type      {boolean}
          * @default   true
          * @since     2.0
          * @apioption xAxis.allowDecimals
          */
-        // allowDecimals: null,
-
 
         /**
          * When using an alternate grid color, a band is painted across the
          * plot area between every other grid line.
          *
-         * @type      {Color}
-         * @sample    {highcharts} highcharts/yaxis/alternategridcolor/
-         *            Alternate grid color on the Y axis
-         * @sample    {highstock} stock/xaxis/alternategridcolor/
-         *            Alternate grid color on the Y axis
-         * @default   null
+         * @sample {highcharts} highcharts/yaxis/alternategridcolor/
+         *         Alternate grid color on the Y axis
+         * @sample {highstock} stock/xaxis/alternategridcolor/
+         *         Alternate grid color on the Y axis
+         *
+         * @type      {Highcharts.ColorString}
          * @apioption xAxis.alternateGridColor
          */
-        // alternateGridColor: null,
 
         /**
          * An array defining breaks in the axis, the sections defined will be
@@ -130,18 +210,16 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * @productdesc {highcharts}
          * Requires that the broken-axis.js module is loaded.
          *
-         * @type      {Array}
-         * @sample    {highcharts}
-         *            highcharts/axisbreak/break-simple/
-         *            Simple break
-         * @sample    {highcharts|highstock}
-         *            highcharts/axisbreak/break-visualized/
-         *            Advanced with callback
-         * @sample    {highstock}
-         *            stock/demo/intraday-breaks/
-         *            Break on nights and weekends
+         * @sample {highcharts} highcharts/axisbreak/break-simple/
+         *         Simple break
+         * @sample {highcharts|highstock} highcharts/axisbreak/break-visualized/
+         *         Advanced with callback
+         * @sample {highstock} stock/demo/intraday-breaks/
+         *         Break on nights and weekends
+         *
+         * @type      {Array<*>}
          * @since     4.1.0
-         * @product   highcharts highstock
+         * @product   highcharts highstock gantt
          * @apioption xAxis.breaks
          */
 
@@ -151,19 +229,19 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * so for instance on a `datetime` axis, a break size of 3600000 would
          * indicate the equivalent of an hour.
          *
-         * @type      {Number}
+         * @type      {number}
          * @default   0
          * @since     4.1.0
-         * @product   highcharts highstock
+         * @product   highcharts highstock gantt
          * @apioption xAxis.breaks.breakSize
          */
 
         /**
          * The point where the break starts.
          *
-         * @type      {Number}
+         * @type      {number}
          * @since     4.1.0
-         * @product   highcharts highstock
+         * @product   highcharts highstock gantt
          * @apioption xAxis.breaks.from
          */
 
@@ -171,19 +249,19 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * Defines an interval after which the break appears again. By default
          * the breaks do not repeat.
          *
-         * @type      {Number}
+         * @type      {number}
          * @default   0
          * @since     4.1.0
-         * @product   highcharts highstock
+         * @product   highcharts highstock gantt
          * @apioption xAxis.breaks.repeat
          */
 
         /**
          * The point where the break ends.
          *
-         * @type      {Number}
+         * @type      {number}
          * @since     4.1.0
-         * @product   highcharts highstock
+         * @product   highcharts highstock gantt
          * @apioption xAxis.breaks.to
          */
 
@@ -198,27 +276,28 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          *
          * <pre>categories: ['Apples', 'Bananas', 'Oranges']</pre>
          *
-         * @type      {Array<String>}
-         * @sample    {highcharts} highcharts/chart/reflow-true/
-         *            With
-         * @sample    {highcharts} highcharts/xaxis/categories/
-         *            Without
+         * @sample {highcharts} highcharts/demo/line-labels/
+         *         With
+         * @sample {highcharts} highcharts/xaxis/categories/
+         *         Without
+         *
+         * @type      {Array<string>}
          * @product   highcharts
-         * @default   null
          * @apioption xAxis.categories
          */
-        // categories: [],
 
         /**
          * The highest allowed value for automatically computed axis extremes.
          *
-         * @type      {Number}
-         * @see       [floor](#xAxis.floor)
-         * @sample    {highcharts|highstock} highcharts/yaxis/floor-ceiling/
-         *            Floor and ceiling
-         * @since     4.0
-         * @product   highcharts highstock
-         * @apioption xAxis.ceiling
+         * @see [floor](#xAxis.floor)
+         *
+         * @sample {highcharts|highstock} highcharts/yaxis/floor-ceiling/
+         *         Floor and ceiling
+         *
+         * @type       {number}
+         * @since      4.0
+         * @product    highcharts highstock gantt
+         * @apioption  xAxis.ceiling
          */
 
         /**
@@ -226,10 +305,10 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * Highcharts styled mode. The class name is applied to group elements
          * for the grid, axis elements and labels.
          *
-         * @type      {String}
-         * @sample    {highcharts|highstock|highmaps}
-         *            highcharts/css/axis/
-         *            Multiple axes with separate styling
+         * @sample {highcharts|highstock|highmaps} highcharts/css/axis/
+         *         Multiple axes with separate styling
+         *
+         * @type      {string}
          * @since     5.0.0
          * @apioption xAxis.className
          */
@@ -243,16 +322,17 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * `.highcharts-xaxis-category` classes.
          *
          * @productdesc {highstock}
-         * In Highstock, bu default, the crosshair is enabled on the X axis and
+         * In Highstock, by default, the crosshair is enabled on the X axis and
          * disabled on the Y axis.
          *
-         * @type      {Boolean|Object}
-         * @sample    {highcharts} highcharts/xaxis/crosshair-both/
-         *            Crosshair on both axes
-         * @sample    {highstock} stock/xaxis/crosshairs-xy/
-         *            Crosshair on both axes
-         * @sample    {highmaps} highcharts/xaxis/crosshair-both/
-         *            Crosshair on both axes
+         * @sample {highcharts} highcharts/xaxis/crosshair-both/
+         *         Crosshair on both axes
+         * @sample {highstock} stock/xaxis/crosshairs-xy/
+         *         Crosshair on both axes
+         * @sample {highmaps} highcharts/xaxis/crosshair-both/
+         *         Crosshair on both axes
+         *
+         * @type      {boolean|*}
          * @default   false
          * @since     4.1
          * @apioption xAxis.crosshair
@@ -261,7 +341,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
         /**
          * A class name for the crosshair, especially as a hook for styling.
          *
-         * @type      {String}
+         * @type      {string}
          * @since     5.0.0
          * @apioption xAxis.crosshair.className
          */
@@ -271,10 +351,10 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * datetime axes, and `rgba(204,214,235,0.25)` for category axes, where
          * the crosshair by default highlights the whole category.
          *
-         * @type      {Color}
-         * @sample    {highcharts|highstock|highmaps}
-         *            highcharts/xaxis/crosshair-customized/
-         *            Customized crosshairs
+         * @sample {highcharts|highstock|highmaps} highcharts/xaxis/crosshair-customized/
+         *         Customized crosshairs
+         *
+         * @type      {Highcharts.ColorString}
          * @default   #cccccc
          * @since     4.1
          * @apioption xAxis.crosshair.color
@@ -285,30 +365,145 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * [series.dashStyle](#plotOptions.series.dashStyle)
          * for possible values.
          *
-         * @validvalue ["Solid", "ShortDash", "ShortDot", "ShortDashDot",
-         *              "ShortDashDotDot", "Dot", "Dash" ,"LongDash",
-         *              "DashDot", "LongDashDot", "LongDashDotDot"]
-         * @type       {String}
-         * @sample     {highcharts|highmaps} highcharts/xaxis/crosshair-dotted/
-         *             Dotted crosshair
-         * @sample     {highstock} stock/xaxis/crosshair-dashed/
-         *             Dashed X axis crosshair
+         * @sample {highcharts|highmaps} highcharts/xaxis/crosshair-dotted/
+         *         Dotted crosshair
+         * @sample {highstock} stock/xaxis/crosshair-dashed/
+         *         Dashed X axis crosshair
+         *
+         * @type       {string}
          * @default    Solid
          * @since      4.1
+         * @validvalue ["Solid", "ShortDash", "ShortDot", "ShortDashDot",
+         *             "ShortDashDotDot", "Dot", "Dash" ,"LongDash", "DashDot",
+         *             "LongDashDot", "LongDashDotDot"]
          * @apioption  xAxis.crosshair.dashStyle
          */
 
+        /**
+         * A label on the axis next to the crosshair.
+         *
+         * In styled mode, the label is styled with the
+         * `.highcharts-crosshair-label` class.
+         *
+         * @sample {highstock} stock/xaxis/crosshair-label/
+         *         Crosshair labels
+         * @sample {highstock} highcharts/css/crosshair-label/
+         *         Style mode
+         *
+         * @since     2.1
+         * @product   highstock
+         * @apioption xAxis.crosshair.label
+         */
+
+        /**
+         * Alignment of the label compared to the axis. Defaults to `left` for
+         * right-side axes, `right` for left-side axes and `center` for
+         * horizontal axes.
+         *
+         * @type      {string}
+         * @since     2.1
+         * @product   highstock
+         * @apioption xAxis.crosshair.label.align
+         */
+
+        /**
+         * The background color for the label. Defaults to the related series
+         * color, or `#666666` if that is not available.
+         *
+         * @type      {Highcharts.ColorString}
+         * @since     2.1
+         * @product   highstock
+         * @apioption xAxis.crosshair.label.backgroundColor
+         */
+
+        /**
+         * The border color for the crosshair label
+         *
+         * @type      {Highcharts.ColorString}
+         * @since     2.1
+         * @product   highstock
+         * @apioption xAxis.crosshair.label.borderColor
+         */
+
+        /**
+         * The border corner radius of the crosshair label.
+         *
+         * @type      {number}
+         * @default   3
+         * @since     2.1.10
+         * @product   highstock
+         * @apioption xAxis.crosshair.label.borderRadius
+         */
+
+        /**
+         * The border width for the crosshair label.
+         *
+         * @type      {number}
+         * @default   0
+         * @since     2.1
+         * @product   highstock
+         * @apioption xAxis.crosshair.label.borderWidth
+         */
+
+        /**
+         * A format string for the crosshair label. Defaults to `{value}` for
+         * numeric axes and `{value:%b %d, %Y}` for datetime axes.
+         *
+         * @type      {string}
+         * @since     2.1
+         * @product   highstock
+         * @apioption xAxis.crosshair.label.format
+         */
+
+        /**
+         * Formatter function for the label text.
+         *
+         * @type      {Highcharts.FormatterCallbackFunction}
+         * @since     2.1
+         * @product   highstock
+         * @apioption xAxis.crosshair.label.formatter
+         */
+
+        /**
+         * Padding inside the crosshair label.
+         *
+         * @type      {number}
+         * @default   8
+         * @since     2.1
+         * @product   highstock
+         * @apioption xAxis.crosshair.label.padding
+         */
+
+        /**
+         * The shape to use for the label box.
+         *
+         * @type      {string}
+         * @default   callout
+         * @since     2.1
+         * @product   highstock
+         * @apioption xAxis.crosshair.label.shape
+         */
+
+        /**
+         * Text styles for the crosshair label.
+         *
+         * @type      {Highcharts.CSSObject}
+         * @default   {"color": "white", "fontWeight": "normal", "fontSize": "11px", "textAlign": "center"}
+         * @since     2.1
+         * @product   highstock
+         * @apioption xAxis.crosshair.label.style
+         */
+
         /**
          * Whether the crosshair should snap to the point or follow the pointer
          * independent of points.
          *
-         * @type      {Boolean}
-         * @sample    {highcharts|highstock}
-         *            highcharts/xaxis/crosshair-snap-false/
-         *            True by default
-         * @sample    {highmaps}
-         *            maps/demo/latlon-advanced/
-         *            Snap is false
+         * @sample {highcharts|highstock} highcharts/xaxis/crosshair-snap-false/
+         *         True by default
+         * @sample {highmaps} maps/demo/latlon-advanced/
+         *         Snap is false
+         *
+         * @type      {boolean}
          * @default   true
          * @since     4.1
          * @apioption xAxis.crosshair.snap
@@ -318,13 +513,14 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * The pixel width of the crosshair. Defaults to 1 for numeric or
          * datetime axes, and for one category width for category axes.
          *
-         * @type      {Number}
-         * @sample    {highcharts} highcharts/xaxis/crosshair-customized/
-         *            Customized crosshairs
-         * @sample    {highstock} highcharts/xaxis/crosshair-customized/
-         *            Customized crosshairs
-         * @sample    {highmaps} highcharts/xaxis/crosshair-customized/
-         *            Customized crosshairs
+         * @sample {highcharts} highcharts/xaxis/crosshair-customized/
+         *         Customized crosshairs
+         * @sample {highstock} highcharts/xaxis/crosshair-customized/
+         *         Customized crosshairs
+         * @sample {highmaps} highcharts/xaxis/crosshair-customized/
+         *         Customized crosshairs
+         *
+         * @type      {number}
          * @default   1
          * @since     4.1
          * @apioption xAxis.crosshair.width
@@ -334,7 +530,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * The Z index of the crosshair. Higher Z indices allow drawing the
          * crosshair on top of the series or behind the grid lines.
          *
-         * @type      {Number}
+         * @type      {number}
          * @default   2
          * @since     4.1
          * @apioption xAxis.crosshair.zIndex
@@ -360,22 +556,42 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          *     year: '%Y'
          * }</pre>
          *
-         * @type    {Object}
-         * @sample  {highcharts} highcharts/xaxis/datetimelabelformats/
-         *          Different day format on X axis
-         * @sample  {highstock} stock/xaxis/datetimelabelformats/
-         *          More information in x axis labels
-         * @product highcharts highstock
+         * @sample {highcharts} highcharts/xaxis/datetimelabelformats/
+         *         Different day format on X axis
+         * @sample {highstock} stock/xaxis/datetimelabelformats/
+         *         More information in x axis labels
+         *
+         * @product highcharts highstock gantt
          */
         dateTimeLabelFormats: {
-            millisecond: '%H:%M:%S.%L',
-            second: '%H:%M:%S',
-            minute: '%H:%M',
-            hour: '%H:%M',
-            day: '%e. %b',
-            week: '%e. %b',
-            month: '%b \'%y',
-            year: '%Y'
+            millisecond: {
+                main: '%H:%M:%S.%L',
+                range: false
+            },
+            second: {
+                main: '%H:%M:%S',
+                range: false
+            },
+            minute: {
+                main: '%H:%M',
+                range: false
+            },
+            hour: {
+                main: '%H:%M',
+                range: false
+            },
+            day: {
+                main: '%e. %b'
+            },
+            week: {
+                main: '%e. %b'
+            },
+            month: {
+                main: '%b \'%y'
+            },
+            year: {
+                main: '%Y'
+            }
         },
 
         /**
@@ -383,8 +599,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          *
          * Description of the axis to screen reader users.
          *
-         * @type      {String}
-         * @default   undefined
+         * @type      {string}
          * @since     5.0.0
          * @apioption xAxis.description
          */
@@ -405,25 +620,29 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          *         True by default
          * @sample {highstock} stock/xaxis/endontick/
          *         False
-         * @since  1.2.0
+         *
+         * @since 1.2.0
          */
         endOnTick: false,
 
         /**
          * Event handlers for the axis.
          *
+         * @type      {*}
          * @apioption xAxis.events
          */
 
         /**
          * An event fired after the breaks have rendered.
          *
+         * @see [breaks](#xAxis.breaks)
+         *
+         * @sample {highcharts} highcharts/axisbreak/break-event/
+         *         AfterBreak Event
+         *
          * @type      {Function}
-         * @see       [breaks](#xAxis.breaks)
-         * @sample    {highcharts} highcharts/axisbreak/break-event/
-         *            AfterBreak Event
          * @since     4.1.0
-         * @product   highcharts
+         * @product   highcharts gantt
          * @apioption xAxis.events.afterBreaks
          */
 
@@ -443,21 +662,23 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * `event.dataMin` and `event.dataMax`.
          *
          * @type      {Function}
-         * @context   Axis
          * @since     2.3
+         * @context   Axis
          * @apioption xAxis.events.afterSetExtremes
          */
 
         /**
          * An event fired when a break from this axis occurs on a point.
          *
+         * @see [breaks](#xAxis.breaks)
+         *
+         * @sample {highcharts} highcharts/axisbreak/break-visualized/
+         *         Visualization of a Break
+         *
          * @type      {Function}
-         * @see       [breaks](#xAxis.breaks)
-         * @context   Axis
-         * @sample    {highcharts} highcharts/axisbreak/break-visualized/
-         *            Visualization of a Break
          * @since     4.1.0
-         * @product   highcharts
+         * @product   highcharts gantt
+         * @context   Axis
          * @apioption xAxis.events.pointBreak
          */
 
@@ -465,8 +686,8 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * An event fired when a point falls inside a break from this axis.
          *
          * @type      {Function}
+         * @product   highcharts highstock gantt
          * @context   Axis
-         * @product   highcharts highstock
          * @apioption xAxis.events.pointInBreak
          */
 
@@ -482,56 +703,60 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * the "Reset zoom" button, `event.min` and `event.max` are null, and
          * the new extremes are set based on `this.dataMin` and `this.dataMax`.
          *
+         * @sample {highstock} stock/xaxis/events-setextremes/
+         *         Log new extremes on x axis
+         *
          * @type      {Function}
-         * @context   Axis
-         * @sample    {highstock} stock/xaxis/events-setextremes/
-         *            Log new extremes on x axis
          * @since     1.2.0
+         * @context   Axis
          * @apioption xAxis.events.setExtremes
          */
 
         /**
          * The lowest allowed value for automatically computed axis extremes.
          *
-         * @type      {Number}
-         * @see       [ceiling](#yAxis.ceiling)
-         * @sample    {highcharts} highcharts/yaxis/floor-ceiling/
-         *            Floor and ceiling
-         * @sample    {highstock} stock/demo/lazy-loading/
-         *            Prevent negative stock price on Y axis
-         * @default   null
+         * @see [ceiling](#yAxis.ceiling)
+         *
+         * @sample {highcharts} highcharts/yaxis/floor-ceiling/
+         *         Floor and ceiling
+         * @sample {highstock} stock/demo/lazy-loading/
+         *         Prevent negative stock price on Y axis
+         *
+         * @type      {number}
          * @since     4.0
-         * @product   highcharts highstock
+         * @product   highcharts highstock gantt
          * @apioption xAxis.floor
          */
 
         /**
          * The dash or dot style of the grid lines. For possible values, see
-         * [this demonstration](http://jsfiddle.net/gh/get/library/pure/
-         *highcharts/highcharts/tree/master/samples/highcharts/plotoptions/
-         *series-dashstyle-all/).
+         * [this demonstration](https://jsfiddle.net/gh/get/library/pure/
+         * highcharts/highcharts/tree/master/samples/highcharts/plotoptions/
+         * series-dashstyle-all/).
          *
-         * @validvalue ["Solid", "ShortDash", "ShortDot", "ShortDashDot",
-         *              "ShortDashDotDot", "Dot", "Dash" ,"LongDash",
-         *              "DashDot", "LongDashDot", "LongDashDotDot"]
-         * @type       {String}
-         * @sample     {highcharts} highcharts/yaxis/gridlinedashstyle/
-         *             Long dashes
-         * @sample     {highstock} stock/xaxis/gridlinedashstyle/
-         *             Long dashes
+         * @sample {highcharts} highcharts/yaxis/gridlinedashstyle/
+         *         Long dashes
+         * @sample {highstock} stock/xaxis/gridlinedashstyle/
+         *         Long dashes
+         *
+         * @type       {string}
          * @default    Solid
          * @since      1.2
+         * @validvalue ["Solid", "ShortDash", "ShortDot", "ShortDashDot",
+         *             "ShortDashDotDot", "Dot", "Dash" ,"LongDash", "DashDot",
+         *             "LongDashDot", "LongDashDotDot"]
          * @apioption  xAxis.gridLineDashStyle
          */
 
         /**
          * The Z index of the grid lines.
          *
-         * @type      {Number}
-         * @sample    {highcharts|highstock} highcharts/xaxis/gridzindex/
-         *            A Z index of 4 renders the grid above the graph
+         * @sample {highcharts|highstock} highcharts/xaxis/gridzindex/
+         *         A Z index of 4 renders the grid above the graph
+         *
+         * @type      {number}
          * @default   1
-         * @product   highcharts highstock
+         * @product   highcharts highstock gantt
          * @apioption xAxis.gridZIndex
          */
 
@@ -539,12 +764,12 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * An id for the axis. This can be used after render time to get
          * a pointer to the axis object through `chart.get()`.
          *
-         * @type      {String}
-         * @sample    {highcharts} highcharts/xaxis/id/
-         *            Get the object
-         * @sample    {highstock} stock/xaxis/id/
-         *            Get the object
-         * @default   null
+         * @sample {highcharts} highcharts/xaxis/id/
+         *         Get the object
+         * @sample {highstock} stock/xaxis/id/
+         *         Get the object
+         *
+         * @type      {string}
          * @since     1.2.0
          * @apioption xAxis.id
          */
@@ -558,6 +783,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * and can be enabled on X and Y axes too.
          */
         labels: {
+
             /**
              * What part of the string the given position is anchored to.
              * If `left`, the left side of the string is at the axis position.
@@ -565,19 +791,19 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
              * an intelligent guess based on which side of the chart the axis
              * is on and the rotation of the label.
              *
+             * @see [reserveSpace](#xAxis.labels.reserveSpace)
+             *
+             * @sample {highcharts} highcharts/xaxis/labels-align-left/
+             *         Left
+             * @sample {highcharts} highcharts/xaxis/labels-align-right/
+             *         Right
+             * @sample {highcharts} highcharts/xaxis/labels-reservespace-true/
+             *         Left-aligned labels on a vertical category axis
+             *
+             * @type       {string}
              * @validvalue ["left", "center", "right"]
-             * @type       {String}
-             * @sample     {highcharts} highcharts/xaxis/labels-align-left/
-             *             Left
-             * @sample     {highcharts} highcharts/xaxis/labels-align-right/
-             *             Right
-             * @sample     {highcharts}
-             *             highcharts/xaxis/labels-reservespace-true/
-             *             Left-aligned labels on a vertical category axis
-             * @see        [reserveSpace](#xAxis.labels.reserveSpace)
              * @apioption  xAxis.labels.align
              */
-            // align: 'center',
 
             /**
              * For horizontal axes, the allowed degrees of label rotation
@@ -588,16 +814,15 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
              * Set it to `false` to disable rotation, which will
              * cause the labels to word-wrap if possible.
              *
-             * @type      {Array<Number>}
-             * @sample    {highcharts|highstock}
-             *            highcharts/xaxis/labels-autorotation-default/
-             *            Default auto rotation of 0 or -45
-             * @sample    {highcharts|highstock}
-             *            highcharts/xaxis/labels-autorotation-0-90/
-             *            Custom graded auto rotation
+             * @sample {highcharts|highstock} highcharts/xaxis/labels-autorotation-default/
+             *         Default auto rotation of 0 or -45
+             * @sample {highcharts|highstock} highcharts/xaxis/labels-autorotation-0-90/
+             *         Custom graded auto rotation
+             *
+             * @type      {Array<number>}
              * @default   [-45]
              * @since     4.1.0
-             * @product   highcharts highstock
+             * @product   highcharts highstock gantt
              * @apioption xAxis.labels.autoRotation
              */
 
@@ -608,13 +833,13 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
              * short words that don't extend the available horizontal space for
              * each label.
              *
-             * @type      {Number}
-             * @sample    {highcharts}
-             *            highcharts/xaxis/labels-autorotationlimit/
-             *            Lower limit
+             * @sample {highcharts} highcharts/xaxis/labels-autorotationlimit/
+             *         Lower limit
+             *
+             * @type      {number}
              * @default   80
              * @since     4.1.5
-             * @product   highcharts
+             * @product   highcharts gantt
              * @apioption xAxis.labels.autoRotationLimit
              */
 
@@ -622,31 +847,33 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
              * Polar charts only. The label's pixel distance from the perimeter
              * of the plot area.
              *
-             * @type      {Number}
+             * @type      {number}
              * @default   15
-             * @product   highcharts
+             * @product   highcharts gantt
              * @apioption xAxis.labels.distance
              */
 
             /**
              * Enable or disable the axis labels.
              *
-             * @sample  {highcharts} highcharts/xaxis/labels-enabled/
-             *          X axis labels disabled
-             * @sample  {highstock} stock/xaxis/labels-enabled/
-             *          X axis labels disabled
-             * @default {highcharts|highstock} true
+             * @sample {highcharts} highcharts/xaxis/labels-enabled/
+             *         X axis labels disabled
+             * @sample {highstock} stock/xaxis/labels-enabled/
+             *         X axis labels disabled
+             *
+             * @default {highcharts|highstock|gantt} true
              * @default {highmaps} false
              */
             enabled: true,
 
             /**
-             * A [format string](http://www.highcharts.com/docs/chart-
+             * A [format string](https://www.highcharts.com/docs/chart-
              * concepts/labels-and-string-formatting) for the axis label.
              *
-             * @type      {String}
-             * @sample    {highcharts|highstock} highcharts/yaxis/labels-format/
-             *            Add units to Y axis label
+             * @sample {highcharts|highstock} highcharts/yaxis/labels-format/
+             *         Add units to Y axis label
+             *
+             * @type      {string}
              * @default   {value}
              * @since     3.0
              * @apioption xAxis.labels.format
@@ -665,31 +892,52 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
              *     return this.value;
              * }</pre>
              *
+             * @sample {highcharts} highcharts/xaxis/labels-formatter-linked/
+             *         Linked category names
+             * @sample {highcharts} highcharts/xaxis/labels-formatter-extended/
+             *         Modified numeric labels
+             * @sample {highstock} stock/xaxis/labels-formatter/
+             *         Added units on Y axis
+             *
              * @type      {Function}
-             * @sample    {highcharts}
-             *            highcharts/xaxis/labels-formatter-linked/
-             *            Linked category names
-             * @sample    {highcharts}
-             *            highcharts/xaxis/labels-formatter-extended/
-             *            Modified numeric labels
-             * @sample    {highstock}
-             *            stock/xaxis/labels-formatter/
-             *            Added units on Y axis
              * @apioption xAxis.labels.formatter
              */
 
             /**
-             * How to handle overflowing labels on horizontal axis. Can be
-             * undefined, `false` or `"justify"`. By default it aligns inside
-             * the chart area. If "justify", labels will not render outside
-             * the plot area. If `false`, it will not be aligned at all.
-             * If there is room to move it, it will be aligned to the edge,
-             * else it will be removed.
+             * The number of pixels to indent the labels per level in a treegrid
+             * axis.
+             *
+             * @product gantt
+             * @sample  gantt/treegrid-axis/demo
+             *          Indentation 10px by default.
+             * @sample  gantt/treegrid-axis/indentation-0px
+             *          Indentation set to 0px.
+             */
+            indentation: 10,
+
+            /**
+             * Horizontal axis only. When `staggerLines` is not set,
+             * `maxStaggerLines` defines how many lines the axis is allowed to
+             * add to automatically avoid overlapping X labels. Set to `1` to
+             * disable overlap detection.
              *
              * @deprecated
-             * @validvalue [null, "justify"]
-             * @type       {String}
+             * @type      {number}
+             * @default   5
+             * @since     1.3.3
+             * @apioption xAxis.labels.maxStaggerLines
+             */
+
+            /**
+             * How to handle overflowing labels on horizontal axis. If set to
+             * `"allow"`, it will not be aligned at all. By default it
+             * `"justify"` labels inside the chart area. If there is room to
+             * move it, it will be aligned to the edge, else it will be removed.
+             *
+             * @type       {boolean|string}
+             * @default    justify
              * @since      2.2.5
+             * @validvalue ["allow", "justify"]
              * @apioption  xAxis.labels.overflow
              */
 
@@ -697,9 +945,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
              * The pixel padding for axis labels, to ensure white space between
              * them.
              *
-             * @type      {Number}
+             * @type      {number}
              * @default   5
-             * @product   highcharts
+             * @product   highcharts gantt
              * @apioption xAxis.labels.padding
              */
 
@@ -715,25 +963,26 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
              * This can be turned off when for example the labels are rendered
              * inside the plot area instead of outside.
              *
-             * @type      {Boolean}
-             * @sample    {highcharts} highcharts/xaxis/labels-reservespace/
-             *            No reserved space, labels inside plot
-             * @sample    {highcharts}
-             *            highcharts/xaxis/labels-reservespace-true/
-             *            Left-aligned labels on a vertical category axis
-             * @see       [labels.align](#xAxis.labels.align)
-             * @default   null
+             * @see [labels.align](#xAxis.labels.align)
+             *
+             * @sample {highcharts} highcharts/xaxis/labels-reservespace/
+             *         No reserved space, labels inside plot
+             * @sample {highcharts} highcharts/xaxis/labels-reservespace-true/
+             *         Left-aligned labels on a vertical category axis
+             *
+             * @type      {boolean}
              * @since     4.1.10
-             * @product   highcharts
+             * @product   highcharts gantt
              * @apioption xAxis.labels.reserveSpace
              */
 
             /**
              * Rotation of the labels in degrees.
              *
-             * @type      {Number}
-             * @sample    {highcharts} highcharts/xaxis/labels-rotation/
-             *            X axis labels rotated 90°
+             * @sample {highcharts} highcharts/xaxis/labels-rotation/
+             *         X axis labels rotated 90°
+             *
+             * @type      {number}
              * @default   0
              * @apioption xAxis.labels.rotation
              */
@@ -742,12 +991,12 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
              * Horizontal axes only. The number of lines to spread the labels
              * over to make room or tighter labels.
              *
-             * @type      {Number}
-             * @sample    {highcharts} highcharts/xaxis/labels-staggerlines/
-             *            Show labels over two lines
-             * @sample    {highstock} stock/xaxis/labels-staggerlines/
-             *            Show labels over two lines
-             * @default   null
+             * @sample {highcharts} highcharts/xaxis/labels-staggerlines/
+             *         Show labels over two lines
+             * @sample {highstock} stock/xaxis/labels-staggerlines/
+             *         Show labels over two lines
+             *
+             * @type      {number}
              * @since     2.1
              * @apioption xAxis.labels.staggerLines
              */
@@ -762,60 +1011,59 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
              * chosen the wrong axis type.
              *
              * Read more at
-             * [Axis docs](http://www.highcharts.com/docs/chart-concepts/axes)
+             * [Axis docs](https://www.highcharts.com/docs/chart-concepts/axes)
              * => What axis should I use?
              *
-             * @type      {Number}
-             * @sample    {highcharts} highcharts/xaxis/labels-step/
-             *            Showing only every other axis label on a categorized
-             *            x axis
-             * @sample    {highcharts} highcharts/xaxis/labels-step-auto/
-             *            Auto steps on a category axis
-             * @default   null
+             * @sample {highcharts} highcharts/xaxis/labels-step/
+             *         Showing only every other axis label on a categorized
+             *         x-axis
+             * @sample {highcharts} highcharts/xaxis/labels-step-auto/
+             *         Auto steps on a category axis
+             *
+             * @type      {number}
              * @since     2.1
              * @apioption xAxis.labels.step
              */
 
+            /**
+             * Whether to [use HTML](https://www.highcharts.com/docs/chart-
+             * concepts/labels-and-string-formatting#html) to render the labels.
+             *
+             * @type      {boolean}
+             * @default   false
+             * @apioption xAxis.labels.useHTML
+             */
+
+            /**
+             * The x position offset of the label relative to the tick position
+             * on the axis.
+             *
+             * @sample {highcharts} highcharts/xaxis/labels-x/
+             *         Y axis labels placed on grid lines
+             */
+            x: 0,
 
             /**
              * The y position offset of the label relative to the tick position
              * on the axis. The default makes it adapt to the font size on
              * bottom axis.
              *
-             * @type      {Number}
-             * @sample    {highcharts} highcharts/xaxis/labels-x/
-             *            Y axis labels placed on grid lines
-             * @default   null
+             * @sample {highcharts} highcharts/xaxis/labels-x/
+             *         Y axis labels placed on grid lines
+             *
+             * @type      {number}
              * @apioption xAxis.labels.y
              */
 
             /**
              * The Z index for the axis labels.
              *
-             * @type {Number}
-             * @default 7
+             * @type      {number}
+             * @default   7
              * @apioption xAxis.labels.zIndex
              */
 
             
-
-            /**
-             * Whether to [use HTML](http://www.highcharts.com/docs/chart-
-             * concepts/labels-and-string-formatting#html) to render the labels.
-             *
-             * @type      {Boolean}
-             * @default   false
-             * @apioption xAxis.labels.useHTML
-             */
-
-            /**
-             * The x position offset of the label relative to the tick position
-             * on the axis.
-             *
-             * @sample {highcharts} highcharts/xaxis/labels-x/
-             *         Y axis labels placed on grid lines
-             */
-            x: 0
         },
 
         /**
@@ -825,14 +1073,14 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * It can be used to show additional info, or to ease reading the
          * chart by duplicating the scales.
          *
-         * @type      {Number}
-         * @sample    {highcharts} highcharts/xaxis/linkedto/
-         *            Different string formats of the same date
-         * @sample    {highcharts} highcharts/yaxis/linkedto/
-         *            Y values on both sides
-         * @default   null
+         * @sample {highcharts} highcharts/xaxis/linkedto/
+         *         Different string formats of the same date
+         * @sample {highcharts} highcharts/yaxis/linkedto/
+         *         Y values on both sides
+         *
+         * @type      {number}
          * @since     2.0.2
-         * @product   highcharts highstock
+         * @product   highcharts highstock gantt
          * @apioption xAxis.linkedTo
          */
 
@@ -840,44 +1088,25 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * The maximum value of the axis. If `null`, the max value is
          * automatically calculated.
          *
-         * If the `endOnTick` option is true, the `max` value might
-         * be rounded up.
+         * If the [endOnTick](#yAxis.endOnTick) option is true, the `max` value
+         * might be rounded up.
          *
          * If a [tickAmount](#yAxis.tickAmount) is set, the axis may be extended
          * beyond the set max in order to reach the given number of ticks. The
          * same may happen in a chart with multiple axes, determined by [chart.
          * alignTicks](#chart), where a `tickAmount` is applied internally.
          *
-         * @type      {Number}
-         * @sample    {highcharts} highcharts/yaxis/max-200/
-         *            Y axis max of 200
-         * @sample    {highcharts} highcharts/yaxis/max-logarithmic/
-         *            Y axis max on logarithmic axis
-         * @sample    {highstock} stock/xaxis/min-max/
-         *            Fixed min and max on X axis
-         * @sample    {highmaps} maps/axis/min-max/
-         *            Pre-zoomed to a specific area
-         * @apioption xAxis.max
-         */
-
-        /**
-         * When using multiple axis, the ticks of two or more opposite axes
-         * will automatically be aligned by adding ticks to the axis or axes
-         * with the least ticks, as if `tickAmount` were specified.
-         *
-         * This can be prevented by setting `alignTicks` to false. If the grid
-         * lines look messy, it's a good idea to hide them for the secondary
-         * axis by setting `gridLineWidth` to 0.
-         *
-         * If `startOnTick` or `endOnTick` in an Axis options are set to false,
-         * then the `alignTicks ` will be disabled for the Axis.
-         *
-         * Disabled for logarithmic axes.
+         * @sample {highcharts} highcharts/yaxis/max-200/
+         *         Y axis max of 200
+         * @sample {highcharts} highcharts/yaxis/max-logarithmic/
+         *         Y axis max on logarithmic axis
+         * @sample {highstock} stock/xaxis/min-max/
+         *         Fixed min and max on X axis
+         * @sample {highmaps} maps/axis/min-max/
+         *         Pre-zoomed to a specific area
          *
-         * @type      {Boolean}
-         * @default   true
-         * @product   highcharts highstock
-         * @apioption xAxis.alignTicks
+         * @type      {number}
+         * @apioption xAxis.max
          */
 
         /**
@@ -887,15 +1116,16 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * of the plot area. When the axis' `max` option is set or a max extreme
          * is set using `axis.setExtremes()`, the maxPadding will be ignored.
          *
-         * @sample  {highcharts} highcharts/yaxis/maxpadding/
-         *          Max padding of 0.25 on y axis
-         * @sample  {highstock} stock/xaxis/minpadding-maxpadding/
-         *          Greater min- and maxPadding
-         * @sample  {highmaps} maps/chart/plotbackgroundcolor-gradient/
-         *          Add some padding
-         * @default {highcharts} 0.01
-         * @default {highstock|highmaps} 0
-         * @since   1.2.0
+         * @sample {highcharts} highcharts/yaxis/maxpadding/
+         *         Max padding of 0.25 on y axis
+         * @sample {highstock} stock/xaxis/minpadding-maxpadding/
+         *         Greater min- and maxPadding
+         * @sample {highmaps} maps/chart/plotbackgroundcolor-gradient/
+         *         Add some padding
+         *
+         * @default   {highcharts} 0.01
+         * @default   {highstock|highmaps} 0
+         * @since     1.2.0
          */
         maxPadding: 0.01,
 
@@ -903,17 +1133,17 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * Deprecated. Use `minRange` instead.
          *
          * @deprecated
-         * @type       {Number}
-         * @product    highcharts highstock
-         * @apioption  xAxis.maxZoom
+         * @type      {number}
+         * @product   highcharts highstock
+         * @apioption xAxis.maxZoom
          */
 
         /**
          * The minimum value of the axis. If `null` the min value is
          * automatically calculated.
          *
-         * If the `startOnTick` option is true (default), the `min` value might
-         * be rounded down.
+         * If the [startOnTick](#yAxis.startOnTick) option is true (default),
+         * the `min` value might be rounded down.
          *
          * The automatically calculated minimum value is also affected by
          * [floor](#yAxis.floor), [softMin](#yAxis.softMin),
@@ -921,64 +1151,67 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * as well as [series.threshold](#plotOptions.series.threshold)
          * and [series.softThreshold](#plotOptions.series.softThreshold).
          *
-         * @type      {Number}
-         * @sample    {highcharts} highcharts/yaxis/min-startontick-false/
-         *            -50 with startOnTick to false
-         * @sample    {highcharts} highcharts/yaxis/min-startontick-true/
-         *            -50 with startOnTick true by default
-         * @sample    {highstock} stock/xaxis/min-max/
-         *            Set min and max on X axis
-         * @sample    {highmaps} maps/axis/min-max/
-         *            Pre-zoomed to a specific area
+         * @sample {highcharts} highcharts/yaxis/min-startontick-false/
+         *         -50 with startOnTick to false
+         * @sample {highcharts} highcharts/yaxis/min-startontick-true/
+         *         -50 with startOnTick true by default
+         * @sample {highstock} stock/xaxis/min-max/
+         *         Set min and max on X axis
+         * @sample {highmaps} maps/axis/min-max/
+         *         Pre-zoomed to a specific area
+         *
+         * @type      {number}
          * @apioption xAxis.min
          */
 
         /**
          * The dash or dot style of the minor grid lines. For possible values,
-         * see [this demonstration](http://jsfiddle.net/gh/get/library/pure/
+         * see [this demonstration](https://jsfiddle.net/gh/get/library/pure/
          * highcharts/highcharts/tree/master/samples/highcharts/plotoptions/
          * series-dashstyle-all/).
          *
-         * @validvalue ["Solid", "ShortDash", "ShortDot", "ShortDashDot",
-         *              "ShortDashDotDot", "Dot", "Dash" ,"LongDash",
-         *              "DashDot", "LongDashDot", "LongDashDotDot"]
-         * @type       {String}
-         * @sample     {highcharts} highcharts/yaxis/minorgridlinedashstyle/
-         *             Long dashes on minor grid lines
-         * @sample     {highstock} stock/xaxis/minorgridlinedashstyle/
-         *             Long dashes on minor grid lines
+         * @sample {highcharts} highcharts/yaxis/minorgridlinedashstyle/
+         *         Long dashes on minor grid lines
+         * @sample {highstock} stock/xaxis/minorgridlinedashstyle/
+         *         Long dashes on minor grid lines
+         *
+         * @type       {string}
          * @default    Solid
          * @since      1.2
+         * @validvalue ["Solid", "ShortDash", "ShortDot", "ShortDashDot",
+         *             "ShortDashDotDot", "Dot", "Dash" ,"LongDash",
+         *             "DashDot", "LongDashDot", "LongDashDotDot"]
          * @apioption  xAxis.minorGridLineDashStyle
          */
 
         /**
-         * Specific tick interval in axis units for the minor ticks.
-         * On a linear axis, if `"auto"`, the minor tick interval is
-         * calculated as a fifth of the tickInterval. If `null`, minor
-         * ticks are not shown.
+         * Specific tick interval in axis units for the minor ticks. On a linear
+         * axis, if `"auto"`, the minor tick interval is calculated as a fifth
+         * of the tickInterval. If `null` or `undefined`, minor ticks are not
+         * shown.
          *
          * On logarithmic axes, the unit is the power of the value. For example,
-         * setting the minorTickInterval to 1 puts one tick on each of 0.1,
-         * 1, 10, 100 etc. Setting the minorTickInterval to 0.1 produces 9
-         * ticks between 1 and 10, 10 and 100 etc.
+         * setting the minorTickInterval to 1 puts one tick on each of 0.1, 1,
+         * 10, 100 etc. Setting the minorTickInterval to 0.1 produces 9 ticks
+         * between 1 and 10, 10 and 100 etc.
          *
          * If user settings dictate minor ticks to become too dense, they don't
          * make sense, and will be ignored to prevent performance problems.
          *
-         * @type      {Number|String}
-         * @sample    {highcharts} highcharts/yaxis/minortickinterval-null/
-         *            Null by default
-         * @sample    {highcharts} highcharts/yaxis/minortickinterval-5/
-         *            5 units
-         * @sample    {highcharts} highcharts/yaxis/minortickinterval-log-auto/
-         *            "auto"
-         * @sample    {highcharts} highcharts/yaxis/minortickinterval-log/
-         *            0.1
-         * @sample    {highstock} stock/demo/basic-line/
-         *            Null by default
-         * @sample    {highstock} stock/xaxis/minortickinterval-auto/
-         *            "auto"
+         * @sample {highcharts} highcharts/yaxis/minortickinterval-null/
+         *         Null by default
+         * @sample {highcharts} highcharts/yaxis/minortickinterval-5/
+         *         5 units
+         * @sample {highcharts} highcharts/yaxis/minortickinterval-log-auto/
+         *         "auto"
+         * @sample {highcharts} highcharts/yaxis/minortickinterval-log/
+         *         0.1
+         * @sample {highstock} stock/demo/basic-line/
+         *         Null by default
+         * @sample {highstock} stock/xaxis/minortickinterval-auto/
+         *         "auto"
+         *
+         * @type      {number|string|null}
          * @apioption xAxis.minorTickInterval
          */
 
@@ -996,13 +1229,14 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * The position of the minor tick marks relative to the axis line.
          *  Can be one of `inside` and `outside`.
          *
+         * @sample {highcharts} highcharts/yaxis/minortickposition-outside/
+         *         Outside by default
+         * @sample {highcharts} highcharts/yaxis/minortickposition-inside/
+         *         Inside
+         * @sample {highstock} stock/xaxis/minorticks/
+         *         Inside
+         *
          * @validvalue ["inside", "outside"]
-         * @sample     {highcharts} highcharts/yaxis/minortickposition-outside/
-         *             Outside by default
-         * @sample     {highcharts} highcharts/yaxis/minortickposition-inside/
-         *             Inside
-         * @sample     {highstock} stock/xaxis/minorticks/
-         *             Inside
          */
         minorTickPosition: 'outside',
 
@@ -1022,22 +1256,24 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * On axes using [categories](#xAxis.categories), minor ticks are not
          * supported.
          *
-         * @type      {Boolean}
+         * @sample {highcharts} highcharts/yaxis/minorticks-true/
+         *         Enabled on linear Y axis
+         *
+         * @type      {boolean}
          * @default   false
          * @since     6.0.0
-         * @sample    {highcharts} highcharts/yaxis/minorticks-true/
-         *            Enabled on linear Y axis
          * @apioption xAxis.minorTicks
          */
 
         /**
          * The pixel width of the minor tick mark.
          *
-         * @type      {Number}
-         * @sample    {highcharts} highcharts/yaxis/minortickwidth/
-         *            3px width
-         * @sample    {highstock} stock/xaxis/minorticks/
-         *            1px width
+         * @sample {highcharts} highcharts/yaxis/minortickwidth/
+         *         3px width
+         * @sample {highstock} stock/xaxis/minorticks/
+         *         1px width
+         *
+         * @type      {number}
          * @default   0
          * @apioption xAxis.minorTickWidth
          */
@@ -1049,15 +1285,17 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * of the plot area. When the axis' `min` option is set or a min extreme
          * is set using `axis.setExtremes()`, the minPadding will be ignored.
          *
-         * @sample  {highcharts} highcharts/yaxis/minpadding/
-         *          Min padding of 0.2
-         * @sample  {highstock} stock/xaxis/minpadding-maxpadding/
-         *          Greater min- and maxPadding
-         * @sample  {highmaps} maps/chart/plotbackgroundcolor-gradient/
-         *          Add some padding
-         * @default {highcharts} 0.01
-         * @default {highstock|highmaps} 0
-         * @since   1.2.0
+         * @sample {highcharts} highcharts/yaxis/minpadding/
+         *         Min padding of 0.2
+         * @sample {highstock} stock/xaxis/minpadding-maxpadding/
+         *         Greater min- and maxPadding
+         * @sample {highmaps} maps/chart/plotbackgroundcolor-gradient/
+         *         Add some padding
+         *
+         * @default    {highcharts} 0.01
+         * @default    {highstock|highmaps} 0
+         * @since      1.2.0
+         * @product    highcharts highstock gantt
          */
         minPadding: 0.01,
 
@@ -1078,13 +1316,14 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * `endOnTick` settings also affect how the extremes of the axis
          * are computed.
          *
-         * @type      {Number}
-         * @sample    {highcharts} highcharts/xaxis/minrange/
-         *            Minimum range of 5
-         * @sample    {highstock} stock/xaxis/minrange/
-         *            Max zoom of 6 months overrides user selections
-         * @sample    {highmaps} maps/axis/minrange/
-         *            Minimum range of 1000
+         * @sample {highcharts} highcharts/xaxis/minrange/
+         *         Minimum range of 5
+         * @sample {highstock} stock/xaxis/minrange/
+         *         Max zoom of 6 months overrides user selections
+         * @sample {highmaps} maps/axis/minrange/
+         *         Minimum range of 1000
+         *
+         * @type      {number}
          * @apioption xAxis.minRange
          */
 
@@ -1094,7 +1333,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * the axis from showing hours. Defaults to the closest distance between
          * two points on the axis.
          *
-         * @type      {Number}
+         * @type      {number}
          * @since     2.3.0
          * @apioption xAxis.minTickInterval
          */
@@ -1107,13 +1346,14 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * axes the offset is dynamically adjusted to avoid collision, this
          * can be overridden by setting offset explicitly.
          *
-         * @type      {Number}
          * @sample    {highcharts} highcharts/yaxis/offset/
          *            Y axis offset of 70
          * @sample    {highcharts} highcharts/yaxis/offset-centered/
          *            Axes positioned in the center of the plot
          * @sample    {highstock} stock/xaxis/offset/
          *            Y axis offset by 70 px
+         *
+         * @type      {number}
          * @default   0
          * @apioption xAxis.offset
          */
@@ -1124,69 +1364,221 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * horizontal, so the opposite sides will be right and top respectively.
          * This is typically used with dual or multiple axes.
          *
-         * @type      {Boolean}
-         * @sample    {highcharts} highcharts/yaxis/opposite/
-         *            Secondary Y axis opposite
-         * @sample    {highstock} stock/xaxis/opposite/
-         *            Y axis on left side
+         * @sample {highcharts} highcharts/yaxis/opposite/
+         *         Secondary Y axis opposite
+         * @sample {highstock} stock/xaxis/opposite/
+         *         Y axis on left side
+         *
+         * @type      {boolean}
          * @default   false
          * @apioption xAxis.opposite
          */
 
         /**
-         * Refers to the index in the [panes](#panes) array. Used for circular
-         * gauges and polar charts. When the option is not set then first pane
-         * will be used.
+         * In an ordinal axis, the points are equally spaced in the chart
+         * regardless of the actual time or x distance between them. This means
+         * that missing data periods (e.g. nights or weekends for a stock chart)
+         * will not take up space in the chart.
+         * Having `ordinal: false` will show any gaps created by the `gapSize`
+         * setting proportionate to their duration.
          *
-         * @type      {Number}
-         * @sample    highcharts/demo/gauge-vu-meter
-         *            Two gauges with different center
-         * @product   highcharts
-         * @apioption xAxis.pane
-         */
-
+         * In stock charts the X axis is ordinal by default, unless
+         * the boost module is used and at least one of the series' data length
+         * exceeds the [boostThreshold](#series.line.boostThreshold).
+         *
+         * @sample {highstock} stock/xaxis/ordinal-true/
+         *         True by default
+         * @sample {highstock} stock/xaxis/ordinal-false/
+         *         False
+         *
+         * @type      {boolean}
+         * @default   true
+         * @since     1.1
+         * @product   highstock
+         * @apioption xAxis.ordinal
+         */
+
+        /**
+         * Additional range on the right side of the xAxis. Works similar to
+         * `xAxis.maxPadding`, but value is set in milliseconds. Can be set for
+         * both main `xAxis` and the navigator's `xAxis`.
+         *
+         * @sample {highstock} stock/xaxis/overscroll/
+         *         One minute overscroll with live data
+         *
+         * @type      {number}
+         * @default   0
+         * @since     6.0.0
+         * @product   highstock
+         * @apioption xAxis.overscroll
+         */
+
+        /**
+         * Refers to the index in the [panes](#panes) array. Used for circular
+         * gauges and polar charts. When the option is not set then first pane
+         * will be used.
+         *
+         * @sample highcharts/demo/gauge-vu-meter
+         *         Two gauges with different center
+         *
+         * @type      {number}
+         * @product   highcharts
+         * @apioption xAxis.pane
+         */
+
+
+        /**
+         * The zoomed range to display when only defining one or none of `min`
+         * or `max`. For example, to show the latest month, a range of one month
+         * can be set.
+         *
+         * @sample {highstock} stock/xaxis/range/
+         *         Setting a zoomed range when the rangeSelector is disabled
+         *
+         * @type      {number}
+         * @product   highstock
+         * @apioption xAxis.range
+         */
+
         /**
          * Whether to reverse the axis so that the highest number is closest
          * to the origin. If the chart is inverted, the x axis is reversed by
          * default.
          *
-         * @type      {Boolean}
-         * @sample    {highcharts} highcharts/yaxis/reversed/
-         *            Reversed Y axis
-         * @sample    {highstock} stock/xaxis/reversed/
-         *            Reversed Y axis
+         * @sample {highcharts} highcharts/yaxis/reversed/
+         *         Reversed Y axis
+         * @sample {highstock} stock/xaxis/reversed/
+         *         Reversed Y axis
+         *
+         * @type      {boolean}
          * @default   false
          * @apioption xAxis.reversed
          */
         // reversed: false,
 
+        /**
+         * This option determines how stacks should be ordered within a group.
+         * For example reversed xAxis also reverses stacks, so first series
+         * comes last in a group. To keep order like for non-reversed xAxis
+         * enable this option.
+         *
+         * @sample {highcharts} highcharts/xaxis/reversedstacks/
+         *         Reversed stacks comparison
+         * @sample {highstock} highcharts/xaxis/reversedstacks/
+         *         Reversed stacks comparison
+         *
+         * @type      {boolean}
+         * @default   false
+         * @since     6.1.1
+         * @product   highcharts highstock
+         * @apioption xAxis.reversedStacks
+         */
+
+        /**
+         * An optional scrollbar to display on the X axis in response to
+         * limiting the minimum and maximum of the axis values.
+         *
+         * In styled mode, all the presentational options for the scrollbar
+         * are replaced by the classes `.highcharts-scrollbar-thumb`,
+         * `.highcharts-scrollbar-arrow`, `.highcharts-scrollbar-button`,
+         * `.highcharts-scrollbar-rifles` and `.highcharts-scrollbar-track`.
+         *
+         * @sample {highstock} stock/yaxis/heatmap-scrollbars/
+         *         Heatmap with both scrollbars
+         *
+         * @type      {*}
+         * @extends   scrollbar
+         * @since     4.2.6
+         * @product   highstock
+         * @apioption xAxis.scrollbar
+         */
+
+        /**
+         * Whether to show the axis line and title when the axis has no data.
+         *
+         * @sample {highcharts} highcharts/yaxis/showempty/
+         *         When clicking the legend to hide series, one axis preserves
+         *         line and title, the other doesn't
+         * @sample {highstock} highcharts/yaxis/showempty/
+         *         When clicking the legend to hide series, one axis preserves
+         *         line and title, the other doesn't
+         *
+         * @type      {boolean}
+         * @default   true
+         * @since     1.1
+         * @apioption xAxis.showEmpty
+         */
+
+        /**
+         * Whether to show the first tick label.
+         *
+         * @sample {highcharts} highcharts/xaxis/showfirstlabel-false/
+         *         Set to false on X axis
+         * @sample {highstock} stock/xaxis/showfirstlabel/
+         *         Labels below plot lines on Y axis
+         *
+         * @type      {boolean}
+         * @default   true
+         * @apioption xAxis.showFirstLabel
+         */
+
         /**
          * Whether to show the last tick label. Defaults to `true` on cartesian
          * charts, and `false` on polar charts.
          *
-         * @type      {Boolean}
-         * @sample    {highcharts} highcharts/xaxis/showlastlabel-true/
-         *            Set to true on X axis
-         * @sample    {highstock} stock/xaxis/showfirstlabel/
-         *            Labels below plot lines on Y axis
+         * @sample {highcharts} highcharts/xaxis/showlastlabel-true/
+         *         Set to true on X axis
+         * @sample {highstock} stock/xaxis/showfirstlabel/
+         *         Labels below plot lines on Y axis
+         *
+         * @type      {boolean}
          * @default   true
-         * @product   highcharts highstock
+         * @product   highcharts highstock gantt
          * @apioption xAxis.showLastLabel
          */
 
+        /**
+         * A soft maximum for the axis. If the series data maximum is less than
+         * this, the axis will stay at this maximum, but if the series data
+         * maximum is higher, the axis will flex to show all data.
+         *
+         * @sample highcharts/yaxis/softmin-softmax/
+         *         Soft min and max
+         *
+         * @type      {number}
+         * @since     5.0.1
+         * @product   highcharts highstock gantt
+         * @apioption xAxis.softMax
+         */
+
+        /**
+         * A soft minimum for the axis. If the series data minimum is greater
+         * than this, the axis will stay at this minimum, but if the series
+         * data minimum is lower, the axis will flex to show all data.
+         *
+         * @sample highcharts/yaxis/softmin-softmax/
+         *         Soft min and max
+         *
+         * @type      {number}
+         * @since     5.0.1
+         * @product   highcharts highstock gantt
+         * @apioption xAxis.softMin
+         */
+
         /**
          * For datetime axes, this decides where to put the tick between weeks.
          *  0 = Sunday, 1 = Monday.
          *
-         * @sample  {highcharts} highcharts/xaxis/startofweek-monday/
-         *          Monday by default
-         * @sample  {highcharts} highcharts/xaxis/startofweek-sunday/
-         *          Sunday
-         * @sample  {highstock} stock/xaxis/startofweek-1
-         *          Monday by default
-         * @sample  {highstock} stock/xaxis/startofweek-0
-         *          Sunday
-         * @product highcharts highstock
+         * @sample {highcharts} highcharts/xaxis/startofweek-monday/
+         *         Monday by default
+         * @sample {highcharts} highcharts/xaxis/startofweek-sunday/
+         *         Sunday
+         * @sample {highstock} stock/xaxis/startofweek-1
+         *         Monday by default
+         * @sample {highstock} stock/xaxis/startofweek-0
+         *         Sunday
+         *
+         * @product highcharts highstock gantt
          */
         startOfWeek: 1,
 
@@ -1198,16 +1590,72 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * In Highstock, `startOnTick` is always false when the navigator is
          * enabled, to prevent jumpy scrolling.
          *
-         * @sample  {highcharts} highcharts/xaxis/startontick-false/
-         *          False by default
-         * @sample  {highcharts} highcharts/xaxis/startontick-true/
-         *          True
-         * @sample  {highstock} stock/xaxis/endontick/
-         *          False for Y axis
-         * @since   1.2.0
+         * @sample {highcharts} highcharts/xaxis/startontick-false/
+         *         False by default
+         * @sample {highcharts} highcharts/xaxis/startontick-true/
+         *         True
+         * @sample {highstock} stock/xaxis/endontick/
+         *         False for Y axis
+         *
+         * @since 1.2.0
          */
         startOnTick: false,
 
+
+        /**
+         * The amount of ticks to draw on the axis. This opens up for aligning
+         * the ticks of multiple charts or panes within a chart. This option
+         * overrides the `tickPixelInterval` option.
+         *
+         * This option only has an effect on linear axes. Datetime, logarithmic
+         * or category axes are not affected.
+         *
+         * @sample {highcharts} highcharts/yaxis/tickamount/
+         *         8 ticks on Y axis
+         * @sample {highstock} highcharts/yaxis/tickamount/
+         *         8 ticks on Y axis
+         *
+         * @type      {number}
+         * @since     4.1.0
+         * @product   highcharts highstock gantt
+         * @apioption xAxis.tickAmount
+         */
+
+        /**
+         * The interval of the tick marks in axis units. When `undefined`, the
+         * tick interval is computed to approximately follow the
+         * [tickPixelInterval](#xAxis.tickPixelInterval) on linear and datetime
+         * axes. On categorized axes, a `undefined` tickInterval will default to
+         * 1, one category. Note that datetime axes are based on milliseconds,
+         * so for example an interval of one day is expressed as
+         * `24 * 3600 * 1000`.
+         *
+         * On logarithmic axes, the tickInterval is based on powers, so a
+         * tickInterval of 1 means one tick on each of 0.1, 1, 10, 100 etc. A
+         * tickInterval of 2 means a tick of 0.1, 10, 1000 etc. A tickInterval
+         * of 0.2 puts a tick on 0.1, 0.2, 0.4, 0.6, 0.8, 1, 2, 4, 6, 8, 10, 20,
+         * 40 etc.
+         *
+         *
+         * If the tickInterval is too dense for labels to be drawn, Highcharts
+         * may remove ticks.
+         *
+         * If the chart has multiple axes, the [alignTicks](#chart.alignTicks)
+         * option may interfere with the `tickInterval` setting.
+         *
+         * @see [tickPixelInterval](#xAxis.tickPixelInterval)
+         * @see [tickPositions](#xAxis.tickPositions)
+         * @see [tickPositioner](#xAxis.tickPositioner)
+         *
+         * @sample {highcharts} highcharts/xaxis/tickinterval-5/
+         *         Tick interval of 5 on a linear axis
+         * @sample {highstock} stock/xaxis/tickinterval/
+         *         Tick interval of 0.01 on Y axis
+         *
+         * @type      {number}
+         * @apioption xAxis.tickInterval
+         */
+
         /**
          * The pixel length of the main tick marks.
          *
@@ -1218,21 +1666,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          */
         tickLength: 10,
 
-        /**
-         * For categorized axes only. If `on` the tick mark is placed in the
-         * center of the category, if `between` the tick mark is placed between
-         * categories. The default is `between` if the `tickInterval` is 1,
-         *  else `on`.
-         *
-         * @validvalue [null, "on", "between"]
-         * @sample     {highcharts} highcharts/xaxis/tickmarkplacement-between/
-         *             "between" by default
-         * @sample     {highcharts} highcharts/xaxis/tickmarkplacement-on/
-         *             "on"
-         * @product    highcharts
-         */
-        tickmarkPlacement: 'between',
-
         /**
          * If tickInterval is `null` this option sets the approximate pixel
          * interval of the tick marks. Not applicable to categorized axis.
@@ -1241,9 +1674,10 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * #xAxis.minTickInterval) option, that, by default prevents ticks from
          * being denser than the data points.
          *
-         * @see    [tickInterval](#xAxis.tickInterval),
-         *         [tickPositioner](#xAxis.tickPositioner),
-         *         [tickPositions](#xAxis.tickPositions).
+         * @see [tickInterval](#xAxis.tickInterval)
+         * @see [tickPositioner](#xAxis.tickPositioner)
+         * @see [tickPositions](#xAxis.tickPositions)
+         *
          * @sample {highcharts} highcharts/xaxis/tickpixelinterval-50/
          *         50 px on X axis
          * @sample {highstock} stock/xaxis/tickpixelinterval/
@@ -1251,20 +1685,93 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          */
         tickPixelInterval: 100,
 
+        /**
+         * For categorized axes only. If `on` the tick mark is placed in the
+         * center of the category, if `between` the tick mark is placed between
+         * categories. The default is `between` if the `tickInterval` is 1,
+         *  else `on`.
+         *
+         * @sample {highcharts} highcharts/xaxis/tickmarkplacement-between/
+         *         "between" by default
+         * @sample {highcharts} highcharts/xaxis/tickmarkplacement-on/
+         *         "on"
+         *
+         * @product    highcharts gantt
+         * @validvalue [null, "on", "between"]
+         */
+        tickmarkPlacement: 'between',
+
         /**
          * The position of the major tick marks relative to the axis line.
          * Can be one of `inside` and `outside`.
          *
+         * @sample {highcharts} highcharts/xaxis/tickposition-outside/
+         *         "outside" by default
+         * @sample {highcharts} highcharts/xaxis/tickposition-inside/
+         *         "inside"
+         * @sample {highstock} stock/xaxis/ticks/
+         *         Formatted ticks on X axis
+         *
          * @validvalue ["inside", "outside"]
-         * @sample     {highcharts} highcharts/xaxis/tickposition-outside/
-         *             "outside" by default
-         * @sample     {highcharts} highcharts/xaxis/tickposition-inside/
-         *             "inside"
-         * @sample     {highstock} stock/xaxis/ticks/
-         *             Formatted ticks on X axis
          */
         tickPosition: 'outside',
 
+        /**
+         * A callback function returning array defining where the ticks are
+         * laid out on the axis. This overrides the default behaviour of
+         * [tickPixelInterval](#xAxis.tickPixelInterval) and [tickInterval](
+         * #xAxis.tickInterval). The automatic tick positions are accessible
+         * through `this.tickPositions` and can be modified by the callback.
+         *
+         * @see [tickPositions](#xAxis.tickPositions)
+         *
+         * @sample {highcharts} highcharts/xaxis/tickpositions-tickpositioner/
+         *         Demo of tickPositions and tickPositioner
+         * @sample {highstock} highcharts/xaxis/tickpositions-tickpositioner/
+         *         Demo of tickPositions and tickPositioner
+         *
+         * @type      {Function}
+         * @apioption xAxis.tickPositioner
+         */
+
+        /**
+         * An array defining where the ticks are laid out on the axis. This
+         * overrides the default behaviour of [tickPixelInterval](
+         * #xAxis.tickPixelInterval) and [tickInterval](#xAxis.tickInterval).
+         *
+         * @see [tickPositioner](#xAxis.tickPositioner)
+         *
+         * @sample {highcharts} highcharts/xaxis/tickpositions-tickpositioner/
+         *         Demo of tickPositions and tickPositioner
+         * @sample {highstock} highcharts/xaxis/tickpositions-tickpositioner/
+         *         Demo of tickPositions and tickPositioner
+         *
+         * @type      {Array<number>}
+         * @apioption xAxis.tickPositions
+         */
+
+        /**
+         * The pixel width of the major tick marks.
+         *
+         * In styled mode, the stroke width is given in the `.highcharts-tick`
+         * class.
+         *
+         * @sample {highcharts} highcharts/xaxis/tickwidth/
+         *         10 px width
+         * @sample {highcharts} highcharts/css/axis-grid/
+         *         Styled mode
+         * @sample {highstock} stock/xaxis/ticks/
+         *         Formatted ticks on X axis
+         * @sample {highstock} highcharts/css/axis-grid/
+         *         Styled mode
+         *
+         * @type      {number}
+         * @default   {highcharts} 1
+         * @default   {highstock} 1
+         * @default   {highmaps} 0
+         * @apioption xAxis.tickWidth
+         */
+
         /**
          * The axis title, showing next to the axis line.
          *
@@ -1275,25 +1782,153 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          */
         title: {
 
+            /**
+             * Deprecated. Set the `text` to `null` to disable the title.
+             *
+             * @deprecated
+             * @type      {string}
+             * @default   middle
+             * @product   highcharts
+             * @apioption xAxis.title.enabled
+             */
+
+            /**
+             * The pixel distance between the axis labels or line and the title.
+             * Defaults to 0 for horizontal axes, 10 for vertical
+             *
+             * @sample {highcharts} highcharts/xaxis/title-margin/
+             *         Y axis title margin of 60
+             *
+             * @type      {number}
+             * @apioption xAxis.title.margin
+             */
+
+            /**
+             * The distance of the axis title from the axis line. By default,
+             * this distance is computed from the offset width of the labels,
+             * the labels' distance from the axis and the title's margin.
+             * However when the offset option is set, it overrides all this.
+             *
+             * @sample {highcharts} highcharts/yaxis/title-offset/
+             *         Place the axis title on top of the axis
+             * @sample {highstock} highcharts/yaxis/title-offset/
+             *         Place the axis title on top of the Y axis
+             *
+             * @type      {number}
+             * @since     2.2.0
+             * @apioption xAxis.title.offset
+             */
+
+            /**
+             * Whether to reserve space for the title when laying out the axis.
+             *
+             * @type      {boolean}
+             * @default   true
+             * @since     5.0.11
+             * @product   highcharts highstock gantt
+             * @apioption xAxis.title.reserveSpace
+             */
+
+            /**
+             * The rotation of the text in degrees. 0 is horizontal, 270 is
+             * vertical reading from bottom to top.
+             *
+             * @sample {highcharts} highcharts/yaxis/title-offset/
+             *         Horizontal
+             *
+             * @type      {number}
+             * @default   0
+             * @apioption xAxis.title.rotation
+             */
+
+            /**
+             * The actual text of the axis title. It can contain basic HTML text
+             * markup like <b>, <i> and spans with style.
+             *
+             * @sample {highcharts} highcharts/xaxis/title-text/
+             *         Custom HTML
+             * @sample {highstock} stock/xaxis/title-text/
+             *         Titles for both axes
+             *
+             * @type      {string}
+             * @apioption xAxis.title.text
+             */
+
+            /**
+             * Alignment of the text, can be `"left"`, `"right"` or `"center"`.
+             * Default alignment depends on the
+             * [title.align](xAxis.title.align):
+             *
+             * Horizontal axes:
+             * - for `align` = `"low"`, `textAlign` is set to `left`
+             * - for `align` = `"middle"`, `textAlign` is set to `center`
+             * - for `align` = `"high"`, `textAlign` is set to `right`
+             *
+             * Vertical axes:
+             * - for `align` = `"low"` and `opposite` = `true`, `textAlign` is
+             *   set to `right`
+             * - for `align` = `"low"` and `opposite` = `false`, `textAlign` is
+             *   set to `left`
+             * - for `align` = `"middle"`, `textAlign` is set to `center`
+             * - for `align` = `"high"` and `opposite` = `true` `textAlign` is
+             *   set to `left`
+             * - for `align` = `"high"` and `opposite` = `false` `textAlign` is
+             *   set to `right`
+             *
+             * @type      {string}
+             * @apioption xAxis.title.textAlign
+             */
+
+            /**
+             * Whether to [use HTML](https://www.highcharts.com/docs/
+             * chart-concepts/labels-and-string-formatting#html) to render the
+             * axis title.
+             *
+             * @type      {boolean}
+             * @default   false
+             * @product   highcharts highstock gantt
+             * @apioption xAxis.title.useHTML
+             */
+
+            /**
+             * Horizontal pixel offset of the title position.
+             *
+             * @type      {number}
+             * @default   0
+             * @since     4.1.6
+             * @product   highcharts highstock gantt
+             * @apioption xAxis.title.x
+             */
+
+            /**
+             * Vertical pixel offset of the title position.
+             *
+             * @type      {number}
+             * @product   highcharts highstock gantt
+             * @apioption xAxis.title.y
+             */
+
             /**
              * Alignment of the title relative to the axis values. Possible
              * values are "low", "middle" or "high".
              *
+             * @sample {highcharts} highcharts/xaxis/title-align-low/
+             *         "low"
+             * @sample {highcharts} highcharts/xaxis/title-align-center/
+             *         "middle" by default
+             * @sample {highcharts} highcharts/xaxis/title-align-high/
+             *         "high"
+             * @sample {highcharts} highcharts/yaxis/title-offset/
+             *         Place the Y axis title on top of the axis
+             * @sample {highstock} stock/xaxis/title-align/
+             *         Aligned to "high" value
+             *
              * @validvalue ["low", "middle", "high"]
-             * @sample     {highcharts} highcharts/xaxis/title-align-low/
-             *             "low"
-             * @sample     {highcharts} highcharts/xaxis/title-align-center/
-             *             "middle" by default
-             * @sample     {highcharts} highcharts/xaxis/title-align-high/
-             *             "high"
-             * @sample     {highcharts} highcharts/yaxis/title-offset/
-             *             Place the Y axis title on top of the axis
-             * @sample     {highstock} stock/xaxis/title-align/
-             *             Aligned to "high" value
              */
             align: 'middle'
 
             
+
         },
 
         /**
@@ -1305,22 +1940,116 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * for categories, if not a [categories](#xAxis.categories) array is
          * defined.
          *
+         * @sample {highcharts} highcharts/xaxis/type-linear/
+         *         Linear
+         * @sample {highcharts} highcharts/yaxis/type-log/
+         *         Logarithmic
+         * @sample {highcharts} highcharts/yaxis/type-log-minorgrid/
+         *         Logarithmic with minor grid lines
+         * @sample {highcharts} highcharts/xaxis/type-log-both/
+         *         Logarithmic on two axes
+         * @sample {highcharts} highcharts/yaxis/type-log-negative/
+         *         Logarithmic with extension to emulate negative values
+         *
+         * @product    highcharts gantt
          * @validvalue ["linear", "logarithmic", "datetime", "category"]
-         * @sample     {highcharts} highcharts/xaxis/type-linear/
-         *             Linear
-         * @sample     {highcharts} highcharts/yaxis/type-log/
-         *             Logarithmic
-         * @sample     {highcharts} highcharts/yaxis/type-log-minorgrid/
-         *             Logarithmic with minor grid lines
-         * @sample     {highcharts} highcharts/xaxis/type-log-both/
-         *             Logarithmic on two axes
-         * @sample     {highcharts} highcharts/yaxis/type-log-negative/
-         *             Logarithmic with extension to emulate negative values
-         * @product    highcharts
          */
-        type: 'linear'
+        type: 'linear',
+
+        /**
+         * The type of axis. Can be one of `linear`, `logarithmic`, `datetime`,
+         * `category` or `treegrid`. Defaults to `treegrid` for Gantt charts,
+         * `linear` for other chart types.
+         *
+         * In a datetime axis, the numbers are given in milliseconds, and tick
+         * marks are placed on appropriate values, like full hours or days. In a
+         * category or treegrid axis, the [point names](#series.line.data.name)
+         * of the chart's series are used for categories, if a
+         * [categories](#xAxis.categories) array is not defined.
+         *
+         * @sample {highcharts} highcharts/yaxis/type-log-minorgrid/
+         *         Logarithmic with minor grid lines
+         * @sample {highcharts} highcharts/yaxis/type-log-negative/
+         *         Logarithmic with extension to emulate negative values
+         *
+         * @product    highcharts gantt
+         * @validvalue ["linear", "logarithmic", "datetime", "category", "treegrid"]
+         * @default {highcharts} linear
+         * @default {gantt} treegrid
+         * @apioption yAxis.type
+         */
+
+        /**
+         * Applies only when the axis `type` is `category`. When `uniqueNames`
+         * is true, points are placed on the X axis according to their names.
+         * If the same point name is repeated in the same or another series,
+         * the point is placed on the same X position as other points of the
+         * same name. When `uniqueNames` is false, the points are laid out in
+         * increasing X positions regardless of their names, and the X axis
+         * category will take the name of the last point in each position.
+         *
+         * @sample {highcharts} highcharts/xaxis/uniquenames-true/
+         *         True by default
+         * @sample {highcharts} highcharts/xaxis/uniquenames-false/
+         *         False
+         *
+         * @type      {boolean}
+         * @default   true
+         * @since     4.2.7
+         * @product   highcharts gantt
+         * @apioption xAxis.uniqueNames
+         */
+
+        /**
+         * Datetime axis only. An array determining what time intervals the
+         * ticks are allowed to fall on. Each array item is an array where the
+         * first value is the time unit and the second value another array of
+         * allowed multiples. Defaults to:
+         *
+         * <pre>units: [[
+         *     'millisecond', // unit name
+         *     [1, 2, 5, 10, 20, 25, 50, 100, 200, 500] // allowed multiples
+         * ], [
+         *     'second',
+         *     [1, 2, 5, 10, 15, 30]
+         * ], [
+         *     'minute',
+         *     [1, 2, 5, 10, 15, 30]
+         * ], [
+         *     'hour',
+         *     [1, 2, 3, 4, 6, 8, 12]
+         * ], [
+         *     'day',
+         *     [1]
+         * ], [
+         *     'week',
+         *     [1]
+         * ], [
+         *     'month',
+         *     [1, 3, 6]
+         * ], [
+         *     'year',
+         *     null
+         * ]]</pre>
+         *
+         * @type      {Array<Array<string|Array<number>>>}
+         * @product   highcharts highstock gantt
+         * @apioption xAxis.units
+         */
+
+        /**
+         * Whether axis, including axis title, line, ticks and labels, should
+         * be visible.
+         *
+         * @type      {boolean}
+         * @default   true
+         * @since     4.1.9
+         * @product   highcharts highstock gantt
+         * @apioption xAxis.visible
+         */
 
         
+
     },
 
     /**
@@ -1333,42 +2062,248 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * access to the axis.
      *
      * @extends      xAxis
-     * @excluding    ordinal,overscroll
+     * @excluding    ordinal,overscroll,currentDateIndicator
      * @optionparent yAxis
      */
     defaultYAxisOptions: {
+
+        /**
+         * In a polar chart, this is the angle of the Y axis in degrees, where
+         * 0 is up and 90 is right. The angle determines the position of the
+         * axis line and the labels, though the coordinate system is unaffected.
+         *
+         * @sample {highcharts} highcharts/yaxis/angle/
+         *         Dual axis polar chart
+         *
+         * @type      {number}
+         * @default   0
+         * @since     4.2.7
+         * @product   highcharts
+         * @apioption yAxis.angle
+         */
+
+        /**
+         * Polar charts only. Whether the grid lines should draw as a polygon
+         * with straight lines between categories, or as circles. Can be either
+         * `circle` or `polygon`.
+         *
+         * @sample {highcharts} highcharts/demo/polar-spider/
+         *         Polygon grid lines
+         * @sample {highcharts} highcharts/yaxis/gridlineinterpolation/
+         *         Circle and polygon
+         *
+         * @type       {string}
+         * @product    highcharts
+         * @validvalue ["circle", "polygon"]
+         * @apioption  yAxis.gridLineInterpolation
+         */
+
+        /**
+         * The height of the Y axis. If it's a number, it is interpreted as
+         * pixels.
+         *
+         * Since Highstock 2: If it's a percentage string, it is interpreted
+         * as percentages of the total plot height.
+         *
+         * @see [yAxis.top](#yAxis.top)
+         *
+         * @sample {highstock} stock/demo/candlestick-and-volume/
+         *         Percentage height panes
+         *
+         * @type      {number|string}
+         * @product   highstock
+         * @apioption yAxis.height
+         */
+
+        /**
+         * Solid gauge only. Unless [stops](#yAxis.stops) are set, the color
+         * to represent the maximum value of the Y axis.
+         *
+         * @sample {highcharts} highcharts/yaxis/mincolor-maxcolor/
+         *         Min and max colors
+         *
+         * @type      {Highcharts.ColorString}
+         * @default   #003399
+         * @since     4.0
+         * @product   highcharts
+         * @apioption yAxis.maxColor
+         */
+
+        /**
+         * Solid gauge only. Unless [stops](#yAxis.stops) are set, the color
+         * to represent the minimum value of the Y axis.
+         *
+         * @sample {highcharts} highcharts/yaxis/mincolor-maxcolor/
+         *         Min and max color
+         *
+         * @type      {Highcharts.ColorString}
+         * @default   #e6ebf5
+         * @since     4.0
+         * @product   highcharts
+         * @apioption yAxis.minColor
+         */
+
+        /**
+         * Whether to reverse the axis so that the highest number is closest
+         * to the origin.
+         *
+         * @sample {highcharts} highcharts/yaxis/reversed/
+         *         Reversed Y axis
+         * @sample {highstock} stock/xaxis/reversed/
+         *         Reversed Y axis
+         *
+         * @type      {boolean}
+         * @default   {highcharts} false
+         * @default   {highstock} false
+         * @default   {highmaps} true
+         * @default   {gantt} true
+         * @apioption yAxis.reversed
+         */
+
+        /**
+         * If `true`, the first series in a stack will be drawn on top in a
+         * positive, non-reversed Y axis. If `false`, the first series is in
+         * the base of the stack.
+         *
+         * @sample {highcharts} highcharts/yaxis/reversedstacks-false/
+         *         Non-reversed stacks
+         * @sample {highstock} highcharts/yaxis/reversedstacks-false/
+         *         Non-reversed stacks
+         *
+         * @type      {boolean}
+         * @default   true
+         * @since     3.0.10
+         * @product   highcharts highstock
+         * @apioption yAxis.reversedStacks
+         */
+
+        /**
+         * Solid gauge series only. Color stops for the solid gauge. Use this
+         * in cases where a linear gradient between a `minColor` and `maxColor`
+         * is not sufficient. The stops is an array of tuples, where the first
+         * item is a float between 0 and 1 assigning the relative position in
+         * the gradient, and the second item is the color.
+         *
+         * For solid gauges, the Y axis also inherits the concept of [data classes](http://api.
+         * highcharts.com/highmaps#colorAxis.dataClasses) from the Highmaps
+         * color axis.
+         *
+         * @see [minColor](#yAxis.minColor)
+         * @see [maxColor](#yAxis.maxColor)
+         *
+         * @sample {highcharts} highcharts/demo/gauge-solid/
+         *         True by default
+         *
+         * @type      {Array<Array<number, Highcharts.ColorString>>}
+         * @since     4.0
+         * @product   highcharts
+         * @apioption yAxis.stops
+         */
+
+        /**
+         * The pixel width of the major tick marks.
+         *
+         * @sample {highcharts} highcharts/xaxis/tickwidth/ 10 px width
+         * @sample {highstock} stock/xaxis/ticks/ Formatted ticks on X axis
+         *
+         * @type      {number}
+         * @default   0
+         * @product   highcharts highstock gantt
+         * @apioption yAxis.tickWidth
+         */
+
+        /**
+         * Angular gauges and solid gauges only. The label's pixel distance
+         * from the perimeter of the plot area.
+         *
+         * @type      {number}
+         * @default   -25
+         * @product   highcharts
+         * @apioption yAxis.labels.distance
+         */
+
+        /**
+         * The y position offset of the label relative to the tick position
+         * on the axis.
+         *
+         * @sample {highcharts} highcharts/xaxis/labels-x/
+         *         Y axis labels placed on grid lines
+         *
+         * @type      {number}
+         * @default   {highcharts} 3
+         * @default   {highstock} -2
+         * @default   {highmaps} 3
+         * @apioption yAxis.labels.y
+         */
+
         /**
          * @productdesc {highstock}
          * In Highstock, `endOnTick` is always false when the navigator is
          * enabled, to prevent jumpy scrolling.
          */
-        endOnTick: true,
+        endOnTick: true,
+
+        /**
+         * Padding of the max value relative to the length of the axis. A
+         * padding of 0.05 will make a 100px axis 5px longer. This is useful
+         * when you don't want the highest data value to appear on the edge
+         * of the plot area. When the axis' `max` option is set or a max extreme
+         * is set using `axis.setExtremes()`, the maxPadding will be ignored.
+         *
+         * @sample {highcharts} highcharts/yaxis/maxpadding-02/
+         *         Max padding of 0.2
+         * @sample {highstock} stock/xaxis/minpadding-maxpadding/
+         *         Greater min- and maxPadding
+         *
+         * @since   1.2.0
+         * @product highcharts highstock gantt
+         */
+        maxPadding: 0.05,
+
+        /**
+         * Padding of the min value relative to the length of the axis. A
+         * padding of 0.05 will make a 100px axis 5px longer. This is useful
+         * when you don't want the lowest data value to appear on the edge
+         * of the plot area. When the axis' `min` option is set or a max extreme
+         * is set using `axis.setExtremes()`, the maxPadding will be ignored.
+         *
+         * @sample {highcharts} highcharts/yaxis/minpadding/
+         *         Min padding of 0.2
+         * @sample {highstock} stock/xaxis/minpadding-maxpadding/
+         *         Greater min- and maxPadding
+         *
+         * @since   1.2.0
+         * @product highcharts highstock gantt
+         */
+        minPadding: 0.05,
 
         /**
          * @productdesc {highstock}
          * In Highstock 1.x, the Y axis was placed on the left side by default.
          *
-         * @sample    {highcharts} highcharts/yaxis/opposite/
-         *            Secondary Y axis opposite
-         * @sample    {highstock} stock/xaxis/opposite/
-         *            Y axis on left side
+         * @sample {highcharts} highcharts/yaxis/opposite/
+         *         Secondary Y axis opposite
+         * @sample {highstock} stock/xaxis/opposite/
+         *         Y axis on left side
+         *
+         * @type      {boolean}
          * @default   {highstock} true
          * @default   {highcharts} false
-         * @product   highstock highcharts
+         * @product   highstock highcharts gantt
          * @apioption yAxis.opposite
          */
 
         /**
-         * @see [tickInterval](#xAxis.tickInterval),
-         *      [tickPositioner](#xAxis.tickPositioner),
-         *      [tickPositions](#xAxis.tickPositions).
+         * @see [tickInterval](#xAxis.tickInterval)
+         * @see [tickPositioner](#xAxis.tickPositioner)
+         * @see [tickPositions](#xAxis.tickPositions)
          */
         tickPixelInterval: 72,
 
         showLastLabel: true,
 
         /**
-         * @extends xAxis.labels
+         * @extends    xAxis.labels
          */
         labels: {
             /**
@@ -1378,12 +2313,13 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
              *
              * Angular gauges and solid gauges defaults to `center`.
              *
-             * @validvalue ["left", "center", "right"]
-             * @type       {String}
-             * @sample     {highcharts} highcharts/yaxis/labels-align-left/
-             *             Left
+             * @sample {highcharts} highcharts/yaxis/labels-align-left/
+             *         Left
+             *
+             * @type       {string}
              * @default    {highcharts|highmaps} right
              * @default    {highstock} left
+             * @validvalue ["left", "center", "right"]
              * @apioption  yAxis.labels.align
              */
 
@@ -1402,64 +2338,269 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * In Highmaps, the axis line is hidden by default, because the axis is
          * not visible by default.
          *
+         * @type      {Highcharts.ColorString}
          * @apioption yAxis.lineColor
          */
 
         /**
-         * @sample    {highcharts} highcharts/yaxis/min-startontick-false/
-         *            -50 with startOnTick to false
-         * @sample    {highcharts} highcharts/yaxis/min-startontick-true/
-         *            -50 with startOnTick true by default
-         * @sample    {highstock} stock/yaxis/min-max/
-         *            Fixed min and max on Y axis
-         * @sample    {highmaps} maps/axis/min-max/
-         *            Pre-zoomed to a specific area
+         * @sample {highcharts} highcharts/yaxis/max-200/
+         *         Y axis max of 200
+         * @sample {highcharts} highcharts/yaxis/max-logarithmic/
+         *         Y axis max on logarithmic axis
+         * @sample {highstock} stock/yaxis/min-max/
+         *         Fixed min and max on Y axis
+         * @sample {highmaps} maps/axis/min-max/
+         *         Pre-zoomed to a specific area
+         *
+         * @type      {number}
+         * @apioption yAxis.max
+         */
+
+        /**
+         * @sample {highcharts} highcharts/yaxis/min-startontick-false/
+         *         -50 with startOnTick to false
+         * @sample {highcharts} highcharts/yaxis/min-startontick-true/
+         *         -50 with startOnTick true by default
+         * @sample {highstock} stock/yaxis/min-max/
+         *         Fixed min and max on Y axis
+         * @sample {highmaps} maps/axis/min-max/
+         *         Pre-zoomed to a specific area
+         *
+         * @type      {number}
          * @apioption yAxis.min
          */
 
         /**
-         * @sample    {highcharts} highcharts/yaxis/max-200/
-         *            Y axis max of 200
-         * @sample    {highcharts} highcharts/yaxis/max-logarithmic/
-         *            Y axis max on logarithmic axis
-         * @sample    {highstock} stock/yaxis/min-max/
-         *            Fixed min and max on Y axis
-         * @sample    {highmaps} maps/axis/min-max/
-         *            Pre-zoomed to a specific area
-         * @apioption yAxis.max
+         * An optional scrollbar to display on the Y axis in response to
+         * limiting the minimum an maximum of the axis values.
+         *
+         * In styled mode, all the presentational options for the scrollbar
+         * are replaced by the classes `.highcharts-scrollbar-thumb`,
+         * `.highcharts-scrollbar-arrow`, `.highcharts-scrollbar-button`,
+         * `.highcharts-scrollbar-rifles` and `.highcharts-scrollbar-track`.
+         *
+         * @sample {highstock} stock/yaxis/scrollbar/
+         *         Scrollbar on the Y axis
+         *
+         * @extends   scrollbar
+         * @excluding height
+         * @since     4.2.6
+         * @product   highstock
+         * @apioption yAxis.scrollbar
          */
 
         /**
-         * Padding of the max value relative to the length of the axis. A
-         * padding of 0.05 will make a 100px axis 5px longer. This is useful
-         * when you don't want the highest data value to appear on the edge
-         * of the plot area. When the axis' `max` option is set or a max extreme
-         * is set using `axis.setExtremes()`, the maxPadding will be ignored.
+         * Enable the scrollbar on the Y axis.
          *
-         * @sample  {highcharts} highcharts/yaxis/maxpadding-02/
-         *          Max padding of 0.2
-         * @sample  {highstock} stock/xaxis/minpadding-maxpadding/
-         *          Greater min- and maxPadding
-         * @since   1.2.0
-         * @product highcharts highstock
+         * @sample {highstock} stock/yaxis/scrollbar/
+         *         Enabled on Y axis
+         *
+         * @type      {boolean}
+         * @default   false
+         * @since     4.2.6
+         * @product   highstock
+         * @apioption yAxis.scrollbar.enabled
          */
-        maxPadding: 0.05,
 
         /**
-         * Padding of the min value relative to the length of the axis. A
-         * padding of 0.05 will make a 100px axis 5px longer. This is useful
-         * when you don't want the lowest data value to appear on the edge
-         * of the plot area. When the axis' `min` option is set or a max extreme
-         * is set using `axis.setExtremes()`, the maxPadding will be ignored.
+         * Pixel margin between the scrollbar and the axis elements.
          *
-         * @sample  {highcharts} highcharts/yaxis/minpadding/
-         *          Min padding of 0.2
-         * @sample  {highstock} stock/xaxis/minpadding-maxpadding/
-         *          Greater min- and maxPadding
-         * @since   1.2.0
-         * @product highcharts highstock
+         * @type      {number}
+         * @default   10
+         * @since     4.2.6
+         * @product   highstock
+         * @apioption yAxis.scrollbar.margin
+         */
+
+        /**
+         * Whether to show the scrollbar when it is fully zoomed out at max
+         * range. Setting it to `false` on the Y axis makes the scrollbar stay
+         * hidden until the user zooms in, like common in browsers.
+         *
+         * @type      {boolean}
+         * @default   true
+         * @since     4.2.6
+         * @product   highstock
+         * @apioption yAxis.scrollbar.showFull
+         */
+
+        /**
+         * The width of a vertical scrollbar or height of a horizontal
+         * scrollbar. Defaults to 20 on touch devices.
+         *
+         * @type      {number}
+         * @default   14
+         * @since     4.2.6
+         * @product   highstock
+         * @apioption yAxis.scrollbar.size
+         */
+
+        /**
+         * Z index of the scrollbar elements.
+         *
+         * @type      {number}
+         * @default   3
+         * @since     4.2.6
+         * @product   highstock
+         * @apioption yAxis.scrollbar.zIndex
+         */
+
+        /**
+         * A soft maximum for the axis. If the series data maximum is less
+         * than this, the axis will stay at this maximum, but if the series
+         * data maximum is higher, the axis will flex to show all data.
+         *
+         * **Note**: The [series.softThreshold](
+         * #plotOptions.series.softThreshold) option takes precedence over this
+         * option.
+         *
+         * @sample highcharts/yaxis/softmin-softmax/
+         *         Soft min and max
+         *
+         * @type      {number}
+         * @since     5.0.1
+         * @product   highcharts highstock gantt
+         * @apioption yAxis.softMax
+         */
+
+        /**
+         * A soft minimum for the axis. If the series data minimum is greater
+         * than this, the axis will stay at this minimum, but if the series
+         * data minimum is lower, the axis will flex to show all data.
+         *
+         * **Note**: The [series.softThreshold](
+         * #plotOptions.series.softThreshold) option takes precedence over this
+         * option.
+         *
+         * @sample highcharts/yaxis/softmin-softmax/
+         *         Soft min and max
+         *
+         * @type      {number}
+         * @since     5.0.1
+         * @product   highcharts highstock gantt
+         * @apioption yAxis.softMin
+         */
+
+        /**
+         * Defines the horizontal alignment of the stack total label. Can be one
+         * of `"left"`, `"center"` or `"right"`. The default value is calculated
+         * at runtime and depends on orientation and whether the stack is
+         * positive or negative.
+         *
+         * @sample {highcharts} highcharts/yaxis/stacklabels-align-left/
+         *         Aligned to the left
+         * @sample {highcharts} highcharts/yaxis/stacklabels-align-center/
+         *         Aligned in center
+         * @sample {highcharts} highcharts/yaxis/stacklabels-align-right/
+         *         Aligned to the right
+         *
+         * @type       {string}
+         * @since      2.1.5
+         * @product    highcharts
+         * @validvalue ["left", "center", "right"]
+         * @apioption  yAxis.stackLabels.align
+         */
+
+        /**
+         * A [format string](http://docs.highcharts.com/#formatting) for the
+         * data label. Available variables are the same as for `formatter`.
+         *
+         * @type      {string}
+         * @default   {total}
+         * @since     3.0.2
+         * @product   highcharts highstock
+         * @apioption yAxis.stackLabels.format
+         */
+
+        /**
+         * Rotation of the labels in degrees.
+         *
+         * @sample {highcharts} highcharts/yaxis/stacklabels-rotation/
+         *         Labels rotated 45°
+         *
+         * @type      {number}
+         * @default   0
+         * @since     2.1.5
+         * @product   highcharts
+         * @apioption yAxis.stackLabels.rotation
+         */
+
+        /**
+         * The text alignment for the label. While `align` determines where the
+         * texts anchor point is placed with regards to the stack, `textAlign`
+         * determines how the text is aligned against its anchor point. Possible
+         * values are `"left"`, `"center"` and `"right"`. The default value is
+         * calculated at runtime and depends on orientation and whether the
+         * stack is positive or negative.
+         *
+         * @sample {highcharts} highcharts/yaxis/stacklabels-textalign-left/
+         *         Label in center position but text-aligned left
+         *
+         * @type       {string}
+         * @since      2.1.5
+         * @product    highcharts
+         * @validvalue ["left", "center", "right"]
+         * @apioption  yAxis.stackLabels.textAlign
+         */
+
+        /**
+         * Whether to [use HTML](https://www.highcharts.com/docs/chart-concepts/
+         * labels-and-string-formatting#html) to render the labels.
+         *
+         * @type      {boolean}
+         * @default   false
+         * @since     3.0
+         * @product   highcharts highstock
+         * @apioption yAxis.stackLabels.useHTML
+         */
+
+        /**
+         * Defines the vertical alignment of the stack total label. Can be one
+         * of `"top"`, `"middle"` or `"bottom"`. The default value is calculated
+         * at runtime and depends on orientation and whether the stack is
+         * positive or negative.
+         *
+         * @sample {highcharts} highcharts/yaxis/stacklabels-verticalalign-top/
+         *         Vertically aligned top
+         * @sample {highcharts} highcharts/yaxis/stacklabels-verticalalign-middle/
+         *         Vertically aligned middle
+         * @sample {highcharts} highcharts/yaxis/stacklabels-verticalalign-bottom/
+         *         Vertically aligned bottom
+         *
+         * @type       {string}
+         * @since      2.1.5
+         * @product    highcharts
+         * @validvalue ["top", "middle", "bottom"]
+         * @apioption  yAxis.stackLabels.verticalAlign
+         */
+
+        /**
+         * The x position offset of the label relative to the left of the
+         * stacked bar. The default value is calculated at runtime and depends
+         * on orientation and whether the stack is positive or negative.
+         *
+         * @sample {highcharts} highcharts/yaxis/stacklabels-x/
+         *         Stack total labels with x offset
+         *
+         * @type      {number}
+         * @since     2.1.5
+         * @product   highcharts
+         * @apioption yAxis.stackLabels.x
+         */
+
+        /**
+         * The y position offset of the label relative to the tick position
+         * on the axis. The default value is calculated at runtime and depends
+         * on orientation and whether the stack is positive or negative.
+         *
+         * @sample {highcharts} highcharts/yaxis/stacklabels-y/
+         *         Stack total labels with y offset
+         *
+         * @type      {number}
+         * @since     2.1.5
+         * @product   highcharts
+         * @apioption yAxis.stackLabels.y
          */
-        minPadding: 0.05,
 
         /**
          * Whether to force the axis to start on a tick. Use this option with
@@ -1471,16 +2612,26 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          *          True
          * @sample  {highstock} stock/xaxis/endontick/
          *          False for Y axis
+         *
          * @since   1.2.0
-         * @product highcharts highstock
+         * @product highcharts highstock gantt
          */
         startOnTick: true,
 
-        /**
-         * @extends xAxis.title
-         */
         title: {
 
+            /**
+             * The pixel distance between the axis labels and the title.
+             * Positive values are outside the axis line, negative are inside.
+             *
+             * @sample {highcharts} highcharts/xaxis/title-margin/
+             *         Y axis title margin of 60
+             *
+             * @type      {number}
+             * @default   40
+             * @apioption yAxis.title.margin
+             */
+
             /**
              * The rotation of the text in degrees. 0 is horizontal, 270 is
              * vertical reading from bottom to top.
@@ -1494,17 +2645,35 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
              * The actual text of the axis title. Horizontal texts can contain
              * HTML, but rotated texts are painted using vector techniques and
              * must be clean text. The Y axis title is disabled by setting the
-             * `text` option to `null`.
+             * `text` option to `undefined`.
              *
              * @sample  {highcharts} highcharts/xaxis/title-text/
              *          Custom HTML
+             *
              * @default {highcharts} Values
-             * @default {highstock} null
-             * @product highcharts highstock
+             * @default {highstock} undefined
+             * @product highcharts highstock gantt
              */
             text: 'Values'
         },
 
+        /**
+         * The top position of the Y axis. If it's a number, it is interpreted
+         * as pixel position relative to the chart.
+         *
+         * Since Highstock 2: If it's a percentage string, it is interpreted
+         * as percentages of the plot height, offset from plot area top.
+         *
+         * @see [yAxis.height](#yAxis.height)
+         *
+         * @sample {highstock} stock/demo/candlestick-and-volume/
+         *         Percentage height panes
+         *
+         * @type      {number|string}
+         * @product   highstock
+         * @apioption yAxis.top
+         */
+
         /**
          * The stack labels show the total value for each bar in a stacked
          * column or bar chart. The label will be placed on top of positive
@@ -1519,9 +2688,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
             /**
              * Allow the stack labels to overlap.
              *
-             * @sample  {highcharts}
-             *          highcharts/yaxis/stacklabels-allowoverlap-false/
-             *          Default false
+             * @sample {highcharts} highcharts/yaxis/stacklabels-allowoverlap-false/
+             *         Default false
+             *
              * @since   5.0.13
              * @product highcharts
              */
@@ -1530,8 +2699,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
             /**
              * Enable or disable the stack total labels.
              *
-             * @sample  {highcharts} highcharts/yaxis/stacklabels-enabled/
-             *          Enabled stack total labels
+             * @sample {highcharts} highcharts/yaxis/stacklabels-enabled/
+             *         Enabled stack total labels
+             *
              * @since   2.1.5
              * @product highcharts
              */
@@ -1541,27 +2711,49 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
              * Callback JavaScript function to format the label. The value is
              * given by `this.total`.
              *
-             * @default function() { return this.total; }
+             * @sample {highcharts} highcharts/yaxis/stacklabels-formatter/
+             *         Added units to stack total value
              *
-             * @type    {Function}
-             * @sample  {highcharts} highcharts/yaxis/stacklabels-formatter/
-             *          Added units to stack total value
+             * @type    {Highcharts.FormatterCallbackFunction}
              * @since   2.1.5
              * @product highcharts
              */
             formatter: function () {
                 return H.numberFormat(this.total, -1);
             }
+
             
+
         }
+
         
+
     },
 
+    /**
+     * The Z axis or depth axis for 3D plots.
+     *
+     * See [the Axis object](/class-reference/Highcharts.Axis) for programmatic
+     * access to the axis.
+     *
+     * @sample {highcharts} highcharts/3d/scatter-zaxis-categories/
+     *         Z-Axis with Categories
+     * @sample {highcharts} highcharts/3d/scatter-zaxis-grid/
+     *         Z-Axis with styling
+     *
+     * @extends   xAxis
+     * @since     5.0.0
+     * @product   highcharts
+     * @excluding breaks, crosshair, lineColor, lineWidth, nameToX, showEmpty
+     * @apioption zAxis
+     */
+
     /**
      * These options extend the defaultOptions for left axes.
      *
      * @private
-     * @type {Object}
+     * @name Highcharts.Axis#defaultLeftAxisOptions
+     * @type {*}
      */
     defaultLeftAxisOptions: {
         labels: {
@@ -1576,7 +2768,8 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * These options extend the defaultOptions for right axes.
      *
      * @private
-     * @type {Object}
+     * @name Highcharts.Axis#defaultRightAxisOptions
+     * @type {*}
      */
     defaultRightAxisOptions: {
         labels: {
@@ -1591,7 +2784,8 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * These options extend the defaultOptions for bottom axes.
      *
      * @private
-     * @type {Object}
+     * @name Highcharts.Axis#defaultBottomAxisOptions
+     * @type {*}
      */
     defaultBottomAxisOptions: {
         labels: {
@@ -1608,7 +2802,8 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * These options extend the defaultOptions for top axes.
      *
      * @private
-     * @type {Object}
+     * @name Highcharts.Axis#defaultTopAxisOptions
+     * @type {*}
      */
     defaultTopAxisOptions: {
         labels: {
@@ -1626,6 +2821,15 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Overrideable function to initialize the axis.
      *
      * @see {@link Axis}
+     *
+     * @function Highcharts.Axis#init
+     *
+     * @param {Highcharts.Chart} chart
+     *
+     * @param {Highcharts.Options} userOptions
+     *
+     * @fires Highcharts.Axis#event:afterInit
+     * @fires Highcharts.Axis#event:init
      */
     init: function (chart, userOptions) {
 
@@ -1636,18 +2840,16 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
         /**
          * The Chart that the axis belongs to.
          *
-         * @name     chart
-         * @memberof Axis
-         * @type     {Chart}
+         * @name Highcharts.Axis#chart
+         * @type {Highcharts.Chart}
          */
         axis.chart = chart;
 
         /**
          * Whether the axis is horizontal.
          *
-         * @name     horiz
-         * @memberof Axis
-         * @type     {Boolean}
+         * @name Highcharts.Axis#horiz
+         * @type {boolean}
          */
         axis.horiz = chart.inverted && !axis.isZAxis ? !isXAxis : isXAxis;
 
@@ -1659,9 +2861,8 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * or `colorAxis`. Corresponds to properties on Chart, for example
          * {@link Chart.xAxis}.
          *
-         * @name     coll
-         * @memberof Axis
-         * @type     {String}
+         * @name Highcharts.Axis#coll
+         * @type {string}
          */
         axis.coll = axis.coll || (isXAxis ? 'xAxis' : 'yAxis');
 
@@ -1673,9 +2874,8 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * The side on which the axis is rendered. 0 is top, 1 is right, 2 is
          * bottom and 3 is left.
          *
-         * @name     side
-         * @memberof Axis
-         * @type     {Number}
+         * @name Highcharts.Axis#side
+         * @type {number}
          */
         axis.side = userOptions.side || (axis.horiz ?
                 (axis.opposite ? 0 : 2) : // top : bottom
@@ -1702,9 +2902,8 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * Whether the axis is reversed. Based on the `axis.reversed`,
          * option, but inverted charts have reversed xAxis by default.
          *
-         * @name     reversed
-         * @memberof Axis
-         * @type     {Boolean}
+         * @name Highcharts.Axis#reversed
+         * @type {boolean}
          */
         axis.reversed = options.reversed;
         axis.visible = options.visible !== false;
@@ -1730,10 +2929,25 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
         // Flag, if axis is linked to another axis
         axis.isLinked = defined(options.linkedTo);
 
-        // Major ticks
+        /**
+         * List of major ticks mapped by postition on axis.
+         *
+         * @name ticks
+         * @memberOf Axis
+         * @type {Object.<number, Highcharts.Tick>}
+         * @see  Highcharts.Tick
+         */
         axis.ticks = {};
         axis.labelEdge = [];
-        // Minor ticks
+        /**
+         * List of minor ticks mapped by position on the axis.
+         *
+         * @name minorTicks
+         * @memberOf Axis
+         * @type {Object.<number, Highcharts.Tick>}
+         *
+         * @see  Highcharts.Tick
+         */
         axis.minorTicks = {};
 
         // List of plotLines/Bands
@@ -1760,9 +2974,8 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * logarithm of the real value, and the real value can be obtained from
          * {@link Axis#getExtremes}.
          *
-         * @name     max
-         * @memberof Axis
-         * @type     {Number}
+         * @name Highcharts.Axis#max
+         * @type {number}
          */
         axis.max = null;
         /**
@@ -1770,9 +2983,8 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
          * logarithm of the real value, and the real value can be obtained from
          * {@link Axis#getExtremes}.
          *
-         * @name     min
-         * @memberof Axis
-         * @type     {Number}
+         * @name Highcharts.Axis#min
+         * @type {number}
          */
         axis.min = null;
 
@@ -1780,9 +2992,8 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
         /**
          * The processed crosshair options.
          *
-         * @name     crosshair
-         * @memberof Axis
-         * @type     {AxisCrosshairOptions}
+         * @name Highcharts.Axis#crosshair
+         * @type {false|Highcharts.AxisCrosshairOptions}
          */
         axis.crosshair = pick(
             options.crosshair,
@@ -1806,9 +3017,8 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
         /**
          * All series associated to the axis.
          *
-         * @name     series
-         * @memberof Axis
-         * @type     {Array<Series>}
+         * @name Highcharts.Axis#series
+         * @type {Array<Highcharts.Series>}
          */
         axis.series = axis.series || []; // populated by Series
 
@@ -1841,6 +3051,11 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Merge and set options.
      *
      * @private
+     * @function Highcharts.Axis#setOptions
+     *
+     * @param {Highcharts.AxisOptions} userOptions
+     *
+     * @fires Highcharts.Axis#event:afterSetOptions
      */
     setOptions: function (userOptions) {
         this.options = merge(
@@ -1868,6 +3083,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * labels.formatter} instead except when a modification is needed.
      *
      * @private
+     * @function Highcharts.Axis#defaultLabelFormatter
+     *
+     * @return {string}
      */
     defaultLabelFormatter: function () {
         var axis = this.axis,
@@ -1937,6 +3155,10 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * analyzes the axis series and updates `this.dataMin` and `this.dataMax`.
      *
      * @private
+     * @function Highcharts.Axis#getSeriesExtremes
+     *
+     * @fires Highcharts.Axis#event:afterGetSeriesExtremes
+     * @fires Highcharts.Axis#event:getSeriesExtremes
      */
     getSeriesExtremes: function () {
         var axis = this,
@@ -2055,6 +3277,21 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * the `toPixels` and `toValue` functions in applications.
      *
      * @private
+     * @function Highcharts.Axis#translate
+     *
+     * @param {number} val
+     *
+     * @param {boolean} [backwards]
+     *
+     * @param {boolean} [cvsCoord]
+     *
+     * @param {boolean} [old]
+     *
+     * @param {boolean} [handleLog]
+     *
+     * @param {number} [pointPlacement=0]
+     *
+     * @return {number|undefined}
      */
     translate: function (
         val,
@@ -2125,12 +3362,17 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
     /**
      * Translate a value in terms of axis units into pixels within the chart.
      *
-     * @param  {Number} value
-     *         A value in terms of axis units.
-     * @param  {Boolean} paneCoordinates
-     *         Whether to return the pixel coordinate relative to the chart or
-     *         just the axis/pane itself.
-     * @return {Number} Pixel position of the value on the chart or axis.
+     * @function Highcharts.Axis#toPixels
+     *
+     * @param {number} value
+     *        A value in terms of axis units.
+     *
+     * @param {boolean} paneCoordinates
+     *        Whether to return the pixel coordinate relative to the chart or
+     *        just the axis/pane itself.
+     *
+     * @return {number}
+     *         Pixel position of the value on the chart or axis.
      */
     toPixels: function (value, paneCoordinates) {
         return this.translate(value, false, !this.horiz, null, true) +
@@ -2140,12 +3382,18 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
     /**
      * Translate a pixel position along the axis to a value in terms of axis
      * units.
-     * @param  {Number} pixel
-     *         The pixel value coordinate.
-     * @param  {Boolean} paneCoordiantes
-     *         Whether the input pixel is relative to the chart or just the
-     *         axis/pane itself.
-     * @return {Number} The axis value.
+     *
+     * @function Highcharts.Axis#toValue
+     *
+     * @param {number} pixel
+     *        The pixel value coordinate.
+     *
+     * @param {boolean} paneCoordiantes
+     *        Whether the input pixel is relative to the chart or just the
+     *        axis/pane itself.
+     *
+     * @return {number}
+     *         The axis value.
      */
     toValue: function (pixel, paneCoordinates) {
         return this.translate(
@@ -2162,20 +3410,28 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * this axis, across the plot to the opposite side. Also used internally for
      * grid lines and crosshairs.
      *
-     * @param  {Number} value
-     *         Axis value.
-     * @param  {Number} [lineWidth=1]
-     *         Used for calculation crisp line coordinates.
-     * @param  {Boolean} [old=false]
-     *         Use old coordinates (for resizing and rescaling).
-     * @param  {Boolean} [force=false]
-     *         If `false`, the function will return null when it falls outside
-     *         the axis bounds.
-     * @param  {Number} [translatedValue]
-     *         If given, return the plot line path of a pixel position on the
-     *         axis.
-     *
-     * @return {Array<String|Number>}
+     * @function Highcharts.Axis#getPlotLinePath
+     *
+     * @param {number} value
+     *        Axis value.
+     *
+     * @param {number} [lineWidth=1]
+     *        Used for calculation crisp line coordinates.
+     *
+     * @param {boolean} [old=false]
+     *        Use old coordinates (for resizing and rescaling).
+     *
+     * @param {boolean|string} [force=false]
+     *        If `false`, the function will return null when it falls outside
+     *        the axis bounds. If `true`, the function will return a path
+     *        aligned to the plot area sides if it falls outside. If `pass`, it
+     *        will return a path outside.
+     *
+     * @param {number} [translatedValue]
+     *        If given, return the plot line path of a pixel position on the
+     *        axis.
+     *
+     * @return {Array<string|number>}
      *         The SVG path definition for the plot line.
      */
     getPlotLinePath: function (value, lineWidth, old, force, translatedValue) {
@@ -2196,7 +3452,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
              * or skip, depending on the force parameter.
              */
             between = function (x, a, b) {
-                if (x < a || x > b) {
+                if (force !== 'pass' && x < a || x > b) {
                     if (force) {
                         x = Math.min(Math.max(a, x), b);
                     } else {
@@ -2241,14 +3497,18 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Internal function to et the tick positions of a linear axis to round
      * values like whole tens or every five.
      *
-     * @param  {Number} tickInterval
-     *         The normalized tick interval
-     * @param  {Number} min
-     *         Axis minimum.
-     * @param  {Number} max
-     *         Axis maximum.
+     * @function Highcharts.Axis#getLinearTickPositions
+     *
+     * @param {number} tickInterval
+     *        The normalized tick interval.
+     *
+     * @param {number} min
+     *        Axis minimum.
      *
-     * @return {Array<Number>}
+     * @param {number} max
+     *        Axis maximum.
+     *
+     * @return {Array<number>}
      *         An array of axis values where ticks should be placed.
      */
     getLinearTickPositions: function (tickInterval, min, max) {
@@ -2302,6 +3562,10 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
     /**
      * Resolve the new minorTicks/minorTickInterval options into the legacy
      * loosely typed minorTickInterval option.
+     *
+     * @function Highcharts.Axis#getMinorTickInterval
+     *
+     * @return {number|'auto'|null}
      */
     getMinorTickInterval: function () {
         var options = this.options;
@@ -2319,7 +3583,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Internal function to return the minor tick positions. For logarithmic
      * axes, the same logic as for major ticks is reused.
      *
-     * @return {Array<Number>}
+     * @function Highcharts.Axis#getMinorTickPositions
+     *
+     * @return {Array<number>}
      *         An array of axis values where ticks should be placed.
      */
     getMinorTickPositions: function () {
@@ -2396,6 +3662,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * max.
      *
      * @private
+     * @function Highcharts.Axis#adjustForMinRange
      */
     adjustForMinRange: function () {
         var axis = this,
@@ -2488,6 +3755,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Find the closestPointRange across all series.
      *
      * @private
+     * @function Highcharts.Axis#getClosest
+     *
+     * @return {number}
      */
     getClosest: function () {
         var ret;
@@ -2520,11 +3790,12 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * new category (#2522).
      *
      * @private
+     * @function Highcharts.Axis#nameToX
      *
-     * @param  {Point}
-     *         The point to inspect.
+     * @param {Highcharts.Point} point
+     *        The point to inspect.
      *
-     * @return {Number}
+     * @return {number}
      *         The X value that the point is given.
      */
     nameToX: function (point) {
@@ -2567,6 +3838,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * When changes have been done to series data, update the axis.names.
      *
      * @private
+     * @function Highcharts.Axis#updateNames
      */
     updateNames: function () {
         var axis = this,
@@ -2609,6 +3881,11 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Update translation information.
      *
      * @private
+     * @function Highcharts.Axis#setAxisTranslation
+     *
+     * @param {boolean} saveOld
+     *
+     * @fires Highcharts.Axis#event:afterSetAxisTranslation
      */
     setAxisTranslation: function (saveOld) {
         var axis = this,
@@ -2698,7 +3975,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
             axis.oldTransA = transA;
         }
         axis.translationSlope = axis.transA = transA =
-            axis.options.staticScale ||
+            axis.staticScale ||
             axis.len / ((range + pointRangePadding) || 1);
 
         // Translation addend
@@ -2708,6 +3985,12 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
         fireEvent(this, 'afterSetAxisTranslation');
     },
 
+    /**
+     * @private
+     * @function Highcharts.Axis#minFromRange
+     *
+     * @return {number}
+     */
     minFromRange: function () {
         return this.max - this.range;
     },
@@ -2717,6 +4000,11 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * to the nearest tick.
      *
      * @private
+     * @function Highcharts.Axis#setTickInterval
+     *
+     * @param {boolean} secondPass
+     *
+     * @fires Highcharts.Axis#event:foundExtremes
      */
     setTickInterval: function (secondPass) {
         var axis = this,
@@ -2987,6 +4275,10 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
 
     /**
      * Now we have computed the normalized tickInterval, get the tick positions
+     *
+     * @function Highcharts.Axis#setTickPositions
+     *
+     * @fires Highcharts.Axis#event:afterSetTickPositions
      */
     setTickPositions: function () {
 
@@ -3034,7 +4326,19 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
             tickPositionsOption && tickPositionsOption.slice();
         if (!tickPositions) {
 
-            if (this.isDatetimeAxis) {
+            // Too many ticks (#6405). Create a friendly warning and provide two
+            // ticks so at least we can show the data series.
+            if (
+                !this.ordinalPositions &&
+                (
+                    (this.max - this.min) / this.tickInterval >
+                    Math.max(2 * this.len, 200)
+                )
+            ) {
+                tickPositions = [this.min, this.max];
+                H.error(19);
+
+            } else if (this.isDatetimeAxis) {
                 tickPositions = this.getTimeTicks(
                     this.normalizeTimeTickInterval(
                         this.tickInterval,
@@ -3110,6 +4414,13 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * rounded min/max. Also handle single data points.
      *
      * @private
+     * @function Highcharts.Axis#trimTicks
+     *
+     * @param {Array<number>} tickPositions
+     *
+     * @param {boolean} startOnTicl
+     *
+     * @param {boolean} endOnTick
      */
     trimTicks: function (tickPositions, startOnTick, endOnTick) {
         var roundedMin = tickPositions[0],
@@ -3149,7 +4460,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Check if there are multiple axes in the same pane.
      *
      * @private
-     * @return {Boolean}
+     * @function Highcharts.Axis#alignToOthers
+     *
+     * @return {boolean}
      *         True if there are other axes.
      */
     alignToOthers: function () {
@@ -3198,6 +4511,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * in `this.tickAmount`.
      *
      * @private
+     * @function Highcharts.Axis#getTickAmount
      */
     getTickAmount: function () {
         var options = this.options,
@@ -3237,6 +4551,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * number of ticks in that group.
      *
      * @private
+     * @function Highcharts.Axis#adjustTickAmount
      */
     adjustTickAmount: function () {
         var tickInterval = this.tickInterval,
@@ -3302,6 +4617,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Set the scale based on data min and max, user set min and max or options.
      *
      * @private
+     * @function Highcharts.Axis#setScale
+     *
+     * @fires Highcharts.Axis#event:afterSetScale
      */
     setScale: function () {
         var axis = this,
@@ -3379,18 +4697,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * will not allow a range lower than the `minRange` option, which by default
      * is the range of five points.
      *
-     * @param  {Number} [newMin]
-     *         The new minimum value.
-     * @param  {Number} [newMax]
-     *         The new maximum value.
-     * @param  {Boolean} [redraw=true]
-     *         Whether to redraw the chart or wait for an explicit call to
-     *         {@link Highcharts.Chart#redraw}
-     * @param  {AnimationOptions} [animation=true]
-     *         Enable or modify animations.
-     * @param  {Object} [eventArguments]
-     *         Arguments to be accessed in event handler.
-     *
      * @sample highcharts/members/axis-setextremes/
      *         Set extremes from a button
      * @sample highcharts/members/axis-setextremes-datetime/
@@ -3401,6 +4707,26 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      *         Set extremes in Highstock
      * @sample maps/members/axis-setextremes/
      *         Set extremes in Highmaps
+     *
+     * @function Highcharts.Axis#setExtremes
+     *
+     * @param {number} [newMin]
+     *        The new minimum value.
+     *
+     * @param {number} [newMax]
+     *        The new maximum value.
+     *
+     * @param {boolean} [redraw=true]
+     *        Whether to redraw the chart or wait for an explicit call to
+     *        {@link Highcharts.Chart#redraw}
+     *
+     * @param {boolean|Highcharts.AnimationOptionsObject} [animation=true]
+     *        Enable or modify animations.
+     *
+     * @param {*} [eventArguments]
+     *        Arguments to be accessed in event handler.
+     *
+     * @fires Highcharts.Axis#event:setExtremes
      */
     setExtremes: function (newMin, newMax, redraw, animation, eventArguments) {
         var axis = this,
@@ -3436,6 +4762,13 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * allow overriding in stock charts.
      *
      * @private
+     * @function Highcharts.Axis#zoom
+     *
+     * @param {number} newMin
+     *
+     * @param {number} newMax
+     *
+     * @return {boolean}
      */
     zoom: function (newMin, newMax) {
         var dataMin = this.dataMin,
@@ -3489,6 +4822,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Update the axis metrics.
      *
      * @private
+     * @function Highcharts.Axis#setAxisSize
      */
     setAxisSize: function () {
         var chart = this.chart,
@@ -3533,35 +4867,18 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
         this.pos = horiz ? left : top; // distance from SVG origin
     },
 
-    /**
-     * The returned object literal from the {@link Highcharts.Axis#getExtremes}
-     * function.
-     *
-     * @typedef  {Object} Extremes
-     * @property {Number} dataMax
-     *           The maximum value of the axis' associated series.
-     * @property {Number} dataMin
-     *           The minimum value of the axis' associated series.
-     * @property {Number} max
-     *           The maximum axis value, either automatic or set manually. If
-     *           the `max` option is not set, `maxPadding` is 0 and `endOnTick`
-     *           is false, this value will be the same as `dataMax`.
-     * @property {Number} min
-     *           The minimum axis value, either automatic or set manually. If
-     *           the `min` option is not set, `minPadding` is 0 and
-     *           `startOnTick` is false, this value will be the same
-     *           as `dataMin`.
-     */
     /**
      * Get the current extremes for the axis.
      *
-     * @returns {Extremes}
-     *          An object containing extremes information.
+     * @sample highcharts/members/axis-getextremes/
+     *         Report extremes by click on a button
+     * @sample maps/members/axis-getextremes/
+     *         Get extremes in Highmaps
+     *
+     * @function Highcharts.Axis#getExtremes
      *
-     * @sample  highcharts/members/axis-getextremes/
-     *          Report extremes by click on a button
-     * @sample  maps/members/axis-getextremes/
-     *          Get extremes in Highmaps
+     * @returns {Highcharts.ExtremesObject}
+     *          An object containing extremes information.
      */
     getExtremes: function () {
         var axis = this,
@@ -3581,10 +4898,12 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Get the zero plane either based on zero or on the min or max value.
      * Used in bar and area plots.
      *
-     * @param  {Number} threshold
-     *         The threshold in axis values.
+     * @function Highcharts.Axis#getThreshold
+     *
+     * @param {number} threshold
+     *        The threshold in axis values.
      *
-     * @return {Number}
+     * @return {number}
      *         The translated threshold position in terms of pixels, and
      *         corrected to stay within the axis bounds.
      */
@@ -3611,10 +4930,15 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Compute auto alignment for the axis label based on which side the axis is
      * on and the given rotation for the label.
      *
-     * @param  {Number} rotation
-     *         The rotation in degrees as set by either the `rotation` or
-     *         `autoRotation` options.
      * @private
+     * @function Highcharts.Axis#autoLabelAlign
+     *
+     * @param {number} rotation
+     *        The rotation in degrees as set by either the `rotation` or
+     *        `autoRotation` options.
+     *
+     * @return {string}
+     *         Can be `center`, `left` or `right`.
      */
     autoLabelAlign: function (rotation) {
         var ret,
@@ -3634,10 +4958,12 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Get the tick length and width for the axis based on axis options.
      *
      * @private
+     * @function Highcharts.Axis#tickSize
      *
-     * @param  {String} prefix
-     *         'tick' or 'minorTick'
-     * @return {Array<Number>}
+     * @param {string} prefix
+     *        'tick' or 'minorTick'
+     *
+     * @return {Array<number>}
      *         An array of tickLength and tickWidth
      */
     tickSize: function (prefix) {
@@ -3662,6 +4988,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Return the size of the labels.
      *
      * @private
+     * @function Highcharts.Axis#labelMetrics
+     *
+     * @return {Highcharts.FontMetricsObject}
      */
     labelMetrics: function () {
         var index = this.tickPositions && this.tickPositions[0] || 0;
@@ -3677,6 +5006,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * and adding ellipsis. On a vertical axis remove ticks and add ellipsis.
      *
      * @private
+     * @function Highcharts.Axis#unsquish
+     *
+     * @return {number}
      */
     unsquish: function () {
         var labelOptions = this.options.labels,
@@ -3755,15 +5087,17 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * rendering and placement.
      *
      * @private
+     * @function Highcharts.Axis#getSlotWidth
      *
-     * @param  {Object} tick Optionally, calculate the slot width basing on
-     * tick label. It is used in highcharts-3d module, where the slots has
-     * different widths depending on perspective angles.
+     * @param {*} [tick]
+     *        Optionally, calculate the slot width basing on tick label. It is
+     *        used in highcharts-3d module, where the slots has different widths
+     *        depending on perspective angles.
      *
-     * @return {Number}
+     * @return {number}
      *         The pixel width allocated to each axis label.
      */
-    getSlotWidth: function () {
+    getSlotWidth: function (tick) {
         // #5086, #1580, #1931
         var chart = this.chart,
             horiz = this.horiz,
@@ -3775,6 +5109,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
             marginLeft = chart.margin[3];
 
         return (
+            tick &&
+            tick.slotWidth // Used by grid axis
+        ) || (
             horiz &&
             (labelOptions.step || 0) < 2 &&
             !labelOptions.rotation && // #4415
@@ -3801,6 +5138,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * to be applied.
      *
      * @private
+     * @function Highcharts.Axis#renderUnsquish
      */
     renderUnsquish: function () {
         var chart = this.chart,
@@ -3907,7 +5245,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
             commonWidth = (
                 maxLabelLength > chart.chartHeight * 0.5 ?
                     chart.chartHeight * 0.33 :
-                    chart.chartHeight
+                    maxLabelLength
             );
             if (!textOverflowOption) {
                 commonTextOverflow = 'ellipsis';
@@ -3927,11 +5265,14 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
                 label = tick && tick.label,
                 widthOption = labelStyleOptions.width,
                 css = {};
+
             if (label) {
                 // This needs to go before the CSS in old IE (#4502)
                 label.attr(attr);
 
-                if (
+                if (tick.shortenLabel) {
+                    tick.shortenLabel();
+                } else if (
                     commonWidth &&
                     !widthOption &&
                     // Setting width in this case messes with the bounding box
@@ -3966,7 +5307,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
                 delete label.specificTextOverflow;
                 tick.rotation = attr.rotation;
             }
-        });
+        }, this);
 
         // Note: Why is this not part of getLabelPosition?
         this.tickRotCorr = renderer.rotCorr(
@@ -3979,7 +5320,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
     /**
      * Return true if the axis has associated data.
      *
-     * @return {Boolean}
+     * @function Highcharts.Axis#hasData
+     *
+     * @return {boolean}
      *         True if the axis has associated visible series and those series
      *         have either valid data points or explicit `min` and `max`
      *         settings.
@@ -3998,7 +5341,11 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
 
     /**
      * Adds the title defined in axis.options.title.
-     * @param {Boolean} display - whether or not to display the title
+     *
+     * @function Highcharts.Axis#addTitle
+     *
+     * @param {boolean} display
+     *        Whether or not to display the title.
      */
     addTitle: function (display) {
         var axis = this,
@@ -4054,8 +5401,11 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Generates a tick for initial positioning.
      *
      * @private
+     * @function Highcharts.Axis#generateTick
+     *
      * @param {number} pos
      *        The tick position in axis values.
+     *
      * @param {number} i
      *        The index of the tick in {@link Axis.tickPositions}.
      */
@@ -4070,9 +5420,13 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
     },
 
     /**
-     * Render the tick labels to a preliminary position to get their sizes.
+    /**
+     * Render the tick labels to a preliminary position to get their sizes
      *
      * @private
+     * @function Highcharts.Axis#getOffset
+     *
+     * @fires Highcharts.Axis#event:afterGetOffset
      */
     getOffset: function () {
         var axis = this,
@@ -4101,7 +5455,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
             className = options.className,
             axisParent = axis.axisParent, // Used in color axis
             lineHeightCorrection,
-            tickSize = this.tickSize('tick');
+            tickSize;
 
         // For reuse in Axis.render
         hasData = axis.hasData();
@@ -4227,6 +5581,17 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
 
         axis.axisTitleMargin = pick(titleOffsetOption, labelOffsetPadded);
 
+        if (axis.getMaxLabelDimensions) {
+            axis.maxLabelDimensions = axis.getMaxLabelDimensions(
+                ticks,
+                tickPositions
+            );
+        }
+
+        // Due to GridAxis.tickSize, tickSize should be calculated after ticks
+        // has rendered.
+        tickSize = this.tickSize('tick');
+
         axisOffset[side] = Math.max(
             axisOffset[side],
             axis.axisTitleMargin + titleOffset + directionFactor * axis.offset,
@@ -4242,15 +5607,20 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
             0 :
             Math.floor(axis.axisLine.strokeWidth() / 2) * 2; // #4308, #4371
         clipOffset[invertedSide] = Math.max(clipOffset[invertedSide], clip);
+
+        fireEvent(this, 'afterGetOffset');
     },
 
     /**
      * Internal function to get the path for the axis line. Extended for polar
      * charts.
      *
-     * @param  {Number} lineWidth
-     *         The line width in pixels.
-     * @return {Array}
+     * @function Highcharts.Axis#getLinePath
+     *
+     * @param {number} lineWidth
+     *        The line width in pixels.
+     *
+     * @return {Highcharts.SVGPathArray}
      *         The SVG path definition in array form.
      */
     getLinePath: function (lineWidth) {
@@ -4288,6 +5658,8 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
     /**
      * Render the axis line. Called internally when rendering and redrawing the
      * axis.
+     *
+     * @function Highcharts.Axis#renderLine
      */
     renderLine: function () {
         if (!this.axisLine) {
@@ -4303,8 +5675,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Position the axis title.
      *
      * @private
+     * @function Highcharts.Axis#getTitlePosition
      *
-     * @return {Object}
+     * @return {Highcharts.AxisTitlePositionObject}
      *         X and Y positions for the title.
      */
     getTitlePosition: function () {
@@ -4366,8 +5739,10 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Render a minor tick into the given position. If a minor tick already
      * exists in this position, move it.
      *
-     * @param  {number} pos
-     *         The position in axis values.
+     * @function Highcharts.Axis#renderMinorTick
+     *
+     * @param {number} pos
+     *        The position in axis values.
      */
     renderMinorTick: function (pos) {
         var slideInTicks = this.chart.hasRendered && isNumber(this.oldMin),
@@ -4389,10 +5764,13 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Render a major tick into the given position. If a tick already exists
      * in this position, move it.
      *
-     * @param  {number} pos
-     *         The position in axis values.
-     * @param  {number} i
-     *         The tick index.
+     * @function Highcharts.Axis#renderTick
+     *
+     * @param {number} pos
+     *        The position in axis values.
+     *
+     * @param {number} i
+     *        The tick index.
      */
     renderTick: function (pos, i) {
         var isLinked = this.isLinked,
@@ -4405,10 +5783,13 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
             if (!ticks[pos]) {
                 ticks[pos] = new Tick(this, pos);
             }
-
+            // NOTE this seems like overkill. Could be handled in tick.render by
+            // setting old position in attr, then set new position in animate.
             // render new ticks in old position
             if (slideInTicks && ticks[pos].isNew) {
-                ticks[pos].render(i, true, 0.1);
+                // Start with negative opacity so that it is visible from
+                // halfway into the animation
+                ticks[pos].render(i, true, -1);
             }
 
             ticks[pos].render(i);
@@ -4419,6 +5800,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * Render the axis.
      *
      * @private
+     * @function Highcharts.Axis#render
+     *
+     * @fires Highcharts.Axis#event:afterRender
      */
     render: function () {
         var axis = this,
@@ -4604,6 +5988,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * internally from {@link Chart#redraw}.
      *
      * @private
+     * @function Highcharts.Axis#redraw
      */
     redraw: function () {
 
@@ -4633,8 +6018,10 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
      * to fully remove the axis.
      *
      * @private
-     * @param  {Boolean} keepEvents
-     *         Whether to preserve events, used internally in Axis.update.
+     * @function Highcharts.Axis#destroy
+     *
+     * @param {boolean} keepEvents
+     *        Whether to preserve events, used internally in Axis.update.
      */
     destroy: function (keepEvents) {
         var axis = this,
@@ -4671,10 +6058,10 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
             }
         }
 
-        // Destroy local variables
+        // Destroy elements
         each(
             ['stackTotalGroup', 'axisLine', 'axisTitle', 'axisGroup',
-                'gridGroup', 'labelGroup', 'cross'],
+                'gridGroup', 'labelGroup', 'cross', 'scrollbar'],
             function (prop) {
                 if (axis[prop]) {
                     axis[prop] = axis[prop].destroy();
@@ -4699,11 +6086,17 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
     /**
      * Internal function to draw a crosshair.
      *
-     * @param  {PointerEvent} [e]
-     *         The event arguments from the modified pointer event, extended
-     *         with `chartX` and `chartY`
-     * @param  {Point} [point]
-     *         The Point object if the crosshair snaps to points.
+     * @function Highcharts.Axis#drawCrosshair
+     *
+     * @param {Highcharts.PointerEventObject} [e]
+     *        The event arguments from the modified pointer event, extended with
+     *        `chartX` and `chartY`
+     *
+     * @param {Highcharts.Point} [point]
+     *        The Point object if the crosshair snaps to points.
+     *
+     * @fires Highcharts.Axis#event:afterDrawCrosshair
+     * @fires Highcharts.Axis#event:drawCrosshair
      */
     drawCrosshair: function (e, point) {
 
@@ -4802,7 +6195,9 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */{
     },
 
     /**
-     *    Hide the crosshair if visible.
+     * Hide the crosshair if visible.
+     *
+     * @function Highcharts.Axis#hideCrosshair
      */
     hideCrosshair: function () {
         if (this.cross) {