From 08820aae0c4b7c8e8dd7335f2dce8d7c483ae730 Mon Sep 17 00:00:00 2001
From: Kem Chen <chenkem@gmail.com>
Date: Sat, 22 Sep 2018 21:00:04 +0800
Subject: [PATCH 01/10] Add Parameters Section

```
(\n[ ]+)(((/// - parameter \w+:.*\s+)(///((\s+)|( \s+.+\s+)))?)*/// - parameter \w+:.*)
```

```
$1/// - Parameters:$1$2
```
---
 Source/Charts/Animation/Animator.swift         |  8 ++++++++
 Source/Charts/Charts/BarChartView.swift        |  2 ++
 .../Charts/Charts/BarLineChartViewBase.swift   | 18 ++++++++++++++++++
 Source/Charts/Charts/ChartViewBase.swift       | 18 ++++++++++++++++++
 Source/Charts/Components/AxisBase.swift        |  1 +
 Source/Charts/Components/IMarker.swift         |  2 ++
 Source/Charts/Components/LegendEntry.swift     |  1 +
 .../Implementations/ChartBaseDataSet.swift     |  5 +++++
 .../Standard/BarChartData.swift                |  2 ++
 .../Standard/BarChartDataEntry.swift           |  2 ++
 .../Standard/BubbleChartDataEntry.swift        |  4 ++++
 .../Implementations/Standard/ChartData.swift   |  3 +++
 .../Standard/ChartDataEntry.swift              |  4 ++++
 .../Standard/ChartDataEntryBase.swift          |  4 ++++
 .../Standard/ChartDataSet.swift                |  8 ++++++++
 .../Standard/CombinedChartData.swift           |  2 ++
 .../Standard/PieChartDataEntry.swift           |  8 ++++++++
 .../Standard/RadarChartDataEntry.swift         |  2 ++
 .../Charts/Data/Interfaces/IChartDataSet.swift |  9 +++++++++
 Source/Charts/Filters/DataApproximator.swift   |  1 +
 .../Formatters/IAxisValueFormatter.swift       |  1 +
 Source/Charts/Formatters/IValueFormatter.swift |  1 +
 Source/Charts/Highlight/BarHighlighter.swift   |  2 ++
 Source/Charts/Highlight/ChartHighlighter.swift |  3 +++
 Source/Charts/Highlight/Highlight.swift        |  5 +++++
 Source/Charts/Highlight/IHighlighter.swift     |  1 +
 .../Charts/Highlight/PieRadarHighlighter.swift |  1 +
 Source/Charts/Highlight/RadarHighlighter.swift |  1 +
 Source/Charts/Highlight/Range.swift            |  1 +
 Source/Charts/Renderers/AxisRendererBase.swift |  1 +
 .../Renderers/ChartDataRendererBase.swift      |  1 +
 .../Charts/Renderers/RadarChartRenderer.swift  |  1 +
 .../Renderers/Scatter/IShapeRenderer.swift     |  1 +
 33 files changed, 124 insertions(+)

diff --git a/Source/Charts/Animation/Animator.swift b/Source/Charts/Animation/Animator.swift
index 042012b1ba..af150b130d 100644
--- a/Source/Charts/Animation/Animator.swift
+++ b/Source/Charts/Animation/Animator.swift
@@ -136,6 +136,7 @@ open class Animator: NSObject
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter xAxisDuration: duration for animating the x axis
     /// - parameter yAxisDuration: duration for animating the y axis
     /// - parameter easingX: an easing function for the animation on the x axis
@@ -169,6 +170,7 @@ open class Animator: NSObject
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter xAxisDuration: duration for animating the x axis
     /// - parameter yAxisDuration: duration for animating the y axis
     /// - parameter easingOptionX: the easing function for the animation on the x axis
@@ -180,6 +182,7 @@ open class Animator: NSObject
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter xAxisDuration: duration for animating the x axis
     /// - parameter yAxisDuration: duration for animating the y axis
     /// - parameter easing: an easing function for the animation
@@ -190,6 +193,7 @@ open class Animator: NSObject
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter xAxisDuration: duration for animating the x axis
     /// - parameter yAxisDuration: duration for animating the y axis
     /// - parameter easingOption: the easing function for the animation
@@ -200,6 +204,7 @@ open class Animator: NSObject
 
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter xAxisDuration: duration for animating the x axis
     /// - parameter easing: an easing function for the animation
     @objc open func animate(xAxisDuration: TimeInterval, easing: ChartEasingFunctionBlock?)
@@ -225,6 +230,7 @@ open class Animator: NSObject
     
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter xAxisDuration: duration for animating the x axis
     /// - parameter easingOption: the easing function for the animation
     @objc open func animate(xAxisDuration: TimeInterval, easingOption: ChartEasingOption = .easeInOutSine)
@@ -234,6 +240,7 @@ open class Animator: NSObject
 
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter yAxisDuration: duration for animating the y axis
     /// - parameter easing: an easing function for the animation
     @objc open func animate(yAxisDuration: TimeInterval, easing: ChartEasingFunctionBlock?)
@@ -259,6 +266,7 @@ open class Animator: NSObject
     
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter yAxisDuration: duration for animating the y axis
     /// - parameter easingOption: the easing function for the animation
     @objc open func animate(yAxisDuration: TimeInterval, easingOption: ChartEasingOption = .easeInOutSine)
diff --git a/Source/Charts/Charts/BarChartView.swift b/Source/Charts/Charts/BarChartView.swift
index ec4c019f1f..b847825816 100644
--- a/Source/Charts/Charts/BarChartView.swift
+++ b/Source/Charts/Charts/BarChartView.swift
@@ -111,6 +111,7 @@ open class BarChartView: BarLineChartViewBase, BarChartDataProvider
     /// Previously set x-values of entries will be overwritten. Leaves space between bars and groups as specified by the parameters.
     /// Calls `notifyDataSetChanged()` afterwards.
     ///
+    /// - Parameters:
     /// - parameter fromX: the starting point on the x-axis where the grouping should begin
     /// - parameter groupSpace: the space between groups of bars in values (not pixels) e.g. 0.8f for bar width 1f
     /// - parameter barSpace: the space between individual bars in values (not pixels) e.g. 0.1f for bar width 1f
@@ -128,6 +129,7 @@ open class BarChartView: BarLineChartViewBase, BarChartDataProvider
     }
     
     /// Highlights the value at the given x-value in the given DataSet. Provide -1 as the dataSetIndex to undo all highlighting.
+    /// - Parameters:
     /// - parameter x:
     /// - parameter dataSetIndex:
     /// - parameter stackIndex: the index inside the stack - only relevant for stacked entries
diff --git a/Source/Charts/Charts/BarLineChartViewBase.swift b/Source/Charts/Charts/BarLineChartViewBase.swift
index b64baba3bf..4becef6541 100644
--- a/Source/Charts/Charts/BarLineChartViewBase.swift
+++ b/Source/Charts/Charts/BarLineChartViewBase.swift
@@ -1010,6 +1010,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// Zooms in or out by the given scale factor. x and y are the coordinates
     /// (in pixels) of the zoom center.
     ///
+    /// - Parameters:
     /// - parameter scaleX: if < 1 --> zoom out, if > 1 --> zoom in
     /// - parameter scaleY: if < 1 --> zoom out, if > 1 --> zoom in
     /// - parameter x:
@@ -1031,6 +1032,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// Zooms in or out by the given scale factor.
     /// x and y are the values (**not pixels**) of the zoom center.
     ///
+    /// - Parameters:
     /// - parameter scaleX: if < 1 --> zoom out, if > 1 --> zoom in
     /// - parameter scaleY: if < 1 --> zoom out, if > 1 --> zoom in
     /// - parameter xValue:
@@ -1057,6 +1059,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     
     /// Zooms to the center of the chart with the given scale factor.
     ///
+    /// - Parameters:
     /// - parameter scaleX: if < 1 --> zoom out, if > 1 --> zoom in
     /// - parameter scaleY: if < 1 --> zoom out, if > 1 --> zoom in
     /// - parameter xValue:
@@ -1077,6 +1080,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     
     /// Zooms by the specified scale factor to the specified values on the specified axis.
     ///
+    /// - Parameters:
     /// - parameter scaleX:
     /// - parameter scaleY:
     /// - parameter xValue:
@@ -1119,6 +1123,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     
     /// Zooms by the specified scale factor to the specified values on the specified axis.
     ///
+    /// - Parameters:
     /// - parameter scaleX:
     /// - parameter scaleY:
     /// - parameter xValue:
@@ -1140,6 +1145,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     
     /// Zooms by the specified scale factor to the specified values on the specified axis.
     ///
+    /// - Parameters:
     /// - parameter scaleX:
     /// - parameter scaleY:
     /// - parameter xValue:
@@ -1219,6 +1225,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     
     /// Sets the size of the area (range on the y-axis) that should be maximum visible at once.
     ///
+    /// - Parameters:
     /// - parameter yRange:
     /// - parameter axis: - the axis for which this limit should apply
     @objc open func setVisibleYRangeMaximum(_ maxYRange: Double, axis: YAxis.AxisDependency)
@@ -1229,6 +1236,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     
     /// Sets the size of the area (range on the y-axis) that should be minimum visible at once, no further zooming in possible.
     ///
+    /// - Parameters:
     /// - parameter yRange:
     /// - parameter axis: - the axis for which this limit should apply
     @objc open func setVisibleYRangeMinimum(_ minYRange: Double, axis: YAxis.AxisDependency)
@@ -1239,6 +1247,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
 
     /// Limits the maximum and minimum y range that can be visible by pinching and zooming.
     ///
+    /// - Parameters:
     /// - parameter minYRange:
     /// - parameter maxYRange:
     /// - parameter axis:
@@ -1266,6 +1275,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// Centers the viewport to the specified y-value on the y-axis.
     /// This also refreshes the chart by calling setNeedsDisplay().
     /// 
+    /// - Parameters:
     /// - parameter yValue:
     /// - parameter axis: - which axis should be used as a reference for the y-axis
     @objc open func moveViewToY(_ yValue: Double, axis: YAxis.AxisDependency)
@@ -1285,6 +1295,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// This will move the left side of the current viewport to the specified x-value on the x-axis, and center the viewport to the specified y-value on the y-axis.
     /// This also refreshes the chart by calling setNeedsDisplay().
     /// 
+    /// - Parameters:
     /// - parameter xValue:
     /// - parameter yValue:
     /// - parameter axis: - which axis should be used as a reference for the y-axis
@@ -1305,6 +1316,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// This will move the left side of the current viewport to the specified x-position and center the viewport to the specified y-position animated.
     /// This also refreshes the chart by calling setNeedsDisplay().
     ///
+    /// - Parameters:
     /// - parameter xValue:
     /// - parameter yValue:
     /// - parameter axis: which axis should be used as a reference for the y-axis
@@ -1340,6 +1352,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// This will move the left side of the current viewport to the specified x-position and center the viewport to the specified y-position animated.
     /// This also refreshes the chart by calling setNeedsDisplay().
     ///
+    /// - Parameters:
     /// - parameter xValue:
     /// - parameter yValue:
     /// - parameter axis: which axis should be used as a reference for the y-axis
@@ -1358,6 +1371,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// This will move the left side of the current viewport to the specified x-position and center the viewport to the specified y-position animated.
     /// This also refreshes the chart by calling setNeedsDisplay().
     ///
+    /// - Parameters:
     /// - parameter xValue:
     /// - parameter yValue:
     /// - parameter axis: which axis should be used as a reference for the y-axis
@@ -1375,6 +1389,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// This will move the center of the current viewport to the specified x-value and y-value.
     /// This also refreshes the chart by calling setNeedsDisplay().
     ///
+    /// - Parameters:
     /// - parameter xValue:
     /// - parameter yValue:
     /// - parameter axis: - which axis should be used as a reference for the y-axis
@@ -1398,6 +1413,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     
     /// This will move the center of the current viewport to the specified x-value and y-value animated.
     ///
+    /// - Parameters:
     /// - parameter xValue:
     /// - parameter yValue:
     /// - parameter axis: which axis should be used as a reference for the y-axis
@@ -1433,6 +1449,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     
     /// This will move the center of the current viewport to the specified x-value and y-value animated.
     ///
+    /// - Parameters:
     /// - parameter xValue:
     /// - parameter yValue:
     /// - parameter axis: which axis should be used as a reference for the y-axis
@@ -1450,6 +1467,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     
     /// This will move the center of the current viewport to the specified x-value and y-value animated.
     ///
+    /// - Parameters:
     /// - parameter xValue:
     /// - parameter yValue:
     /// - parameter axis: which axis should be used as a reference for the y-axis
diff --git a/Source/Charts/Charts/ChartViewBase.swift b/Source/Charts/Charts/ChartViewBase.swift
index 7528e0c75b..7a1518b66b 100644
--- a/Source/Charts/Charts/ChartViewBase.swift
+++ b/Source/Charts/Charts/ChartViewBase.swift
@@ -21,6 +21,7 @@ import CoreGraphics
 public protocol ChartViewDelegate
 {
     /// Called when a value has been selected inside the chart.
+    /// - Parameters:
     /// - parameter entry: The selected Entry.
     /// - parameter highlight: The corresponding highlight object that contains information about the highlighted position such as dataSetIndex etc.
     @objc optional func chartValueSelected(_ chartView: ChartViewBase, entry: ChartDataEntry, highlight: Highlight)
@@ -428,6 +429,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Highlights any y-value at the given x-value in the given DataSet.
     /// Provide -1 as the dataSetIndex to undo all highlighting.
     /// This method will call the delegate.
+    /// - Parameters:
     /// - parameter x: The x-value to highlight
     /// - parameter dataSetIndex: The dataset index to search in
     /// - parameter dataIndex: The data index to search in (only used in CombinedChartView currently)
@@ -439,6 +441,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Highlights the value at the given x-value and y-value in the given DataSet.
     /// Provide -1 as the dataSetIndex to undo all highlighting.
     /// This method will call the delegate.
+    /// - Parameters:
     /// - parameter x: The x-value to highlight
     /// - parameter y: The y-value to highlight. Supply `NaN` for "any"
     /// - parameter dataSetIndex: The dataset index to search in
@@ -450,6 +453,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Highlights any y-value at the given x-value in the given DataSet.
     /// Provide -1 as the dataSetIndex to undo all highlighting.
+    /// - Parameters:
     /// - parameter x: The x-value to highlight
     /// - parameter dataSetIndex: The dataset index to search in
     /// - parameter dataIndex: The data index to search in (only used in CombinedChartView currently)
@@ -461,6 +465,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Highlights the value at the given x-value and y-value in the given DataSet.
     /// Provide -1 as the dataSetIndex to undo all highlighting.
+    /// - Parameters:
     /// - parameter x: The x-value to highlight
     /// - parameter y: The y-value to highlight. Supply `NaN` for "any"
     /// - parameter dataSetIndex: The dataset index to search in
@@ -486,6 +491,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Highlights the values represented by the provided Highlight object
     /// This method *will not* call the delegate.
+    /// - Parameters:
     /// - parameter highlight: contains information about which entry should be highlighted
     @objc open func highlightValue(_ highlight: Highlight?)
     {
@@ -611,6 +617,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter xAxisDuration: duration for animating the x axis
     /// - parameter yAxisDuration: duration for animating the y axis
     /// - parameter easingX: an easing function for the animation on the x axis
@@ -622,6 +629,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter xAxisDuration: duration for animating the x axis
     /// - parameter yAxisDuration: duration for animating the y axis
     /// - parameter easingOptionX: the easing function for the animation on the x axis
@@ -633,6 +641,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter xAxisDuration: duration for animating the x axis
     /// - parameter yAxisDuration: duration for animating the y axis
     /// - parameter easing: an easing function for the animation
@@ -643,6 +652,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter xAxisDuration: duration for animating the x axis
     /// - parameter yAxisDuration: duration for animating the y axis
     /// - parameter easingOption: the easing function for the animation
@@ -653,6 +663,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter xAxisDuration: duration for animating the x axis
     /// - parameter yAxisDuration: duration for animating the y axis
     @objc open func animate(xAxisDuration: TimeInterval, yAxisDuration: TimeInterval)
@@ -662,6 +673,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter xAxisDuration: duration for animating the x axis
     /// - parameter easing: an easing function for the animation
     @objc open func animate(xAxisDuration: TimeInterval, easing: ChartEasingFunctionBlock?)
@@ -671,6 +683,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter xAxisDuration: duration for animating the x axis
     /// - parameter easingOption: the easing function for the animation
     @objc open func animate(xAxisDuration: TimeInterval, easingOption: ChartEasingOption)
@@ -680,6 +693,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter xAxisDuration: duration for animating the x axis
     @objc open func animate(xAxisDuration: TimeInterval)
     {
@@ -688,6 +702,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter yAxisDuration: duration for animating the y axis
     /// - parameter easing: an easing function for the animation
     @objc open func animate(yAxisDuration: TimeInterval, easing: ChartEasingFunctionBlock?)
@@ -697,6 +712,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter yAxisDuration: duration for animating the y axis
     /// - parameter easingOption: the easing function for the animation
     @objc open func animate(yAxisDuration: TimeInterval, easingOption: ChartEasingOption)
@@ -706,6 +722,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    /// - Parameters:
     /// - parameter yAxisDuration: duration for animating the y axis
     @objc open func animate(yAxisDuration: TimeInterval)
     {
@@ -824,6 +841,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// the SD card chart is saved as a PNG image, example:
     /// saveToPath("myfilename", "foldername1/foldername2")
     ///
+    /// - Parameters:
     /// - parameter to: path to the image to save
     /// - parameter format: the format to save
     /// - parameter compressionQuality: compression quality for lossless formats (JPEG)
diff --git a/Source/Charts/Components/AxisBase.swift b/Source/Charts/Components/AxisBase.swift
index 56d56b9c82..ea460e36dc 100644
--- a/Source/Charts/Components/AxisBase.swift
+++ b/Source/Charts/Components/AxisBase.swift
@@ -336,6 +336,7 @@ open class AxisBase: ComponentBase
     }
     
     /// Calculates the minimum, maximum and range values of the YAxis with the given minimum and maximum values from the chart data.
+    /// - Parameters:
     /// - parameter dataMin: the y-min value according to chart data
     /// - parameter dataMax: the y-max value according to chart
     @objc open func calculate(min dataMin: Double, max dataMax: Double)
diff --git a/Source/Charts/Components/IMarker.swift b/Source/Charts/Components/IMarker.swift
index 59abfad7bb..4d52486ba9 100644
--- a/Source/Charts/Components/IMarker.swift
+++ b/Source/Charts/Components/IMarker.swift
@@ -26,11 +26,13 @@ public protocol IMarker: class
     ///            This allows conditional adjusting of the Marker position.
     ///            If you have no adjustments to make, return self.offset().
     ///
+    /// - Parameters:
     /// - parameter point: This is the point at which the marker wants to be drawn. You can adjust the offset conditionally based on this argument.
     func offsetForDrawing(atPoint: CGPoint) -> CGPoint
     
     /// This method enables a custom IMarker to update it's content every time the IMarker is redrawn according to the data entry it points to.
     ///
+    /// - Parameters:
     /// - parameter entry: The Entry the IMarker belongs to. This can also be any subclass of Entry, like BarEntry or CandleEntry, simply cast it at runtime.
     /// - parameter highlight: The highlight object contains information about the highlighted value such as it's dataset-index, the selected range or stack-index (only stacked bar entries).
     func refreshContent(entry: ChartDataEntry, highlight: Highlight)
diff --git a/Source/Charts/Components/LegendEntry.swift b/Source/Charts/Components/LegendEntry.swift
index 88ed2e115c..7006515f0c 100644
--- a/Source/Charts/Components/LegendEntry.swift
+++ b/Source/Charts/Components/LegendEntry.swift
@@ -24,6 +24,7 @@ open class LegendEntry: NSObject
         super.init()
     }
     
+    /// - Parameters:
     /// - parameter label:                  The legend entry text.
     ///                                     A `nil` label will start a group.
     /// - parameter form:                   The form to draw for this entry.
diff --git a/Source/Charts/Data/Implementations/ChartBaseDataSet.swift b/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
index b78867679e..ca97336681 100644
--- a/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
+++ b/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
@@ -217,6 +217,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     }
     
     /// Adds a new color to the colors array of the DataSet.
+    /// - Parameters:
     /// - parameter color: the color to add
     open func addColor(_ color: NSUIColor)
     {
@@ -225,6 +226,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     
     /// Sets the one and **only** color that should be used for this DataSet.
     /// Internally, this recreates the colors array and adds the specified color.
+    /// - Parameters:
     /// - parameter color: the color to set
     open func setColor(_ color: NSUIColor)
     {
@@ -233,6 +235,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     }
     
     /// Sets colors to a single color a specific alpha value.
+    /// - Parameters:
     /// - parameter color: the color to set
     /// - parameter alpha: alpha to apply to the set `color`
     @objc open func setColor(_ color: NSUIColor, alpha: CGFloat)
@@ -241,6 +244,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     }
     
     /// Sets colors with a specific alpha value.
+    /// - Parameters:
     /// - parameter colors: the colors to set
     /// - parameter alpha: alpha to apply to the set `colors`
     @objc open func setColors(_ colors: [NSUIColor], alpha: CGFloat)
@@ -256,6 +260,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     }
     
     /// Sets colors with a specific alpha value.
+    /// - Parameters:
     /// - parameter colors: the colors to set
     /// - parameter alpha: alpha to apply to the set `colors`
     open func setColors(_ colors: NSUIColor...)
diff --git a/Source/Charts/Data/Implementations/Standard/BarChartData.swift b/Source/Charts/Data/Implementations/Standard/BarChartData.swift
index 0317fc8a6b..846876a556 100644
--- a/Source/Charts/Data/Implementations/Standard/BarChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/BarChartData.swift
@@ -34,6 +34,7 @@ open class BarChartData: BarLineScatterCandleBubbleChartData
     /// Do not forget to call notifyDataSetChanged() on your BarChart object after calling this method.
     ///
     /// - parameter the starting point on the x-axis where the grouping should begin
+    /// - Parameters:
     /// - parameter groupSpace: The space between groups of bars in values (not pixels) e.g. 0.8f for bar width 1f
     /// - parameter barSpace: The space between individual bars in values (not pixels) e.g. 0.1f for bar width 1f
     @objc open func groupBars(fromX: Double, groupSpace: Double, barSpace: Double)
@@ -95,6 +96,7 @@ open class BarChartData: BarLineScatterCandleBubbleChartData
     
     /// In case of grouped bars, this method returns the space an individual group of bar needs on the x-axis.
     ///
+    /// - Parameters:
     /// - parameter groupSpace:
     /// - parameter barSpace:
     @objc open func groupWidth(groupSpace: Double, barSpace: Double) -> Double
diff --git a/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
index 5c60dabb6e..460fa21751 100644
--- a/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
@@ -150,6 +150,7 @@ open class BarChartDataEntry: ChartDataEntry
     }
     
     /// Splits up the stack-values of the given bar-entry into Range objects.
+    /// - Parameters:
     /// - parameter entry:
     /// - returns:
     @objc open func calcRanges()
@@ -228,6 +229,7 @@ open class BarChartDataEntry: ChartDataEntry
     
     /// Calculates the sum across all values of the given stack.
     ///
+    /// - Parameters:
     /// - parameter vals:
     /// - returns:
     private static func calcSum(values: [Double]?) -> Double
diff --git a/Source/Charts/Data/Implementations/Standard/BubbleChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/BubbleChartDataEntry.swift
index 7f412d7397..a2bb4cf035 100644
--- a/Source/Charts/Data/Implementations/Standard/BubbleChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/BubbleChartDataEntry.swift
@@ -22,6 +22,7 @@ open class BubbleChartDataEntry: ChartDataEntry
         super.init()
     }
     
+    /// - Parameters:
     /// - parameter x: The index on the x-axis.
     /// - parameter y: The value on the y-axis.
     /// - parameter size: The size of the bubble.
@@ -32,6 +33,7 @@ open class BubbleChartDataEntry: ChartDataEntry
         self.size = size
     }
     
+    /// - Parameters:
     /// - parameter x: The index on the x-axis.
     /// - parameter y: The value on the y-axis.
     /// - parameter size: The size of the bubble.
@@ -43,6 +45,7 @@ open class BubbleChartDataEntry: ChartDataEntry
         self.size = size
     }
     
+    /// - Parameters:
     /// - parameter x: The index on the x-axis.
     /// - parameter y: The value on the y-axis.
     /// - parameter size: The size of the bubble.
@@ -54,6 +57,7 @@ open class BubbleChartDataEntry: ChartDataEntry
         self.size = size
     }
     
+    /// - Parameters:
     /// - parameter x: The index on the x-axis.
     /// - parameter y: The value on the y-axis.
     /// - parameter size: The size of the bubble.
diff --git a/Source/Charts/Data/Implementations/Standard/ChartData.swift b/Source/Charts/Data/Implementations/Standard/ChartData.swift
index 24309ebae9..56dd737c39 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartData.swift
@@ -346,6 +346,7 @@ open class ChartData: NSObject
     /// 
     /// **IMPORTANT: This method does calculations at runtime, do not over-use in performance critical situations.**
     ///
+    /// - Parameters:
     /// - parameter dataSets: the DataSet array to search
     /// - parameter type:
     /// - parameter ignorecase: if true, the search is not case-sensitive
@@ -400,6 +401,7 @@ open class ChartData: NSObject
     
     /// Get the Entry for a corresponding highlight object
     ///
+    /// - Parameters:
     /// - parameter highlight:
     /// - returns: The entry that is highlighted
     @objc open func entryForHighlight(_ highlight: Highlight) -> ChartDataEntry?
@@ -416,6 +418,7 @@ open class ChartData: NSObject
     
     /// **IMPORTANT: This method does calculations at runtime. Use with care in performance critical situations.**
     ///
+    /// - Parameters:
     /// - parameter label:
     /// - parameter ignorecase:
     /// - returns: The DataSet Object with the given label. Sensitive or not.
diff --git a/Source/Charts/Data/Implementations/Standard/ChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/ChartDataEntry.swift
index 9021c56670..02d5490e70 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartDataEntry.swift
@@ -22,6 +22,7 @@ open class ChartDataEntry: ChartDataEntryBase
     }
     
     /// An Entry represents one single entry in the chart.
+    /// - Parameters:
     /// - parameter x: the x value
     /// - parameter y: the y value (the actual value of the entry)
     @objc public init(x: Double, y: Double)
@@ -32,6 +33,7 @@ open class ChartDataEntry: ChartDataEntryBase
     }
     
     /// An Entry represents one single entry in the chart.
+    /// - Parameters:
     /// - parameter x: the x value
     /// - parameter y: the y value (the actual value of the entry)
     /// - parameter data: Space for additional data this Entry represents.
@@ -46,6 +48,7 @@ open class ChartDataEntry: ChartDataEntryBase
     }
     
     /// An Entry represents one single entry in the chart.
+    /// - Parameters:
     /// - parameter x: the x value
     /// - parameter y: the y value (the actual value of the entry)
     /// - parameter icon: icon image
@@ -58,6 +61,7 @@ open class ChartDataEntry: ChartDataEntryBase
     }
     
     /// An Entry represents one single entry in the chart.
+    /// - Parameters:
     /// - parameter x: the x value
     /// - parameter y: the y value (the actual value of the entry)
     /// - parameter icon: icon image
diff --git a/Source/Charts/Data/Implementations/Standard/ChartDataEntryBase.swift b/Source/Charts/Data/Implementations/Standard/ChartDataEntryBase.swift
index 0dcb1c71c6..783326cfa0 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartDataEntryBase.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartDataEntryBase.swift
@@ -28,6 +28,7 @@ open class ChartDataEntryBase: NSObject
     }
     
     /// An Entry represents one single entry in the chart.
+    /// - Parameters:
     /// - parameter y: the y value (the actual value of the entry)
     @objc public init(y: Double)
     {
@@ -36,6 +37,7 @@ open class ChartDataEntryBase: NSObject
         self.y = y
     }
     
+    /// - Parameters:
     /// - parameter y: the y value (the actual value of the entry)
     /// - parameter data: Space for additional data this Entry represents.
     
@@ -47,6 +49,7 @@ open class ChartDataEntryBase: NSObject
         self.data = data
     }
     
+    /// - Parameters:
     /// - parameter y: the y value (the actual value of the entry)
     /// - parameter icon: icon image
     
@@ -58,6 +61,7 @@ open class ChartDataEntryBase: NSObject
         self.icon = icon
     }
     
+    /// - Parameters:
     /// - parameter y: the y value (the actual value of the entry)
     /// - parameter icon: icon image
     /// - parameter data: Space for additional data this Entry represents.
diff --git a/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift b/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
index 8d1736bb97..c196b1f615 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
@@ -140,6 +140,7 @@ open class ChartDataSet: ChartBaseDataSet
     
     /// Updates the min and max x and y value of this DataSet based on the given Entry.
     ///
+    /// - Parameters:
     /// - parameter e:
     internal func calcMinMax(entry e: ChartDataEntry)
     {
@@ -176,6 +177,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// - returns: The first Entry object found at the given x-value with binary search.
     /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value according to the rounding.
     /// nil if no Entry object at that x-value.
+    /// - Parameters:
     /// - parameter xValue: the x-value
     /// - parameter closestToY: If there are multiple y-values for the specified x-value,
     /// - parameter rounding: determine whether to round up/down/closest if there is no Entry matching the provided x-value
@@ -195,6 +197,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// - returns: The first Entry object found at the given x-value with binary search.
     /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value.
     /// nil if no Entry object at that x-value.
+    /// - Parameters:
     /// - parameter xValue: the x-value
     /// - parameter closestToY: If there are multiple y-values for the specified x-value,
     open override func entryForXValue(
@@ -265,6 +268,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// - returns: The array-index of the specified entry.
     /// If the no Entry at the specified x-value is found, this method returns the index of the Entry at the closest x-value according to the rounding.
     ///
+    /// - Parameters:
     /// - parameter xValue: x-value of the entry to search for
     /// - parameter closestToY: If there are multiple y-values for the specified x-value,
     /// - parameter rounding: Rounding method if exact value was not found
@@ -372,6 +376,7 @@ open class ChartDataSet: ChartBaseDataSet
     
     /// - returns: The array-index of the specified entry
     ///
+    /// - Parameters:
     /// - parameter e: the entry to search for
     open override func entryIndex(entry e: ChartDataEntry) -> Int
     {
@@ -389,6 +394,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// Adds an Entry to the DataSet dynamically.
     /// Entries are added to the end of the list.
     /// This will also recalculate the current minimum and maximum values of the DataSet and the value-sum.
+    /// - Parameters:
     /// - parameter e: the entry to add
     /// - returns: True
     open override func addEntry(_ e: ChartDataEntry) -> Bool
@@ -404,6 +410,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// Adds an Entry to the DataSet dynamically.
     /// Entries are added to their appropriate index respective to it's x-index.
     /// This will also recalculate the current minimum and maximum values of the DataSet and the value-sum.
+    /// - Parameters:
     /// - parameter e: the entry to add
     /// - returns: True
     open override func addEntryOrdered(_ e: ChartDataEntry) -> Bool
@@ -430,6 +437,7 @@ open class ChartDataSet: ChartBaseDataSet
     
     /// Removes an Entry from the DataSet dynamically.
     /// This will also recalculate the current minimum and maximum values of the DataSet and the value-sum.
+    /// - Parameters:
     /// - parameter entry: the entry to remove
     /// - returns: `true` if the entry was removed successfully, else if the entry does not exist
     open override func removeEntry(_ entry: ChartDataEntry) -> Bool
diff --git a/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift b/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift
index 8d269edf66..9b0e6853b6 100644
--- a/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift
@@ -269,6 +269,7 @@ open class CombinedChartData: BarLineScatterCandleBubbleChartData
     
     /// Get the Entry for a corresponding highlight object
     ///
+    /// - Parameters:
     /// - parameter highlight:
     /// - returns: The entry that is highlighted
     open override func entryForHighlight(_ highlight: Highlight) -> ChartDataEntry?
@@ -299,6 +300,7 @@ open class CombinedChartData: BarLineScatterCandleBubbleChartData
     
     /// Get dataset for highlight
     ///
+    /// - Parameters:
     /// - Parameter highlight: current highlight
     /// - Returns: dataset related to highlight
     @objc open func getDataSetByHighlight(_ highlight: Highlight) -> IChartDataSet!
diff --git a/Source/Charts/Data/Implementations/Standard/PieChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/PieChartDataEntry.swift
index e833609959..936ce9c410 100644
--- a/Source/Charts/Data/Implementations/Standard/PieChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/PieChartDataEntry.swift
@@ -19,6 +19,7 @@ open class PieChartDataEntry: ChartDataEntry
         super.init()
     }
     
+    /// - Parameters:
     /// - parameter value: The value on the y-axis
     /// - parameter label: The label for the x-axis
     @objc public convenience init(value: Double, label: String?)
@@ -26,6 +27,7 @@ open class PieChartDataEntry: ChartDataEntry
         self.init(value: value, label: label, icon: nil, data: nil)
     }
     
+    /// - Parameters:
     /// - parameter value: The value on the y-axis
     /// - parameter label: The label for the x-axis
     /// - parameter data: Spot for additional data this Entry represents
@@ -34,6 +36,7 @@ open class PieChartDataEntry: ChartDataEntry
         self.init(value: value, label: label, icon: nil, data: data)
     }
     
+    /// - Parameters:
     /// - parameter value: The value on the y-axis
     /// - parameter label: The label for the x-axis
     /// - parameter icon: icon image
@@ -42,6 +45,7 @@ open class PieChartDataEntry: ChartDataEntry
         self.init(value: value, label: label, icon: icon, data: nil)
     }
     
+    /// - Parameters:
     /// - parameter value: The value on the y-axis
     /// - parameter label: The label for the x-axis
     /// - parameter icon: icon image
@@ -53,12 +57,14 @@ open class PieChartDataEntry: ChartDataEntry
         self.label = label
     }
     
+    /// - Parameters:
     /// - parameter value: The value on the y-axis
     @objc public convenience init(value: Double)
     {
         self.init(value: value, label: nil, icon: nil, data: nil)
     }
     
+    /// - Parameters:
     /// - parameter value: The value on the y-axis
     /// - parameter data: Spot for additional data this Entry represents
     @objc public convenience init(value: Double, data: AnyObject?)
@@ -66,6 +72,7 @@ open class PieChartDataEntry: ChartDataEntry
         self.init(value: value, label: nil, icon: nil, data: data)
     }
     
+    /// - Parameters:
     /// - parameter value: The value on the y-axis
     /// - parameter icon: icon image
     @objc public convenience init(value: Double, icon: NSUIImage?)
@@ -73,6 +80,7 @@ open class PieChartDataEntry: ChartDataEntry
         self.init(value: value, label: nil, icon: icon, data: nil)
     }
     
+    /// - Parameters:
     /// - parameter value: The value on the y-axis
     /// - parameter icon: icon image
     /// - parameter data: Spot for additional data this Entry represents
diff --git a/Source/Charts/Data/Implementations/Standard/RadarChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/RadarChartDataEntry.swift
index 4cf7189008..5656f6e7a2 100644
--- a/Source/Charts/Data/Implementations/Standard/RadarChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/RadarChartDataEntry.swift
@@ -19,6 +19,7 @@ open class RadarChartDataEntry: ChartDataEntry
         super.init()
     }
     
+    /// - Parameters:
     /// - parameter value: The value on the y-axis.
     /// - parameter data: Spot for additional data this Entry represents.
     @objc public init(value: Double, data: AnyObject?)
@@ -26,6 +27,7 @@ open class RadarChartDataEntry: ChartDataEntry
         super.init(x: 0.0, y: value, data: data)
     }
     
+    /// - Parameters:
     /// - parameter value: The value on the y-axis.
     @objc public convenience init(value: Double)
     {
diff --git a/Source/Charts/Data/Interfaces/IChartDataSet.swift b/Source/Charts/Data/Interfaces/IChartDataSet.swift
index 293db393eb..8514acfa95 100644
--- a/Source/Charts/Data/Interfaces/IChartDataSet.swift
+++ b/Source/Charts/Data/Interfaces/IChartDataSet.swift
@@ -50,6 +50,7 @@ public protocol IChartDataSet
     /// - returns: The first Entry object found at the given x-value with binary search.
     /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value according to the rounding.
     /// nil if no Entry object at that x-value.
+    /// - Parameters:
     /// - parameter xValue: the x-value
     /// - parameter closestToY: If there are multiple y-values for the specified x-value,
     /// - parameter rounding: determine whether to round up/down/closest if there is no Entry matching the provided x-value
@@ -61,6 +62,7 @@ public protocol IChartDataSet
     /// - returns: The first Entry object found at the given x-value with binary search.
     /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value.
     /// nil if no Entry object at that x-value.
+    /// - Parameters:
     /// - parameter xValue: the x-value
     /// - parameter closestToY: If there are multiple y-values for the specified x-value,
     func entryForXValue(
@@ -74,6 +76,7 @@ public protocol IChartDataSet
     /// - returns: The array-index of the specified entry.
     /// If the no Entry at the specified x-value is found, this method returns the index of the Entry at the closest x-value according to the rounding.
     ///
+    /// - Parameters:
     /// - parameter xValue: x-value of the entry to search for
     /// - parameter closestToY: If there are multiple y-values for the specified x-value,
     /// - parameter rounding: Rounding method if exact value was not found
@@ -84,6 +87,7 @@ public protocol IChartDataSet
     
     /// - returns: The array-index of the specified entry
     ///
+    /// - Parameters:
     /// - parameter e: the entry to search for
     func entryIndex(entry e: ChartDataEntry) -> Int
     
@@ -92,6 +96,7 @@ public protocol IChartDataSet
     /// *optional feature, can return `false` ifnot implemented*
     ///
     /// Entries are added to the end of the list.
+    /// - Parameters:
     /// - parameter e: the entry to add
     /// - returns: `true` if the entry was added successfully, `false` ifthis feature is not supported
     func addEntry(_ e: ChartDataEntry) -> Bool
@@ -103,6 +108,7 @@ public protocol IChartDataSet
     /// *optional feature, can return `false` ifnot implemented*
     ///
     /// Entries are added to the end of the list.
+    /// - Parameters:
     /// - parameter e: the entry to add
     /// - returns: `true` if the entry was added successfully, `false` ifthis feature is not supported
     func addEntryOrdered(_ e: ChartDataEntry) -> Bool
@@ -111,6 +117,7 @@ public protocol IChartDataSet
     ///
     /// *optional feature, can return `false` ifnot implemented*
     ///
+    /// - Parameters:
     /// - parameter entry: the entry to remove
     /// - returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
     func removeEntry(_ entry: ChartDataEntry) -> Bool
@@ -119,6 +126,7 @@ public protocol IChartDataSet
     ///
     /// *optional feature, can return `false` ifnot implemented*
     ///
+    /// - Parameters:
     /// - parameter index: the index of the entry to remove
     /// - returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
     func removeEntry(index: Int) -> Bool
@@ -127,6 +135,7 @@ public protocol IChartDataSet
     ///
     /// *optional feature, can return `false` ifnot implemented*
     ///
+    /// - Parameters:
     /// - parameter x: the x-value to remove
     /// - returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
     func removeEntry(x: Double) -> Bool
diff --git a/Source/Charts/Filters/DataApproximator.swift b/Source/Charts/Filters/DataApproximator.swift
index 6cd5338ff7..1de5927230 100644
--- a/Source/Charts/Filters/DataApproximator.swift
+++ b/Source/Charts/Filters/DataApproximator.swift
@@ -52,6 +52,7 @@ open class DataApproximator: NSObject
 
     /// apply the Douglas-Peucker-Reduction to an array of `CGPoint`s with a given tolerance
     ///
+    /// - Parameters:
     /// - parameter points:
     /// - parameter tolerance:
     /// - parameter start:
diff --git a/Source/Charts/Formatters/IAxisValueFormatter.swift b/Source/Charts/Formatters/IAxisValueFormatter.swift
index 9634334cb5..951e56085c 100644
--- a/Source/Charts/Formatters/IAxisValueFormatter.swift
+++ b/Source/Charts/Formatters/IAxisValueFormatter.swift
@@ -21,6 +21,7 @@ public protocol IAxisValueFormatter: class
     /// For performance reasons, avoid excessive calculations and memory allocations inside this method.
     ///
     /// - returns: The customized label that is drawn on the x-axis.
+    /// - Parameters:
     /// - parameter value:           the value that is currently being drawn
     /// - parameter axis:            the axis that the value belongs to
     ///
diff --git a/Source/Charts/Formatters/IValueFormatter.swift b/Source/Charts/Formatters/IValueFormatter.swift
index 5aae95b2a1..311deb34ee 100644
--- a/Source/Charts/Formatters/IValueFormatter.swift
+++ b/Source/Charts/Formatters/IValueFormatter.swift
@@ -26,6 +26,7 @@ public protocol IValueFormatter: class
     ///
     /// - returns:                   The formatted label ready to be drawn
     ///
+    /// - Parameters:
     /// - parameter value:           The value to be formatted
     ///
     /// - parameter dataSetIndex:    The index of the DataSet the entry in focus belongs to
diff --git a/Source/Charts/Highlight/BarHighlighter.swift b/Source/Charts/Highlight/BarHighlighter.swift
index 2bb81a2a33..919f4c111a 100644
--- a/Source/Charts/Highlight/BarHighlighter.swift
+++ b/Source/Charts/Highlight/BarHighlighter.swift
@@ -49,6 +49,7 @@ open class BarHighlighter: ChartHighlighter
     }
     
     /// This method creates the Highlight object that also indicates which value of a stacked BarEntry has been selected.
+    /// - Parameters:
     /// - parameter high: the Highlight to work with looking for stacked values
     /// - parameter set:
     /// - parameter xIndex:
@@ -90,6 +91,7 @@ open class BarHighlighter: ChartHighlighter
     }
     
     /// - returns: The index of the closest value inside the values array / ranges (stacked barchart) to the value given as a parameter.
+    /// - Parameters:
     /// - parameter entry:
     /// - parameter value:
     /// - returns:
diff --git a/Source/Charts/Highlight/ChartHighlighter.swift b/Source/Charts/Highlight/ChartHighlighter.swift
index 3fe679f20d..fee034eb31 100644
--- a/Source/Charts/Highlight/ChartHighlighter.swift
+++ b/Source/Charts/Highlight/ChartHighlighter.swift
@@ -29,6 +29,7 @@ open class ChartHighlighter : NSObject, IHighlighter
     }
     
     /// - returns: The corresponding x-pos for a given touch-position in pixels.
+    /// - Parameters:
     /// - parameter x:
     /// - returns:
     @objc open func getValsForTouch(x: CGFloat, y: CGFloat) -> CGPoint
@@ -40,6 +41,7 @@ open class ChartHighlighter : NSObject, IHighlighter
     }
     
     /// - returns: The corresponding ChartHighlight for a given x-value and xy-touch position in pixels.
+    /// - Parameters:
     /// - parameter xValue:
     /// - parameter x:
     /// - parameter y:
@@ -63,6 +65,7 @@ open class ChartHighlighter : NSObject, IHighlighter
     
     /// - returns: A list of Highlight objects representing the entries closest to the given xVal.
     /// The returned list contains two objects per DataSet (closest rounding up, closest rounding down).
+    /// - Parameters:
     /// - parameter xValue: the transformed x-value of the x-touch position
     /// - parameter x: touch position
     /// - parameter y: touch position
diff --git a/Source/Charts/Highlight/Highlight.swift b/Source/Charts/Highlight/Highlight.swift
index e036b08464..98643b6355 100644
--- a/Source/Charts/Highlight/Highlight.swift
+++ b/Source/Charts/Highlight/Highlight.swift
@@ -52,6 +52,7 @@ open class Highlight: NSObject
         super.init()
     }
     
+    /// - Parameters:
     /// - parameter x: the x-value of the highlighted value
     /// - parameter y: the y-value of the highlighted value
     /// - parameter xPx: the x-pixel of the highlighted value
@@ -80,6 +81,7 @@ open class Highlight: NSObject
         _axis = axis
     }
     
+    /// - Parameters:
     /// - parameter x: the x-value of the highlighted value
     /// - parameter y: the y-value of the highlighted value
     /// - parameter xPx: the x-pixel of the highlighted value
@@ -101,6 +103,7 @@ open class Highlight: NSObject
                   axis: axis)
     }
     
+    /// - Parameters:
     /// - parameter x: the x-value of the highlighted value
     /// - parameter y: the y-value of the highlighted value
     /// - parameter xPx: the x-pixel of the highlighted value
@@ -125,6 +128,7 @@ open class Highlight: NSObject
         _axis = axis
     }
     
+    /// - Parameters:
     /// - parameter x: the x-value of the highlighted value
     /// - parameter y: the y-value of the highlighted value
     /// - parameter dataSetIndex: the index of the DataSet the highlighted value belongs to
@@ -137,6 +141,7 @@ open class Highlight: NSObject
         self.dataIndex = dataIndex
     }
     
+    /// - Parameters:
     /// - parameter x: the x-value of the highlighted value
     /// - parameter dataSetIndex: the index of the DataSet the highlighted value belongs to
     /// - parameter stackIndex: references which value of a stacked-bar entry has been selected
diff --git a/Source/Charts/Highlight/IHighlighter.swift b/Source/Charts/Highlight/IHighlighter.swift
index 56acfcc226..ae5e91db2a 100644
--- a/Source/Charts/Highlight/IHighlighter.swift
+++ b/Source/Charts/Highlight/IHighlighter.swift
@@ -16,6 +16,7 @@ import CoreGraphics
 public protocol IHighlighter: class
 {
     /// - returns: A Highlight object corresponding to the given x- and y- touch positions in pixels.
+    /// - Parameters:
     /// - parameter x:
     /// - parameter y:
     /// - returns:
diff --git a/Source/Charts/Highlight/PieRadarHighlighter.swift b/Source/Charts/Highlight/PieRadarHighlighter.swift
index ec77e72f5b..a7023f8ed2 100644
--- a/Source/Charts/Highlight/PieRadarHighlighter.swift
+++ b/Source/Charts/Highlight/PieRadarHighlighter.swift
@@ -50,6 +50,7 @@ open class PieRadarHighlighter: ChartHighlighter
     }
     
     /// - returns: The closest Highlight object of the given objects based on the touch position inside the chart.
+    /// - Parameters:
     /// - parameter index:
     /// - parameter x:
     /// - parameter y:
diff --git a/Source/Charts/Highlight/RadarHighlighter.swift b/Source/Charts/Highlight/RadarHighlighter.swift
index d54193c2f8..291622928c 100644
--- a/Source/Charts/Highlight/RadarHighlighter.swift
+++ b/Source/Charts/Highlight/RadarHighlighter.swift
@@ -42,6 +42,7 @@ open class RadarHighlighter: PieRadarHighlighter
     /// - returns: An array of Highlight objects for the given index.
     /// The Highlight objects give information about the value at the selected index and DataSet it belongs to.
     ///
+    /// - Parameters:
     /// - parameter index:
     internal func getHighlights(forIndex index: Int) -> [Highlight]
     {
diff --git a/Source/Charts/Highlight/Range.swift b/Source/Charts/Highlight/Range.swift
index 1585869ff0..70dfadbf3e 100644
--- a/Source/Charts/Highlight/Range.swift
+++ b/Source/Charts/Highlight/Range.swift
@@ -26,6 +26,7 @@ open class Range: NSObject
     }
 
     /// - returns: `true` if this range contains (if the value is in between) the given value, `false` ifnot.
+    /// - Parameters:
     /// - parameter value:
     @objc open func contains(_ value: Double) -> Bool
     {
diff --git a/Source/Charts/Renderers/AxisRendererBase.swift b/Source/Charts/Renderers/AxisRendererBase.swift
index 15a9206e51..4914bd389d 100644
--- a/Source/Charts/Renderers/AxisRendererBase.swift
+++ b/Source/Charts/Renderers/AxisRendererBase.swift
@@ -54,6 +54,7 @@ open class AxisRendererBase: Renderer
     }
     
     /// Computes the axis values.
+    /// - Parameters:
     /// - parameter min: the minimum value in the data object for this axis
     /// - parameter max: the maximum value in the data object for this axis
     @objc open func computeAxis(min: Double, max: Double, inverted: Bool)
diff --git a/Source/Charts/Renderers/ChartDataRendererBase.swift b/Source/Charts/Renderers/ChartDataRendererBase.swift
index ef21083966..5c4483fcb6 100644
--- a/Source/Charts/Renderers/ChartDataRendererBase.swift
+++ b/Source/Charts/Renderers/ChartDataRendererBase.swift
@@ -50,6 +50,7 @@ open class DataRenderer: Renderer
     
     /// Draws all highlight indicators for the values that are currently highlighted.
     ///
+    /// - Parameters:
     /// - parameter indices: the highlighted values
     @objc open func drawHighlighted(context: CGContext, indices: [Highlight])
     {
diff --git a/Source/Charts/Renderers/RadarChartRenderer.swift b/Source/Charts/Renderers/RadarChartRenderer.swift
index a295fad6ee..6b2eede506 100644
--- a/Source/Charts/Renderers/RadarChartRenderer.swift
+++ b/Source/Charts/Renderers/RadarChartRenderer.swift
@@ -76,6 +76,7 @@ open class RadarChartRenderer: LineRadarRenderer
     
     /// Draws the RadarDataSet
     ///
+    /// - Parameters:
     /// - parameter context:
     /// - parameter dataSet:
     /// - parameter mostEntries: the entry count of the dataset with the most entries
diff --git a/Source/Charts/Renderers/Scatter/IShapeRenderer.swift b/Source/Charts/Renderers/Scatter/IShapeRenderer.swift
index bb12d9824a..391b28abcd 100644
--- a/Source/Charts/Renderers/Scatter/IShapeRenderer.swift
+++ b/Source/Charts/Renderers/Scatter/IShapeRenderer.swift
@@ -17,6 +17,7 @@ public protocol IShapeRenderer: class
 {
     /// Renders the provided ScatterDataSet with a shape.
     ///
+    /// - Parameters:
     /// - parameter context:         CGContext for drawing on
     /// - parameter dataSet:         The DataSet to be drawn
     /// - parameter viewPortHandler: Contains information about the current state of the view

From 576d7af245d56dd4c4c1f813e09e64457030bc47 Mon Sep 17 00:00:00 2001
From: Kem Chen <chenkem@gmail.com>
Date: Sat, 22 Sep 2018 21:02:38 +0800
Subject: [PATCH 02/10] Remove parameter prefix

```
/// - parameter (\w+):(.*)(\s+///(\n))*(\s+)
```

```
///   - $1:$2$4$5
```
---
 Source/Charts/Animation/Animator.swift        |  44 ++---
 Source/Charts/Charts/BarChartView.swift       |  12 +-
 .../Charts/Charts/BarLineChartViewBase.swift  | 160 +++++++++---------
 Source/Charts/Charts/ChartViewBase.swift      |  97 ++++++-----
 Source/Charts/Components/AxisBase.swift       |   4 +-
 Source/Charts/Components/IMarker.swift        |   6 +-
 Source/Charts/Components/LegendEntry.swift    |  14 +-
 .../Implementations/ChartBaseDataSet.swift    |  16 +-
 .../Standard/BarChartData.swift               |   8 +-
 .../Standard/BarChartDataEntry.swift          |   4 +-
 .../Standard/BubbleChartDataEntry.swift       |  32 ++--
 .../Implementations/Standard/ChartData.swift  |  12 +-
 .../Standard/ChartDataEntry.swift             |  24 +--
 .../Standard/ChartDataEntryBase.swift         |  16 +-
 .../Standard/ChartDataSet.swift               |  26 +--
 .../Standard/CombinedChartData.swift          |   4 +-
 .../Standard/PieChartDataEntry.swift          |  40 ++---
 .../Standard/RadarChartDataEntry.swift        |   6 +-
 .../Data/Interfaces/IChartDataSet.swift       |  28 +--
 Source/Charts/Filters/DataApproximator.swift  |   8 +-
 .../Formatters/IAxisValueFormatter.swift      |   5 +-
 .../Charts/Formatters/IValueFormatter.swift   |   9 +-
 Source/Charts/Highlight/BarHighlighter.swift  |  12 +-
 .../Charts/Highlight/ChartHighlighter.swift   |  14 +-
 Source/Charts/Highlight/Highlight.swift       |  60 +++----
 Source/Charts/Highlight/IHighlighter.swift    |   4 +-
 .../Highlight/PieRadarHighlighter.swift       |   6 +-
 .../Charts/Highlight/RadarHighlighter.swift   |   2 +-
 Source/Charts/Highlight/Range.swift           |   2 +-
 .../Charts/Renderers/AxisRendererBase.swift   |   4 +-
 .../Renderers/ChartDataRendererBase.swift     |   2 +-
 .../Charts/Renderers/RadarChartRenderer.swift |   6 +-
 .../Renderers/Scatter/IShapeRenderer.swift    |  10 +-
 33 files changed, 346 insertions(+), 351 deletions(-)

diff --git a/Source/Charts/Animation/Animator.swift b/Source/Charts/Animation/Animator.swift
index af150b130d..806e323e67 100644
--- a/Source/Charts/Animation/Animator.swift
+++ b/Source/Charts/Animation/Animator.swift
@@ -137,10 +137,10 @@ open class Animator: NSObject
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter xAxisDuration: duration for animating the x axis
-    /// - parameter yAxisDuration: duration for animating the y axis
-    /// - parameter easingX: an easing function for the animation on the x axis
-    /// - parameter easingY: an easing function for the animation on the y axis
+    ///   - xAxisDuration: duration for animating the x axis
+    ///   - yAxisDuration: duration for animating the y axis
+    ///   - easingX: an easing function for the animation on the x axis
+    ///   - easingY: an easing function for the animation on the y axis
     @objc open func animate(xAxisDuration: TimeInterval, yAxisDuration: TimeInterval, easingX: ChartEasingFunctionBlock?, easingY: ChartEasingFunctionBlock?)
     {
         stop()
@@ -171,10 +171,10 @@ open class Animator: NSObject
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter xAxisDuration: duration for animating the x axis
-    /// - parameter yAxisDuration: duration for animating the y axis
-    /// - parameter easingOptionX: the easing function for the animation on the x axis
-    /// - parameter easingOptionY: the easing function for the animation on the y axis
+    ///   - xAxisDuration: duration for animating the x axis
+    ///   - yAxisDuration: duration for animating the y axis
+    ///   - easingOptionX: the easing function for the animation on the x axis
+    ///   - easingOptionY: the easing function for the animation on the y axis
     @objc open func animate(xAxisDuration: TimeInterval, yAxisDuration: TimeInterval, easingOptionX: ChartEasingOption, easingOptionY: ChartEasingOption)
     {
         animate(xAxisDuration: xAxisDuration, yAxisDuration: yAxisDuration, easingX: easingFunctionFromOption(easingOptionX), easingY: easingFunctionFromOption(easingOptionY))
@@ -183,9 +183,9 @@ open class Animator: NSObject
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter xAxisDuration: duration for animating the x axis
-    /// - parameter yAxisDuration: duration for animating the y axis
-    /// - parameter easing: an easing function for the animation
+    ///   - xAxisDuration: duration for animating the x axis
+    ///   - yAxisDuration: duration for animating the y axis
+    ///   - easing: an easing function for the animation
     @objc open func animate(xAxisDuration: TimeInterval, yAxisDuration: TimeInterval, easing: ChartEasingFunctionBlock?)
     {
         animate(xAxisDuration: xAxisDuration, yAxisDuration: yAxisDuration, easingX: easing, easingY: easing)
@@ -194,9 +194,9 @@ open class Animator: NSObject
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter xAxisDuration: duration for animating the x axis
-    /// - parameter yAxisDuration: duration for animating the y axis
-    /// - parameter easingOption: the easing function for the animation
+    ///   - xAxisDuration: duration for animating the x axis
+    ///   - yAxisDuration: duration for animating the y axis
+    ///   - easingOption: the easing function for the animation
     @objc open func animate(xAxisDuration: TimeInterval, yAxisDuration: TimeInterval, easingOption: ChartEasingOption = .easeInOutSine)
     {
         animate(xAxisDuration: xAxisDuration, yAxisDuration: yAxisDuration, easing: easingFunctionFromOption(easingOption))
@@ -205,8 +205,8 @@ open class Animator: NSObject
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter xAxisDuration: duration for animating the x axis
-    /// - parameter easing: an easing function for the animation
+    ///   - xAxisDuration: duration for animating the x axis
+    ///   - easing: an easing function for the animation
     @objc open func animate(xAxisDuration: TimeInterval, easing: ChartEasingFunctionBlock?)
     {
         _startTimeX = CACurrentMediaTime()
@@ -231,8 +231,8 @@ open class Animator: NSObject
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter xAxisDuration: duration for animating the x axis
-    /// - parameter easingOption: the easing function for the animation
+    ///   - xAxisDuration: duration for animating the x axis
+    ///   - easingOption: the easing function for the animation
     @objc open func animate(xAxisDuration: TimeInterval, easingOption: ChartEasingOption = .easeInOutSine)
     {
         animate(xAxisDuration: xAxisDuration, easing: easingFunctionFromOption(easingOption))
@@ -241,8 +241,8 @@ open class Animator: NSObject
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter yAxisDuration: duration for animating the y axis
-    /// - parameter easing: an easing function for the animation
+    ///   - yAxisDuration: duration for animating the y axis
+    ///   - easing: an easing function for the animation
     @objc open func animate(yAxisDuration: TimeInterval, easing: ChartEasingFunctionBlock?)
     {
         _startTimeY = CACurrentMediaTime()
@@ -267,8 +267,8 @@ open class Animator: NSObject
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter yAxisDuration: duration for animating the y axis
-    /// - parameter easingOption: the easing function for the animation
+    ///   - yAxisDuration: duration for animating the y axis
+    ///   - easingOption: the easing function for the animation
     @objc open func animate(yAxisDuration: TimeInterval, easingOption: ChartEasingOption = .easeInOutSine)
     {
         animate(yAxisDuration: yAxisDuration, easing: easingFunctionFromOption(easingOption))
diff --git a/Source/Charts/Charts/BarChartView.swift b/Source/Charts/Charts/BarChartView.swift
index b847825816..cc867270a0 100644
--- a/Source/Charts/Charts/BarChartView.swift
+++ b/Source/Charts/Charts/BarChartView.swift
@@ -112,9 +112,9 @@ open class BarChartView: BarLineChartViewBase, BarChartDataProvider
     /// Calls `notifyDataSetChanged()` afterwards.
     ///
     /// - Parameters:
-    /// - parameter fromX: the starting point on the x-axis where the grouping should begin
-    /// - parameter groupSpace: the space between groups of bars in values (not pixels) e.g. 0.8f for bar width 1f
-    /// - parameter barSpace: the space between individual bars in values (not pixels) e.g. 0.1f for bar width 1f
+    ///   - fromX: the starting point on the x-axis where the grouping should begin
+    ///   - groupSpace: the space between groups of bars in values (not pixels) e.g. 0.8f for bar width 1f
+    ///   - barSpace: the space between individual bars in values (not pixels) e.g. 0.1f for bar width 1f
     @objc open func groupBars(fromX: Double, groupSpace: Double, barSpace: Double)
     {
         guard let barData = self.barData
@@ -130,9 +130,9 @@ open class BarChartView: BarLineChartViewBase, BarChartDataProvider
     
     /// Highlights the value at the given x-value in the given DataSet. Provide -1 as the dataSetIndex to undo all highlighting.
     /// - Parameters:
-    /// - parameter x:
-    /// - parameter dataSetIndex:
-    /// - parameter stackIndex: the index inside the stack - only relevant for stacked entries
+    ///   - x:
+    ///   - dataSetIndex:
+    ///   - stackIndex: the index inside the stack - only relevant for stacked entries
     @objc open func highlightValue(x: Double, dataSetIndex: Int, stackIndex: Int)
     {
         highlightValue(Highlight(x: x, dataSetIndex: dataSetIndex, stackIndex: stackIndex))
diff --git a/Source/Charts/Charts/BarLineChartViewBase.swift b/Source/Charts/Charts/BarLineChartViewBase.swift
index 4becef6541..943204b9cb 100644
--- a/Source/Charts/Charts/BarLineChartViewBase.swift
+++ b/Source/Charts/Charts/BarLineChartViewBase.swift
@@ -1011,10 +1011,10 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// (in pixels) of the zoom center.
     ///
     /// - Parameters:
-    /// - parameter scaleX: if < 1 --> zoom out, if > 1 --> zoom in
-    /// - parameter scaleY: if < 1 --> zoom out, if > 1 --> zoom in
-    /// - parameter x:
-    /// - parameter y:
+    ///   - scaleX: if < 1 --> zoom out, if > 1 --> zoom in
+    ///   - scaleY: if < 1 --> zoom out, if > 1 --> zoom in
+    ///   - x:
+    ///   - y:
     @objc open func zoom(
         scaleX: CGFloat,
                scaleY: CGFloat,
@@ -1033,11 +1033,11 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// x and y are the values (**not pixels**) of the zoom center.
     ///
     /// - Parameters:
-    /// - parameter scaleX: if < 1 --> zoom out, if > 1 --> zoom in
-    /// - parameter scaleY: if < 1 --> zoom out, if > 1 --> zoom in
-    /// - parameter xValue:
-    /// - parameter yValue:
-    /// - parameter axis:
+    ///   - scaleX: if < 1 --> zoom out, if > 1 --> zoom in
+    ///   - scaleY: if < 1 --> zoom out, if > 1 --> zoom in
+    ///   - xValue:
+    ///   - yValue:
+    ///   - axis:
     @objc open func zoom(
         scaleX: CGFloat,
                scaleY: CGFloat,
@@ -1060,11 +1060,11 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// Zooms to the center of the chart with the given scale factor.
     ///
     /// - Parameters:
-    /// - parameter scaleX: if < 1 --> zoom out, if > 1 --> zoom in
-    /// - parameter scaleY: if < 1 --> zoom out, if > 1 --> zoom in
-    /// - parameter xValue:
-    /// - parameter yValue:
-    /// - parameter axis:
+    ///   - scaleX: if < 1 --> zoom out, if > 1 --> zoom in
+    ///   - scaleY: if < 1 --> zoom out, if > 1 --> zoom in
+    ///   - xValue:
+    ///   - yValue:
+    ///   - axis:
     @objc open func zoomToCenter(
         scaleX: CGFloat,
                scaleY: CGFloat)
@@ -1081,13 +1081,13 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// Zooms by the specified scale factor to the specified values on the specified axis.
     ///
     /// - Parameters:
-    /// - parameter scaleX:
-    /// - parameter scaleY:
-    /// - parameter xValue:
-    /// - parameter yValue:
-    /// - parameter axis: which axis should be used as a reference for the y-axis
-    /// - parameter duration: the duration of the animation in seconds
-    /// - parameter easing:
+    ///   - scaleX:
+    ///   - scaleY:
+    ///   - xValue:
+    ///   - yValue:
+    ///   - axis: which axis should be used as a reference for the y-axis
+    ///   - duration: the duration of the animation in seconds
+    ///   - easing:
     @objc open func zoomAndCenterViewAnimated(
         scaleX: CGFloat,
         scaleY: CGFloat,
@@ -1124,13 +1124,13 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// Zooms by the specified scale factor to the specified values on the specified axis.
     ///
     /// - Parameters:
-    /// - parameter scaleX:
-    /// - parameter scaleY:
-    /// - parameter xValue:
-    /// - parameter yValue:
-    /// - parameter axis: which axis should be used as a reference for the y-axis
-    /// - parameter duration: the duration of the animation in seconds
-    /// - parameter easing:
+    ///   - scaleX:
+    ///   - scaleY:
+    ///   - xValue:
+    ///   - yValue:
+    ///   - axis: which axis should be used as a reference for the y-axis
+    ///   - duration: the duration of the animation in seconds
+    ///   - easing:
     @objc open func zoomAndCenterViewAnimated(
         scaleX: CGFloat,
         scaleY: CGFloat,
@@ -1146,13 +1146,13 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// Zooms by the specified scale factor to the specified values on the specified axis.
     ///
     /// - Parameters:
-    /// - parameter scaleX:
-    /// - parameter scaleY:
-    /// - parameter xValue:
-    /// - parameter yValue:
-    /// - parameter axis: which axis should be used as a reference for the y-axis
-    /// - parameter duration: the duration of the animation in seconds
-    /// - parameter easing:
+    ///   - scaleX:
+    ///   - scaleY:
+    ///   - xValue:
+    ///   - yValue:
+    ///   - axis: which axis should be used as a reference for the y-axis
+    ///   - duration: the duration of the animation in seconds
+    ///   - easing:
     @objc open func zoomAndCenterViewAnimated(
         scaleX: CGFloat,
         scaleY: CGFloat,
@@ -1226,8 +1226,8 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// Sets the size of the area (range on the y-axis) that should be maximum visible at once.
     ///
     /// - Parameters:
-    /// - parameter yRange:
-    /// - parameter axis: - the axis for which this limit should apply
+    ///   - yRange:
+    ///   - axis: - the axis for which this limit should apply
     @objc open func setVisibleYRangeMaximum(_ maxYRange: Double, axis: YAxis.AxisDependency)
     {
         let yScale = getAxisRange(axis: axis) / maxYRange
@@ -1237,8 +1237,8 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// Sets the size of the area (range on the y-axis) that should be minimum visible at once, no further zooming in possible.
     ///
     /// - Parameters:
-    /// - parameter yRange:
-    /// - parameter axis: - the axis for which this limit should apply
+    ///   - yRange:
+    ///   - axis: - the axis for which this limit should apply
     @objc open func setVisibleYRangeMinimum(_ minYRange: Double, axis: YAxis.AxisDependency)
     {
         let yScale = getAxisRange(axis: axis) / minYRange
@@ -1248,9 +1248,9 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// Limits the maximum and minimum y range that can be visible by pinching and zooming.
     ///
     /// - Parameters:
-    /// - parameter minYRange:
-    /// - parameter maxYRange:
-    /// - parameter axis:
+    ///   - minYRange:
+    ///   - maxYRange:
+    ///   - axis:
     @objc open func setVisibleYRange(minYRange: Double, maxYRange: Double, axis: YAxis.AxisDependency)
     {
         let minScale = getAxisRange(axis: axis) / minYRange
@@ -1276,8 +1276,8 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// This also refreshes the chart by calling setNeedsDisplay().
     /// 
     /// - Parameters:
-    /// - parameter yValue:
-    /// - parameter axis: - which axis should be used as a reference for the y-axis
+    ///   - yValue:
+    ///   - axis: - which axis should be used as a reference for the y-axis
     @objc open func moveViewToY(_ yValue: Double, axis: YAxis.AxisDependency)
     {
         let yInView = getAxisRange(axis: axis) / Double(_viewPortHandler.scaleY)
@@ -1296,9 +1296,9 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// This also refreshes the chart by calling setNeedsDisplay().
     /// 
     /// - Parameters:
-    /// - parameter xValue:
-    /// - parameter yValue:
-    /// - parameter axis: - which axis should be used as a reference for the y-axis
+    ///   - xValue:
+    ///   - yValue:
+    ///   - axis: - which axis should be used as a reference for the y-axis
     @objc open func moveViewTo(xValue: Double, yValue: Double, axis: YAxis.AxisDependency)
     {
         let yInView = getAxisRange(axis: axis) / Double(_viewPortHandler.scaleY)
@@ -1317,11 +1317,11 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// This also refreshes the chart by calling setNeedsDisplay().
     ///
     /// - Parameters:
-    /// - parameter xValue:
-    /// - parameter yValue:
-    /// - parameter axis: which axis should be used as a reference for the y-axis
-    /// - parameter duration: the duration of the animation in seconds
-    /// - parameter easing:
+    ///   - xValue:
+    ///   - yValue:
+    ///   - axis: which axis should be used as a reference for the y-axis
+    ///   - duration: the duration of the animation in seconds
+    ///   - easing:
     @objc open func moveViewToAnimated(
         xValue: Double,
         yValue: Double,
@@ -1353,11 +1353,11 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// This also refreshes the chart by calling setNeedsDisplay().
     ///
     /// - Parameters:
-    /// - parameter xValue:
-    /// - parameter yValue:
-    /// - parameter axis: which axis should be used as a reference for the y-axis
-    /// - parameter duration: the duration of the animation in seconds
-    /// - parameter easing:
+    ///   - xValue:
+    ///   - yValue:
+    ///   - axis: which axis should be used as a reference for the y-axis
+    ///   - duration: the duration of the animation in seconds
+    ///   - easing:
     @objc open func moveViewToAnimated(
         xValue: Double,
         yValue: Double,
@@ -1372,11 +1372,11 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// This also refreshes the chart by calling setNeedsDisplay().
     ///
     /// - Parameters:
-    /// - parameter xValue:
-    /// - parameter yValue:
-    /// - parameter axis: which axis should be used as a reference for the y-axis
-    /// - parameter duration: the duration of the animation in seconds
-    /// - parameter easing:
+    ///   - xValue:
+    ///   - yValue:
+    ///   - axis: which axis should be used as a reference for the y-axis
+    ///   - duration: the duration of the animation in seconds
+    ///   - easing:
     @objc open func moveViewToAnimated(
         xValue: Double,
         yValue: Double,
@@ -1390,9 +1390,9 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// This also refreshes the chart by calling setNeedsDisplay().
     ///
     /// - Parameters:
-    /// - parameter xValue:
-    /// - parameter yValue:
-    /// - parameter axis: - which axis should be used as a reference for the y-axis
+    ///   - xValue:
+    ///   - yValue:
+    ///   - axis: - which axis should be used as a reference for the y-axis
     @objc open func centerViewTo(
         xValue: Double,
         yValue: Double,
@@ -1414,11 +1414,11 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// This will move the center of the current viewport to the specified x-value and y-value animated.
     ///
     /// - Parameters:
-    /// - parameter xValue:
-    /// - parameter yValue:
-    /// - parameter axis: which axis should be used as a reference for the y-axis
-    /// - parameter duration: the duration of the animation in seconds
-    /// - parameter easing:
+    ///   - xValue:
+    ///   - yValue:
+    ///   - axis: which axis should be used as a reference for the y-axis
+    ///   - duration: the duration of the animation in seconds
+    ///   - easing:
     @objc open func centerViewToAnimated(
         xValue: Double,
         yValue: Double,
@@ -1450,11 +1450,11 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// This will move the center of the current viewport to the specified x-value and y-value animated.
     ///
     /// - Parameters:
-    /// - parameter xValue:
-    /// - parameter yValue:
-    /// - parameter axis: which axis should be used as a reference for the y-axis
-    /// - parameter duration: the duration of the animation in seconds
-    /// - parameter easing:
+    ///   - xValue:
+    ///   - yValue:
+    ///   - axis: which axis should be used as a reference for the y-axis
+    ///   - duration: the duration of the animation in seconds
+    ///   - easing:
     @objc open func centerViewToAnimated(
         xValue: Double,
         yValue: Double,
@@ -1468,11 +1468,11 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// This will move the center of the current viewport to the specified x-value and y-value animated.
     ///
     /// - Parameters:
-    /// - parameter xValue:
-    /// - parameter yValue:
-    /// - parameter axis: which axis should be used as a reference for the y-axis
-    /// - parameter duration: the duration of the animation in seconds
-    /// - parameter easing:
+    ///   - xValue:
+    ///   - yValue:
+    ///   - axis: which axis should be used as a reference for the y-axis
+    ///   - duration: the duration of the animation in seconds
+    ///   - easing:
     @objc open func centerViewToAnimated(
         xValue: Double,
         yValue: Double,
diff --git a/Source/Charts/Charts/ChartViewBase.swift b/Source/Charts/Charts/ChartViewBase.swift
index 7a1518b66b..97205492e5 100644
--- a/Source/Charts/Charts/ChartViewBase.swift
+++ b/Source/Charts/Charts/ChartViewBase.swift
@@ -22,8 +22,8 @@ public protocol ChartViewDelegate
 {
     /// Called when a value has been selected inside the chart.
     /// - Parameters:
-    /// - parameter entry: The selected Entry.
-    /// - parameter highlight: The corresponding highlight object that contains information about the highlighted position such as dataSetIndex etc.
+    ///   - entry: The selected Entry.
+    ///   - highlight: The corresponding highlight object that contains information about the highlighted position such as dataSetIndex etc.
     @objc optional func chartValueSelected(_ chartView: ChartViewBase, entry: ChartDataEntry, highlight: Highlight)
     
     // Called when nothing has been selected or an "un-select" has been made.
@@ -430,9 +430,9 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Provide -1 as the dataSetIndex to undo all highlighting.
     /// This method will call the delegate.
     /// - Parameters:
-    /// - parameter x: The x-value to highlight
-    /// - parameter dataSetIndex: The dataset index to search in
-    /// - parameter dataIndex: The data index to search in (only used in CombinedChartView currently)
+    ///   - x: The x-value to highlight
+    ///   - dataSetIndex: The dataset index to search in
+    ///   - dataIndex: The data index to search in (only used in CombinedChartView currently)
     @objc open func highlightValue(x: Double, dataSetIndex: Int, dataIndex: Int = -1)
     {
         highlightValue(x: x, dataSetIndex: dataSetIndex, dataIndex: dataIndex, callDelegate: true)
@@ -442,10 +442,10 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Provide -1 as the dataSetIndex to undo all highlighting.
     /// This method will call the delegate.
     /// - Parameters:
-    /// - parameter x: The x-value to highlight
-    /// - parameter y: The y-value to highlight. Supply `NaN` for "any"
-    /// - parameter dataSetIndex: The dataset index to search in
-    /// - parameter dataIndex: The data index to search in (only used in CombinedChartView currently)
+    ///   - x: The x-value to highlight
+    ///   - y: The y-value to highlight. Supply `NaN` for "any"
+    ///   - dataSetIndex: The dataset index to search in
+    ///   - dataIndex: The data index to search in (only used in CombinedChartView currently)
     @objc open func highlightValue(x: Double, y: Double, dataSetIndex: Int, dataIndex: Int = -1)
     {
         highlightValue(x: x, y: y, dataSetIndex: dataSetIndex, dataIndex: dataIndex, callDelegate: true)
@@ -454,10 +454,10 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Highlights any y-value at the given x-value in the given DataSet.
     /// Provide -1 as the dataSetIndex to undo all highlighting.
     /// - Parameters:
-    /// - parameter x: The x-value to highlight
-    /// - parameter dataSetIndex: The dataset index to search in
-    /// - parameter dataIndex: The data index to search in (only used in CombinedChartView currently)
-    /// - parameter callDelegate: Should the delegate be called for this change
+    ///   - x: The x-value to highlight
+    ///   - dataSetIndex: The dataset index to search in
+    ///   - dataIndex: The data index to search in (only used in CombinedChartView currently)
+    ///   - callDelegate: Should the delegate be called for this change
     @objc open func highlightValue(x: Double, dataSetIndex: Int, dataIndex: Int = -1, callDelegate: Bool)
     {
         highlightValue(x: x, y: .nan, dataSetIndex: dataSetIndex, dataIndex: dataIndex, callDelegate: callDelegate)
@@ -466,11 +466,11 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Highlights the value at the given x-value and y-value in the given DataSet.
     /// Provide -1 as the dataSetIndex to undo all highlighting.
     /// - Parameters:
-    /// - parameter x: The x-value to highlight
-    /// - parameter y: The y-value to highlight. Supply `NaN` for "any"
-    /// - parameter dataSetIndex: The dataset index to search in
-    /// - parameter dataIndex: The data index to search in (only used in CombinedChartView currently)
-    /// - parameter callDelegate: Should the delegate be called for this change
+    ///   - x: The x-value to highlight
+    ///   - y: The y-value to highlight. Supply `NaN` for "any"
+    ///   - dataSetIndex: The dataset index to search in
+    ///   - dataIndex: The data index to search in (only used in CombinedChartView currently)
+    ///   - callDelegate: Should the delegate be called for this change
     @objc open func highlightValue(x: Double, y: Double, dataSetIndex: Int, dataIndex: Int = -1, callDelegate: Bool)
     {
         guard let data = _data else
@@ -492,7 +492,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Highlights the values represented by the provided Highlight object
     /// This method *will not* call the delegate.
     /// - Parameters:
-    /// - parameter highlight: contains information about which entry should be highlighted
+    ///   - highlight: contains information about which entry should be highlighted
     @objc open func highlightValue(_ highlight: Highlight?)
     {
         highlightValue(highlight, callDelegate: false)
@@ -618,10 +618,10 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter xAxisDuration: duration for animating the x axis
-    /// - parameter yAxisDuration: duration for animating the y axis
-    /// - parameter easingX: an easing function for the animation on the x axis
-    /// - parameter easingY: an easing function for the animation on the y axis
+    ///   - xAxisDuration: duration for animating the x axis
+    ///   - yAxisDuration: duration for animating the y axis
+    ///   - easingX: an easing function for the animation on the x axis
+    ///   - easingY: an easing function for the animation on the y axis
     @objc open func animate(xAxisDuration: TimeInterval, yAxisDuration: TimeInterval, easingX: ChartEasingFunctionBlock?, easingY: ChartEasingFunctionBlock?)
     {
         _animator.animate(xAxisDuration: xAxisDuration, yAxisDuration: yAxisDuration, easingX: easingX, easingY: easingY)
@@ -630,10 +630,10 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter xAxisDuration: duration for animating the x axis
-    /// - parameter yAxisDuration: duration for animating the y axis
-    /// - parameter easingOptionX: the easing function for the animation on the x axis
-    /// - parameter easingOptionY: the easing function for the animation on the y axis
+    ///   - xAxisDuration: duration for animating the x axis
+    ///   - yAxisDuration: duration for animating the y axis
+    ///   - easingOptionX: the easing function for the animation on the x axis
+    ///   - easingOptionY: the easing function for the animation on the y axis
     @objc open func animate(xAxisDuration: TimeInterval, yAxisDuration: TimeInterval, easingOptionX: ChartEasingOption, easingOptionY: ChartEasingOption)
     {
         _animator.animate(xAxisDuration: xAxisDuration, yAxisDuration: yAxisDuration, easingOptionX: easingOptionX, easingOptionY: easingOptionY)
@@ -642,9 +642,9 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter xAxisDuration: duration for animating the x axis
-    /// - parameter yAxisDuration: duration for animating the y axis
-    /// - parameter easing: an easing function for the animation
+    ///   - xAxisDuration: duration for animating the x axis
+    ///   - yAxisDuration: duration for animating the y axis
+    ///   - easing: an easing function for the animation
     @objc open func animate(xAxisDuration: TimeInterval, yAxisDuration: TimeInterval, easing: ChartEasingFunctionBlock?)
     {
         _animator.animate(xAxisDuration: xAxisDuration, yAxisDuration: yAxisDuration, easing: easing)
@@ -653,9 +653,9 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter xAxisDuration: duration for animating the x axis
-    /// - parameter yAxisDuration: duration for animating the y axis
-    /// - parameter easingOption: the easing function for the animation
+    ///   - xAxisDuration: duration for animating the x axis
+    ///   - yAxisDuration: duration for animating the y axis
+    ///   - easingOption: the easing function for the animation
     @objc open func animate(xAxisDuration: TimeInterval, yAxisDuration: TimeInterval, easingOption: ChartEasingOption)
     {
         _animator.animate(xAxisDuration: xAxisDuration, yAxisDuration: yAxisDuration, easingOption: easingOption)
@@ -664,8 +664,8 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter xAxisDuration: duration for animating the x axis
-    /// - parameter yAxisDuration: duration for animating the y axis
+    ///   - xAxisDuration: duration for animating the x axis
+    ///   - yAxisDuration: duration for animating the y axis
     @objc open func animate(xAxisDuration: TimeInterval, yAxisDuration: TimeInterval)
     {
         _animator.animate(xAxisDuration: xAxisDuration, yAxisDuration: yAxisDuration)
@@ -674,8 +674,8 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter xAxisDuration: duration for animating the x axis
-    /// - parameter easing: an easing function for the animation
+    ///   - xAxisDuration: duration for animating the x axis
+    ///   - easing: an easing function for the animation
     @objc open func animate(xAxisDuration: TimeInterval, easing: ChartEasingFunctionBlock?)
     {
         _animator.animate(xAxisDuration: xAxisDuration, easing: easing)
@@ -684,8 +684,8 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter xAxisDuration: duration for animating the x axis
-    /// - parameter easingOption: the easing function for the animation
+    ///   - xAxisDuration: duration for animating the x axis
+    ///   - easingOption: the easing function for the animation
     @objc open func animate(xAxisDuration: TimeInterval, easingOption: ChartEasingOption)
     {
         _animator.animate(xAxisDuration: xAxisDuration, easingOption: easingOption)
@@ -694,7 +694,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter xAxisDuration: duration for animating the x axis
+    ///   - xAxisDuration: duration for animating the x axis
     @objc open func animate(xAxisDuration: TimeInterval)
     {
         _animator.animate(xAxisDuration: xAxisDuration)
@@ -703,8 +703,8 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter yAxisDuration: duration for animating the y axis
-    /// - parameter easing: an easing function for the animation
+    ///   - yAxisDuration: duration for animating the y axis
+    ///   - easing: an easing function for the animation
     @objc open func animate(yAxisDuration: TimeInterval, easing: ChartEasingFunctionBlock?)
     {
         _animator.animate(yAxisDuration: yAxisDuration, easing: easing)
@@ -713,8 +713,8 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter yAxisDuration: duration for animating the y axis
-    /// - parameter easingOption: the easing function for the animation
+    ///   - yAxisDuration: duration for animating the y axis
+    ///   - easingOption: the easing function for the animation
     @objc open func animate(yAxisDuration: TimeInterval, easingOption: ChartEasingOption)
     {
         _animator.animate(yAxisDuration: yAxisDuration, easingOption: easingOption)
@@ -723,7 +723,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
     /// - Parameters:
-    /// - parameter yAxisDuration: duration for animating the y axis
+    ///   - yAxisDuration: duration for animating the y axis
     @objc open func animate(yAxisDuration: TimeInterval)
     {
         _animator.animate(yAxisDuration: yAxisDuration)
@@ -842,10 +842,9 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// saveToPath("myfilename", "foldername1/foldername2")
     ///
     /// - Parameters:
-    /// - parameter to: path to the image to save
-    /// - parameter format: the format to save
-    /// - parameter compressionQuality: compression quality for lossless formats (JPEG)
-    ///
+    ///   - to: path to the image to save
+    ///   - format: the format to save
+    ///   - compressionQuality: compression quality for lossless formats (JPEG)
     /// - returns: `true` if the image was saved successfully
     open func save(to path: String, format: ImageFormat, compressionQuality: Double) -> Bool
     {
diff --git a/Source/Charts/Components/AxisBase.swift b/Source/Charts/Components/AxisBase.swift
index ea460e36dc..f79ab6e201 100644
--- a/Source/Charts/Components/AxisBase.swift
+++ b/Source/Charts/Components/AxisBase.swift
@@ -337,8 +337,8 @@ open class AxisBase: ComponentBase
     
     /// Calculates the minimum, maximum and range values of the YAxis with the given minimum and maximum values from the chart data.
     /// - Parameters:
-    /// - parameter dataMin: the y-min value according to chart data
-    /// - parameter dataMax: the y-max value according to chart
+    ///   - dataMin: the y-min value according to chart data
+    ///   - dataMax: the y-max value according to chart
     @objc open func calculate(min dataMin: Double, max dataMax: Double)
     {
         // if custom, use value as is, else use data value
diff --git a/Source/Charts/Components/IMarker.swift b/Source/Charts/Components/IMarker.swift
index 4d52486ba9..6126d1d484 100644
--- a/Source/Charts/Components/IMarker.swift
+++ b/Source/Charts/Components/IMarker.swift
@@ -27,14 +27,14 @@ public protocol IMarker: class
     ///            If you have no adjustments to make, return self.offset().
     ///
     /// - Parameters:
-    /// - parameter point: This is the point at which the marker wants to be drawn. You can adjust the offset conditionally based on this argument.
+    ///   - point: This is the point at which the marker wants to be drawn. You can adjust the offset conditionally based on this argument.
     func offsetForDrawing(atPoint: CGPoint) -> CGPoint
     
     /// This method enables a custom IMarker to update it's content every time the IMarker is redrawn according to the data entry it points to.
     ///
     /// - Parameters:
-    /// - parameter entry: The Entry the IMarker belongs to. This can also be any subclass of Entry, like BarEntry or CandleEntry, simply cast it at runtime.
-    /// - parameter highlight: The highlight object contains information about the highlighted value such as it's dataset-index, the selected range or stack-index (only stacked bar entries).
+    ///   - entry: The Entry the IMarker belongs to. This can also be any subclass of Entry, like BarEntry or CandleEntry, simply cast it at runtime.
+    ///   - highlight: The highlight object contains information about the highlighted value such as it's dataset-index, the selected range or stack-index (only stacked bar entries).
     func refreshContent(entry: ChartDataEntry, highlight: Highlight)
     
     /// Draws the IMarker on the given position on the given context
diff --git a/Source/Charts/Components/LegendEntry.swift b/Source/Charts/Components/LegendEntry.swift
index 7006515f0c..7b8c88b424 100644
--- a/Source/Charts/Components/LegendEntry.swift
+++ b/Source/Charts/Components/LegendEntry.swift
@@ -25,14 +25,14 @@ open class LegendEntry: NSObject
     }
     
     /// - Parameters:
-    /// - parameter label:                  The legend entry text.
+    ///   - label:                  The legend entry text.
     ///                                     A `nil` label will start a group.
-    /// - parameter form:                   The form to draw for this entry.
-    /// - parameter formSize:               Set to NaN to use the legend's default.
-    /// - parameter formLineWidth:          Set to NaN to use the legend's default.
-    /// - parameter formLineDashPhase:      Line dash configuration.
-    /// - parameter formLineDashLengths:    Line dash configurationas NaN to use the legend's default.
-    /// - parameter formColor:              The color for drawing the form.
+    ///   - form:                   The form to draw for this entry.
+    ///   - formSize:               Set to NaN to use the legend's default.
+    ///   - formLineWidth:          Set to NaN to use the legend's default.
+    ///   - formLineDashPhase:      Line dash configuration.
+    ///   - formLineDashLengths:    Line dash configurationas NaN to use the legend's default.
+    ///   - formColor:              The color for drawing the form.
     @objc public init(label: String?,
                 form: Legend.Form,
                 formSize: CGFloat,
diff --git a/Source/Charts/Data/Implementations/ChartBaseDataSet.swift b/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
index ca97336681..bec941b760 100644
--- a/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
+++ b/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
@@ -218,7 +218,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     
     /// Adds a new color to the colors array of the DataSet.
     /// - Parameters:
-    /// - parameter color: the color to add
+    ///   - color: the color to add
     open func addColor(_ color: NSUIColor)
     {
         colors.append(color)
@@ -227,7 +227,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     /// Sets the one and **only** color that should be used for this DataSet.
     /// Internally, this recreates the colors array and adds the specified color.
     /// - Parameters:
-    /// - parameter color: the color to set
+    ///   - color: the color to set
     open func setColor(_ color: NSUIColor)
     {
         colors.removeAll(keepingCapacity: false)
@@ -236,8 +236,8 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     
     /// Sets colors to a single color a specific alpha value.
     /// - Parameters:
-    /// - parameter color: the color to set
-    /// - parameter alpha: alpha to apply to the set `color`
+    ///   - color: the color to set
+    ///   - alpha: alpha to apply to the set `color`
     @objc open func setColor(_ color: NSUIColor, alpha: CGFloat)
     {
         setColor(color.withAlphaComponent(alpha))
@@ -245,8 +245,8 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     
     /// Sets colors with a specific alpha value.
     /// - Parameters:
-    /// - parameter colors: the colors to set
-    /// - parameter alpha: alpha to apply to the set `colors`
+    ///   - colors: the colors to set
+    ///   - alpha: alpha to apply to the set `colors`
     @objc open func setColors(_ colors: [NSUIColor], alpha: CGFloat)
     {
         var colorsWithAlpha = colors
@@ -261,8 +261,8 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     
     /// Sets colors with a specific alpha value.
     /// - Parameters:
-    /// - parameter colors: the colors to set
-    /// - parameter alpha: alpha to apply to the set `colors`
+    ///   - colors: the colors to set
+    ///   - alpha: alpha to apply to the set `colors`
     open func setColors(_ colors: NSUIColor...)
     {
         self.colors = colors
diff --git a/Source/Charts/Data/Implementations/Standard/BarChartData.swift b/Source/Charts/Data/Implementations/Standard/BarChartData.swift
index 846876a556..f54e6995b3 100644
--- a/Source/Charts/Data/Implementations/Standard/BarChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/BarChartData.swift
@@ -35,8 +35,8 @@ open class BarChartData: BarLineScatterCandleBubbleChartData
     ///
     /// - parameter the starting point on the x-axis where the grouping should begin
     /// - Parameters:
-    /// - parameter groupSpace: The space between groups of bars in values (not pixels) e.g. 0.8f for bar width 1f
-    /// - parameter barSpace: The space between individual bars in values (not pixels) e.g. 0.1f for bar width 1f
+    ///   - groupSpace: The space between groups of bars in values (not pixels) e.g. 0.8f for bar width 1f
+    ///   - barSpace: The space between individual bars in values (not pixels) e.g. 0.1f for bar width 1f
     @objc open func groupBars(fromX: Double, groupSpace: Double, barSpace: Double)
     {
         let setCount = _dataSets.count
@@ -97,8 +97,8 @@ open class BarChartData: BarLineScatterCandleBubbleChartData
     /// In case of grouped bars, this method returns the space an individual group of bar needs on the x-axis.
     ///
     /// - Parameters:
-    /// - parameter groupSpace:
-    /// - parameter barSpace:
+    ///   - groupSpace:
+    ///   - barSpace:
     @objc open func groupWidth(groupSpace: Double, barSpace: Double) -> Double
     {
         return Double(_dataSets.count) * (self.barWidth + barSpace) + groupSpace
diff --git a/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
index 460fa21751..8570b52538 100644
--- a/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
@@ -151,7 +151,7 @@ open class BarChartDataEntry: ChartDataEntry
     
     /// Splits up the stack-values of the given bar-entry into Range objects.
     /// - Parameters:
-    /// - parameter entry:
+    ///   - entry:
     /// - returns:
     @objc open func calcRanges()
     {
@@ -230,7 +230,7 @@ open class BarChartDataEntry: ChartDataEntry
     /// Calculates the sum across all values of the given stack.
     ///
     /// - Parameters:
-    /// - parameter vals:
+    ///   - vals:
     /// - returns:
     private static func calcSum(values: [Double]?) -> Double
     {
diff --git a/Source/Charts/Data/Implementations/Standard/BubbleChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/BubbleChartDataEntry.swift
index a2bb4cf035..f219171759 100644
--- a/Source/Charts/Data/Implementations/Standard/BubbleChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/BubbleChartDataEntry.swift
@@ -23,9 +23,9 @@ open class BubbleChartDataEntry: ChartDataEntry
     }
     
     /// - Parameters:
-    /// - parameter x: The index on the x-axis.
-    /// - parameter y: The value on the y-axis.
-    /// - parameter size: The size of the bubble.
+    ///   - x: The index on the x-axis.
+    ///   - y: The value on the y-axis.
+    ///   - size: The size of the bubble.
     @objc public init(x: Double, y: Double, size: CGFloat)
     {
         super.init(x: x, y: y)
@@ -34,10 +34,10 @@ open class BubbleChartDataEntry: ChartDataEntry
     }
     
     /// - Parameters:
-    /// - parameter x: The index on the x-axis.
-    /// - parameter y: The value on the y-axis.
-    /// - parameter size: The size of the bubble.
-    /// - parameter data: Spot for additional data this Entry represents.
+    ///   - x: The index on the x-axis.
+    ///   - y: The value on the y-axis.
+    ///   - size: The size of the bubble.
+    ///   - data: Spot for additional data this Entry represents.
     @objc public init(x: Double, y: Double, size: CGFloat, data: AnyObject?)
     {
         super.init(x: x, y: y, data: data)
@@ -46,10 +46,10 @@ open class BubbleChartDataEntry: ChartDataEntry
     }
     
     /// - Parameters:
-    /// - parameter x: The index on the x-axis.
-    /// - parameter y: The value on the y-axis.
-    /// - parameter size: The size of the bubble.
-    /// - parameter icon: icon image
+    ///   - x: The index on the x-axis.
+    ///   - y: The value on the y-axis.
+    ///   - size: The size of the bubble.
+    ///   - icon: icon image
     @objc public init(x: Double, y: Double, size: CGFloat, icon: NSUIImage?)
     {
         super.init(x: x, y: y, icon: icon)
@@ -58,11 +58,11 @@ open class BubbleChartDataEntry: ChartDataEntry
     }
     
     /// - Parameters:
-    /// - parameter x: The index on the x-axis.
-    /// - parameter y: The value on the y-axis.
-    /// - parameter size: The size of the bubble.
-    /// - parameter icon: icon image
-    /// - parameter data: Spot for additional data this Entry represents.
+    ///   - x: The index on the x-axis.
+    ///   - y: The value on the y-axis.
+    ///   - size: The size of the bubble.
+    ///   - icon: icon image
+    ///   - data: Spot for additional data this Entry represents.
     @objc public init(x: Double, y: Double, size: CGFloat, icon: NSUIImage?, data: AnyObject?)
     {
         super.init(x: x, y: y, icon: icon, data: data)
diff --git a/Source/Charts/Data/Implementations/Standard/ChartData.swift b/Source/Charts/Data/Implementations/Standard/ChartData.swift
index 56dd737c39..c6bf7805bb 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartData.swift
@@ -347,9 +347,9 @@ open class ChartData: NSObject
     /// **IMPORTANT: This method does calculations at runtime, do not over-use in performance critical situations.**
     ///
     /// - Parameters:
-    /// - parameter dataSets: the DataSet array to search
-    /// - parameter type:
-    /// - parameter ignorecase: if true, the search is not case-sensitive
+    ///   - dataSets: the DataSet array to search
+    ///   - type:
+    ///   - ignorecase: if true, the search is not case-sensitive
     /// - returns: The index of the DataSet Object with the given label. Sensitive or not.
     internal func getDataSetIndexByLabel(_ label: String, ignorecase: Bool) -> Int
     {
@@ -402,7 +402,7 @@ open class ChartData: NSObject
     /// Get the Entry for a corresponding highlight object
     ///
     /// - Parameters:
-    /// - parameter highlight:
+    ///   - highlight:
     /// - returns: The entry that is highlighted
     @objc open func entryForHighlight(_ highlight: Highlight) -> ChartDataEntry?
     {
@@ -419,8 +419,8 @@ open class ChartData: NSObject
     /// **IMPORTANT: This method does calculations at runtime. Use with care in performance critical situations.**
     ///
     /// - Parameters:
-    /// - parameter label:
-    /// - parameter ignorecase:
+    ///   - label:
+    ///   - ignorecase:
     /// - returns: The DataSet Object with the given label. Sensitive or not.
     @objc open func getDataSetByLabel(_ label: String, ignorecase: Bool) -> IChartDataSet?
     {
diff --git a/Source/Charts/Data/Implementations/Standard/ChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/ChartDataEntry.swift
index 02d5490e70..8dfee1fc71 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartDataEntry.swift
@@ -23,8 +23,8 @@ open class ChartDataEntry: ChartDataEntryBase
     
     /// An Entry represents one single entry in the chart.
     /// - Parameters:
-    /// - parameter x: the x value
-    /// - parameter y: the y value (the actual value of the entry)
+    ///   - x: the x value
+    ///   - y: the y value (the actual value of the entry)
     @objc public init(x: Double, y: Double)
     {
         super.init(y: y)
@@ -34,9 +34,9 @@ open class ChartDataEntry: ChartDataEntryBase
     
     /// An Entry represents one single entry in the chart.
     /// - Parameters:
-    /// - parameter x: the x value
-    /// - parameter y: the y value (the actual value of the entry)
-    /// - parameter data: Space for additional data this Entry represents.
+    ///   - x: the x value
+    ///   - y: the y value (the actual value of the entry)
+    ///   - data: Space for additional data this Entry represents.
     
     @objc public init(x: Double, y: Double, data: AnyObject?)
     {
@@ -49,9 +49,9 @@ open class ChartDataEntry: ChartDataEntryBase
     
     /// An Entry represents one single entry in the chart.
     /// - Parameters:
-    /// - parameter x: the x value
-    /// - parameter y: the y value (the actual value of the entry)
-    /// - parameter icon: icon image
+    ///   - x: the x value
+    ///   - y: the y value (the actual value of the entry)
+    ///   - icon: icon image
     
     @objc public init(x: Double, y: Double, icon: NSUIImage?)
     {
@@ -62,10 +62,10 @@ open class ChartDataEntry: ChartDataEntryBase
     
     /// An Entry represents one single entry in the chart.
     /// - Parameters:
-    /// - parameter x: the x value
-    /// - parameter y: the y value (the actual value of the entry)
-    /// - parameter icon: icon image
-    /// - parameter data: Space for additional data this Entry represents.
+    ///   - x: the x value
+    ///   - y: the y value (the actual value of the entry)
+    ///   - icon: icon image
+    ///   - data: Space for additional data this Entry represents.
     
     @objc public init(x: Double, y: Double, icon: NSUIImage?, data: AnyObject?)
     {
diff --git a/Source/Charts/Data/Implementations/Standard/ChartDataEntryBase.swift b/Source/Charts/Data/Implementations/Standard/ChartDataEntryBase.swift
index 783326cfa0..ad18b8a580 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartDataEntryBase.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartDataEntryBase.swift
@@ -29,7 +29,7 @@ open class ChartDataEntryBase: NSObject
     
     /// An Entry represents one single entry in the chart.
     /// - Parameters:
-    /// - parameter y: the y value (the actual value of the entry)
+    ///   - y: the y value (the actual value of the entry)
     @objc public init(y: Double)
     {
         super.init()
@@ -38,8 +38,8 @@ open class ChartDataEntryBase: NSObject
     }
     
     /// - Parameters:
-    /// - parameter y: the y value (the actual value of the entry)
-    /// - parameter data: Space for additional data this Entry represents.
+    ///   - y: the y value (the actual value of the entry)
+    ///   - data: Space for additional data this Entry represents.
     
     @objc public init(y: Double, data: AnyObject?)
     {
@@ -50,8 +50,8 @@ open class ChartDataEntryBase: NSObject
     }
     
     /// - Parameters:
-    /// - parameter y: the y value (the actual value of the entry)
-    /// - parameter icon: icon image
+    ///   - y: the y value (the actual value of the entry)
+    ///   - icon: icon image
     
     @objc public init(y: Double, icon: NSUIImage?)
     {
@@ -62,9 +62,9 @@ open class ChartDataEntryBase: NSObject
     }
     
     /// - Parameters:
-    /// - parameter y: the y value (the actual value of the entry)
-    /// - parameter icon: icon image
-    /// - parameter data: Space for additional data this Entry represents.
+    ///   - y: the y value (the actual value of the entry)
+    ///   - icon: icon image
+    ///   - data: Space for additional data this Entry represents.
     
     @objc public init(y: Double, icon: NSUIImage?, data: AnyObject?)
     {
diff --git a/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift b/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
index c196b1f615..fc98a93da4 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
@@ -141,7 +141,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// Updates the min and max x and y value of this DataSet based on the given Entry.
     ///
     /// - Parameters:
-    /// - parameter e:
+    ///   - e:
     internal func calcMinMax(entry e: ChartDataEntry)
     {
         calcMinMaxX(entry: e)
@@ -178,9 +178,9 @@ open class ChartDataSet: ChartBaseDataSet
     /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value according to the rounding.
     /// nil if no Entry object at that x-value.
     /// - Parameters:
-    /// - parameter xValue: the x-value
-    /// - parameter closestToY: If there are multiple y-values for the specified x-value,
-    /// - parameter rounding: determine whether to round up/down/closest if there is no Entry matching the provided x-value
+    ///   - xValue: the x-value
+    ///   - closestToY: If there are multiple y-values for the specified x-value,
+    ///   - rounding: determine whether to round up/down/closest if there is no Entry matching the provided x-value
     open override func entryForXValue(
         _ xValue: Double,
         closestToY yValue: Double,
@@ -198,8 +198,8 @@ open class ChartDataSet: ChartBaseDataSet
     /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value.
     /// nil if no Entry object at that x-value.
     /// - Parameters:
-    /// - parameter xValue: the x-value
-    /// - parameter closestToY: If there are multiple y-values for the specified x-value,
+    ///   - xValue: the x-value
+    ///   - closestToY: If there are multiple y-values for the specified x-value,
     open override func entryForXValue(
         _ xValue: Double,
         closestToY yValue: Double) -> ChartDataEntry?
@@ -269,9 +269,9 @@ open class ChartDataSet: ChartBaseDataSet
     /// If the no Entry at the specified x-value is found, this method returns the index of the Entry at the closest x-value according to the rounding.
     ///
     /// - Parameters:
-    /// - parameter xValue: x-value of the entry to search for
-    /// - parameter closestToY: If there are multiple y-values for the specified x-value,
-    /// - parameter rounding: Rounding method if exact value was not found
+    ///   - xValue: x-value of the entry to search for
+    ///   - closestToY: If there are multiple y-values for the specified x-value,
+    ///   - rounding: Rounding method if exact value was not found
     open override func entryIndex(
         x xValue: Double,
         closestToY yValue: Double,
@@ -377,7 +377,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// - returns: The array-index of the specified entry
     ///
     /// - Parameters:
-    /// - parameter e: the entry to search for
+    ///   - e: the entry to search for
     open override func entryIndex(entry e: ChartDataEntry) -> Int
     {
         for i in 0 ..< values.count
@@ -395,7 +395,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// Entries are added to the end of the list.
     /// This will also recalculate the current minimum and maximum values of the DataSet and the value-sum.
     /// - Parameters:
-    /// - parameter e: the entry to add
+    ///   - e: the entry to add
     /// - returns: True
     open override func addEntry(_ e: ChartDataEntry) -> Bool
     {
@@ -411,7 +411,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// Entries are added to their appropriate index respective to it's x-index.
     /// This will also recalculate the current minimum and maximum values of the DataSet and the value-sum.
     /// - Parameters:
-    /// - parameter e: the entry to add
+    ///   - e: the entry to add
     /// - returns: True
     open override func addEntryOrdered(_ e: ChartDataEntry) -> Bool
     {
@@ -438,7 +438,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// Removes an Entry from the DataSet dynamically.
     /// This will also recalculate the current minimum and maximum values of the DataSet and the value-sum.
     /// - Parameters:
-    /// - parameter entry: the entry to remove
+    ///   - entry: the entry to remove
     /// - returns: `true` if the entry was removed successfully, else if the entry does not exist
     open override func removeEntry(_ entry: ChartDataEntry) -> Bool
     {
diff --git a/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift b/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift
index 9b0e6853b6..7a7bd7b495 100644
--- a/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift
@@ -270,7 +270,7 @@ open class CombinedChartData: BarLineScatterCandleBubbleChartData
     /// Get the Entry for a corresponding highlight object
     ///
     /// - Parameters:
-    /// - parameter highlight:
+    ///   - highlight:
     /// - returns: The entry that is highlighted
     open override func entryForHighlight(_ highlight: Highlight) -> ChartDataEntry?
     {
@@ -301,7 +301,7 @@ open class CombinedChartData: BarLineScatterCandleBubbleChartData
     /// Get dataset for highlight
     ///
     /// - Parameters:
-    /// - Parameter highlight: current highlight
+    ///   - highlight: current highlight
     /// - Returns: dataset related to highlight
     @objc open func getDataSetByHighlight(_ highlight: Highlight) -> IChartDataSet!
     {  
diff --git a/Source/Charts/Data/Implementations/Standard/PieChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/PieChartDataEntry.swift
index 936ce9c410..d3ee58074c 100644
--- a/Source/Charts/Data/Implementations/Standard/PieChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/PieChartDataEntry.swift
@@ -20,36 +20,36 @@ open class PieChartDataEntry: ChartDataEntry
     }
     
     /// - Parameters:
-    /// - parameter value: The value on the y-axis
-    /// - parameter label: The label for the x-axis
+    ///   - value: The value on the y-axis
+    ///   - label: The label for the x-axis
     @objc public convenience init(value: Double, label: String?)
     {
         self.init(value: value, label: label, icon: nil, data: nil)
     }
     
     /// - Parameters:
-    /// - parameter value: The value on the y-axis
-    /// - parameter label: The label for the x-axis
-    /// - parameter data: Spot for additional data this Entry represents
+    ///   - value: The value on the y-axis
+    ///   - label: The label for the x-axis
+    ///   - data: Spot for additional data this Entry represents
     @objc public convenience init(value: Double, label: String?, data: AnyObject?)
     {
         self.init(value: value, label: label, icon: nil, data: data)
     }
     
     /// - Parameters:
-    /// - parameter value: The value on the y-axis
-    /// - parameter label: The label for the x-axis
-    /// - parameter icon: icon image
+    ///   - value: The value on the y-axis
+    ///   - label: The label for the x-axis
+    ///   - icon: icon image
     @objc public convenience init(value: Double, label: String?, icon: NSUIImage?)
     {
         self.init(value: value, label: label, icon: icon, data: nil)
     }
     
     /// - Parameters:
-    /// - parameter value: The value on the y-axis
-    /// - parameter label: The label for the x-axis
-    /// - parameter icon: icon image
-    /// - parameter data: Spot for additional data this Entry represents
+    ///   - value: The value on the y-axis
+    ///   - label: The label for the x-axis
+    ///   - icon: icon image
+    ///   - data: Spot for additional data this Entry represents
     @objc public init(value: Double, label: String?, icon: NSUIImage?, data: AnyObject?)
     {
         super.init(x: 0.0, y: value, icon: icon, data: data)
@@ -58,32 +58,32 @@ open class PieChartDataEntry: ChartDataEntry
     }
     
     /// - Parameters:
-    /// - parameter value: The value on the y-axis
+    ///   - value: The value on the y-axis
     @objc public convenience init(value: Double)
     {
         self.init(value: value, label: nil, icon: nil, data: nil)
     }
     
     /// - Parameters:
-    /// - parameter value: The value on the y-axis
-    /// - parameter data: Spot for additional data this Entry represents
+    ///   - value: The value on the y-axis
+    ///   - data: Spot for additional data this Entry represents
     @objc public convenience init(value: Double, data: AnyObject?)
     {
         self.init(value: value, label: nil, icon: nil, data: data)
     }
     
     /// - Parameters:
-    /// - parameter value: The value on the y-axis
-    /// - parameter icon: icon image
+    ///   - value: The value on the y-axis
+    ///   - icon: icon image
     @objc public convenience init(value: Double, icon: NSUIImage?)
     {
         self.init(value: value, label: nil, icon: icon, data: nil)
     }
     
     /// - Parameters:
-    /// - parameter value: The value on the y-axis
-    /// - parameter icon: icon image
-    /// - parameter data: Spot for additional data this Entry represents
+    ///   - value: The value on the y-axis
+    ///   - icon: icon image
+    ///   - data: Spot for additional data this Entry represents
     @objc public convenience init(value: Double, icon: NSUIImage?, data: AnyObject?)
     {
         self.init(value: value, label: nil, icon: icon, data: data)
diff --git a/Source/Charts/Data/Implementations/Standard/RadarChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/RadarChartDataEntry.swift
index 5656f6e7a2..7160be478c 100644
--- a/Source/Charts/Data/Implementations/Standard/RadarChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/RadarChartDataEntry.swift
@@ -20,15 +20,15 @@ open class RadarChartDataEntry: ChartDataEntry
     }
     
     /// - Parameters:
-    /// - parameter value: The value on the y-axis.
-    /// - parameter data: Spot for additional data this Entry represents.
+    ///   - value: The value on the y-axis.
+    ///   - data: Spot for additional data this Entry represents.
     @objc public init(value: Double, data: AnyObject?)
     {
         super.init(x: 0.0, y: value, data: data)
     }
     
     /// - Parameters:
-    /// - parameter value: The value on the y-axis.
+    ///   - value: The value on the y-axis.
     @objc public convenience init(value: Double)
     {
         self.init(value: value, data: nil)
diff --git a/Source/Charts/Data/Interfaces/IChartDataSet.swift b/Source/Charts/Data/Interfaces/IChartDataSet.swift
index 8514acfa95..3eb3c17188 100644
--- a/Source/Charts/Data/Interfaces/IChartDataSet.swift
+++ b/Source/Charts/Data/Interfaces/IChartDataSet.swift
@@ -51,9 +51,9 @@ public protocol IChartDataSet
     /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value according to the rounding.
     /// nil if no Entry object at that x-value.
     /// - Parameters:
-    /// - parameter xValue: the x-value
-    /// - parameter closestToY: If there are multiple y-values for the specified x-value,
-    /// - parameter rounding: determine whether to round up/down/closest if there is no Entry matching the provided x-value
+    ///   - xValue: the x-value
+    ///   - closestToY: If there are multiple y-values for the specified x-value,
+    ///   - rounding: determine whether to round up/down/closest if there is no Entry matching the provided x-value
     func entryForXValue(
         _ xValue: Double,
         closestToY yValue: Double,
@@ -63,8 +63,8 @@ public protocol IChartDataSet
     /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value.
     /// nil if no Entry object at that x-value.
     /// - Parameters:
-    /// - parameter xValue: the x-value
-    /// - parameter closestToY: If there are multiple y-values for the specified x-value,
+    ///   - xValue: the x-value
+    ///   - closestToY: If there are multiple y-values for the specified x-value,
     func entryForXValue(
         _ xValue: Double,
         closestToY yValue: Double) -> ChartDataEntry?
@@ -77,9 +77,9 @@ public protocol IChartDataSet
     /// If the no Entry at the specified x-value is found, this method returns the index of the Entry at the closest x-value according to the rounding.
     ///
     /// - Parameters:
-    /// - parameter xValue: x-value of the entry to search for
-    /// - parameter closestToY: If there are multiple y-values for the specified x-value,
-    /// - parameter rounding: Rounding method if exact value was not found
+    ///   - xValue: x-value of the entry to search for
+    ///   - closestToY: If there are multiple y-values for the specified x-value,
+    ///   - rounding: Rounding method if exact value was not found
     func entryIndex(
         x xValue: Double,
         closestToY yValue: Double,
@@ -88,7 +88,7 @@ public protocol IChartDataSet
     /// - returns: The array-index of the specified entry
     ///
     /// - Parameters:
-    /// - parameter e: the entry to search for
+    ///   - e: the entry to search for
     func entryIndex(entry e: ChartDataEntry) -> Int
     
     /// Adds an Entry to the DataSet dynamically.
@@ -97,7 +97,7 @@ public protocol IChartDataSet
     ///
     /// Entries are added to the end of the list.
     /// - Parameters:
-    /// - parameter e: the entry to add
+    ///   - e: the entry to add
     /// - returns: `true` if the entry was added successfully, `false` ifthis feature is not supported
     func addEntry(_ e: ChartDataEntry) -> Bool
     
@@ -109,7 +109,7 @@ public protocol IChartDataSet
     ///
     /// Entries are added to the end of the list.
     /// - Parameters:
-    /// - parameter e: the entry to add
+    ///   - e: the entry to add
     /// - returns: `true` if the entry was added successfully, `false` ifthis feature is not supported
     func addEntryOrdered(_ e: ChartDataEntry) -> Bool
     
@@ -118,7 +118,7 @@ public protocol IChartDataSet
     /// *optional feature, can return `false` ifnot implemented*
     ///
     /// - Parameters:
-    /// - parameter entry: the entry to remove
+    ///   - entry: the entry to remove
     /// - returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
     func removeEntry(_ entry: ChartDataEntry) -> Bool
     
@@ -127,7 +127,7 @@ public protocol IChartDataSet
     /// *optional feature, can return `false` ifnot implemented*
     ///
     /// - Parameters:
-    /// - parameter index: the index of the entry to remove
+    ///   - index: the index of the entry to remove
     /// - returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
     func removeEntry(index: Int) -> Bool
     
@@ -136,7 +136,7 @@ public protocol IChartDataSet
     /// *optional feature, can return `false` ifnot implemented*
     ///
     /// - Parameters:
-    /// - parameter x: the x-value to remove
+    ///   - x: the x-value to remove
     /// - returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
     func removeEntry(x: Double) -> Bool
     
diff --git a/Source/Charts/Filters/DataApproximator.swift b/Source/Charts/Filters/DataApproximator.swift
index 1de5927230..01c1d9fb4a 100644
--- a/Source/Charts/Filters/DataApproximator.swift
+++ b/Source/Charts/Filters/DataApproximator.swift
@@ -53,10 +53,10 @@ open class DataApproximator: NSObject
     /// apply the Douglas-Peucker-Reduction to an array of `CGPoint`s with a given tolerance
     ///
     /// - Parameters:
-    /// - parameter points:
-    /// - parameter tolerance:
-    /// - parameter start:
-    /// - parameter end:
+    ///   - points:
+    ///   - tolerance:
+    ///   - start:
+    ///   - end:
     open class func reduceWithDouglasPeuker(
         points: [CGPoint],
         tolerance: CGFloat,
diff --git a/Source/Charts/Formatters/IAxisValueFormatter.swift b/Source/Charts/Formatters/IAxisValueFormatter.swift
index 951e56085c..7273dcc19d 100644
--- a/Source/Charts/Formatters/IAxisValueFormatter.swift
+++ b/Source/Charts/Formatters/IAxisValueFormatter.swift
@@ -22,9 +22,8 @@ public protocol IAxisValueFormatter: class
     ///
     /// - returns: The customized label that is drawn on the x-axis.
     /// - Parameters:
-    /// - parameter value:           the value that is currently being drawn
-    /// - parameter axis:            the axis that the value belongs to
-    ///
+    ///   - value:           the value that is currently being drawn
+    ///   - axis:            the axis that the value belongs to
     func stringForValue(_ value: Double,
                         axis: AxisBase?) -> String
     
diff --git a/Source/Charts/Formatters/IValueFormatter.swift b/Source/Charts/Formatters/IValueFormatter.swift
index 311deb34ee..a3997f143a 100644
--- a/Source/Charts/Formatters/IValueFormatter.swift
+++ b/Source/Charts/Formatters/IValueFormatter.swift
@@ -27,12 +27,9 @@ public protocol IValueFormatter: class
     /// - returns:                   The formatted label ready to be drawn
     ///
     /// - Parameters:
-    /// - parameter value:           The value to be formatted
-    ///
-    /// - parameter dataSetIndex:    The index of the DataSet the entry in focus belongs to
-    ///
-    /// - parameter viewPortHandler: provides information about the current chart state (scale, translation, ...)
-    ///
+    ///   - value:           The value to be formatted
+    ///   - dataSetIndex:    The index of the DataSet the entry in focus belongs to
+    ///   - viewPortHandler: provides information about the current chart state (scale, translation, ...)
     func stringForValue(_ value: Double,
                         entry: ChartDataEntry,
                         dataSetIndex: Int,
diff --git a/Source/Charts/Highlight/BarHighlighter.swift b/Source/Charts/Highlight/BarHighlighter.swift
index 919f4c111a..6b8fe2f7a8 100644
--- a/Source/Charts/Highlight/BarHighlighter.swift
+++ b/Source/Charts/Highlight/BarHighlighter.swift
@@ -50,10 +50,10 @@ open class BarHighlighter: ChartHighlighter
     
     /// This method creates the Highlight object that also indicates which value of a stacked BarEntry has been selected.
     /// - Parameters:
-    /// - parameter high: the Highlight to work with looking for stacked values
-    /// - parameter set:
-    /// - parameter xIndex:
-    /// - parameter yValue:
+    ///   - high: the Highlight to work with looking for stacked values
+    ///   - set:
+    ///   - xIndex:
+    ///   - yValue:
     /// - returns:
     @objc open func getStackedHighlight(high: Highlight,
                                   set: IBarChartDataSet,
@@ -92,8 +92,8 @@ open class BarHighlighter: ChartHighlighter
     
     /// - returns: The index of the closest value inside the values array / ranges (stacked barchart) to the value given as a parameter.
     /// - Parameters:
-    /// - parameter entry:
-    /// - parameter value:
+    ///   - entry:
+    ///   - value:
     /// - returns:
     @objc open func getClosestStackIndex(ranges: [Range]?, value: Double) -> Int
     {
diff --git a/Source/Charts/Highlight/ChartHighlighter.swift b/Source/Charts/Highlight/ChartHighlighter.swift
index fee034eb31..cfe4bd4b10 100644
--- a/Source/Charts/Highlight/ChartHighlighter.swift
+++ b/Source/Charts/Highlight/ChartHighlighter.swift
@@ -30,7 +30,7 @@ open class ChartHighlighter : NSObject, IHighlighter
     
     /// - returns: The corresponding x-pos for a given touch-position in pixels.
     /// - Parameters:
-    /// - parameter x:
+    ///   - x:
     /// - returns:
     @objc open func getValsForTouch(x: CGFloat, y: CGFloat) -> CGPoint
     {
@@ -42,9 +42,9 @@ open class ChartHighlighter : NSObject, IHighlighter
     
     /// - returns: The corresponding ChartHighlight for a given x-value and xy-touch position in pixels.
     /// - Parameters:
-    /// - parameter xValue:
-    /// - parameter x:
-    /// - parameter y:
+    ///   - xValue:
+    ///   - x:
+    ///   - y:
     /// - returns:
     @objc open func getHighlight(xValue xVal: Double, x: CGFloat, y: CGFloat) -> Highlight?
     {
@@ -66,9 +66,9 @@ open class ChartHighlighter : NSObject, IHighlighter
     /// - returns: A list of Highlight objects representing the entries closest to the given xVal.
     /// The returned list contains two objects per DataSet (closest rounding up, closest rounding down).
     /// - Parameters:
-    /// - parameter xValue: the transformed x-value of the x-touch position
-    /// - parameter x: touch position
-    /// - parameter y: touch position
+    ///   - xValue: the transformed x-value of the x-touch position
+    ///   - x: touch position
+    ///   - y: touch position
     /// - returns:
     @objc open func getHighlights(xValue: Double, x: CGFloat, y: CGFloat) -> [Highlight]
     {
diff --git a/Source/Charts/Highlight/Highlight.swift b/Source/Charts/Highlight/Highlight.swift
index 98643b6355..d1692d3fbb 100644
--- a/Source/Charts/Highlight/Highlight.swift
+++ b/Source/Charts/Highlight/Highlight.swift
@@ -53,14 +53,14 @@ open class Highlight: NSObject
     }
     
     /// - Parameters:
-    /// - parameter x: the x-value of the highlighted value
-    /// - parameter y: the y-value of the highlighted value
-    /// - parameter xPx: the x-pixel of the highlighted value
-    /// - parameter yPx: the y-pixel of the highlighted value
-    /// - parameter dataIndex: the index of the Data the highlighted value belongs to
-    /// - parameter dataSetIndex: the index of the DataSet the highlighted value belongs to
-    /// - parameter stackIndex: references which value of a stacked-bar entry has been selected
-    /// - parameter axis: the axis the highlighted value belongs to
+    ///   - x: the x-value of the highlighted value
+    ///   - y: the y-value of the highlighted value
+    ///   - xPx: the x-pixel of the highlighted value
+    ///   - yPx: the y-pixel of the highlighted value
+    ///   - dataIndex: the index of the Data the highlighted value belongs to
+    ///   - dataSetIndex: the index of the DataSet the highlighted value belongs to
+    ///   - stackIndex: references which value of a stacked-bar entry has been selected
+    ///   - axis: the axis the highlighted value belongs to
     @objc public init(
         x: Double, y: Double,
         xPx: CGFloat, yPx: CGFloat,
@@ -82,13 +82,13 @@ open class Highlight: NSObject
     }
     
     /// - Parameters:
-    /// - parameter x: the x-value of the highlighted value
-    /// - parameter y: the y-value of the highlighted value
-    /// - parameter xPx: the x-pixel of the highlighted value
-    /// - parameter yPx: the y-pixel of the highlighted value
-    /// - parameter dataSetIndex: the index of the DataSet the highlighted value belongs to
-    /// - parameter stackIndex: references which value of a stacked-bar entry has been selected
-    /// - parameter axis: the axis the highlighted value belongs to
+    ///   - x: the x-value of the highlighted value
+    ///   - y: the y-value of the highlighted value
+    ///   - xPx: the x-pixel of the highlighted value
+    ///   - yPx: the y-pixel of the highlighted value
+    ///   - dataSetIndex: the index of the DataSet the highlighted value belongs to
+    ///   - stackIndex: references which value of a stacked-bar entry has been selected
+    ///   - axis: the axis the highlighted value belongs to
     @objc public convenience init(
         x: Double, y: Double,
         xPx: CGFloat, yPx: CGFloat,
@@ -104,14 +104,14 @@ open class Highlight: NSObject
     }
     
     /// - Parameters:
-    /// - parameter x: the x-value of the highlighted value
-    /// - parameter y: the y-value of the highlighted value
-    /// - parameter xPx: the x-pixel of the highlighted value
-    /// - parameter yPx: the y-pixel of the highlighted value
-    /// - parameter dataIndex: the index of the Data the highlighted value belongs to
-    /// - parameter dataSetIndex: the index of the DataSet the highlighted value belongs to
-    /// - parameter stackIndex: references which value of a stacked-bar entry has been selected
-    /// - parameter axis: the axis the highlighted value belongs to
+    ///   - x: the x-value of the highlighted value
+    ///   - y: the y-value of the highlighted value
+    ///   - xPx: the x-pixel of the highlighted value
+    ///   - yPx: the y-pixel of the highlighted value
+    ///   - dataIndex: the index of the Data the highlighted value belongs to
+    ///   - dataSetIndex: the index of the DataSet the highlighted value belongs to
+    ///   - stackIndex: references which value of a stacked-bar entry has been selected
+    ///   - axis: the axis the highlighted value belongs to
     @objc public init(
         x: Double, y: Double,
         xPx: CGFloat, yPx: CGFloat,
@@ -129,10 +129,10 @@ open class Highlight: NSObject
     }
     
     /// - Parameters:
-    /// - parameter x: the x-value of the highlighted value
-    /// - parameter y: the y-value of the highlighted value
-    /// - parameter dataSetIndex: the index of the DataSet the highlighted value belongs to
-    /// - parameter dataIndex: The data index to search in (only used in CombinedChartView currently)
+    ///   - x: the x-value of the highlighted value
+    ///   - y: the y-value of the highlighted value
+    ///   - dataSetIndex: the index of the DataSet the highlighted value belongs to
+    ///   - dataIndex: The data index to search in (only used in CombinedChartView currently)
     @objc public init(x: Double, y: Double, dataSetIndex: Int, dataIndex: Int = -1)
     {
         _x = x
@@ -142,9 +142,9 @@ open class Highlight: NSObject
     }
     
     /// - Parameters:
-    /// - parameter x: the x-value of the highlighted value
-    /// - parameter dataSetIndex: the index of the DataSet the highlighted value belongs to
-    /// - parameter stackIndex: references which value of a stacked-bar entry has been selected
+    ///   - x: the x-value of the highlighted value
+    ///   - dataSetIndex: the index of the DataSet the highlighted value belongs to
+    ///   - stackIndex: references which value of a stacked-bar entry has been selected
     @objc public convenience init(x: Double, dataSetIndex: Int, stackIndex: Int)
     {
         self.init(x: x, y: Double.nan, dataSetIndex: dataSetIndex)
diff --git a/Source/Charts/Highlight/IHighlighter.swift b/Source/Charts/Highlight/IHighlighter.swift
index ae5e91db2a..99a5df65ae 100644
--- a/Source/Charts/Highlight/IHighlighter.swift
+++ b/Source/Charts/Highlight/IHighlighter.swift
@@ -17,8 +17,8 @@ public protocol IHighlighter: class
 {
     /// - returns: A Highlight object corresponding to the given x- and y- touch positions in pixels.
     /// - Parameters:
-    /// - parameter x:
-    /// - parameter y:
+    ///   - x:
+    ///   - y:
     /// - returns:
     func getHighlight(x: CGFloat, y: CGFloat) -> Highlight?
 }
diff --git a/Source/Charts/Highlight/PieRadarHighlighter.swift b/Source/Charts/Highlight/PieRadarHighlighter.swift
index a7023f8ed2..b65ca9f4bf 100644
--- a/Source/Charts/Highlight/PieRadarHighlighter.swift
+++ b/Source/Charts/Highlight/PieRadarHighlighter.swift
@@ -51,9 +51,9 @@ open class PieRadarHighlighter: ChartHighlighter
     
     /// - returns: The closest Highlight object of the given objects based on the touch position inside the chart.
     /// - Parameters:
-    /// - parameter index:
-    /// - parameter x:
-    /// - parameter y:
+    ///   - index:
+    ///   - x:
+    ///   - y:
     @objc open func closestHighlight(index: Int, x: CGFloat, y: CGFloat) -> Highlight?
     {
         fatalError("closestHighlight(index, x, y) cannot be called on PieRadarChartHighlighter")
diff --git a/Source/Charts/Highlight/RadarHighlighter.swift b/Source/Charts/Highlight/RadarHighlighter.swift
index 291622928c..1333e1514c 100644
--- a/Source/Charts/Highlight/RadarHighlighter.swift
+++ b/Source/Charts/Highlight/RadarHighlighter.swift
@@ -43,7 +43,7 @@ open class RadarHighlighter: PieRadarHighlighter
     /// The Highlight objects give information about the value at the selected index and DataSet it belongs to.
     ///
     /// - Parameters:
-    /// - parameter index:
+    ///   - index:
     internal func getHighlights(forIndex index: Int) -> [Highlight]
     {
         var vals = [Highlight]()
diff --git a/Source/Charts/Highlight/Range.swift b/Source/Charts/Highlight/Range.swift
index 70dfadbf3e..3608544fcc 100644
--- a/Source/Charts/Highlight/Range.swift
+++ b/Source/Charts/Highlight/Range.swift
@@ -27,7 +27,7 @@ open class Range: NSObject
 
     /// - returns: `true` if this range contains (if the value is in between) the given value, `false` ifnot.
     /// - Parameters:
-    /// - parameter value:
+    ///   - value:
     @objc open func contains(_ value: Double) -> Bool
     {
         if value > from && value <= to
diff --git a/Source/Charts/Renderers/AxisRendererBase.swift b/Source/Charts/Renderers/AxisRendererBase.swift
index 4914bd389d..c0b6821bac 100644
--- a/Source/Charts/Renderers/AxisRendererBase.swift
+++ b/Source/Charts/Renderers/AxisRendererBase.swift
@@ -55,8 +55,8 @@ open class AxisRendererBase: Renderer
     
     /// Computes the axis values.
     /// - Parameters:
-    /// - parameter min: the minimum value in the data object for this axis
-    /// - parameter max: the maximum value in the data object for this axis
+    ///   - min: the minimum value in the data object for this axis
+    ///   - max: the maximum value in the data object for this axis
     @objc open func computeAxis(min: Double, max: Double, inverted: Bool)
     {
         var min = min, max = max
diff --git a/Source/Charts/Renderers/ChartDataRendererBase.swift b/Source/Charts/Renderers/ChartDataRendererBase.swift
index 5c4483fcb6..ac8300413f 100644
--- a/Source/Charts/Renderers/ChartDataRendererBase.swift
+++ b/Source/Charts/Renderers/ChartDataRendererBase.swift
@@ -51,7 +51,7 @@ open class DataRenderer: Renderer
     /// Draws all highlight indicators for the values that are currently highlighted.
     ///
     /// - Parameters:
-    /// - parameter indices: the highlighted values
+    ///   - indices: the highlighted values
     @objc open func drawHighlighted(context: CGContext, indices: [Highlight])
     {
         fatalError("drawHighlighted() cannot be called on DataRenderer")
diff --git a/Source/Charts/Renderers/RadarChartRenderer.swift b/Source/Charts/Renderers/RadarChartRenderer.swift
index 6b2eede506..d798d3a292 100644
--- a/Source/Charts/Renderers/RadarChartRenderer.swift
+++ b/Source/Charts/Renderers/RadarChartRenderer.swift
@@ -77,9 +77,9 @@ open class RadarChartRenderer: LineRadarRenderer
     /// Draws the RadarDataSet
     ///
     /// - Parameters:
-    /// - parameter context:
-    /// - parameter dataSet:
-    /// - parameter mostEntries: the entry count of the dataset with the most entries
+    ///   - context:
+    ///   - dataSet:
+    ///   - mostEntries: the entry count of the dataset with the most entries
     internal func drawDataSet(context: CGContext, dataSet: IRadarChartDataSet, mostEntries: Int)
     {
         guard let chart = chart else { return }
diff --git a/Source/Charts/Renderers/Scatter/IShapeRenderer.swift b/Source/Charts/Renderers/Scatter/IShapeRenderer.swift
index 391b28abcd..ff12ee3fb2 100644
--- a/Source/Charts/Renderers/Scatter/IShapeRenderer.swift
+++ b/Source/Charts/Renderers/Scatter/IShapeRenderer.swift
@@ -18,11 +18,11 @@ public protocol IShapeRenderer: class
     /// Renders the provided ScatterDataSet with a shape.
     ///
     /// - Parameters:
-    /// - parameter context:         CGContext for drawing on
-    /// - parameter dataSet:         The DataSet to be drawn
-    /// - parameter viewPortHandler: Contains information about the current state of the view
-    /// - parameter point:           Position to draw the shape at
-    /// - parameter color:           Color to draw the shape
+    ///   - context:         CGContext for drawing on
+    ///   - dataSet:         The DataSet to be drawn
+    ///   - viewPortHandler: Contains information about the current state of the view
+    ///   - point:           Position to draw the shape at
+    ///   - color:           Color to draw the shape
     func renderShape(
         context: CGContext,
         dataSet: IScatterChartDataSet,

From 849acbe9b214ac38e56d046ba233fe3a0ff7f92a Mon Sep 17 00:00:00 2001
From: Kem Chen <chenkem@gmail.com>
Date: Sat, 22 Sep 2018 21:04:20 +0800
Subject: [PATCH 03/10] =?UTF-8?q?Remove=20property=E2=80=99s=20`returns`?=
 =?UTF-8?q?=20section?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

```
/// - returns: (.+\s+((override|@IBOutlet|@objc|weak|unowned|lazy|static|class|open|public|private|fileprivate|internal)(\(set\))? )*(var|let))
```

```
/// $1
```
---
 Source/Charts/Charts/BarChartView.swift       |  6 ++--
 .../Charts/Charts/BarLineChartViewBase.swift  | 22 +++++++-------
 Source/Charts/Charts/ChartViewBase.swift      | 22 +++++++-------
 Source/Charts/Charts/CombinedChartView.swift  |  6 ++--
 .../Charts/HorizontalBarChartView.swift       |  4 +--
 Source/Charts/Charts/PieChartView.swift       | 14 ++++-----
 .../Charts/Charts/PieRadarChartViewBase.swift |  8 ++---
 Source/Charts/Charts/RadarChartView.swift     | 12 ++++----
 Source/Charts/Components/AxisBase.swift       |  4 +--
 Source/Charts/Components/Legend.swift         |  2 +-
 Source/Charts/Components/XAxis.swift          |  2 +-
 Source/Charts/Components/YAxis.swift          |  2 +-
 .../Implementations/ChartBaseDataSet.swift    |  6 ++--
 .../Standard/BarChartDataEntry.swift          |  6 ++--
 .../Standard/BarChartDataSet.swift            |  6 ++--
 .../Standard/CandleChartDataEntry.swift       |  4 +--
 .../Implementations/Standard/ChartData.swift  | 16 +++++-----
 .../Standard/ChartDataSet.swift               | 10 +++----
 .../Standard/CombinedChartData.swift          |  2 +-
 .../Standard/LineChartDataSet.swift           |  4 +--
 .../Standard/LineRadarChartDataSet.swift      |  2 +-
 .../LineScatterCandleRadarChartDataSet.swift  |  4 +--
 .../Standard/PieChartData.swift               |  4 +--
 .../Standard/RadarChartDataSet.swift          |  2 +-
 .../Data/Interfaces/IBarChartDataSet.swift    |  4 +--
 .../Data/Interfaces/IChartDataSet.swift       | 18 +++++------
 .../Data/Interfaces/ILineChartDataSet.swift   |  4 +--
 .../Interfaces/ILineRadarChartDataSet.swift   |  2 +-
 .../ILineScatterCandleRadarChartDataSet.swift |  4 +--
 .../Interfaces/IScatterChartDataSet.swift     |  4 +--
 .../Charts/Interfaces/ChartDataProvider.swift | 10 +++----
 .../Renderers/CombinedChartRenderer.swift     |  6 ++--
 Source/Charts/Utils/ViewPortHandler.swift     | 30 +++++++++----------
 33 files changed, 126 insertions(+), 126 deletions(-)

diff --git a/Source/Charts/Charts/BarChartView.swift b/Source/Charts/Charts/BarChartView.swift
index cc867270a0..3a8e254010 100644
--- a/Source/Charts/Charts/BarChartView.swift
+++ b/Source/Charts/Charts/BarChartView.swift
@@ -170,16 +170,16 @@ open class BarChartView: BarLineChartViewBase, BarChartDataProvider
     /// If enabled, highlighting operations will highlight the whole bar, even if only a single stack entry was tapped.
     @objc open var highlightFullBarEnabled: Bool = false
     
-    /// - returns: `true` the highlight is be full-bar oriented, `false` ifsingle-value
+    /// `true` the highlight is be full-bar oriented, `false` ifsingle-value
     open var isHighlightFullBarEnabled: Bool { return highlightFullBarEnabled }
     
     // MARK: - BarChartDataProvider
     
     open var barData: BarChartData? { return _data as? BarChartData }
     
-    /// - returns: `true` if drawing values above bars is enabled, `false` ifnot
+    /// `true` if drawing values above bars is enabled, `false` ifnot
     open var isDrawValueAboveBarEnabled: Bool { return drawValueAboveBarEnabled }
     
-    /// - returns: `true` if drawing shadows (maxvalue) for each bar is enabled, `false` ifnot
+    /// `true` if drawing shadows (maxvalue) for each bar is enabled, `false` ifnot
     open var isDrawBarShadowEnabled: Bool { return drawBarShadowEnabled }
 }
diff --git a/Source/Charts/Charts/BarLineChartViewBase.swift b/Source/Charts/Charts/BarLineChartViewBase.swift
index 943204b9cb..ea8833dbeb 100644
--- a/Source/Charts/Charts/BarLineChartViewBase.swift
+++ b/Source/Charts/Charts/BarLineChartViewBase.swift
@@ -1650,7 +1650,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     }
     
     /// **default**: true
-    /// - returns: `true` if zooming via double-tap is enabled `false` ifnot.
+    /// `true` if zooming via double-tap is enabled `false` ifnot.
     @objc open var isDoubleTapToZoomEnabled: Bool
     {
         return doubleTapToZoomEnabled
@@ -1669,14 +1669,14 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     }
     
     /// **default**: true
-    /// - returns: `true` if drawing the grid background is enabled, `false` ifnot.
+    /// `true` if drawing the grid background is enabled, `false` ifnot.
     @objc open var isDrawGridBackgroundEnabled: Bool
     {
         return drawGridBackgroundEnabled
     }
     
     /// **default**: false
-    /// - returns: `true` if drawing the borders rectangle is enabled, `false` ifnot.
+    /// `true` if drawing the borders rectangle is enabled, `false` ifnot.
     @objc open var isDrawBordersEnabled: Bool
     {
         return drawBordersEnabled
@@ -1719,7 +1719,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
         return nil
     }
 
-    /// - returns: The current x-scale factor
+    /// The current x-scale factor
     @objc open var scaleX: CGFloat
     {
         if _viewPortHandler === nil
@@ -1729,7 +1729,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
         return _viewPortHandler.scaleX
     }
 
-    /// - returns: The current y-scale factor
+    /// The current y-scale factor
     @objc open var scaleY: CGFloat
     {
         if _viewPortHandler === nil
@@ -1776,7 +1776,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     }
 
     /// **default**: false
-    /// - returns: `true` if pinch-zoom is enabled, `false` ifnot
+    /// `true` if pinch-zoom is enabled, `false` ifnot
     @objc open var isPinchZoomEnabled: Bool { return pinchZoomEnabled }
 
     /// Set an offset in dp that allows the user to drag the chart over it's
@@ -1793,7 +1793,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
         _viewPortHandler.setDragOffsetY(offset)
     }
 
-    /// - returns: `true` if both drag offsets (x and y) are zero or smaller.
+    /// `true` if both drag offsets (x and y) are zero or smaller.
     @objc open var hasNoDragOffset: Bool { return _viewPortHandler.hasNoDragOffset }
 
     open override var chartYMax: Double
@@ -1806,7 +1806,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
         return min(leftAxis._axisMinimum, rightAxis._axisMinimum)
     }
     
-    /// - returns: `true` if either the left or the right or both axes are inverted.
+    /// `true` if either the left or the right or both axes are inverted.
     @objc open var isAnyAxisInverted: Bool
     {
         return leftAxis.isInverted || rightAxis.isInverted
@@ -1821,7 +1821,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     }
     
     /// **default**: false
-    /// - returns: `true` if auto scaling on the y axis is enabled.
+    /// `true` if auto scaling on the y axis is enabled.
     @objc open var isAutoScaleMinMaxEnabled : Bool { return autoScaleMinMaxEnabled }
     
     /// Sets a minimum width to the specified y axis.
@@ -1928,7 +1928,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
         return getAxis(axis).isInverted
     }
     
-    /// - returns: The lowest x-index (value on the x-axis) that is still visible on he chart.
+    /// The lowest x-index (value on the x-axis) that is still visible on he chart.
     open var lowestVisibleX: Double
     {
         var pt = CGPoint(
@@ -1940,7 +1940,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
         return max(xAxis._axisMinimum, Double(pt.x))
     }
     
-    /// - returns: The highest x-index (value on the x-axis) that is still visible on the chart.
+    /// The highest x-index (value on the x-axis) that is still visible on the chart.
     open var highestVisibleX: Double
     {
         var pt = CGPoint(
diff --git a/Source/Charts/Charts/ChartViewBase.swift b/Source/Charts/Charts/ChartViewBase.swift
index 97205492e5..3ec8fcac44 100644
--- a/Source/Charts/Charts/ChartViewBase.swift
+++ b/Source/Charts/Charts/ChartViewBase.swift
@@ -376,7 +376,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
 
     // MARK: - Highlighting
     
-    /// - returns: The array of currently highlighted values. This might an empty if nothing is highlighted.
+    /// The array of currently highlighted values. This might an empty if nothing is highlighted.
     @objc open var highlighted: [Highlight]
     {
         return _indicesToHighlight
@@ -391,7 +391,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
         set { _highlightPerTapEnabled = newValue }
     }
     
-    /// - returns: `true` if values can be highlighted via tap gesture, `false` ifnot.
+    /// `true` if values can be highlighted via tap gesture, `false` ifnot.
     @objc open var isHighLightPerTapEnabled: Bool
     {
         return highlightPerTapEnabled
@@ -609,7 +609,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     // MARK: - Animation
     
-    /// - returns: The animator responsible for animating chart values.
+    /// The animator responsible for animating chart values.
     @objc open var chartAnimator: Animator!
     {
         return _animator
@@ -731,13 +731,13 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     // MARK: - Accessors
 
-    /// - returns: The current y-max value across all DataSets
+    /// The current y-max value across all DataSets
     open var chartYMax: Double
     {
         return _data?.yMax ?? 0.0
     }
 
-    /// - returns: The current y-min value across all DataSets
+    /// The current y-min value across all DataSets
     open var chartYMin: Double
     {
         return _data?.yMin ?? 0.0
@@ -760,32 +760,32 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// *
     /// - note: (Equivalent of getCenter() in MPAndroidChart, as center is already a standard in iOS that returns the center point relative to superview, and MPAndroidChart returns relative to self)*
-    /// - returns: The center point of the chart (the whole View) in pixels.
+    /// The center point of the chart (the whole View) in pixels.
     @objc open var midPoint: CGPoint
     {
         let bounds = self.bounds
         return CGPoint(x: bounds.origin.x + bounds.size.width / 2.0, y: bounds.origin.y + bounds.size.height / 2.0)
     }
     
-    /// - returns: The center of the chart taking offsets under consideration. (returns the center of the content rectangle)
+    /// The center of the chart taking offsets under consideration. (returns the center of the content rectangle)
     open var centerOffsets: CGPoint
     {
         return _viewPortHandler.contentCenter
     }
     
-    /// - returns: The Legend object of the chart. This method can be used to get an instance of the legend in order to customize the automatically generated Legend.
+    /// The Legend object of the chart. This method can be used to get an instance of the legend in order to customize the automatically generated Legend.
     @objc open var legend: Legend
     {
         return _legend
     }
     
-    /// - returns: The renderer object responsible for rendering / drawing the Legend.
+    /// The renderer object responsible for rendering / drawing the Legend.
     @objc open var legendRenderer: LegendRenderer!
     {
         return _legendRenderer
     }
     
-    /// - returns: The rectangle that defines the borders of the chart-value surface (into which the actual values are drawn).
+    /// The rectangle that defines the borders of the chart-value surface (into which the actual values are drawn).
     @objc open var contentRect: CGRect
     {
         return _viewPortHandler.contentRect
@@ -925,7 +925,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     }
     
     /// **default**: true
-    /// - returns: `true` if chart continues to scroll after touch up, `false` ifnot.
+    /// `true` if chart continues to scroll after touch up, `false` ifnot.
     @objc open var isDragDecelerationEnabled: Bool
         {
             return dragDecelerationEnabled
diff --git a/Source/Charts/Charts/CombinedChartView.swift b/Source/Charts/Charts/CombinedChartView.swift
index e1b13b495e..94fa343d01 100644
--- a/Source/Charts/Charts/CombinedChartView.swift
+++ b/Source/Charts/Charts/CombinedChartView.swift
@@ -176,10 +176,10 @@ open class CombinedChartView: BarLineChartViewBase, CombinedChartDataProvider
         set { (renderer as! CombinedChartRenderer).drawBarShadowEnabled = newValue }
     }
     
-    /// - returns: `true` if drawing values above bars is enabled, `false` ifnot
+    /// `true` if drawing values above bars is enabled, `false` ifnot
     open var isDrawValueAboveBarEnabled: Bool { return (renderer as! CombinedChartRenderer).drawValueAboveBarEnabled }
     
-    /// - returns: `true` if drawing shadows (maxvalue) for each bar is enabled, `false` ifnot
+    /// `true` if drawing shadows (maxvalue) for each bar is enabled, `false` ifnot
     open var isDrawBarShadowEnabled: Bool { return (renderer as! CombinedChartRenderer).drawBarShadowEnabled }
     
     /// the order in which the provided data objects should be drawn.
@@ -200,7 +200,7 @@ open class CombinedChartView: BarLineChartViewBase, CombinedChartDataProvider
     /// Set this to `true` to make the highlight operation full-bar oriented, `false` to make it highlight single values
     @objc open var highlightFullBarEnabled: Bool = false
     
-    /// - returns: `true` the highlight is be full-bar oriented, `false` ifsingle-value
+    /// `true` the highlight is be full-bar oriented, `false` ifsingle-value
     open var isHighlightFullBarEnabled: Bool { return highlightFullBarEnabled }
     
     // MARK: - ChartViewBase
diff --git a/Source/Charts/Charts/HorizontalBarChartView.swift b/Source/Charts/Charts/HorizontalBarChartView.swift
index 380680d0d3..ceacca0567 100644
--- a/Source/Charts/Charts/HorizontalBarChartView.swift
+++ b/Source/Charts/Charts/HorizontalBarChartView.swift
@@ -208,7 +208,7 @@ open class HorizontalBarChartView: BarChartView
         return self.highlighter?.getHighlight(x: pt.y, y: pt.x)
     }
     
-    /// - returns: The lowest x-index (value on the x-axis) that is still visible on he chart.
+    /// The lowest x-index (value on the x-axis) that is still visible on he chart.
     open override var lowestVisibleX: Double
     {
         var pt = CGPoint(
@@ -220,7 +220,7 @@ open class HorizontalBarChartView: BarChartView
         return max(xAxis._axisMinimum, Double(pt.y))
     }
     
-    /// - returns: The highest x-index (value on the x-axis) that is still visible on the chart.
+    /// The highest x-index (value on the x-axis) that is still visible on the chart.
     open override var highestVisibleX: Double
     {
         var pt = CGPoint(
diff --git a/Source/Charts/Charts/PieChartView.swift b/Source/Charts/Charts/PieChartView.swift
index 2c4ea8b5d5..bfa862328f 100644
--- a/Source/Charts/Charts/PieChartView.swift
+++ b/Source/Charts/Charts/PieChartView.swift
@@ -342,7 +342,7 @@ open class PieChartView: PieRadarChartViewBase
         }
     }
     
-    /// - returns: `true` if the inner tips of the slices are visible behind the hole, `false` if not.
+    /// `true` if the inner tips of the slices are visible behind the hole, `false` if not.
     @objc open var isDrawSlicesUnderHoleEnabled: Bool
     {
         return drawSlicesUnderHoleEnabled
@@ -362,7 +362,7 @@ open class PieChartView: PieRadarChartViewBase
         }
     }
     
-    /// - returns: `true` if the hole in the center of the pie-chart is set to be visible, `false` ifnot
+    /// `true` if the hole in the center of the pie-chart is set to be visible, `false` ifnot
     @objc open var isDrawHoleEnabled: Bool
     {
         get
@@ -449,7 +449,7 @@ open class PieChartView: PieRadarChartViewBase
         }
     }
     
-    /// - returns: `true` if drawing the center text is enabled
+    /// `true` if drawing the center text is enabled
     @objc open var isDrawCenterTextEnabled: Bool
     {
         get
@@ -473,13 +473,13 @@ open class PieChartView: PieRadarChartViewBase
         return _circleBox.width / 2.0
     }
     
-    /// - returns: The circlebox, the boundingbox of the pie-chart slices
+    /// The circlebox, the boundingbox of the pie-chart slices
     @objc open var circleBox: CGRect
     {
         return _circleBox
     }
     
-    /// - returns: The center of the circlebox
+    /// The center of the circlebox
     @objc open var centerCircleBox: CGPoint
     {
         return CGPoint(x: _circleBox.midX, y: _circleBox.midY)
@@ -569,7 +569,7 @@ open class PieChartView: PieRadarChartViewBase
         }
     }
     
-    /// - returns: `true` if drawing entry labels is enabled, `false` ifnot
+    /// `true` if drawing entry labels is enabled, `false` ifnot
     @objc open var isDrawEntryLabelsEnabled: Bool
     {
         get
@@ -592,7 +592,7 @@ open class PieChartView: PieRadarChartViewBase
         }
     }
     
-    /// - returns: `true` if drawing x-values is enabled, `false` ifnot
+    /// `true` if drawing x-values is enabled, `false` ifnot
     @objc open var isUsePercentValuesEnabled: Bool
     {
         get
diff --git a/Source/Charts/Charts/PieRadarChartViewBase.swift b/Source/Charts/Charts/PieRadarChartViewBase.swift
index a073d47f33..1c987dc110 100755
--- a/Source/Charts/Charts/PieRadarChartViewBase.swift
+++ b/Source/Charts/Charts/PieRadarChartViewBase.swift
@@ -326,7 +326,7 @@ open class PieRadarChartViewBase: ChartViewBase
     /// current rotation angle of the pie chart
     ///
     /// **default**: 270 --> top (NORTH)
-    /// - returns: Will always return a normalized value, which will be between 0.0 < 360.0
+    /// Will always return a normalized value, which will be between 0.0 < 360.0
     @objc open var rotationAngle: CGFloat
     {
         get
@@ -348,7 +348,7 @@ open class PieRadarChartViewBase: ChartViewBase
         return _rawRotationAngle
     }
 
-    /// - returns: The diameter of the pie- or radar-chart
+    /// The diameter of the pie- or radar-chart
     @objc open var diameter: CGFloat
     {
         var content = _viewPortHandler.contentRect
@@ -359,13 +359,13 @@ open class PieRadarChartViewBase: ChartViewBase
         return min(content.width, content.height)
     }
 
-    /// - returns: The radius of the chart in pixels.
+    /// The radius of the chart in pixels.
     @objc open var radius: CGFloat
     {
         fatalError("radius cannot be called on PieRadarChartViewBase")
     }
 
-    /// - returns: The required offset for the chart legend.
+    /// The required offset for the chart legend.
     internal var requiredLegendOffset: CGFloat
     {
         fatalError("requiredLegendOffset cannot be called on PieRadarChartViewBase")
diff --git a/Source/Charts/Charts/RadarChartView.swift b/Source/Charts/Charts/RadarChartView.swift
index 745c933bf1..93dc72f5a1 100644
--- a/Source/Charts/Charts/RadarChartView.swift
+++ b/Source/Charts/Charts/RadarChartView.swift
@@ -146,7 +146,7 @@ open class RadarChartView: PieRadarChartViewBase
         drawMarkers(context: context)
     }
 
-    /// - returns: The factor that is needed to transform values into pixels.
+    /// The factor that is needed to transform values into pixels.
     @objc open var factor: CGFloat
     {
         let content = _viewPortHandler.contentRect
@@ -154,7 +154,7 @@ open class RadarChartView: PieRadarChartViewBase
                 / CGFloat(_yAxis.axisRange)
     }
 
-    /// - returns: The angle that each slice in the radar chart occupies.
+    /// The angle that each slice in the radar chart occupies.
     @objc open var sliceAngle: CGFloat
     {
         return 360.0 / CGFloat(_data?.maxEntryCountSet?.entryCount ?? 0)
@@ -185,7 +185,7 @@ open class RadarChartView: PieRadarChartViewBase
         return index
     }
 
-    /// - returns: The object that represents all y-labels of the RadarChart.
+    /// The object that represents all y-labels of the RadarChart.
     @objc open var yAxis: YAxis
     {
         return _yAxis
@@ -221,12 +221,12 @@ open class RadarChartView: PieRadarChartViewBase
         return min(content.width / 2.0, content.height / 2.0)
     }
 
-    /// - returns: The maximum value this chart can display on it's y-axis.
+    /// The maximum value this chart can display on it's y-axis.
     open override var chartYMax: Double { return _yAxis._axisMaximum }
     
-    /// - returns: The minimum value this chart can display on it's y-axis.
+    /// The minimum value this chart can display on it's y-axis.
     open override var chartYMin: Double { return _yAxis._axisMinimum }
     
-    /// - returns: The range of y-values this chart can display.
+    /// The range of y-values this chart can display.
     @objc open var yRange: Double { return _yAxis.axisRange }
 }
diff --git a/Source/Charts/Components/AxisBase.swift b/Source/Charts/Components/AxisBase.swift
index f79ab6e201..7d02ecc24c 100644
--- a/Source/Charts/Components/AxisBase.swift
+++ b/Source/Charts/Components/AxisBase.swift
@@ -249,7 +249,7 @@ open class AxisBase: ComponentBase
         forceLabelsEnabled = force
     }
     
-    /// - returns: `true` if focing the y-label count is enabled. Default: false
+    /// `true` if focing the y-label count is enabled. Default: false
     @objc open var isForceLabelsEnabled: Bool { return forceLabelsEnabled }
     
     /// Adds a new ChartLimitLine to this axis.
@@ -277,7 +277,7 @@ open class AxisBase: ComponentBase
         _limitLines.removeAll(keepingCapacity: false)
     }
     
-    /// - returns: The LimitLines of this axis.
+    /// The LimitLines of this axis.
     @objc open var limitLines : [ChartLimitLine]
     {
         return _limitLines
diff --git a/Source/Charts/Components/Legend.swift b/Source/Charts/Components/Legend.swift
index 53177d04f5..ccde6be422 100644
--- a/Source/Charts/Components/Legend.swift
+++ b/Source/Charts/Components/Legend.swift
@@ -420,7 +420,7 @@ open class Legend: ComponentBase
     }
     
     /// **default**: false (automatic legend)
-    /// - returns: `true` if a custom legend entries has been set
+    /// `true` if a custom legend entries has been set
     @objc open var isLegendCustom: Bool
     {
         return _isLegendCustom
diff --git a/Source/Charts/Components/XAxis.swift b/Source/Charts/Components/XAxis.swift
index 1031bbb0e7..6078bb4e10 100644
--- a/Source/Charts/Components/XAxis.swift
+++ b/Source/Charts/Components/XAxis.swift
@@ -52,7 +52,7 @@ open class XAxis: AxisBase
     /// - note: currently supports all charts except pie/radar/horizontal-bar*
     @objc open var wordWrapEnabled = false
     
-    /// - returns: `true` if word wrapping the labels is enabled
+    /// `true` if word wrapping the labels is enabled
     @objc open var isWordWrapEnabled: Bool { return wordWrapEnabled }
     
     /// the width for wrapping the labels, as percentage out of one value width.
diff --git a/Source/Charts/Components/YAxis.swift b/Source/Charts/Components/YAxis.swift
index efc48a30e4..2f912991e2 100644
--- a/Source/Charts/Components/YAxis.swift
+++ b/Source/Charts/Components/YAxis.swift
@@ -129,7 +129,7 @@ open class YAxis: AxisBase
         return requiredSize().height
     }
     
-    /// - returns: `true` if this axis needs horizontal offset, `false` ifno offset is needed.
+    /// `true` if this axis needs horizontal offset, `false` ifno offset is needed.
     @objc open var needsOffset: Bool
     {
         if isEnabled && isDrawLabelsEnabled && labelPosition == .outsideChart
diff --git a/Source/Charts/Data/Implementations/ChartBaseDataSet.swift b/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
index bec941b760..86543d4c43 100644
--- a/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
+++ b/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
@@ -271,7 +271,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     /// if true, value highlighting is enabled
     open var highlightEnabled = true
     
-    /// - returns: `true` if value highlighting is enabled for this dataset
+    /// `true` if value highlighting is enabled for this dataset
     open var isHighlightEnabled: Bool { return highlightEnabled }
     
     /// Custom formatter that is used instead of the auto-formatter if set
@@ -362,7 +362,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     /// - note: For bar and line charts: if `maxVisibleCount` is reached, no values will be drawn even if this is enabled.
     open var drawValuesEnabled = true
     
-    /// - returns: `true` if y-value drawing is enabled, `false` ifnot
+    /// `true` if y-value drawing is enabled, `false` ifnot
     open var isDrawValuesEnabled: Bool
     {
         return drawValuesEnabled
@@ -389,7 +389,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     /// Set the visibility of this DataSet. If not visible, the DataSet will not be drawn to the chart upon refreshing it.
     open var visible = true
     
-    /// - returns: `true` if this DataSet is visible inside the chart, or `false` ifit is currently hidden.
+    /// `true` if this DataSet is visible inside the chart, or `false` ifit is currently hidden.
     open var isVisible: Bool
     {
         return visible
diff --git a/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
index 8570b52538..c21fe777de 100644
--- a/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
@@ -109,13 +109,13 @@ open class BarChartDataEntry: ChartDataEntry
         return remainder
     }
     
-    /// - returns: The sum of all negative values this entry (if stacked) contains. (this is a positive number)
+    /// The sum of all negative values this entry (if stacked) contains. (this is a positive number)
     @objc open var negativeSum: Double
     {
         return _negativeSum
     }
     
-    /// - returns: The sum of all positive values this entry (if stacked) contains.
+    /// The sum of all positive values this entry (if stacked) contains.
     @objc open var positiveSum: Double
     {
         return _positiveSum
@@ -210,7 +210,7 @@ open class BarChartDataEntry: ChartDataEntry
         }
     }
     
-    /// - returns: The ranges of the individual stack-entries. Will return null if this entry is not stacked.
+    /// The ranges of the individual stack-entries. Will return null if this entry is not stacked.
     @objc open var ranges: [Range]?
     {
         return _ranges
diff --git a/Source/Charts/Data/Implementations/Standard/BarChartDataSet.swift b/Source/Charts/Data/Implementations/Standard/BarChartDataSet.swift
index 27ed7a5722..832f24aa08 100644
--- a/Source/Charts/Data/Implementations/Standard/BarChartDataSet.swift
+++ b/Source/Charts/Data/Implementations/Standard/BarChartDataSet.swift
@@ -114,19 +114,19 @@ open class BarChartDataSet: BarLineScatterCandleBubbleChartDataSet, IBarChartDat
         }
     }
     
-    /// - returns: The maximum number of bars that can be stacked upon another in this DataSet.
+    /// The maximum number of bars that can be stacked upon another in this DataSet.
     open var stackSize: Int
     {
         return _stackSize
     }
     
-    /// - returns: `true` if this DataSet is stacked (stacksize > 1) or not.
+    /// `true` if this DataSet is stacked (stacksize > 1) or not.
     open var isStacked: Bool
     {
         return _stackSize > 1 ? true : false
     }
     
-    /// - returns: The overall entry count, including counting each stack-value individually
+    /// The overall entry count, including counting each stack-value individually
     @objc open var entryCountStacks: Int
     {
         return _entryCountStacks
diff --git a/Source/Charts/Data/Implementations/Standard/CandleChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/CandleChartDataEntry.swift
index 538066ad87..d857142d43 100644
--- a/Source/Charts/Data/Implementations/Standard/CandleChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/CandleChartDataEntry.swift
@@ -70,13 +70,13 @@ open class CandleChartDataEntry: ChartDataEntry
         self.close = close
     }
     
-    /// - returns: The overall range (difference) between shadow-high and shadow-low.
+    /// The overall range (difference) between shadow-high and shadow-low.
     @objc open var shadowRange: Double
     {
         return abs(high - low)
     }
     
-    /// - returns: The body size (difference between open and close).
+    /// The body size (difference between open and close).
     @objc open var bodyRange: Double
     {
         return abs(open - close)
diff --git a/Source/Charts/Data/Implementations/Standard/ChartData.swift b/Source/Charts/Data/Implementations/Standard/ChartData.swift
index c6bf7805bb..7bc6070693 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartData.swift
@@ -235,13 +235,13 @@ open class ChartData: NSObject
         }
     }
     
-    /// - returns: The number of LineDataSets this object contains
+    /// The number of LineDataSets this object contains
     @objc open var dataSetCount: Int
     {
         return _dataSets.count
     }
     
-    /// - returns: The smallest y-value the data object contains.
+    /// The smallest y-value the data object contains.
     @objc open var yMin: Double
     {
         return _yMin
@@ -279,7 +279,7 @@ open class ChartData: NSObject
         }
     }
     
-    /// - returns: The greatest y-value the data object contains.
+    /// The greatest y-value the data object contains.
     @objc open var yMax: Double
     {
         return _yMax
@@ -317,18 +317,18 @@ open class ChartData: NSObject
         }
     }
     
-    /// - returns: The minimum x-value the data object contains.
+    /// The minimum x-value the data object contains.
     @objc open var xMin: Double
     {
         return _xMin
     }
-    /// - returns: The maximum x-value the data object contains.
+    /// The maximum x-value the data object contains.
     @objc open var xMax: Double
     {
         return _xMax
     }
     
-    /// - returns: All DataSet objects this ChartData object holds.
+    /// All DataSet objects this ChartData object holds.
     @objc open var dataSets: [IChartDataSet]
     {
         get
@@ -726,7 +726,7 @@ open class ChartData: NSObject
         return false
     }
     
-    /// - returns: The total entry count across all DataSet objects this data object contains.
+    /// The total entry count across all DataSet objects this data object contains.
     @objc open var entryCount: Int
     {
         var count = 0
@@ -739,7 +739,7 @@ open class ChartData: NSObject
         return count
     }
 
-    /// - returns: The DataSet object with the maximum number of entries or null if there are no DataSets.
+    /// The DataSet object with the maximum number of entries or null if there are no DataSets.
     @objc open var maxEntryCountSet: IChartDataSet?
     {
         if _dataSets.count == 0
diff --git a/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift b/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
index fc98a93da4..2f4c4901c0 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
@@ -148,19 +148,19 @@ open class ChartDataSet: ChartBaseDataSet
         calcMinMaxY(entry: e)
     }
     
-    /// - returns: The minimum y-value this DataSet holds
+    /// The minimum y-value this DataSet holds
     open override var yMin: Double { return _yMin }
     
-    /// - returns: The maximum y-value this DataSet holds
+    /// The maximum y-value this DataSet holds
     open override var yMax: Double { return _yMax }
     
-    /// - returns: The minimum x-value this DataSet holds
+    /// The minimum x-value this DataSet holds
     open override var xMin: Double { return _xMin }
     
-    /// - returns: The maximum x-value this DataSet holds
+    /// The maximum x-value this DataSet holds
     open override var xMax: Double { return _xMax }
     
-    /// - returns: The number of y-values this DataSet represents
+    /// The number of y-values this DataSet represents
     open override var entryCount: Int { return values.count }
     
     /// - returns: The entry object found at the given index (not x-value!)
diff --git a/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift b/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift
index 7a7bd7b495..e1a616dcdd 100644
--- a/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift
@@ -165,7 +165,7 @@ open class CombinedChartData: BarLineScatterCandleBubbleChartData
         }
     }
     
-    /// - returns: All data objects in row: line-bar-scatter-candle-bubble if not null.
+    /// All data objects in row: line-bar-scatter-candle-bubble if not null.
     @objc open var allData: [ChartData]
     {
         var data = [ChartData]()
diff --git a/Source/Charts/Data/Implementations/Standard/LineChartDataSet.swift b/Source/Charts/Data/Implementations/Standard/LineChartDataSet.swift
index d8c29c0acd..d0cde4ff91 100644
--- a/Source/Charts/Data/Implementations/Standard/LineChartDataSet.swift
+++ b/Source/Charts/Data/Implementations/Standard/LineChartDataSet.swift
@@ -112,7 +112,7 @@ open class LineChartDataSet: LineRadarChartDataSet, ILineChartDataSet
     /// If true, drawing circles is enabled
     open var drawCirclesEnabled = true
     
-    /// - returns: `true` if drawing circles for this DataSet is enabled, `false` ifnot
+    /// `true` if drawing circles for this DataSet is enabled, `false` ifnot
     open var isDrawCirclesEnabled: Bool { return drawCirclesEnabled }
     
     /// The color of the inner circle (the circle-hole).
@@ -121,7 +121,7 @@ open class LineChartDataSet: LineRadarChartDataSet, ILineChartDataSet
     /// `true` if drawing circles for this DataSet is enabled, `false` ifnot
     open var drawCircleHoleEnabled = true
     
-    /// - returns: `true` if drawing the circle-holes is enabled, `false` ifnot.
+    /// `true` if drawing the circle-holes is enabled, `false` ifnot.
     open var isDrawCircleHoleEnabled: Bool { return drawCircleHoleEnabled }
     
     /// This is how much (in pixels) into the dash pattern are we starting from.
diff --git a/Source/Charts/Data/Implementations/Standard/LineRadarChartDataSet.swift b/Source/Charts/Data/Implementations/Standard/LineRadarChartDataSet.swift
index 5f1770a0b7..e42b694440 100644
--- a/Source/Charts/Data/Implementations/Standard/LineRadarChartDataSet.swift
+++ b/Source/Charts/Data/Implementations/Standard/LineRadarChartDataSet.swift
@@ -63,7 +63,7 @@ open class LineRadarChartDataSet: LineScatterCandleRadarChartDataSet, ILineRadar
     /// Please note that this method uses the path clipping for drawing the filled area (with images, gradients and layers).
     open var drawFilledEnabled = false
     
-    /// - returns: `true` if filled drawing is enabled, `false` ifnot
+    /// `true` if filled drawing is enabled, `false` ifnot
     open var isDrawFilledEnabled: Bool
     {
         return drawFilledEnabled
diff --git a/Source/Charts/Data/Implementations/Standard/LineScatterCandleRadarChartDataSet.swift b/Source/Charts/Data/Implementations/Standard/LineScatterCandleRadarChartDataSet.swift
index b21868ab08..6b88050bab 100644
--- a/Source/Charts/Data/Implementations/Standard/LineScatterCandleRadarChartDataSet.swift
+++ b/Source/Charts/Data/Implementations/Standard/LineScatterCandleRadarChartDataSet.swift
@@ -24,10 +24,10 @@ open class LineScatterCandleRadarChartDataSet: BarLineScatterCandleBubbleChartDa
     /// Enables / disables the vertical highlight-indicator. If disabled, the indicator is not drawn.
     open var drawVerticalHighlightIndicatorEnabled = true
     
-    /// - returns: `true` if horizontal highlight indicator lines are enabled (drawn)
+    /// `true` if horizontal highlight indicator lines are enabled (drawn)
     open var isHorizontalHighlightIndicatorEnabled: Bool { return drawHorizontalHighlightIndicatorEnabled }
     
-    /// - returns: `true` if vertical highlight indicator lines are enabled (drawn)
+    /// `true` if vertical highlight indicator lines are enabled (drawn)
     open var isVerticalHighlightIndicatorEnabled: Bool { return drawVerticalHighlightIndicatorEnabled }
     
     /// Enables / disables both vertical and horizontal highlight-indicators.
diff --git a/Source/Charts/Data/Implementations/Standard/PieChartData.swift b/Source/Charts/Data/Implementations/Standard/PieChartData.swift
index b8476492b9..158c3e723f 100644
--- a/Source/Charts/Data/Implementations/Standard/PieChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/PieChartData.swift
@@ -23,7 +23,7 @@ open class PieChartData: ChartData
         super.init(dataSets: dataSets)
     }
 
-    /// - returns: All DataSet objects this ChartData object holds.
+    /// All DataSet objects this ChartData object holds.
     @objc open override var dataSets: [IChartDataSet]
     {
         get
@@ -113,7 +113,7 @@ open class PieChartData: ChartData
         return false
     }
     
-    /// - returns: The total y-value sum across all DataSet objects the this object represents.
+    /// The total y-value sum across all DataSet objects the this object represents.
     @objc open var yValueSum: Double
     {
         guard let dataSet = dataSet else { return 0.0 }
diff --git a/Source/Charts/Data/Implementations/Standard/RadarChartDataSet.swift b/Source/Charts/Data/Implementations/Standard/RadarChartDataSet.swift
index 67b4730a28..5cb4560d62 100644
--- a/Source/Charts/Data/Implementations/Standard/RadarChartDataSet.swift
+++ b/Source/Charts/Data/Implementations/Standard/RadarChartDataSet.swift
@@ -40,7 +40,7 @@ open class RadarChartDataSet: LineRadarChartDataSet, IRadarChartDataSet
     /// **default**: false
     open var drawHighlightCircleEnabled: Bool = false
     
-    /// - returns: `true` if highlight circle should be drawn, `false` ifnot
+    /// `true` if highlight circle should be drawn, `false` ifnot
     open var isDrawHighlightCircleEnabled: Bool { return drawHighlightCircleEnabled }
     
     open var highlightCircleFillColor: NSUIColor? = NSUIColor.white
diff --git a/Source/Charts/Data/Interfaces/IBarChartDataSet.swift b/Source/Charts/Data/Interfaces/IBarChartDataSet.swift
index 6f5cad081c..b90b4dc0c2 100644
--- a/Source/Charts/Data/Interfaces/IBarChartDataSet.swift
+++ b/Source/Charts/Data/Interfaces/IBarChartDataSet.swift
@@ -19,10 +19,10 @@ public protocol IBarChartDataSet: IBarLineScatterCandleBubbleChartDataSet
     
     // MARK: - Styling functions and accessors
     
-    /// - returns: `true` if this DataSet is stacked (stacksize > 1) or not.
+    /// `true` if this DataSet is stacked (stacksize > 1) or not.
     var isStacked: Bool { get }
     
-    /// - returns: The maximum number of bars that can be stacked upon another in this DataSet.
+    /// The maximum number of bars that can be stacked upon another in this DataSet.
     var stackSize: Int { get }
     
     /// the color used for drawing the bar-shadows. The bar shadows is a surface behind the bar that indicates the maximum value
diff --git a/Source/Charts/Data/Interfaces/IChartDataSet.swift b/Source/Charts/Data/Interfaces/IChartDataSet.swift
index 3eb3c17188..8aa9296bd3 100644
--- a/Source/Charts/Data/Interfaces/IChartDataSet.swift
+++ b/Source/Charts/Data/Interfaces/IChartDataSet.swift
@@ -27,19 +27,19 @@ public protocol IChartDataSet
     /// This is only needed for the autoScaleMinMax feature.
     func calcMinMaxY(fromX: Double, toX: Double)
     
-    /// - returns: The minimum y-value this DataSet holds
+    /// The minimum y-value this DataSet holds
     var yMin: Double { get }
     
-    /// - returns: The maximum y-value this DataSet holds
+    /// The maximum y-value this DataSet holds
     var yMax: Double { get }
     
-    /// - returns: The minimum x-value this DataSet holds
+    /// The minimum x-value this DataSet holds
     var xMin: Double { get }
     
-    /// - returns: The maximum x-value this DataSet holds
+    /// The maximum x-value this DataSet holds
     var xMax: Double { get }
     
-    /// - returns: The number of y-values this DataSet represents
+    /// The number of y-values this DataSet represents
     var entryCount: Int { get }
     
     /// - returns: The entry object found at the given index (not x-value!)
@@ -192,13 +192,13 @@ public protocol IChartDataSet
     /// if true, value highlighting is enabled
     var highlightEnabled: Bool { get set }
     
-    /// - returns: `true` if value highlighting is enabled for this dataset
+    /// `true` if value highlighting is enabled for this dataset
     var isHighlightEnabled: Bool { get }
     
     /// Custom formatter that is used instead of the auto-formatter if set
     var valueFormatter: IValueFormatter? { get set }
     
-    /// - returns: `true` if the valueFormatter object of this DataSet is null.
+    /// `true` if the valueFormatter object of this DataSet is null.
     var needsFormatter: Bool { get }
     
     /// Sets/get a single color for value text.
@@ -244,7 +244,7 @@ public protocol IChartDataSet
     /// - note: For bar and line charts: if `maxVisibleCount` is reached, no values will be drawn even if this is enabled.
     var drawValuesEnabled: Bool { get set }
     
-    /// - returns: `true` if y-value drawing is enabled, `false` ifnot
+    /// `true` if y-value drawing is enabled, `false` ifnot
     var isDrawValuesEnabled: Bool { get }
     
     /// Set this to true to draw y-icons on the chart
@@ -265,6 +265,6 @@ public protocol IChartDataSet
     /// Set the visibility of this DataSet. If not visible, the DataSet will not be drawn to the chart upon refreshing it.
     var visible: Bool { get set }
     
-    /// - returns: `true` if this DataSet is visible inside the chart, or `false` ifit is currently hidden.
+    /// `true` if this DataSet is visible inside the chart, or `false` ifit is currently hidden.
     var isVisible: Bool { get }
 }
diff --git a/Source/Charts/Data/Interfaces/ILineChartDataSet.swift b/Source/Charts/Data/Interfaces/ILineChartDataSet.swift
index bc9e484907..6541b65517 100644
--- a/Source/Charts/Data/Interfaces/ILineChartDataSet.swift
+++ b/Source/Charts/Data/Interfaces/ILineChartDataSet.swift
@@ -52,7 +52,7 @@ public protocol ILineChartDataSet: ILineRadarChartDataSet
     /// If true, drawing circles is enabled
     var drawCirclesEnabled: Bool { get set }
     
-    /// - returns: `true` if drawing circles for this DataSet is enabled, `false` ifnot
+    /// `true` if drawing circles for this DataSet is enabled, `false` ifnot
     var isDrawCirclesEnabled: Bool { get }
     
     /// The color of the inner circle (the circle-hole).
@@ -61,7 +61,7 @@ public protocol ILineChartDataSet: ILineRadarChartDataSet
     /// `true` if drawing circles for this DataSet is enabled, `false` ifnot
     var drawCircleHoleEnabled: Bool { get set }
     
-    /// - returns: `true` if drawing the circle-holes is enabled, `false` ifnot.
+    /// `true` if drawing the circle-holes is enabled, `false` ifnot.
     var isDrawCircleHoleEnabled: Bool { get }
     
     /// This is how much (in pixels) into the dash pattern are we starting from.
diff --git a/Source/Charts/Data/Interfaces/ILineRadarChartDataSet.swift b/Source/Charts/Data/Interfaces/ILineRadarChartDataSet.swift
index b53a5337fa..d67e84a25a 100644
--- a/Source/Charts/Data/Interfaces/ILineRadarChartDataSet.swift
+++ b/Source/Charts/Data/Interfaces/ILineRadarChartDataSet.swift
@@ -40,6 +40,6 @@ public protocol ILineRadarChartDataSet: ILineScatterCandleRadarChartDataSet
     /// Please note that this method uses the path clipping for drawing the filled area (with images, gradients and layers).
     var drawFilledEnabled: Bool { get set }
     
-    /// - returns: `true` if filled drawing is enabled, `false` if not
+    /// `true` if filled drawing is enabled, `false` if not
     var isDrawFilledEnabled: Bool { get }
 }
diff --git a/Source/Charts/Data/Interfaces/ILineScatterCandleRadarChartDataSet.swift b/Source/Charts/Data/Interfaces/ILineScatterCandleRadarChartDataSet.swift
index cf646a1b56..27c2bca944 100644
--- a/Source/Charts/Data/Interfaces/ILineScatterCandleRadarChartDataSet.swift
+++ b/Source/Charts/Data/Interfaces/ILineScatterCandleRadarChartDataSet.swift
@@ -24,10 +24,10 @@ public protocol ILineScatterCandleRadarChartDataSet: IBarLineScatterCandleBubble
     /// Enables / disables the vertical highlight-indicator. If disabled, the indicator is not drawn.
     var drawVerticalHighlightIndicatorEnabled: Bool { get set }
     
-    /// - returns: `true` if horizontal highlight indicator lines are enabled (drawn)
+    /// `true` if horizontal highlight indicator lines are enabled (drawn)
     var isHorizontalHighlightIndicatorEnabled: Bool { get }
     
-    /// - returns: `true` if vertical highlight indicator lines are enabled (drawn)
+    /// `true` if vertical highlight indicator lines are enabled (drawn)
     var isVerticalHighlightIndicatorEnabled: Bool { get }
     
     /// Enables / disables both vertical and horizontal highlight-indicators.
diff --git a/Source/Charts/Data/Interfaces/IScatterChartDataSet.swift b/Source/Charts/Data/Interfaces/IScatterChartDataSet.swift
index 5703f07d00..ddea9e80b6 100644
--- a/Source/Charts/Data/Interfaces/IScatterChartDataSet.swift
+++ b/Source/Charts/Data/Interfaces/IScatterChartDataSet.swift
@@ -19,7 +19,7 @@ public protocol IScatterChartDataSet: ILineScatterCandleRadarChartDataSet
     
     // MARK: - Styling functions and accessors
     
-    /// - returns: The size the scatter shape will have
+    /// The size the scatter shape will have
     var scatterShapeSize: CGFloat { get }
     
     /// - returns: The radius of the hole in the shape (applies to Square, Circle and Triangle)
@@ -31,6 +31,6 @@ public protocol IScatterChartDataSet: ILineScatterCandleRadarChartDataSet
     /// **default**: nil
     var scatterShapeHoleColor: NSUIColor? { get }
     
-    /// - returns: The IShapeRenderer responsible for rendering this DataSet.
+    /// The IShapeRenderer responsible for rendering this DataSet.
     var shapeRenderer: IShapeRenderer? { get }
 }
diff --git a/Source/Charts/Interfaces/ChartDataProvider.swift b/Source/Charts/Interfaces/ChartDataProvider.swift
index 99619331c0..531f04b750 100644
--- a/Source/Charts/Interfaces/ChartDataProvider.swift
+++ b/Source/Charts/Interfaces/ChartDataProvider.swift
@@ -15,16 +15,16 @@ import CoreGraphics
 @objc
 public protocol ChartDataProvider
 {
-    /// - returns: The minimum x-value of the chart, regardless of zoom or translation.
+    /// The minimum x-value of the chart, regardless of zoom or translation.
     var chartXMin: Double { get }
     
-    /// - returns: The maximum x-value of the chart, regardless of zoom or translation.
+    /// The maximum x-value of the chart, regardless of zoom or translation.
     var chartXMax: Double { get }
     
-    /// - returns: The minimum y-value of the chart, regardless of zoom or translation.
+    /// The minimum y-value of the chart, regardless of zoom or translation.
     var chartYMin: Double { get }
     
-    /// - returns: The maximum y-value of the chart, regardless of zoom or translation.
+    /// The maximum y-value of the chart, regardless of zoom or translation.
     var chartYMax: Double { get }
     
     var maxHighlightDistance: CGFloat { get }
@@ -36,4 +36,4 @@ public protocol ChartDataProvider
     var data: ChartData? { get }
     
     var maxVisibleCount: Int { get }
-}
\ No newline at end of file
+}
diff --git a/Source/Charts/Renderers/CombinedChartRenderer.swift b/Source/Charts/Renderers/CombinedChartRenderer.swift
index bc80bd0a34..5f36613fc0 100644
--- a/Source/Charts/Renderers/CombinedChartRenderer.swift
+++ b/Source/Charts/Renderers/CombinedChartRenderer.swift
@@ -181,7 +181,7 @@ open class CombinedChartRenderer: DataRenderer
         }
     }
 
-    /// - returns: All sub-renderers.
+    /// All sub-renderers.
     @objc open var subRenderers: [DataRenderer]
     {
         get { return _renderers }
@@ -190,10 +190,10 @@ open class CombinedChartRenderer: DataRenderer
     
     // MARK: Accessors
     
-    /// - returns: `true` if drawing values above bars is enabled, `false` ifnot
+    /// `true` if drawing values above bars is enabled, `false` ifnot
     @objc open var isDrawValueAboveBarEnabled: Bool { return drawValueAboveBarEnabled }
     
-    /// - returns: `true` if drawing shadows (maxvalue) for each bar is enabled, `false` ifnot
+    /// `true` if drawing shadows (maxvalue) for each bar is enabled, `false` ifnot
     @objc open var isDrawBarShadowEnabled: Bool { return drawBarShadowEnabled }
     
     /// the order in which the provided data objects should be drawn.
diff --git a/Source/Charts/Utils/ViewPortHandler.swift b/Source/Charts/Utils/ViewPortHandler.swift
index 4fde6eca50..56e034b418 100755
--- a/Source/Charts/Utils/ViewPortHandler.swift
+++ b/Source/Charts/Utils/ViewPortHandler.swift
@@ -443,49 +443,49 @@ open class ViewPortHandler: NSObject
         return (_contentRect.origin.y + _contentRect.size.height) >= normalizedY
     }
     
-    /// - returns: The current x-scale factor
+    /// The current x-scale factor
     @objc open var scaleX: CGFloat
     {
         return _scaleX
     }
     
-    /// - returns: The current y-scale factor
+    /// The current y-scale factor
     @objc open var scaleY: CGFloat
     {
         return _scaleY
     }
     
-    /// - returns: The minimum x-scale factor
+    /// The minimum x-scale factor
     @objc open var minScaleX: CGFloat
     {
         return _minScaleX
     }
     
-    /// - returns: The minimum y-scale factor
+    /// The minimum y-scale factor
     @objc open var minScaleY: CGFloat
     {
         return _minScaleY
     }
     
-    /// - returns: The minimum x-scale factor
+    /// The minimum x-scale factor
     @objc open var maxScaleX: CGFloat
     {
         return _maxScaleX
     }
     
-    /// - returns: The minimum y-scale factor
+    /// The minimum y-scale factor
     @objc open var maxScaleY: CGFloat
     {
         return _maxScaleY
     }
     
-    /// - returns: The translation (drag / pan) distance on the x-axis
+    /// The translation (drag / pan) distance on the x-axis
     @objc open var transX: CGFloat
     {
         return _transX
     }
     
-    /// - returns: The translation (drag / pan) distance on the y-axis
+    /// The translation (drag / pan) distance on the y-axis
     @objc open var transY: CGFloat
     {
         return _transY
@@ -497,13 +497,13 @@ open class ViewPortHandler: NSObject
         return isFullyZoomedOutX && isFullyZoomedOutY
     }
     
-    /// - returns: `true` if the chart is fully zoomed out on it's y-axis (vertical).
+    /// `true` if the chart is fully zoomed out on it's y-axis (vertical).
     @objc open var isFullyZoomedOutY: Bool
     {
         return !(_scaleY > _minScaleY || _minScaleY > 1.0)
     }
     
-    /// - returns: `true` if the chart is fully zoomed out on it's x-axis (horizontal).
+    /// `true` if the chart is fully zoomed out on it's x-axis (horizontal).
     @objc open var isFullyZoomedOutX: Bool
     {
         return !(_scaleX > _minScaleX || _minScaleX > 1.0)
@@ -521,31 +521,31 @@ open class ViewPortHandler: NSObject
         _transOffsetY = offset
     }
     
-    /// - returns: `true` if both drag offsets (x and y) are zero or smaller.
+    /// `true` if both drag offsets (x and y) are zero or smaller.
     @objc open var hasNoDragOffset: Bool
     {
         return _transOffsetX <= 0.0 && _transOffsetY <= 0.0
     }
     
-    /// - returns: `true` if the chart is not yet fully zoomed out on the x-axis
+    /// `true` if the chart is not yet fully zoomed out on the x-axis
     @objc open var canZoomOutMoreX: Bool
     {
         return _scaleX > _minScaleX
     }
     
-    /// - returns: `true` if the chart is not yet fully zoomed in on the x-axis
+    /// `true` if the chart is not yet fully zoomed in on the x-axis
     @objc open var canZoomInMoreX: Bool
     {
         return _scaleX < _maxScaleX
     }
     
-    /// - returns: `true` if the chart is not yet fully zoomed out on the y-axis
+    /// `true` if the chart is not yet fully zoomed out on the y-axis
     @objc open var canZoomOutMoreY: Bool
     {
         return _scaleY > _minScaleY
     }
     
-    /// - returns: `true` if the chart is not yet fully zoomed in on the y-axis
+    /// `true` if the chart is not yet fully zoomed in on the y-axis
     @objc open var canZoomInMoreY: Bool
     {
         return _scaleY < _maxScaleY

From bad3eef4e0e418f0ae7d98af9f78c0c09ca5cf39 Mon Sep 17 00:00:00 2001
From: Kem Chen <chenkem@gmail.com>
Date: Sat, 22 Sep 2018 21:15:31 +0800
Subject: [PATCH 04/10] Add missing `-`

```
/// (note|return|parameters|throws):
```

```
/// - $1:
```
---
 Source/Charts/Utils/ChartUtils.swift             | 2 +-
 Source/Charts/Utils/Platform+Accessibility.swift | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Source/Charts/Utils/ChartUtils.swift b/Source/Charts/Utils/ChartUtils.swift
index 3746866ccf..1675692fbb 100644
--- a/Source/Charts/Utils/ChartUtils.swift
+++ b/Source/Charts/Utils/ChartUtils.swift
@@ -37,7 +37,7 @@ extension FloatingPoint
     }
 
     /// - returns: An angle between 0.0 < 360.0 (not less than zero, less than 360)
-    /// NOTE: Value must be in degrees
+    /// - NOTE: Value must be in degrees
     var normalizedAngle: Self
     {
         let angle = truncatingRemainder(dividingBy: 360)
diff --git a/Source/Charts/Utils/Platform+Accessibility.swift b/Source/Charts/Utils/Platform+Accessibility.swift
index 37cd6fa07c..7bf2cf72b3 100644
--- a/Source/Charts/Utils/Platform+Accessibility.swift
+++ b/Source/Charts/Utils/Platform+Accessibility.swift
@@ -176,7 +176,7 @@ open class NSUIAccessibilityElement: NSAccessibilityElement
     }
 }
 
-/// NOTE: setAccessibilityRole(.list) is called at init. See Platform.swift.
+/// - NOTE: setAccessibilityRole(.list) is called at init. See Platform.swift.
 extension NSUIView: NSAccessibilityGroup
 {
     open override func accessibilityLabel() -> String?

From f3fa7524cb8e5949731fb65d396203b142725a98 Mon Sep 17 00:00:00 2001
From: Kem Chen <chenkem@gmail.com>
Date: Sat, 22 Sep 2018 23:13:50 +0800
Subject: [PATCH 05/10] Sort sections

```
((///)[ ]+[^-\n]+(\s+))?(((((/// - Parameters:\s+(/// (( - \w+:)|([^-]{1})).*\s+)+)\s+)|(/// - Returns:.*\s+(/// [^-]{1}.*\s+)*)|(/// - Note:.*\s+(/// [^-]{1}.*\s+)*)|(/// - Throws:.*\s+(/// [^-]{1}.*\s+)*))(///\n\s+)?)+)
```

```
$1$2$3$15$7$17$13
```
---
 Source/Charts/Animation/Animator.swift        |  8 +++++++
 .../Charts/Charts/BarLineChartViewBase.swift  |  2 ++
 Source/Charts/Charts/ChartViewBase.swift      | 17 +++++++++++++
 Source/Charts/Components/AxisBase.swift       |  1 +
 Source/Charts/Components/IMarker.swift        |  7 ++----
 .../Implementations/ChartBaseDataSet.swift    |  5 ++++
 .../Implementations/Standard/ChartData.swift  |  2 ++
 .../Standard/ChartDataEntry.swift             |  4 ++++
 .../Standard/ChartDataEntryBase.swift         |  1 +
 .../Standard/ChartDataSet.swift               | 24 +++++++++----------
 .../Data/Interfaces/IChartDataSet.swift       | 24 +++++++++----------
 .../Formatters/IAxisValueFormatter.swift      |  2 +-
 .../Charts/Formatters/IValueFormatter.swift   |  3 +--
 Source/Charts/Highlight/BarHighlighter.swift  |  3 ++-
 .../Charts/Highlight/ChartHighlighter.swift   |  8 +++----
 Source/Charts/Highlight/IHighlighter.swift    |  2 +-
 .../Highlight/PieRadarHighlighter.swift       |  2 +-
 .../Charts/Highlight/RadarHighlighter.swift   |  5 ++--
 Source/Charts/Highlight/Range.swift           |  2 +-
 .../Charts/Renderers/AxisRendererBase.swift   |  1 +
 Source/Charts/Utils/ChartUtils.swift          |  2 +-
 21 files changed, 81 insertions(+), 44 deletions(-)

diff --git a/Source/Charts/Animation/Animator.swift b/Source/Charts/Animation/Animator.swift
index 806e323e67..e626515571 100644
--- a/Source/Charts/Animation/Animator.swift
+++ b/Source/Charts/Animation/Animator.swift
@@ -136,6 +136,7 @@ open class Animator: NSObject
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - xAxisDuration: duration for animating the x axis
     ///   - yAxisDuration: duration for animating the y axis
@@ -170,6 +171,7 @@ open class Animator: NSObject
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - xAxisDuration: duration for animating the x axis
     ///   - yAxisDuration: duration for animating the y axis
@@ -182,6 +184,7 @@ open class Animator: NSObject
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - xAxisDuration: duration for animating the x axis
     ///   - yAxisDuration: duration for animating the y axis
@@ -193,6 +196,7 @@ open class Animator: NSObject
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - xAxisDuration: duration for animating the x axis
     ///   - yAxisDuration: duration for animating the y axis
@@ -204,6 +208,7 @@ open class Animator: NSObject
 
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - xAxisDuration: duration for animating the x axis
     ///   - easing: an easing function for the animation
@@ -230,6 +235,7 @@ open class Animator: NSObject
     
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - xAxisDuration: duration for animating the x axis
     ///   - easingOption: the easing function for the animation
@@ -240,6 +246,7 @@ open class Animator: NSObject
 
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - yAxisDuration: duration for animating the y axis
     ///   - easing: an easing function for the animation
@@ -266,6 +273,7 @@ open class Animator: NSObject
     
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - yAxisDuration: duration for animating the y axis
     ///   - easingOption: the easing function for the animation
diff --git a/Source/Charts/Charts/BarLineChartViewBase.swift b/Source/Charts/Charts/BarLineChartViewBase.swift
index ea8833dbeb..04b076b451 100644
--- a/Source/Charts/Charts/BarLineChartViewBase.swift
+++ b/Source/Charts/Charts/BarLineChartViewBase.swift
@@ -1838,6 +1838,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     }
     
     /// **default**: 0.0
+    ///
     /// - returns: The (custom) minimum width of the specified Y axis.
     @objc open func getYAxisMinWidth(_ axis: YAxis.AxisDependency) -> CGFloat
     {
@@ -1867,6 +1868,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// Zero (0.0) means there's no maximum width
     ///
     /// **default**: 0.0 (no maximum specified)
+    ///
     /// - returns: The (custom) maximum width of the specified Y axis.
     @objc open func getYAxisMaxWidth(_ axis: YAxis.AxisDependency) -> CGFloat
     {
diff --git a/Source/Charts/Charts/ChartViewBase.swift b/Source/Charts/Charts/ChartViewBase.swift
index 3ec8fcac44..842273fa13 100644
--- a/Source/Charts/Charts/ChartViewBase.swift
+++ b/Source/Charts/Charts/ChartViewBase.swift
@@ -21,6 +21,7 @@ import CoreGraphics
 public protocol ChartViewDelegate
 {
     /// Called when a value has been selected inside the chart.
+    ///
     /// - Parameters:
     ///   - entry: The selected Entry.
     ///   - highlight: The corresponding highlight object that contains information about the highlighted position such as dataSetIndex etc.
@@ -398,6 +399,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     }
     
     /// Checks if the highlight array is null, has a length of zero or if the first object is null.
+    ///
     /// - returns: `true` if there are values to highlight, `false` ifthere are no values to highlight.
     @objc open func valuesToHighlight() -> Bool
     {
@@ -429,6 +431,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Highlights any y-value at the given x-value in the given DataSet.
     /// Provide -1 as the dataSetIndex to undo all highlighting.
     /// This method will call the delegate.
+    ///
     /// - Parameters:
     ///   - x: The x-value to highlight
     ///   - dataSetIndex: The dataset index to search in
@@ -441,6 +444,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// Highlights the value at the given x-value and y-value in the given DataSet.
     /// Provide -1 as the dataSetIndex to undo all highlighting.
     /// This method will call the delegate.
+    ///
     /// - Parameters:
     ///   - x: The x-value to highlight
     ///   - y: The y-value to highlight. Supply `NaN` for "any"
@@ -491,6 +495,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Highlights the values represented by the provided Highlight object
     /// This method *will not* call the delegate.
+    ///
     /// - Parameters:
     ///   - highlight: contains information about which entry should be highlighted
     @objc open func highlightValue(_ highlight: Highlight?)
@@ -617,6 +622,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - xAxisDuration: duration for animating the x axis
     ///   - yAxisDuration: duration for animating the y axis
@@ -629,6 +635,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - xAxisDuration: duration for animating the x axis
     ///   - yAxisDuration: duration for animating the y axis
@@ -641,6 +648,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - xAxisDuration: duration for animating the x axis
     ///   - yAxisDuration: duration for animating the y axis
@@ -652,6 +660,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - xAxisDuration: duration for animating the x axis
     ///   - yAxisDuration: duration for animating the y axis
@@ -663,6 +672,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - xAxisDuration: duration for animating the x axis
     ///   - yAxisDuration: duration for animating the y axis
@@ -673,6 +683,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - xAxisDuration: duration for animating the x axis
     ///   - easing: an easing function for the animation
@@ -683,6 +694,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - xAxisDuration: duration for animating the x axis
     ///   - easingOption: the easing function for the animation
@@ -693,6 +705,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart the x-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - xAxisDuration: duration for animating the x axis
     @objc open func animate(xAxisDuration: TimeInterval)
@@ -702,6 +715,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - yAxisDuration: duration for animating the y axis
     ///   - easing: an easing function for the animation
@@ -712,6 +726,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - yAxisDuration: duration for animating the y axis
     ///   - easingOption: the easing function for the animation
@@ -722,6 +737,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Animates the drawing / rendering of the chart the y-axis with the specified animation time.
     /// If `animate(...)` is called, no further calling of `invalidate()` is necessary to refresh the chart.
+    ///
     /// - Parameters:
     ///   - yAxisDuration: duration for animating the y axis
     @objc open func animate(yAxisDuration: TimeInterval)
@@ -759,6 +775,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     }
     
     /// *
+    ///
     /// - note: (Equivalent of getCenter() in MPAndroidChart, as center is already a standard in iOS that returns the center point relative to superview, and MPAndroidChart returns relative to self)*
     /// The center point of the chart (the whole View) in pixels.
     @objc open var midPoint: CGPoint
diff --git a/Source/Charts/Components/AxisBase.swift b/Source/Charts/Components/AxisBase.swift
index 7d02ecc24c..9c1662fb0f 100644
--- a/Source/Charts/Components/AxisBase.swift
+++ b/Source/Charts/Components/AxisBase.swift
@@ -336,6 +336,7 @@ open class AxisBase: ComponentBase
     }
     
     /// Calculates the minimum, maximum and range values of the YAxis with the given minimum and maximum values from the chart data.
+    ///
     /// - Parameters:
     ///   - dataMin: the y-min value according to chart data
     ///   - dataMax: the y-max value according to chart
diff --git a/Source/Charts/Components/IMarker.swift b/Source/Charts/Components/IMarker.swift
index 6126d1d484..51ac3c8cbc 100644
--- a/Source/Charts/Components/IMarker.swift
+++ b/Source/Charts/Components/IMarker.swift
@@ -16,18 +16,15 @@ import CoreGraphics
 public protocol IMarker: class
 {
     /// - returns: The desired (general) offset you wish the IMarker to have on the x-axis.
-    ///
     /// By returning x: -(width / 2) you will center the IMarker horizontally.
-    ///
     /// By returning y: -(height / 2) you will center the IMarker vertically.
     var offset: CGPoint { get }
     
+    /// - Parameters:
+    ///   - point: This is the point at which the marker wants to be drawn. You can adjust the offset conditionally based on this argument.
     /// - returns: The offset for drawing at the specific `point`.
     ///            This allows conditional adjusting of the Marker position.
     ///            If you have no adjustments to make, return self.offset().
-    ///
-    /// - Parameters:
-    ///   - point: This is the point at which the marker wants to be drawn. You can adjust the offset conditionally based on this argument.
     func offsetForDrawing(atPoint: CGPoint) -> CGPoint
     
     /// This method enables a custom IMarker to update it's content every time the IMarker is redrawn according to the data entry it points to.
diff --git a/Source/Charts/Data/Implementations/ChartBaseDataSet.swift b/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
index 86543d4c43..88462dd92b 100644
--- a/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
+++ b/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
@@ -217,6 +217,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     }
     
     /// Adds a new color to the colors array of the DataSet.
+    ///
     /// - Parameters:
     ///   - color: the color to add
     open func addColor(_ color: NSUIColor)
@@ -226,6 +227,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     
     /// Sets the one and **only** color that should be used for this DataSet.
     /// Internally, this recreates the colors array and adds the specified color.
+    ///
     /// - Parameters:
     ///   - color: the color to set
     open func setColor(_ color: NSUIColor)
@@ -235,6 +237,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     }
     
     /// Sets colors to a single color a specific alpha value.
+    ///
     /// - Parameters:
     ///   - color: the color to set
     ///   - alpha: alpha to apply to the set `color`
@@ -244,6 +247,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     }
     
     /// Sets colors with a specific alpha value.
+    ///
     /// - Parameters:
     ///   - colors: the colors to set
     ///   - alpha: alpha to apply to the set `colors`
@@ -260,6 +264,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     }
     
     /// Sets colors with a specific alpha value.
+    ///
     /// - Parameters:
     ///   - colors: the colors to set
     ///   - alpha: alpha to apply to the set `colors`
diff --git a/Source/Charts/Data/Implementations/Standard/ChartData.swift b/Source/Charts/Data/Implementations/Standard/ChartData.swift
index 7bc6070693..f015f03fcb 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartData.swift
@@ -532,6 +532,7 @@ open class ChartData: NSObject
     
     /// Removes the Entry object closest to the given xIndex from the ChartDataSet at the
     /// specified index. 
+    ///
     /// - returns: `true` if an entry was removed, `false` ifno Entry was found that meets the specified requirements.
     @objc @discardableResult open func removeEntry(xValue: Double, dataSetIndex: Int) -> Bool
     {
@@ -712,6 +713,7 @@ open class ChartData: NSObject
     }
     
     /// Checks if this data object contains the specified DataSet. 
+    ///
     /// - returns: `true` if so, `false` ifnot.
     @objc open func contains(dataSet: IChartDataSet) -> Bool
     {
diff --git a/Source/Charts/Data/Implementations/Standard/ChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/ChartDataEntry.swift
index 8dfee1fc71..f957ca45ff 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartDataEntry.swift
@@ -22,6 +22,7 @@ open class ChartDataEntry: ChartDataEntryBase
     }
     
     /// An Entry represents one single entry in the chart.
+    ///
     /// - Parameters:
     ///   - x: the x value
     ///   - y: the y value (the actual value of the entry)
@@ -33,6 +34,7 @@ open class ChartDataEntry: ChartDataEntryBase
     }
     
     /// An Entry represents one single entry in the chart.
+    ///
     /// - Parameters:
     ///   - x: the x value
     ///   - y: the y value (the actual value of the entry)
@@ -48,6 +50,7 @@ open class ChartDataEntry: ChartDataEntryBase
     }
     
     /// An Entry represents one single entry in the chart.
+    ///
     /// - Parameters:
     ///   - x: the x value
     ///   - y: the y value (the actual value of the entry)
@@ -61,6 +64,7 @@ open class ChartDataEntry: ChartDataEntryBase
     }
     
     /// An Entry represents one single entry in the chart.
+    ///
     /// - Parameters:
     ///   - x: the x value
     ///   - y: the y value (the actual value of the entry)
diff --git a/Source/Charts/Data/Implementations/Standard/ChartDataEntryBase.swift b/Source/Charts/Data/Implementations/Standard/ChartDataEntryBase.swift
index ad18b8a580..5b1075bc41 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartDataEntryBase.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartDataEntryBase.swift
@@ -28,6 +28,7 @@ open class ChartDataEntryBase: NSObject
     }
     
     /// An Entry represents one single entry in the chart.
+    ///
     /// - Parameters:
     ///   - y: the y value (the actual value of the entry)
     @objc public init(y: Double)
diff --git a/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift b/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
index 2f4c4901c0..553b7103bf 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
@@ -55,6 +55,7 @@ open class ChartDataSet: ChartBaseDataSet
     // MARK: - Data functions and accessors
 
     /// *
+    ///
     /// - note: Calls `notifyDataSetChanged()` after setting a new value.
     /// - returns: The array of y-values that this DataSet represents.
     /// the entries that this dataset represents / holds together
@@ -163,9 +164,9 @@ open class ChartDataSet: ChartBaseDataSet
     /// The number of y-values this DataSet represents
     open override var entryCount: Int { return values.count }
     
-    /// - returns: The entry object found at the given index (not x-value!)
     /// - throws: out of bounds
     /// if `i` is out of bounds, it may throw an out-of-bounds exception
+    /// - returns: The entry object found at the given index (not x-value!)
     open override func entryForIndex(_ i: Int) -> ChartDataEntry?
     {
         guard i >= values.startIndex, i < values.endIndex else {
@@ -174,13 +175,13 @@ open class ChartDataSet: ChartBaseDataSet
         return values[i]
     }
     
-    /// - returns: The first Entry object found at the given x-value with binary search.
-    /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value according to the rounding.
-    /// nil if no Entry object at that x-value.
     /// - Parameters:
     ///   - xValue: the x-value
     ///   - closestToY: If there are multiple y-values for the specified x-value,
     ///   - rounding: determine whether to round up/down/closest if there is no Entry matching the provided x-value
+    /// - returns: The first Entry object found at the given x-value with binary search.
+    /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value according to the rounding.
+    /// nil if no Entry object at that x-value.
     open override func entryForXValue(
         _ xValue: Double,
         closestToY yValue: Double,
@@ -194,12 +195,12 @@ open class ChartDataSet: ChartBaseDataSet
         return nil
     }
     
-    /// - returns: The first Entry object found at the given x-value with binary search.
-    /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value.
-    /// nil if no Entry object at that x-value.
     /// - Parameters:
     ///   - xValue: the x-value
     ///   - closestToY: If there are multiple y-values for the specified x-value,
+    /// - returns: The first Entry object found at the given x-value with binary search.
+    /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value.
+    /// nil if no Entry object at that x-value.
     open override func entryForXValue(
         _ xValue: Double,
         closestToY yValue: Double) -> ChartDataEntry?
@@ -265,13 +266,12 @@ open class ChartDataSet: ChartBaseDataSet
         return entries
     }
     
-    /// - returns: The array-index of the specified entry.
-    /// If the no Entry at the specified x-value is found, this method returns the index of the Entry at the closest x-value according to the rounding.
-    ///
     /// - Parameters:
     ///   - xValue: x-value of the entry to search for
     ///   - closestToY: If there are multiple y-values for the specified x-value,
     ///   - rounding: Rounding method if exact value was not found
+    /// - returns: The array-index of the specified entry.
+    /// If the no Entry at the specified x-value is found, this method returns the index of the Entry at the closest x-value according to the rounding.
     open override func entryIndex(
         x xValue: Double,
         closestToY yValue: Double,
@@ -374,10 +374,9 @@ open class ChartDataSet: ChartBaseDataSet
         return closest
     }
     
-    /// - returns: The array-index of the specified entry
-    ///
     /// - Parameters:
     ///   - e: the entry to search for
+    /// - returns: The array-index of the specified entry
     open override func entryIndex(entry e: ChartDataEntry) -> Int
     {
         for i in 0 ..< values.count
@@ -479,6 +478,7 @@ open class ChartDataSet: ChartBaseDataSet
     }
     
     /// Checks if this DataSet contains the specified Entry.
+    ///
     /// - returns: `true` if contains the entry, `false` if not.
     open override func contains(_ e: ChartDataEntry) -> Bool
     {
diff --git a/Source/Charts/Data/Interfaces/IChartDataSet.swift b/Source/Charts/Data/Interfaces/IChartDataSet.swift
index 8aa9296bd3..97f95be203 100644
--- a/Source/Charts/Data/Interfaces/IChartDataSet.swift
+++ b/Source/Charts/Data/Interfaces/IChartDataSet.swift
@@ -42,29 +42,29 @@ public protocol IChartDataSet
     /// The number of y-values this DataSet represents
     var entryCount: Int { get }
     
-    /// - returns: The entry object found at the given index (not x-value!)
     /// - throws: out of bounds
     /// if `i` is out of bounds, it may throw an out-of-bounds exception
+    /// - returns: The entry object found at the given index (not x-value!)
     func entryForIndex(_ i: Int) -> ChartDataEntry?
     
-    /// - returns: The first Entry object found at the given x-value with binary search.
-    /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value according to the rounding.
-    /// nil if no Entry object at that x-value.
     /// - Parameters:
     ///   - xValue: the x-value
     ///   - closestToY: If there are multiple y-values for the specified x-value,
     ///   - rounding: determine whether to round up/down/closest if there is no Entry matching the provided x-value
+    /// - returns: The first Entry object found at the given x-value with binary search.
+    /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value according to the rounding.
+    /// nil if no Entry object at that x-value.
     func entryForXValue(
         _ xValue: Double,
         closestToY yValue: Double,
         rounding: ChartDataSetRounding) -> ChartDataEntry?
     
-    /// - returns: The first Entry object found at the given x-value with binary search.
-    /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value.
-    /// nil if no Entry object at that x-value.
     /// - Parameters:
     ///   - xValue: the x-value
     ///   - closestToY: If there are multiple y-values for the specified x-value,
+    /// - returns: The first Entry object found at the given x-value with binary search.
+    /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value.
+    /// nil if no Entry object at that x-value.
     func entryForXValue(
         _ xValue: Double,
         closestToY yValue: Double) -> ChartDataEntry?
@@ -73,22 +73,20 @@ public protocol IChartDataSet
     /// An empty array if no Entry object at that x-value.
     func entriesForXValue(_ xValue: Double) -> [ChartDataEntry]
     
-    /// - returns: The array-index of the specified entry.
-    /// If the no Entry at the specified x-value is found, this method returns the index of the Entry at the closest x-value according to the rounding.
-    ///
     /// - Parameters:
     ///   - xValue: x-value of the entry to search for
     ///   - closestToY: If there are multiple y-values for the specified x-value,
     ///   - rounding: Rounding method if exact value was not found
+    /// - returns: The array-index of the specified entry.
+    /// If the no Entry at the specified x-value is found, this method returns the index of the Entry at the closest x-value according to the rounding.
     func entryIndex(
         x xValue: Double,
         closestToY yValue: Double,
         rounding: ChartDataSetRounding) -> Int
     
-    /// - returns: The array-index of the specified entry
-    ///
     /// - Parameters:
     ///   - e: the entry to search for
+    /// - returns: The array-index of the specified entry
     func entryIndex(entry e: ChartDataEntry) -> Int
     
     /// Adds an Entry to the DataSet dynamically.
@@ -96,6 +94,7 @@ public protocol IChartDataSet
     /// *optional feature, can return `false` ifnot implemented*
     ///
     /// Entries are added to the end of the list.
+    ///
     /// - Parameters:
     ///   - e: the entry to add
     /// - returns: `true` if the entry was added successfully, `false` ifthis feature is not supported
@@ -108,6 +107,7 @@ public protocol IChartDataSet
     /// *optional feature, can return `false` ifnot implemented*
     ///
     /// Entries are added to the end of the list.
+    ///
     /// - Parameters:
     ///   - e: the entry to add
     /// - returns: `true` if the entry was added successfully, `false` ifthis feature is not supported
diff --git a/Source/Charts/Formatters/IAxisValueFormatter.swift b/Source/Charts/Formatters/IAxisValueFormatter.swift
index 7273dcc19d..af064f8e5b 100644
--- a/Source/Charts/Formatters/IAxisValueFormatter.swift
+++ b/Source/Charts/Formatters/IAxisValueFormatter.swift
@@ -20,10 +20,10 @@ public protocol IAxisValueFormatter: class
     ///
     /// For performance reasons, avoid excessive calculations and memory allocations inside this method.
     ///
-    /// - returns: The customized label that is drawn on the x-axis.
     /// - Parameters:
     ///   - value:           the value that is currently being drawn
     ///   - axis:            the axis that the value belongs to
+    /// - returns: The customized label that is drawn on the x-axis.
     func stringForValue(_ value: Double,
                         axis: AxisBase?) -> String
     
diff --git a/Source/Charts/Formatters/IValueFormatter.swift b/Source/Charts/Formatters/IValueFormatter.swift
index a3997f143a..a8a32b3f3f 100644
--- a/Source/Charts/Formatters/IValueFormatter.swift
+++ b/Source/Charts/Formatters/IValueFormatter.swift
@@ -24,12 +24,11 @@ public protocol IValueFormatter: class
     ///
     /// For performance reasons, avoid excessive calculations and memory allocations inside this method.
     ///
-    /// - returns:                   The formatted label ready to be drawn
-    ///
     /// - Parameters:
     ///   - value:           The value to be formatted
     ///   - dataSetIndex:    The index of the DataSet the entry in focus belongs to
     ///   - viewPortHandler: provides information about the current chart state (scale, translation, ...)
+    /// - returns:                   The formatted label ready to be drawn
     func stringForValue(_ value: Double,
                         entry: ChartDataEntry,
                         dataSetIndex: Int,
diff --git a/Source/Charts/Highlight/BarHighlighter.swift b/Source/Charts/Highlight/BarHighlighter.swift
index 6b8fe2f7a8..3a4fcd982a 100644
--- a/Source/Charts/Highlight/BarHighlighter.swift
+++ b/Source/Charts/Highlight/BarHighlighter.swift
@@ -49,6 +49,7 @@ open class BarHighlighter: ChartHighlighter
     }
     
     /// This method creates the Highlight object that also indicates which value of a stacked BarEntry has been selected.
+    ///
     /// - Parameters:
     ///   - high: the Highlight to work with looking for stacked values
     ///   - set:
@@ -90,11 +91,11 @@ open class BarHighlighter: ChartHighlighter
                          axis: high.axis)
     }
     
-    /// - returns: The index of the closest value inside the values array / ranges (stacked barchart) to the value given as a parameter.
     /// - Parameters:
     ///   - entry:
     ///   - value:
     /// - returns:
+    /// - returns: The index of the closest value inside the values array / ranges (stacked barchart) to the value given as a parameter.
     @objc open func getClosestStackIndex(ranges: [Range]?, value: Double) -> Int
     {
         guard let ranges = ranges else { return 0 }
diff --git a/Source/Charts/Highlight/ChartHighlighter.swift b/Source/Charts/Highlight/ChartHighlighter.swift
index cfe4bd4b10..bf5cea7ac1 100644
--- a/Source/Charts/Highlight/ChartHighlighter.swift
+++ b/Source/Charts/Highlight/ChartHighlighter.swift
@@ -28,10 +28,10 @@ open class ChartHighlighter : NSObject, IHighlighter
         return getHighlight(xValue: xVal, x: x, y: y)
     }
     
-    /// - returns: The corresponding x-pos for a given touch-position in pixels.
     /// - Parameters:
     ///   - x:
     /// - returns:
+    /// - returns: The corresponding x-pos for a given touch-position in pixels.
     @objc open func getValsForTouch(x: CGFloat, y: CGFloat) -> CGPoint
     {
         guard let chart = self.chart as? BarLineScatterCandleBubbleChartDataProvider else { return .zero }
@@ -40,12 +40,12 @@ open class ChartHighlighter : NSObject, IHighlighter
         return chart.getTransformer(forAxis: .left).valueForTouchPoint(x: x, y: y)
     }
     
-    /// - returns: The corresponding ChartHighlight for a given x-value and xy-touch position in pixels.
     /// - Parameters:
     ///   - xValue:
     ///   - x:
     ///   - y:
     /// - returns:
+    /// - returns: The corresponding ChartHighlight for a given x-value and xy-touch position in pixels.
     @objc open func getHighlight(xValue xVal: Double, x: CGFloat, y: CGFloat) -> Highlight?
     {
         guard let chart = chart else { return nil }
@@ -63,13 +63,13 @@ open class ChartHighlighter : NSObject, IHighlighter
         return detail
     }
     
-    /// - returns: A list of Highlight objects representing the entries closest to the given xVal.
-    /// The returned list contains two objects per DataSet (closest rounding up, closest rounding down).
     /// - Parameters:
     ///   - xValue: the transformed x-value of the x-touch position
     ///   - x: touch position
     ///   - y: touch position
     /// - returns:
+    /// - returns: A list of Highlight objects representing the entries closest to the given xVal.
+    /// The returned list contains two objects per DataSet (closest rounding up, closest rounding down).
     @objc open func getHighlights(xValue: Double, x: CGFloat, y: CGFloat) -> [Highlight]
     {
         var vals = [Highlight]()
diff --git a/Source/Charts/Highlight/IHighlighter.swift b/Source/Charts/Highlight/IHighlighter.swift
index 99a5df65ae..e87c0afdc5 100644
--- a/Source/Charts/Highlight/IHighlighter.swift
+++ b/Source/Charts/Highlight/IHighlighter.swift
@@ -15,10 +15,10 @@ import CoreGraphics
 @objc(IChartHighlighter)
 public protocol IHighlighter: class
 {
-    /// - returns: A Highlight object corresponding to the given x- and y- touch positions in pixels.
     /// - Parameters:
     ///   - x:
     ///   - y:
     /// - returns:
+    /// - returns: A Highlight object corresponding to the given x- and y- touch positions in pixels.
     func getHighlight(x: CGFloat, y: CGFloat) -> Highlight?
 }
diff --git a/Source/Charts/Highlight/PieRadarHighlighter.swift b/Source/Charts/Highlight/PieRadarHighlighter.swift
index b65ca9f4bf..3d9af58003 100644
--- a/Source/Charts/Highlight/PieRadarHighlighter.swift
+++ b/Source/Charts/Highlight/PieRadarHighlighter.swift
@@ -49,11 +49,11 @@ open class PieRadarHighlighter: ChartHighlighter
 
     }
     
-    /// - returns: The closest Highlight object of the given objects based on the touch position inside the chart.
     /// - Parameters:
     ///   - index:
     ///   - x:
     ///   - y:
+    /// - returns: The closest Highlight object of the given objects based on the touch position inside the chart.
     @objc open func closestHighlight(index: Int, x: CGFloat, y: CGFloat) -> Highlight?
     {
         fatalError("closestHighlight(index, x, y) cannot be called on PieRadarChartHighlighter")
diff --git a/Source/Charts/Highlight/RadarHighlighter.swift b/Source/Charts/Highlight/RadarHighlighter.swift
index 1333e1514c..6506bbbac2 100644
--- a/Source/Charts/Highlight/RadarHighlighter.swift
+++ b/Source/Charts/Highlight/RadarHighlighter.swift
@@ -39,11 +39,10 @@ open class RadarHighlighter: PieRadarHighlighter
         return closest
     }
     
-    /// - returns: An array of Highlight objects for the given index.
-    /// The Highlight objects give information about the value at the selected index and DataSet it belongs to.
-    ///
     /// - Parameters:
     ///   - index:
+    /// - returns: An array of Highlight objects for the given index.
+    /// The Highlight objects give information about the value at the selected index and DataSet it belongs to.
     internal func getHighlights(forIndex index: Int) -> [Highlight]
     {
         var vals = [Highlight]()
diff --git a/Source/Charts/Highlight/Range.swift b/Source/Charts/Highlight/Range.swift
index 3608544fcc..3eb4d9b637 100644
--- a/Source/Charts/Highlight/Range.swift
+++ b/Source/Charts/Highlight/Range.swift
@@ -25,9 +25,9 @@ open class Range: NSObject
         super.init()
     }
 
-    /// - returns: `true` if this range contains (if the value is in between) the given value, `false` ifnot.
     /// - Parameters:
     ///   - value:
+    /// - returns: `true` if this range contains (if the value is in between) the given value, `false` ifnot.
     @objc open func contains(_ value: Double) -> Bool
     {
         if value > from && value <= to
diff --git a/Source/Charts/Renderers/AxisRendererBase.swift b/Source/Charts/Renderers/AxisRendererBase.swift
index c0b6821bac..302bdf5312 100644
--- a/Source/Charts/Renderers/AxisRendererBase.swift
+++ b/Source/Charts/Renderers/AxisRendererBase.swift
@@ -54,6 +54,7 @@ open class AxisRendererBase: Renderer
     }
     
     /// Computes the axis values.
+    ///
     /// - Parameters:
     ///   - min: the minimum value in the data object for this axis
     ///   - max: the maximum value in the data object for this axis
diff --git a/Source/Charts/Utils/ChartUtils.swift b/Source/Charts/Utils/ChartUtils.swift
index 1675692fbb..e18d93a20d 100644
--- a/Source/Charts/Utils/ChartUtils.swift
+++ b/Source/Charts/Utils/ChartUtils.swift
@@ -36,8 +36,8 @@ extension FloatingPoint
         return self * 180 / .pi
     }
 
-    /// - returns: An angle between 0.0 < 360.0 (not less than zero, less than 360)
     /// - NOTE: Value must be in degrees
+    /// - returns: An angle between 0.0 < 360.0 (not less than zero, less than 360)
     var normalizedAngle: Self
     {
         let angle = truncatingRemainder(dividingBy: 360)

From 0edceeac76d5cdeee9b55b6bd8c0bca93679ac98 Mon Sep 17 00:00:00 2001
From: Kem Chen <chenkem@gmail.com>
Date: Sun, 23 Sep 2018 00:09:06 +0800
Subject: [PATCH 06/10] Uppercased the section title

---
 Source/Charts/Charts/BarChartView.swift       |  4 +-
 .../Charts/Charts/BarLineChartViewBase.swift  | 20 +++++-----
 Source/Charts/Charts/ChartViewBase.swift      | 20 +++++-----
 Source/Charts/Charts/CombinedChartView.swift  |  2 +-
 Source/Charts/Charts/PieChartView.swift       |  8 ++--
 .../Charts/Charts/PieRadarChartViewBase.swift | 12 +++---
 Source/Charts/Components/AxisBase.swift       |  2 +-
 Source/Charts/Components/IMarker.swift        |  4 +-
 Source/Charts/Components/XAxis.swift          |  2 +-
 .../Implementations/ChartBaseDataSet.swift    |  8 ++--
 .../Standard/BarChartDataEntry.swift          |  4 +-
 .../Implementations/Standard/ChartData.swift  | 26 ++++++-------
 .../Standard/ChartDataSet.swift               | 30 +++++++--------
 .../Standard/CombinedChartData.swift          |  2 +-
 .../Standard/LineChartDataSet.swift           |  2 +-
 .../Standard/PieChartData.swift               |  2 +-
 .../Standard/ScatterChartData.swift           |  2 +-
 .../Data/Interfaces/IChartDataSet.swift       | 38 +++++++++----------
 .../Data/Interfaces/ILineChartDataSet.swift   |  2 +-
 .../Interfaces/ILineRadarChartDataSet.swift   |  2 +-
 .../Interfaces/IScatterChartDataSet.swift     |  4 +-
 .../Formatters/IAxisValueFormatter.swift      |  2 +-
 Source/Charts/Formatters/IFillFormatter.swift |  2 +-
 .../Charts/Formatters/IValueFormatter.swift   |  2 +-
 Source/Charts/Highlight/BarHighlighter.swift  |  6 +--
 .../Charts/Highlight/ChartHighlighter.swift   | 18 ++++-----
 Source/Charts/Highlight/IHighlighter.swift    |  4 +-
 .../Highlight/PieRadarHighlighter.swift       |  2 +-
 .../Charts/Highlight/RadarHighlighter.swift   |  2 +-
 Source/Charts/Highlight/Range.swift           |  2 +-
 .../BarLineScatterCandleBubbleRenderer.swift  |  2 +-
 .../Renderers/CombinedChartRenderer.swift     |  2 +-
 Source/Charts/Utils/ChartUtils.swift          |  6 +--
 .../Charts/Utils/Platform+Accessibility.swift |  2 +-
 Source/Charts/Utils/Transformer.swift         |  4 +-
 35 files changed, 126 insertions(+), 126 deletions(-)

diff --git a/Source/Charts/Charts/BarChartView.swift b/Source/Charts/Charts/BarChartView.swift
index 3a8e254010..c630340ecd 100644
--- a/Source/Charts/Charts/BarChartView.swift
+++ b/Source/Charts/Charts/BarChartView.swift
@@ -58,7 +58,7 @@ open class BarChartView: BarLineChartViewBase, BarChartDataProvider
             max: data.getYMax(axis: .right))
     }
     
-    /// - returns: The Highlight object (contains x-index and DataSet index) of the selected value at the given touch point inside the BarChart.
+    /// - Returns: The Highlight object (contains x-index and DataSet index) of the selected value at the given touch point inside the BarChart.
     open override func getHighlightByTouchPoint(_ pt: CGPoint) -> Highlight?
     {
         if _data === nil
@@ -82,7 +82,7 @@ open class BarChartView: BarLineChartViewBase, BarChartDataProvider
             axis: h.axis)
     }
         
-    /// - returns: The bounding box of the specified Entry in the specified DataSet. Returns null if the Entry could not be found in the charts data.
+    /// - Returns: The bounding box of the specified Entry in the specified DataSet. Returns null if the Entry could not be found in the charts data.
     @objc open func getBarBounds(entry e: BarChartDataEntry) -> CGRect
     {
         guard let
diff --git a/Source/Charts/Charts/BarLineChartViewBase.swift b/Source/Charts/Charts/BarLineChartViewBase.swift
index 04b076b451..2414374049 100644
--- a/Source/Charts/Charts/BarLineChartViewBase.swift
+++ b/Source/Charts/Charts/BarLineChartViewBase.swift
@@ -1511,7 +1511,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
 
     // MARK: - Accessors
     
-    /// - returns: The range of the specified axis.
+    /// - Returns: The range of the specified axis.
     @objc open func getAxisRange(axis: YAxis.AxisDependency) -> Double
     {
         if axis == .left
@@ -1524,7 +1524,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
         }
     }
 
-    /// - returns: The position (in pixels) the provided Entry has inside the chart view
+    /// - Returns: The position (in pixels) the provided Entry has inside the chart view
     @objc open func getPosition(entry e: ChartDataEntry, axis: YAxis.AxisDependency) -> CGPoint
     {
         var vals = CGPoint(x: CGFloat(e.x), y: CGFloat(e.y))
@@ -1682,7 +1682,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
         return drawBordersEnabled
     }
 
-    /// - returns: The x and y values in the chart at the given touch point
+    /// - Returns: The x and y values in the chart at the given touch point
     /// (encapsulated in a `CGPoint`). This method transforms pixel coordinates to
     /// coordinates / values in the chart. This is the opposite method to
     /// `getPixelsForValues(...)`.
@@ -1698,7 +1698,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
         return getTransformer(forAxis: axis).pixelForValues(x: x, y: y)
     }
     
-    /// - returns: The Entry object displayed at the touched position of the chart
+    /// - Returns: The Entry object displayed at the touched position of the chart
     @objc open func getEntryByTouchPoint(point pt: CGPoint) -> ChartDataEntry!
     {
         if let h = getHighlightByTouchPoint(pt)
@@ -1708,7 +1708,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
         return nil
     }
     
-    /// - returns: The DataSet object displayed at the touched position of the chart
+    /// - Returns: The DataSet object displayed at the touched position of the chart
     @objc open func getDataSetByTouchPoint(point pt: CGPoint) -> IBarLineScatterCandleBubbleChartDataSet?
     {
         let h = getHighlightByTouchPoint(pt)
@@ -1742,7 +1742,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     /// if the chart is fully zoomed out, return true
     @objc open var isFullyZoomedOut: Bool { return _viewPortHandler.isFullyZoomedOut }
 
-    /// - returns: The y-axis object to the corresponding AxisDependency. In the
+    /// - Returns: The y-axis object to the corresponding AxisDependency. In the
     /// horizontal bar-chart, LEFT == top, RIGHT == BOTTOM
     @objc open func getAxis(_ axis: YAxis.AxisDependency) -> YAxis
     {
@@ -1839,7 +1839,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     
     /// **default**: 0.0
     ///
-    /// - returns: The (custom) minimum width of the specified Y axis.
+    /// - Returns: The (custom) minimum width of the specified Y axis.
     @objc open func getYAxisMinWidth(_ axis: YAxis.AxisDependency) -> CGFloat
     {
         if axis == .left
@@ -1869,7 +1869,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     ///
     /// **default**: 0.0 (no maximum specified)
     ///
-    /// - returns: The (custom) maximum width of the specified Y axis.
+    /// - Returns: The (custom) maximum width of the specified Y axis.
     @objc open func getYAxisMaxWidth(_ axis: YAxis.AxisDependency) -> CGFloat
     {
         if axis == .left
@@ -1882,7 +1882,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
         }
     }
 
-    /// - returns the width of the specified y axis.
+    /// - Returns the width of the specified y axis.
     @objc open func getYAxisWidth(_ axis: YAxis.AxisDependency) -> CGFloat
     {
         if axis == .left
@@ -1897,7 +1897,7 @@ open class BarLineChartViewBase: ChartViewBase, BarLineScatterCandleBubbleChartD
     
     // MARK: - BarLineScatterCandleBubbleChartDataProvider
     
-    /// - returns: The Transformer class that contains all matrices and is
+    /// - Returns: The Transformer class that contains all matrices and is
     /// responsible for transforming values into pixels on the screen and
     /// backwards.
     open func getTransformer(forAxis axis: YAxis.AxisDependency) -> Transformer
diff --git a/Source/Charts/Charts/ChartViewBase.swift b/Source/Charts/Charts/ChartViewBase.swift
index 842273fa13..ab949aa1be 100644
--- a/Source/Charts/Charts/ChartViewBase.swift
+++ b/Source/Charts/Charts/ChartViewBase.swift
@@ -41,7 +41,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
 {
     // MARK: - Properties
     
-    /// - returns: The object representing all x-labels, this method can be used to
+    /// - Returns: The object representing all x-labels, this method can be used to
     /// acquire the XAxis object and modify it (e.g. change the position of the
     /// labels)
     @objc open var xAxis: XAxis
@@ -116,7 +116,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     /// (use the `marker` property to specify a marker)
     @objc open var drawMarkers = true
     
-    /// - returns: `true` if drawing the marker is enabled when tapping on values
+    /// - Returns: `true` if drawing the marker is enabled when tapping on values
     /// (use the `marker` property to specify a marker)
     @objc open var isDrawMarkersEnabled: Bool { return drawMarkers }
     
@@ -241,7 +241,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
         setNeedsDisplay()
     }
 
-    /// - returns: `true` if the chart is empty (meaning it's data object is either null or contains no entries).
+    /// - Returns: `true` if the chart is empty (meaning it's data object is either null or contains no entries).
     @objc open func isEmpty() -> Bool
     {
         guard let data = _data else { return true }
@@ -400,7 +400,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Checks if the highlight array is null, has a length of zero or if the first object is null.
     ///
-    /// - returns: `true` if there are values to highlight, `false` ifthere are no values to highlight.
+    /// - Returns: `true` if there are values to highlight, `false` ifthere are no values to highlight.
     @objc open func valuesToHighlight() -> Bool
     {
         return _indicesToHighlight.count > 0
@@ -546,7 +546,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
         setNeedsDisplay()
     }
     
-    /// - returns: The Highlight object (contains x-index and DataSet index) of the
+    /// - Returns: The Highlight object (contains x-index and DataSet index) of the
     /// selected value at the given touch point inside the Line-, Scatter-, or
     /// CandleStick-Chart.
     @objc open func getHighlightByTouchPoint(_ pt: CGPoint) -> Highlight?
@@ -606,7 +606,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
         }
     }
     
-    /// - returns: The actual position in pixels of the MarkerView for the given Entry in the given DataSet.
+    /// - Returns: The actual position in pixels of the MarkerView for the given Entry in the given DataSet.
     @objc open func getMarkerPosition(highlight: Highlight) -> CGPoint
     {
         return CGPoint(x: highlight.drawX, y: highlight.drawY)
@@ -776,7 +776,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// *
     ///
-    /// - note: (Equivalent of getCenter() in MPAndroidChart, as center is already a standard in iOS that returns the center point relative to superview, and MPAndroidChart returns relative to self)*
+    /// - Note: (Equivalent of getCenter() in MPAndroidChart, as center is already a standard in iOS that returns the center point relative to superview, and MPAndroidChart returns relative to self)*
     /// The center point of the chart (the whole View) in pixels.
     @objc open var midPoint: CGPoint
     {
@@ -808,14 +808,14 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
         return _viewPortHandler.contentRect
     }
     
-    /// - returns: The ViewPortHandler of the chart that is responsible for the
+    /// - Returns: The ViewPortHandler of the chart that is responsible for the
     /// content area of the chart and its offsets and dimensions.
     @objc open var viewPortHandler: ViewPortHandler!
     {
         return _viewPortHandler
     }
     
-    /// - returns: The bitmap that represents the chart.
+    /// - Returns: The bitmap that represents the chart.
     @objc open func getChartImage(transparent: Bool) -> NSUIImage?
     {
         NSUIGraphicsBeginImageContextWithOptions(bounds.size, isOpaque || !transparent, NSUIMainScreen()?.nsuiScale ?? 1.0)
@@ -862,7 +862,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     ///   - to: path to the image to save
     ///   - format: the format to save
     ///   - compressionQuality: compression quality for lossless formats (JPEG)
-    /// - returns: `true` if the image was saved successfully
+    /// - Returns: `true` if the image was saved successfully
     open func save(to path: String, format: ImageFormat, compressionQuality: Double) -> Bool
     {
         guard let image = getChartImage(transparent: format != .jpeg) else { return false }
diff --git a/Source/Charts/Charts/CombinedChartView.swift b/Source/Charts/Charts/CombinedChartView.swift
index 94fa343d01..47eebd6c78 100644
--- a/Source/Charts/Charts/CombinedChartView.swift
+++ b/Source/Charts/Charts/CombinedChartView.swift
@@ -76,7 +76,7 @@ open class CombinedChartView: BarLineChartViewBase, CombinedChartDataProvider
         }
     }
     
-    /// - returns: The Highlight object (contains x-index and DataSet index) of the selected value at the given touch point inside the CombinedChart.
+    /// - Returns: The Highlight object (contains x-index and DataSet index) of the selected value at the given touch point inside the CombinedChart.
     open override func getHighlightByTouchPoint(_ pt: CGPoint) -> Highlight?
     {
         if _data === nil
diff --git a/Source/Charts/Charts/PieChartView.swift b/Source/Charts/Charts/PieChartView.swift
index bfa862328f..6833b68823 100644
--- a/Source/Charts/Charts/PieChartView.swift
+++ b/Source/Charts/Charts/PieChartView.swift
@@ -279,7 +279,7 @@ open class PieChartView: PieRadarChartViewBase
         return -1 // return -1 if no index found
     }
     
-    /// - returns: The index of the DataSet this x-index belongs to.
+    /// - Returns: The index of the DataSet this x-index belongs to.
     @objc open func dataSetIndexForIndex(_ xValue: Double) -> Int
     {
         var dataSets = _data?.dataSets ?? []
@@ -295,7 +295,7 @@ open class PieChartView: PieRadarChartViewBase
         return -1
     }
     
-    /// - returns: An integer array of all the different angles the chart slices
+    /// - Returns: An integer array of all the different angles the chart slices
     /// have the angles in the returned array determine how much space (of 360°)
     /// each slice takes
     @objc open var drawAngles: [CGFloat]
@@ -303,7 +303,7 @@ open class PieChartView: PieRadarChartViewBase
         return _drawAngles
     }
 
-    /// - returns: The absolute angles of the different chart slices (where the
+    /// - Returns: The absolute angles of the different chart slices (where the
     /// slices end)
     @objc open var absoluteAngles: [CGFloat]
     {
@@ -312,7 +312,7 @@ open class PieChartView: PieRadarChartViewBase
     
     /// The color for the hole that is drawn in the center of the PieChart (if enabled).
     /// 
-    /// - note: Use holeTransparent with holeColor = nil to make the hole transparent.*
+    /// - Note: Use holeTransparent with holeColor = nil to make the hole transparent.*
     @objc open var holeColor: NSUIColor?
     {
         get
diff --git a/Source/Charts/Charts/PieRadarChartViewBase.swift b/Source/Charts/Charts/PieRadarChartViewBase.swift
index 1c987dc110..ddc7bfa828 100755
--- a/Source/Charts/Charts/PieRadarChartViewBase.swift
+++ b/Source/Charts/Charts/PieRadarChartViewBase.swift
@@ -244,7 +244,7 @@ open class PieRadarChartViewBase: ChartViewBase
         _viewPortHandler.restrainViewPort(offsetLeft: offsetLeft, offsetTop: offsetTop, offsetRight: offsetRight, offsetBottom: offsetBottom)
     }
 
-    /// - returns: The angle relative to the chart center for the given point on the chart in degrees.
+    /// - Returns: The angle relative to the chart center for the given point on the chart in degrees.
     /// The angle is always between 0 and 360°, 0° is NORTH, 90° is EAST, ...
     @objc open func angleForPoint(x: CGFloat, y: CGFloat) -> CGFloat
     {
@@ -282,7 +282,7 @@ open class PieRadarChartViewBase: ChartViewBase
                 y: center.y + dist * sin(angle.DEG2RAD))
     }
 
-    /// - returns: The distance of a certain point on the chart to the center of the chart.
+    /// - Returns: The distance of a certain point on the chart to the center of the chart.
     @objc open func distanceToCenter(x: CGFloat, y: CGFloat) -> CGFloat
     {
         let c = self.centerOffsets
@@ -316,7 +316,7 @@ open class PieRadarChartViewBase: ChartViewBase
         return dist
     }
 
-    /// - returns: The xIndex for the given angle around the center of the chart.
+    /// - Returns: The xIndex for the given angle around the center of the chart.
     /// -1 if not found / outofbounds.
     @objc open func indexForAngle(_ angle: CGFloat) -> Int
     {
@@ -371,7 +371,7 @@ open class PieRadarChartViewBase: ChartViewBase
         fatalError("requiredLegendOffset cannot be called on PieRadarChartViewBase")
     }
 
-    /// - returns: The base offset needed for the chart without calculating the
+    /// - Returns: The base offset needed for the chart without calculating the
     /// legend size.
     internal var requiredBaseOffset: CGFloat
     {
@@ -791,7 +791,7 @@ open class PieRadarChartViewBase: ChartViewBase
         }
     }
     
-    /// - returns: The distance between two points
+    /// - Returns: The distance between two points
     private func distance(eventX: CGFloat, startX: CGFloat, eventY: CGFloat, startY: CGFloat) -> CGFloat
     {
         let dx = eventX - startX
@@ -799,7 +799,7 @@ open class PieRadarChartViewBase: ChartViewBase
         return sqrt(dx * dx + dy * dy)
     }
     
-    /// - returns: The distance between two points
+    /// - Returns: The distance between two points
     private func distance(from: CGPoint, to: CGPoint) -> CGFloat
     {
         let dx = from.x - to.x
diff --git a/Source/Charts/Components/AxisBase.swift b/Source/Charts/Components/AxisBase.swift
index 9c1662fb0f..41da2139af 100644
--- a/Source/Charts/Components/AxisBase.swift
+++ b/Source/Charts/Components/AxisBase.swift
@@ -143,7 +143,7 @@ open class AxisBase: ComponentBase
         return longest
     }
     
-    /// - returns: The formatted label at the specified index. This will either use the auto-formatter or the custom formatter (if one is set).
+    /// - Returns: The formatted label at the specified index. This will either use the auto-formatter or the custom formatter (if one is set).
     @objc open func getFormattedLabel(_ index: Int) -> String
     {
         if index < 0 || index >= entries.count
diff --git a/Source/Charts/Components/IMarker.swift b/Source/Charts/Components/IMarker.swift
index 51ac3c8cbc..a4b7526098 100644
--- a/Source/Charts/Components/IMarker.swift
+++ b/Source/Charts/Components/IMarker.swift
@@ -15,14 +15,14 @@ import CoreGraphics
 @objc(IChartMarker)
 public protocol IMarker: class
 {
-    /// - returns: The desired (general) offset you wish the IMarker to have on the x-axis.
+    /// - Returns: The desired (general) offset you wish the IMarker to have on the x-axis.
     /// By returning x: -(width / 2) you will center the IMarker horizontally.
     /// By returning y: -(height / 2) you will center the IMarker vertically.
     var offset: CGPoint { get }
     
     /// - Parameters:
     ///   - point: This is the point at which the marker wants to be drawn. You can adjust the offset conditionally based on this argument.
-    /// - returns: The offset for drawing at the specific `point`.
+    /// - Returns: The offset for drawing at the specific `point`.
     ///            This allows conditional adjusting of the Marker position.
     ///            If you have no adjustments to make, return self.offset().
     func offsetForDrawing(atPoint: CGPoint) -> CGPoint
diff --git a/Source/Charts/Components/XAxis.swift b/Source/Charts/Components/XAxis.swift
index 6078bb4e10..77dbbd6974 100644
--- a/Source/Charts/Components/XAxis.swift
+++ b/Source/Charts/Components/XAxis.swift
@@ -49,7 +49,7 @@ open class XAxis: AxisBase
     /// if set to true, word wrapping the labels will be enabled.
     /// word wrapping is done using `(value width * labelRotatedWidth)`
     ///
-    /// - note: currently supports all charts except pie/radar/horizontal-bar*
+    /// - Note: currently supports all charts except pie/radar/horizontal-bar*
     @objc open var wordWrapEnabled = false
     
     /// `true` if word wrapping the labels is enabled
diff --git a/Source/Charts/Data/Implementations/ChartBaseDataSet.swift b/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
index 88462dd92b..64f9492a39 100644
--- a/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
+++ b/Source/Charts/Data/Implementations/ChartBaseDataSet.swift
@@ -198,7 +198,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     /// The axis this DataSet should be plotted against.
     open var axisDependency = YAxis.AxisDependency.left
     
-    /// - returns: The color at the given index of the DataSet's color array.
+    /// - Returns: The color at the given index of the DataSet's color array.
     /// This prevents out-of-bounds by performing a modulus on the color index, so colours will repeat themselves.
     open func color(atIndex index: Int) -> NSUIColor
     {
@@ -323,7 +323,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
         }
     }
     
-    /// - returns: The color at the specified index that is used for drawing the values inside the chart. Uses modulus internally.
+    /// - Returns: The color at the specified index that is used for drawing the values inside the chart. Uses modulus internally.
     open func valueTextColorAt(_ index: Int) -> NSUIColor
     {
         var index = index
@@ -364,7 +364,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
     
     /// Set this to true to draw y-values on the chart.
     ///
-    /// - note: For bar and line charts: if `maxVisibleCount` is reached, no values will be drawn even if this is enabled.
+    /// - Note: For bar and line charts: if `maxVisibleCount` is reached, no values will be drawn even if this is enabled.
     open var drawValuesEnabled = true
     
     /// `true` if y-value drawing is enabled, `false` ifnot
@@ -375,7 +375,7 @@ open class ChartBaseDataSet: NSObject, IChartDataSet
 
     /// Set this to true to draw y-icons on the chart.
     ///
-    /// - note: For bar and line charts: if `maxVisibleCount` is reached, no icons will be drawn even if this is enabled.
+    /// - Note: For bar and line charts: if `maxVisibleCount` is reached, no icons will be drawn even if this is enabled.
     open var drawIconsEnabled = true
     
     /// Returns true if y-icon drawing is enabled, false if not
diff --git a/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
index c21fe777de..410e1c2361 100644
--- a/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
@@ -152,7 +152,7 @@ open class BarChartDataEntry: ChartDataEntry
     /// Splits up the stack-values of the given bar-entry into Range objects.
     /// - Parameters:
     ///   - entry:
-    /// - returns:
+    /// - Returns:
     @objc open func calcRanges()
     {
         let values = yValues
@@ -231,7 +231,7 @@ open class BarChartDataEntry: ChartDataEntry
     ///
     /// - Parameters:
     ///   - vals:
-    /// - returns:
+    /// - Returns:
     private static func calcSum(values: [Double]?) -> Double
     {
         guard let values = values
diff --git a/Source/Charts/Data/Implementations/Standard/ChartData.swift b/Source/Charts/Data/Implementations/Standard/ChartData.swift
index f015f03fcb..065cded398 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartData.swift
@@ -350,7 +350,7 @@ open class ChartData: NSObject
     ///   - dataSets: the DataSet array to search
     ///   - type:
     ///   - ignorecase: if true, the search is not case-sensitive
-    /// - returns: The index of the DataSet Object with the given label. Sensitive or not.
+    /// - Returns: The index of the DataSet Object with the given label. Sensitive or not.
     internal func getDataSetIndexByLabel(_ label: String, ignorecase: Bool) -> Int
     {
         if ignorecase
@@ -381,7 +381,7 @@ open class ChartData: NSObject
         return -1
     }
     
-    /// - returns: The labels of all DataSets as a string array.
+    /// - Returns: The labels of all DataSets as a string array.
     internal func dataSetLabels() -> [String]
     {
         var types = [String]()
@@ -403,7 +403,7 @@ open class ChartData: NSObject
     ///
     /// - Parameters:
     ///   - highlight:
-    /// - returns: The entry that is highlighted
+    /// - Returns: The entry that is highlighted
     @objc open func entryForHighlight(_ highlight: Highlight) -> ChartDataEntry?
     {
         if highlight.dataSetIndex >= dataSets.count
@@ -421,7 +421,7 @@ open class ChartData: NSObject
     /// - Parameters:
     ///   - label:
     ///   - ignorecase:
-    /// - returns: The DataSet Object with the given label. Sensitive or not.
+    /// - Returns: The DataSet Object with the given label. Sensitive or not.
     @objc open func getDataSetByLabel(_ label: String, ignorecase: Bool) -> IChartDataSet?
     {
         let index = getDataSetIndexByLabel(label, ignorecase: ignorecase)
@@ -456,7 +456,7 @@ open class ChartData: NSObject
     /// Removes the given DataSet from this data object.
     /// Also recalculates all minimum and maximum values.
     ///
-    /// - returns: `true` if a DataSet was removed, `false` ifno DataSet could be removed.
+    /// - Returns: `true` if a DataSet was removed, `false` ifno DataSet could be removed.
     @objc @discardableResult open func removeDataSet(_ dataSet: IChartDataSet!) -> Bool
     {
         if dataSet === nil
@@ -478,7 +478,7 @@ open class ChartData: NSObject
     /// Removes the DataSet at the given index in the DataSet array from the data object. 
     /// Also recalculates all minimum and maximum values. 
     ///
-    /// - returns: `true` if a DataSet was removed, `false` ifno DataSet could be removed.
+    /// - Returns: `true` if a DataSet was removed, `false` ifno DataSet could be removed.
     @objc @discardableResult open func removeDataSetByIndex(_ index: Int) -> Bool
     {
         if index >= _dataSets.count || index < 0
@@ -533,7 +533,7 @@ open class ChartData: NSObject
     /// Removes the Entry object closest to the given xIndex from the ChartDataSet at the
     /// specified index. 
     ///
-    /// - returns: `true` if an entry was removed, `false` ifno Entry was found that meets the specified requirements.
+    /// - Returns: `true` if an entry was removed, `false` ifno Entry was found that meets the specified requirements.
     @objc @discardableResult open func removeEntry(xValue: Double, dataSetIndex: Int) -> Bool
     {
         if dataSetIndex >= _dataSets.count
@@ -549,7 +549,7 @@ open class ChartData: NSObject
         return false
     }
     
-    /// - returns: The DataSet that contains the provided Entry, or null, if no DataSet contains this entry.
+    /// - Returns: The DataSet that contains the provided Entry, or null, if no DataSet contains this entry.
     @objc open func getDataSetForEntry(_ e: ChartDataEntry!) -> IChartDataSet?
     {
         if e == nil
@@ -570,7 +570,7 @@ open class ChartData: NSObject
         return nil
     }
 
-    /// - returns: The index of the provided DataSet in the DataSet array of this data object, or -1 if it does not exist.
+    /// - Returns: The index of the provided DataSet in the DataSet array of this data object, or -1 if it does not exist.
     @objc open func indexOfDataSet(_ dataSet: IChartDataSet) -> Int
     {
         for i in 0 ..< _dataSets.count
@@ -584,7 +584,7 @@ open class ChartData: NSObject
         return -1
     }
     
-    /// - returns: The first DataSet from the datasets-array that has it's dependency on the left axis. Returns null if no DataSet with left dependency could be found.
+    /// - Returns: The first DataSet from the datasets-array that has it's dependency on the left axis. Returns null if no DataSet with left dependency could be found.
     @objc open func getFirstLeft(dataSets: [IChartDataSet]) -> IChartDataSet?
     {
         for dataSet in dataSets
@@ -598,7 +598,7 @@ open class ChartData: NSObject
         return nil
     }
     
-    /// - returns: The first DataSet from the datasets-array that has it's dependency on the right axis. Returns null if no DataSet with right dependency could be found.
+    /// - Returns: The first DataSet from the datasets-array that has it's dependency on the right axis. Returns null if no DataSet with right dependency could be found.
     @objc open func getFirstRight(dataSets: [IChartDataSet]) -> IChartDataSet?
     {
         for dataSet in _dataSets
@@ -612,7 +612,7 @@ open class ChartData: NSObject
         return nil
     }
     
-    /// - returns: All colors used across all DataSet objects this object represents.
+    /// - Returns: All colors used across all DataSet objects this object represents.
     @objc open func getColors() -> [NSUIColor]?
     {
         var clrcnt = 0
@@ -714,7 +714,7 @@ open class ChartData: NSObject
     
     /// Checks if this data object contains the specified DataSet. 
     ///
-    /// - returns: `true` if so, `false` ifnot.
+    /// - Returns: `true` if so, `false` ifnot.
     @objc open func contains(dataSet: IChartDataSet) -> Bool
     {
         for set in dataSets
diff --git a/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift b/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
index 553b7103bf..bd3631579c 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
@@ -56,8 +56,8 @@ open class ChartDataSet: ChartBaseDataSet
 
     /// *
     ///
-    /// - note: Calls `notifyDataSetChanged()` after setting a new value.
-    /// - returns: The array of y-values that this DataSet represents.
+    /// - Note: Calls `notifyDataSetChanged()` after setting a new value.
+    /// - Returns: The array of y-values that this DataSet represents.
     /// the entries that this dataset represents / holds together
     @objc open var values: [ChartDataEntry]
         {
@@ -164,9 +164,9 @@ open class ChartDataSet: ChartBaseDataSet
     /// The number of y-values this DataSet represents
     open override var entryCount: Int { return values.count }
     
-    /// - throws: out of bounds
+    /// - Throws: out of bounds
     /// if `i` is out of bounds, it may throw an out-of-bounds exception
-    /// - returns: The entry object found at the given index (not x-value!)
+    /// - Returns: The entry object found at the given index (not x-value!)
     open override func entryForIndex(_ i: Int) -> ChartDataEntry?
     {
         guard i >= values.startIndex, i < values.endIndex else {
@@ -179,7 +179,7 @@ open class ChartDataSet: ChartBaseDataSet
     ///   - xValue: the x-value
     ///   - closestToY: If there are multiple y-values for the specified x-value,
     ///   - rounding: determine whether to round up/down/closest if there is no Entry matching the provided x-value
-    /// - returns: The first Entry object found at the given x-value with binary search.
+    /// - Returns: The first Entry object found at the given x-value with binary search.
     /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value according to the rounding.
     /// nil if no Entry object at that x-value.
     open override func entryForXValue(
@@ -198,7 +198,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// - Parameters:
     ///   - xValue: the x-value
     ///   - closestToY: If there are multiple y-values for the specified x-value,
-    /// - returns: The first Entry object found at the given x-value with binary search.
+    /// - Returns: The first Entry object found at the given x-value with binary search.
     /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value.
     /// nil if no Entry object at that x-value.
     open override func entryForXValue(
@@ -208,7 +208,7 @@ open class ChartDataSet: ChartBaseDataSet
         return entryForXValue(xValue, closestToY: yValue, rounding: .closest)
     }
     
-    /// - returns: All Entry objects found at the given xIndex with binary search.
+    /// - Returns: All Entry objects found at the given xIndex with binary search.
     /// An empty array if no Entry object at that index.
     open override func entriesForXValue(_ xValue: Double) -> [ChartDataEntry]
     {
@@ -270,7 +270,7 @@ open class ChartDataSet: ChartBaseDataSet
     ///   - xValue: x-value of the entry to search for
     ///   - closestToY: If there are multiple y-values for the specified x-value,
     ///   - rounding: Rounding method if exact value was not found
-    /// - returns: The array-index of the specified entry.
+    /// - Returns: The array-index of the specified entry.
     /// If the no Entry at the specified x-value is found, this method returns the index of the Entry at the closest x-value according to the rounding.
     open override func entryIndex(
         x xValue: Double,
@@ -376,7 +376,7 @@ open class ChartDataSet: ChartBaseDataSet
     
     /// - Parameters:
     ///   - e: the entry to search for
-    /// - returns: The array-index of the specified entry
+    /// - Returns: The array-index of the specified entry
     open override func entryIndex(entry e: ChartDataEntry) -> Int
     {
         for i in 0 ..< values.count
@@ -395,7 +395,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// This will also recalculate the current minimum and maximum values of the DataSet and the value-sum.
     /// - Parameters:
     ///   - e: the entry to add
-    /// - returns: True
+    /// - Returns: True
     open override func addEntry(_ e: ChartDataEntry) -> Bool
     {
         calcMinMax(entry: e)
@@ -411,7 +411,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// This will also recalculate the current minimum and maximum values of the DataSet and the value-sum.
     /// - Parameters:
     ///   - e: the entry to add
-    /// - returns: True
+    /// - Returns: True
     open override func addEntryOrdered(_ e: ChartDataEntry) -> Bool
     {
         calcMinMax(entry: e)
@@ -438,7 +438,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// This will also recalculate the current minimum and maximum values of the DataSet and the value-sum.
     /// - Parameters:
     ///   - entry: the entry to remove
-    /// - returns: `true` if the entry was removed successfully, else if the entry does not exist
+    /// - Returns: `true` if the entry was removed successfully, else if the entry does not exist
     open override func removeEntry(_ entry: ChartDataEntry) -> Bool
     {
         var removed = false
@@ -461,7 +461,7 @@ open class ChartDataSet: ChartBaseDataSet
     
     /// Removes the first Entry (at index 0) of this DataSet from the entries array.
     ///
-    /// - returns: `true` if successful, `false` if not.
+    /// - Returns: `true` if successful, `false` if not.
     open override func removeFirst() -> Bool
     {
         let entry: ChartDataEntry? = values.isEmpty ? nil : values.removeFirst()
@@ -470,7 +470,7 @@ open class ChartDataSet: ChartBaseDataSet
     
     /// Removes the last Entry (at index size-1) of this DataSet from the entries array.
     ///
-    /// - returns: `true` if successful, `false` if not.
+    /// - Returns: `true` if successful, `false` if not.
     open override func removeLast() -> Bool
     {
         let entry: ChartDataEntry? = values.isEmpty ? nil : values.removeLast()
@@ -479,7 +479,7 @@ open class ChartDataSet: ChartBaseDataSet
     
     /// Checks if this DataSet contains the specified Entry.
     ///
-    /// - returns: `true` if contains the entry, `false` if not.
+    /// - Returns: `true` if contains the entry, `false` if not.
     open override func contains(_ e: ChartDataEntry) -> Bool
     {
         for entry in values
diff --git a/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift b/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift
index e1a616dcdd..32c78e6578 100644
--- a/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/CombinedChartData.swift
@@ -271,7 +271,7 @@ open class CombinedChartData: BarLineScatterCandleBubbleChartData
     ///
     /// - Parameters:
     ///   - highlight:
-    /// - returns: The entry that is highlighted
+    /// - Returns: The entry that is highlighted
     open override func entryForHighlight(_ highlight: Highlight) -> ChartDataEntry?
     {
         if highlight.dataIndex >= allData.count
diff --git a/Source/Charts/Data/Implementations/Standard/LineChartDataSet.swift b/Source/Charts/Data/Implementations/Standard/LineChartDataSet.swift
index d0cde4ff91..445444e2ab 100644
--- a/Source/Charts/Data/Implementations/Standard/LineChartDataSet.swift
+++ b/Source/Charts/Data/Implementations/Standard/LineChartDataSet.swift
@@ -76,7 +76,7 @@ open class LineChartDataSet: LineRadarChartDataSet, ILineChartDataSet
     
     open var circleColors = [NSUIColor]()
     
-    /// - returns: The color at the given index of the DataSet's circle-color array.
+    /// - Returns: The color at the given index of the DataSet's circle-color array.
     /// Performs a IndexOutOfBounds check by modulus.
     open func getCircleColor(atIndex index: Int) -> NSUIColor?
     {
diff --git a/Source/Charts/Data/Implementations/Standard/PieChartData.swift b/Source/Charts/Data/Implementations/Standard/PieChartData.swift
index 158c3e723f..ce6e4b6810 100644
--- a/Source/Charts/Data/Implementations/Standard/PieChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/PieChartData.swift
@@ -102,7 +102,7 @@ open class PieChartData: ChartData
     /// Removes the DataSet at the given index in the DataSet array from the data object.
     /// Also recalculates all minimum and maximum values.
     ///
-    /// - returns: `true` if a DataSet was removed, `false` ifno DataSet could be removed.
+    /// - Returns: `true` if a DataSet was removed, `false` ifno DataSet could be removed.
     open override func removeDataSetByIndex(_ index: Int) -> Bool
     {
         if index >= _dataSets.count || index < 0
diff --git a/Source/Charts/Data/Implementations/Standard/ScatterChartData.swift b/Source/Charts/Data/Implementations/Standard/ScatterChartData.swift
index ff8ccaf93e..58ee4929d1 100644
--- a/Source/Charts/Data/Implementations/Standard/ScatterChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/ScatterChartData.swift
@@ -24,7 +24,7 @@ open class ScatterChartData: BarLineScatterCandleBubbleChartData
         super.init(dataSets: dataSets)
     }
     
-    /// - returns: The maximum shape-size across all DataSets.
+    /// - Returns: The maximum shape-size across all DataSets.
     @objc open func getGreatestShapeSize() -> CGFloat
     {
         var max = CGFloat(0.0)
diff --git a/Source/Charts/Data/Interfaces/IChartDataSet.swift b/Source/Charts/Data/Interfaces/IChartDataSet.swift
index 97f95be203..849da103b7 100644
--- a/Source/Charts/Data/Interfaces/IChartDataSet.swift
+++ b/Source/Charts/Data/Interfaces/IChartDataSet.swift
@@ -42,16 +42,16 @@ public protocol IChartDataSet
     /// The number of y-values this DataSet represents
     var entryCount: Int { get }
     
-    /// - throws: out of bounds
+    /// - Throws: out of bounds
     /// if `i` is out of bounds, it may throw an out-of-bounds exception
-    /// - returns: The entry object found at the given index (not x-value!)
+    /// - Returns: The entry object found at the given index (not x-value!)
     func entryForIndex(_ i: Int) -> ChartDataEntry?
     
     /// - Parameters:
     ///   - xValue: the x-value
     ///   - closestToY: If there are multiple y-values for the specified x-value,
     ///   - rounding: determine whether to round up/down/closest if there is no Entry matching the provided x-value
-    /// - returns: The first Entry object found at the given x-value with binary search.
+    /// - Returns: The first Entry object found at the given x-value with binary search.
     /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value according to the rounding.
     /// nil if no Entry object at that x-value.
     func entryForXValue(
@@ -62,14 +62,14 @@ public protocol IChartDataSet
     /// - Parameters:
     ///   - xValue: the x-value
     ///   - closestToY: If there are multiple y-values for the specified x-value,
-    /// - returns: The first Entry object found at the given x-value with binary search.
+    /// - Returns: The first Entry object found at the given x-value with binary search.
     /// If the no Entry at the specified x-value is found, this method returns the Entry at the closest x-value.
     /// nil if no Entry object at that x-value.
     func entryForXValue(
         _ xValue: Double,
         closestToY yValue: Double) -> ChartDataEntry?
     
-    /// - returns: All Entry objects found at the given x-value with binary search.
+    /// - Returns: All Entry objects found at the given x-value with binary search.
     /// An empty array if no Entry object at that x-value.
     func entriesForXValue(_ xValue: Double) -> [ChartDataEntry]
     
@@ -77,7 +77,7 @@ public protocol IChartDataSet
     ///   - xValue: x-value of the entry to search for
     ///   - closestToY: If there are multiple y-values for the specified x-value,
     ///   - rounding: Rounding method if exact value was not found
-    /// - returns: The array-index of the specified entry.
+    /// - Returns: The array-index of the specified entry.
     /// If the no Entry at the specified x-value is found, this method returns the index of the Entry at the closest x-value according to the rounding.
     func entryIndex(
         x xValue: Double,
@@ -86,7 +86,7 @@ public protocol IChartDataSet
     
     /// - Parameters:
     ///   - e: the entry to search for
-    /// - returns: The array-index of the specified entry
+    /// - Returns: The array-index of the specified entry
     func entryIndex(entry e: ChartDataEntry) -> Int
     
     /// Adds an Entry to the DataSet dynamically.
@@ -97,7 +97,7 @@ public protocol IChartDataSet
     ///
     /// - Parameters:
     ///   - e: the entry to add
-    /// - returns: `true` if the entry was added successfully, `false` ifthis feature is not supported
+    /// - Returns: `true` if the entry was added successfully, `false` ifthis feature is not supported
     func addEntry(_ e: ChartDataEntry) -> Bool
     
     /// Adds an Entry to the DataSet dynamically.
@@ -110,7 +110,7 @@ public protocol IChartDataSet
     ///
     /// - Parameters:
     ///   - e: the entry to add
-    /// - returns: `true` if the entry was added successfully, `false` ifthis feature is not supported
+    /// - Returns: `true` if the entry was added successfully, `false` ifthis feature is not supported
     func addEntryOrdered(_ e: ChartDataEntry) -> Bool
     
     /// Removes an Entry from the DataSet dynamically.
@@ -119,7 +119,7 @@ public protocol IChartDataSet
     ///
     /// - Parameters:
     ///   - entry: the entry to remove
-    /// - returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
+    /// - Returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
     func removeEntry(_ entry: ChartDataEntry) -> Bool
     
     /// Removes the Entry object at the given index in the values array from the DataSet.
@@ -128,7 +128,7 @@ public protocol IChartDataSet
     ///
     /// - Parameters:
     ///   - index: the index of the entry to remove
-    /// - returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
+    /// - Returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
     func removeEntry(index: Int) -> Bool
     
     /// Removes the Entry object closest to the given x-value from the DataSet.
@@ -137,26 +137,26 @@ public protocol IChartDataSet
     ///
     /// - Parameters:
     ///   - x: the x-value to remove
-    /// - returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
+    /// - Returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
     func removeEntry(x: Double) -> Bool
     
     /// Removes the first Entry (at index 0) of this DataSet from the entries array.
     ///
     /// *optional feature, can return `false` ifnot implemented*
     ///
-    /// - returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
+    /// - Returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
     func removeFirst() -> Bool
     
     /// Removes the last Entry (at index 0) of this DataSet from the entries array.
     ///
     /// *optional feature, can return `false` ifnot implemented*
     ///
-    /// - returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
+    /// - Returns: `true` if the entry was removed successfully, `false` ifthe entry does not exist or if this feature is not supported
     func removeLast() -> Bool
     
     /// Checks if this DataSet contains the specified Entry.
     ///
-    /// - returns: `true` if contains the entry, `false` ifnot.
+    /// - Returns: `true` if contains the entry, `false` ifnot.
     func contains(_ e: ChartDataEntry) -> Bool
     
     /// Removes all values from this DataSet and does all necessary recalculations.
@@ -179,7 +179,7 @@ public protocol IChartDataSet
     /// Colors are reused as soon as the number of Entries the DataSet represents is higher than the size of the colors array.
     var colors: [NSUIColor] { get }
     
-    /// - returns: The color at the given index of the DataSet's color array.
+    /// - Returns: The color at the given index of the DataSet's color array.
     /// This prevents out-of-bounds by performing a modulus on the color index, so colours will repeat themselves.
     func color(atIndex: Int) -> NSUIColor
     
@@ -206,7 +206,7 @@ public protocol IChartDataSet
     /// Getting will return the first color in the array.
     var valueTextColor: NSUIColor { get set }
     
-    /// - returns: The color at the specified index that is used for drawing the values inside the chart. Uses modulus internally.
+    /// - Returns: The color at the specified index that is used for drawing the values inside the chart. Uses modulus internally.
     func valueTextColorAt(_ index: Int) -> NSUIColor
     
     /// the font for the value-text labels
@@ -241,7 +241,7 @@ public protocol IChartDataSet
     
     /// Set this to true to draw y-values on the chart.
     ///
-    /// - note: For bar and line charts: if `maxVisibleCount` is reached, no values will be drawn even if this is enabled.
+    /// - Note: For bar and line charts: if `maxVisibleCount` is reached, no values will be drawn even if this is enabled.
     var drawValuesEnabled: Bool { get set }
     
     /// `true` if y-value drawing is enabled, `false` ifnot
@@ -249,7 +249,7 @@ public protocol IChartDataSet
     
     /// Set this to true to draw y-icons on the chart
     ///
-    /// - note: For bar and line charts: if `maxVisibleCount` is reached, no icons will be drawn even if this is enabled.
+    /// - Note: For bar and line charts: if `maxVisibleCount` is reached, no icons will be drawn even if this is enabled.
     var drawIconsEnabled: Bool { get set }
     
     /// Returns true if y-icon drawing is enabled, false if not
diff --git a/Source/Charts/Data/Interfaces/ILineChartDataSet.swift b/Source/Charts/Data/Interfaces/ILineChartDataSet.swift
index 6541b65517..071f269535 100644
--- a/Source/Charts/Data/Interfaces/ILineChartDataSet.swift
+++ b/Source/Charts/Data/Interfaces/ILineChartDataSet.swift
@@ -38,7 +38,7 @@ public protocol ILineChartDataSet: ILineRadarChartDataSet
     
     var circleColors: [NSUIColor] { get set }
     
-    /// - returns: The color at the given index of the DataSet's circle-color array.
+    /// - Returns: The color at the given index of the DataSet's circle-color array.
     /// Performs a IndexOutOfBounds check by modulus.
     func getCircleColor(atIndex: Int) -> NSUIColor?
     
diff --git a/Source/Charts/Data/Interfaces/ILineRadarChartDataSet.swift b/Source/Charts/Data/Interfaces/ILineRadarChartDataSet.swift
index d67e84a25a..d9f8980b47 100644
--- a/Source/Charts/Data/Interfaces/ILineRadarChartDataSet.swift
+++ b/Source/Charts/Data/Interfaces/ILineRadarChartDataSet.swift
@@ -22,7 +22,7 @@ public protocol ILineRadarChartDataSet: ILineScatterCandleRadarChartDataSet
     /// The color that is used for filling the line surface area.
     var fillColor: NSUIColor { get set }
 
-    /// - returns: The object that is used for filling the area below the line.
+    /// - Returns: The object that is used for filling the area below the line.
     /// **default**: nil
     var fill: Fill? { get set }
     
diff --git a/Source/Charts/Data/Interfaces/IScatterChartDataSet.swift b/Source/Charts/Data/Interfaces/IScatterChartDataSet.swift
index ddea9e80b6..0565146725 100644
--- a/Source/Charts/Data/Interfaces/IScatterChartDataSet.swift
+++ b/Source/Charts/Data/Interfaces/IScatterChartDataSet.swift
@@ -22,12 +22,12 @@ public protocol IScatterChartDataSet: ILineScatterCandleRadarChartDataSet
     /// The size the scatter shape will have
     var scatterShapeSize: CGFloat { get }
     
-    /// - returns: The radius of the hole in the shape (applies to Square, Circle and Triangle)
+    /// - Returns: The radius of the hole in the shape (applies to Square, Circle and Triangle)
     /// Set this to <= 0 to remove holes.
     /// **default**: 0.0
     var scatterShapeHoleRadius: CGFloat { get }
     
-    /// - returns: Color for the hole in the shape. Setting to `nil` will behave as transparent.
+    /// - Returns: Color for the hole in the shape. Setting to `nil` will behave as transparent.
     /// **default**: nil
     var scatterShapeHoleColor: NSUIColor? { get }
     
diff --git a/Source/Charts/Formatters/IAxisValueFormatter.swift b/Source/Charts/Formatters/IAxisValueFormatter.swift
index af064f8e5b..302eee18f8 100644
--- a/Source/Charts/Formatters/IAxisValueFormatter.swift
+++ b/Source/Charts/Formatters/IAxisValueFormatter.swift
@@ -23,7 +23,7 @@ public protocol IAxisValueFormatter: class
     /// - Parameters:
     ///   - value:           the value that is currently being drawn
     ///   - axis:            the axis that the value belongs to
-    /// - returns: The customized label that is drawn on the x-axis.
+    /// - Returns: The customized label that is drawn on the x-axis.
     func stringForValue(_ value: Double,
                         axis: AxisBase?) -> String
     
diff --git a/Source/Charts/Formatters/IFillFormatter.swift b/Source/Charts/Formatters/IFillFormatter.swift
index 8a88500299..7b684fd84e 100644
--- a/Source/Charts/Formatters/IFillFormatter.swift
+++ b/Source/Charts/Formatters/IFillFormatter.swift
@@ -16,6 +16,6 @@ import CoreGraphics
 @objc(IChartFillFormatter)
 public protocol IFillFormatter
 {
-    /// - returns: The vertical (y-axis) position where the filled-line of the LineDataSet should end.
+    /// - Returns: The vertical (y-axis) position where the filled-line of the LineDataSet should end.
     func getFillLinePosition(dataSet: ILineChartDataSet, dataProvider: LineChartDataProvider) -> CGFloat
 }
diff --git a/Source/Charts/Formatters/IValueFormatter.swift b/Source/Charts/Formatters/IValueFormatter.swift
index a8a32b3f3f..53ca7a40c2 100644
--- a/Source/Charts/Formatters/IValueFormatter.swift
+++ b/Source/Charts/Formatters/IValueFormatter.swift
@@ -28,7 +28,7 @@ public protocol IValueFormatter: class
     ///   - value:           The value to be formatted
     ///   - dataSetIndex:    The index of the DataSet the entry in focus belongs to
     ///   - viewPortHandler: provides information about the current chart state (scale, translation, ...)
-    /// - returns:                   The formatted label ready to be drawn
+    /// - Returns:                   The formatted label ready to be drawn
     func stringForValue(_ value: Double,
                         entry: ChartDataEntry,
                         dataSetIndex: Int,
diff --git a/Source/Charts/Highlight/BarHighlighter.swift b/Source/Charts/Highlight/BarHighlighter.swift
index 3a4fcd982a..7ab486330e 100644
--- a/Source/Charts/Highlight/BarHighlighter.swift
+++ b/Source/Charts/Highlight/BarHighlighter.swift
@@ -55,7 +55,7 @@ open class BarHighlighter: ChartHighlighter
     ///   - set:
     ///   - xIndex:
     ///   - yValue:
-    /// - returns:
+    /// - Returns:
     @objc open func getStackedHighlight(high: Highlight,
                                   set: IBarChartDataSet,
                                   xValue: Double,
@@ -94,8 +94,8 @@ open class BarHighlighter: ChartHighlighter
     /// - Parameters:
     ///   - entry:
     ///   - value:
-    /// - returns:
-    /// - returns: The index of the closest value inside the values array / ranges (stacked barchart) to the value given as a parameter.
+    /// - Returns:
+    /// - Returns: The index of the closest value inside the values array / ranges (stacked barchart) to the value given as a parameter.
     @objc open func getClosestStackIndex(ranges: [Range]?, value: Double) -> Int
     {
         guard let ranges = ranges else { return 0 }
diff --git a/Source/Charts/Highlight/ChartHighlighter.swift b/Source/Charts/Highlight/ChartHighlighter.swift
index bf5cea7ac1..7beeece4be 100644
--- a/Source/Charts/Highlight/ChartHighlighter.swift
+++ b/Source/Charts/Highlight/ChartHighlighter.swift
@@ -30,8 +30,8 @@ open class ChartHighlighter : NSObject, IHighlighter
     
     /// - Parameters:
     ///   - x:
-    /// - returns:
-    /// - returns: The corresponding x-pos for a given touch-position in pixels.
+    /// - Returns:
+    /// - Returns: The corresponding x-pos for a given touch-position in pixels.
     @objc open func getValsForTouch(x: CGFloat, y: CGFloat) -> CGPoint
     {
         guard let chart = self.chart as? BarLineScatterCandleBubbleChartDataProvider else { return .zero }
@@ -44,8 +44,8 @@ open class ChartHighlighter : NSObject, IHighlighter
     ///   - xValue:
     ///   - x:
     ///   - y:
-    /// - returns:
-    /// - returns: The corresponding ChartHighlight for a given x-value and xy-touch position in pixels.
+    /// - Returns:
+    /// - Returns: The corresponding ChartHighlight for a given x-value and xy-touch position in pixels.
     @objc open func getHighlight(xValue xVal: Double, x: CGFloat, y: CGFloat) -> Highlight?
     {
         guard let chart = chart else { return nil }
@@ -67,8 +67,8 @@ open class ChartHighlighter : NSObject, IHighlighter
     ///   - xValue: the transformed x-value of the x-touch position
     ///   - x: touch position
     ///   - y: touch position
-    /// - returns:
-    /// - returns: A list of Highlight objects representing the entries closest to the given xVal.
+    /// - Returns:
+    /// - Returns: A list of Highlight objects representing the entries closest to the given xVal.
     /// The returned list contains two objects per DataSet (closest rounding up, closest rounding down).
     @objc open func getHighlights(xValue: Double, x: CGFloat, y: CGFloat) -> [Highlight]
     {
@@ -92,7 +92,7 @@ open class ChartHighlighter : NSObject, IHighlighter
         return vals
     }
     
-    /// - returns: An array of `Highlight` objects corresponding to the selected xValue and dataSetIndex.
+    /// - Returns: An array of `Highlight` objects corresponding to the selected xValue and dataSetIndex.
     internal func buildHighlights(
         dataSet set: IChartDataSet,
         dataSetIndex: Int,
@@ -123,7 +123,7 @@ open class ChartHighlighter : NSObject, IHighlighter
 
     // - MARK: - Utilities
     
-    /// - returns: The `ChartHighlight` of the closest value on the x-y cartesian axes
+    /// - Returns: The `ChartHighlight` of the closest value on the x-y cartesian axes
     internal func closestSelectionDetailByPixel(
         closestValues: [Highlight],
         x: CGFloat,
@@ -151,7 +151,7 @@ open class ChartHighlighter : NSObject, IHighlighter
         return closest
     }
     
-    /// - returns: The minimum distance from a touch-y-value (in pixels) to the closest y-value (in pixels) that is displayed in the chart.
+    /// - Returns: The minimum distance from a touch-y-value (in pixels) to the closest y-value (in pixels) that is displayed in the chart.
     internal func getMinimumDistance(
         closestValues: [Highlight],
         y: CGFloat,
diff --git a/Source/Charts/Highlight/IHighlighter.swift b/Source/Charts/Highlight/IHighlighter.swift
index e87c0afdc5..30cb8b9327 100644
--- a/Source/Charts/Highlight/IHighlighter.swift
+++ b/Source/Charts/Highlight/IHighlighter.swift
@@ -18,7 +18,7 @@ public protocol IHighlighter: class
     /// - Parameters:
     ///   - x:
     ///   - y:
-    /// - returns:
-    /// - returns: A Highlight object corresponding to the given x- and y- touch positions in pixels.
+    /// - Returns:
+    /// - Returns: A Highlight object corresponding to the given x- and y- touch positions in pixels.
     func getHighlight(x: CGFloat, y: CGFloat) -> Highlight?
 }
diff --git a/Source/Charts/Highlight/PieRadarHighlighter.swift b/Source/Charts/Highlight/PieRadarHighlighter.swift
index 3d9af58003..c55988ab31 100644
--- a/Source/Charts/Highlight/PieRadarHighlighter.swift
+++ b/Source/Charts/Highlight/PieRadarHighlighter.swift
@@ -53,7 +53,7 @@ open class PieRadarHighlighter: ChartHighlighter
     ///   - index:
     ///   - x:
     ///   - y:
-    /// - returns: The closest Highlight object of the given objects based on the touch position inside the chart.
+    /// - Returns: The closest Highlight object of the given objects based on the touch position inside the chart.
     @objc open func closestHighlight(index: Int, x: CGFloat, y: CGFloat) -> Highlight?
     {
         fatalError("closestHighlight(index, x, y) cannot be called on PieRadarChartHighlighter")
diff --git a/Source/Charts/Highlight/RadarHighlighter.swift b/Source/Charts/Highlight/RadarHighlighter.swift
index 6506bbbac2..cfaf57aec9 100644
--- a/Source/Charts/Highlight/RadarHighlighter.swift
+++ b/Source/Charts/Highlight/RadarHighlighter.swift
@@ -41,7 +41,7 @@ open class RadarHighlighter: PieRadarHighlighter
     
     /// - Parameters:
     ///   - index:
-    /// - returns: An array of Highlight objects for the given index.
+    /// - Returns: An array of Highlight objects for the given index.
     /// The Highlight objects give information about the value at the selected index and DataSet it belongs to.
     internal func getHighlights(forIndex index: Int) -> [Highlight]
     {
diff --git a/Source/Charts/Highlight/Range.swift b/Source/Charts/Highlight/Range.swift
index 3eb4d9b637..4b7ead10fb 100644
--- a/Source/Charts/Highlight/Range.swift
+++ b/Source/Charts/Highlight/Range.swift
@@ -27,7 +27,7 @@ open class Range: NSObject
 
     /// - Parameters:
     ///   - value:
-    /// - returns: `true` if this range contains (if the value is in between) the given value, `false` ifnot.
+    /// - Returns: `true` if this range contains (if the value is in between) the given value, `false` ifnot.
     @objc open func contains(_ value: Double) -> Bool
     {
         if value > from && value <= to
diff --git a/Source/Charts/Renderers/BarLineScatterCandleBubbleRenderer.swift b/Source/Charts/Renderers/BarLineScatterCandleBubbleRenderer.swift
index 4ba1b5fac7..39acdb00ed 100644
--- a/Source/Charts/Renderers/BarLineScatterCandleBubbleRenderer.swift
+++ b/Source/Charts/Renderers/BarLineScatterCandleBubbleRenderer.swift
@@ -38,7 +38,7 @@ open class BarLineScatterCandleBubbleRenderer: DataRenderer
         return XBounds(chart: chart, dataSet: dataSet, animator: animator)
     }
     
-    /// - returns: `true` if the DataSet values should be drawn, `false` if not.
+    /// - Returns: `true` if the DataSet values should be drawn, `false` if not.
     internal func shouldDrawValues(forDataSet set: IChartDataSet) -> Bool
     {
         return set.isVisible && (set.isDrawValuesEnabled || set.isDrawIconsEnabled)
diff --git a/Source/Charts/Renderers/CombinedChartRenderer.swift b/Source/Charts/Renderers/CombinedChartRenderer.swift
index 5f36613fc0..0e2bb0d0b7 100644
--- a/Source/Charts/Renderers/CombinedChartRenderer.swift
+++ b/Source/Charts/Renderers/CombinedChartRenderer.swift
@@ -168,7 +168,7 @@ open class CombinedChartRenderer: DataRenderer
         }
     }
 
-    /// - returns: The sub-renderer object at the specified index.
+    /// - Returns: The sub-renderer object at the specified index.
     @objc open func getSubRenderer(index: Int) -> DataRenderer?
     {
         if index >= _renderers.count || index < 0
diff --git a/Source/Charts/Utils/ChartUtils.swift b/Source/Charts/Utils/ChartUtils.swift
index e18d93a20d..cd6b59455a 100644
--- a/Source/Charts/Utils/ChartUtils.swift
+++ b/Source/Charts/Utils/ChartUtils.swift
@@ -36,8 +36,8 @@ extension FloatingPoint
         return self * 180 / .pi
     }
 
-    /// - NOTE: Value must be in degrees
-    /// - returns: An angle between 0.0 < 360.0 (not less than zero, less than 360)
+    /// - Note: Value must be in degrees
+    /// - Returns: An angle between 0.0 < 360.0 (not less than zero, less than 360)
     var normalizedAngle: Self
     {
         let angle = truncatingRemainder(dividingBy: 360)
@@ -288,7 +288,7 @@ open class ChartUtils
         return formatter
     }
     
-    /// - returns: The default value formatter used for all chart components that needs a default
+    /// - Returns: The default value formatter used for all chart components that needs a default
     open class func defaultValueFormatter() -> IValueFormatter
     {
         return _defaultValueFormatter
diff --git a/Source/Charts/Utils/Platform+Accessibility.swift b/Source/Charts/Utils/Platform+Accessibility.swift
index 7bf2cf72b3..4f9338aafc 100644
--- a/Source/Charts/Utils/Platform+Accessibility.swift
+++ b/Source/Charts/Utils/Platform+Accessibility.swift
@@ -176,7 +176,7 @@ open class NSUIAccessibilityElement: NSAccessibilityElement
     }
 }
 
-/// - NOTE: setAccessibilityRole(.list) is called at init. See Platform.swift.
+/// - Note: setAccessibilityRole(.list) is called at init. See Platform.swift.
 extension NSUIView: NSAccessibilityGroup
 {
     open override func accessibilityLabel() -> String?
diff --git a/Source/Charts/Utils/Transformer.swift b/Source/Charts/Utils/Transformer.swift
index ca99fb2360..86f05ea909 100644
--- a/Source/Charts/Utils/Transformer.swift
+++ b/Source/Charts/Utils/Transformer.swift
@@ -150,7 +150,7 @@ open class Transformer: NSObject
         pixel = pixel.applying(pixelToValueMatrix)
     }
     
-    /// - returns: The x and y values in the chart at the given touch point
+    /// - Returns: The x and y values in the chart at the given touch point
     /// (encapsulated in a CGPoint). This method transforms pixel coordinates to
     /// coordinates / values in the chart.
     @objc open func valueForTouchPoint(_ point: CGPoint) -> CGPoint
@@ -158,7 +158,7 @@ open class Transformer: NSObject
         return point.applying(pixelToValueMatrix)
     }
     
-    /// - returns: The x and y values in the chart at the given touch point
+    /// - Returns: The x and y values in the chart at the given touch point
     /// (x/y). This method transforms pixel coordinates to
     /// coordinates / values in the chart.
     @objc open func valueForTouchPoint(x: CGFloat, y: CGFloat) -> CGPoint

From c68ed078e1ad40d14bb1c90ddb0dd9fdb688eedf Mon Sep 17 00:00:00 2001
From: Kem Chen <chenkem@gmail.com>
Date: Sun, 23 Sep 2018 00:11:31 +0800
Subject: [PATCH 07/10] fix function groupBars document error

---
 Source/Charts/Data/Implementations/Standard/BarChartData.swift | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Source/Charts/Data/Implementations/Standard/BarChartData.swift b/Source/Charts/Data/Implementations/Standard/BarChartData.swift
index f54e6995b3..6697c32cf2 100644
--- a/Source/Charts/Data/Implementations/Standard/BarChartData.swift
+++ b/Source/Charts/Data/Implementations/Standard/BarChartData.swift
@@ -33,8 +33,8 @@ open class BarChartData: BarLineScatterCandleBubbleChartData
     /// Previously set x-values of entries will be overwritten. Leaves space between bars and groups as specified by the parameters.
     /// Do not forget to call notifyDataSetChanged() on your BarChart object after calling this method.
     ///
-    /// - parameter the starting point on the x-axis where the grouping should begin
     /// - Parameters:
+    ///   - fromX: the starting point on the x-axis where the grouping should begin
     ///   - groupSpace: The space between groups of bars in values (not pixels) e.g. 0.8f for bar width 1f
     ///   - barSpace: The space between individual bars in values (not pixels) e.g. 0.1f for bar width 1f
     @objc open func groupBars(fromX: Double, groupSpace: Double, barSpace: Double)

From 033bb119aa3a95c2250adf4ac3839f79e49d22ad Mon Sep 17 00:00:00 2001
From: Kem Chen <chenkem@gmail.com>
Date: Sun, 23 Sep 2018 00:22:38 +0800
Subject: [PATCH 08/10] Remove duplicated section

---
 Source/Charts/Highlight/BarHighlighter.swift   | 1 -
 Source/Charts/Highlight/ChartHighlighter.swift | 3 ---
 Source/Charts/Highlight/IHighlighter.swift     | 1 -
 3 files changed, 5 deletions(-)

diff --git a/Source/Charts/Highlight/BarHighlighter.swift b/Source/Charts/Highlight/BarHighlighter.swift
index 7ab486330e..3500955ee5 100644
--- a/Source/Charts/Highlight/BarHighlighter.swift
+++ b/Source/Charts/Highlight/BarHighlighter.swift
@@ -94,7 +94,6 @@ open class BarHighlighter: ChartHighlighter
     /// - Parameters:
     ///   - entry:
     ///   - value:
-    /// - Returns:
     /// - Returns: The index of the closest value inside the values array / ranges (stacked barchart) to the value given as a parameter.
     @objc open func getClosestStackIndex(ranges: [Range]?, value: Double) -> Int
     {
diff --git a/Source/Charts/Highlight/ChartHighlighter.swift b/Source/Charts/Highlight/ChartHighlighter.swift
index 7beeece4be..6ce94a9b75 100644
--- a/Source/Charts/Highlight/ChartHighlighter.swift
+++ b/Source/Charts/Highlight/ChartHighlighter.swift
@@ -30,7 +30,6 @@ open class ChartHighlighter : NSObject, IHighlighter
     
     /// - Parameters:
     ///   - x:
-    /// - Returns:
     /// - Returns: The corresponding x-pos for a given touch-position in pixels.
     @objc open func getValsForTouch(x: CGFloat, y: CGFloat) -> CGPoint
     {
@@ -44,7 +43,6 @@ open class ChartHighlighter : NSObject, IHighlighter
     ///   - xValue:
     ///   - x:
     ///   - y:
-    /// - Returns:
     /// - Returns: The corresponding ChartHighlight for a given x-value and xy-touch position in pixels.
     @objc open func getHighlight(xValue xVal: Double, x: CGFloat, y: CGFloat) -> Highlight?
     {
@@ -67,7 +65,6 @@ open class ChartHighlighter : NSObject, IHighlighter
     ///   - xValue: the transformed x-value of the x-touch position
     ///   - x: touch position
     ///   - y: touch position
-    /// - Returns:
     /// - Returns: A list of Highlight objects representing the entries closest to the given xVal.
     /// The returned list contains two objects per DataSet (closest rounding up, closest rounding down).
     @objc open func getHighlights(xValue: Double, x: CGFloat, y: CGFloat) -> [Highlight]
diff --git a/Source/Charts/Highlight/IHighlighter.swift b/Source/Charts/Highlight/IHighlighter.swift
index 30cb8b9327..21ae298c34 100644
--- a/Source/Charts/Highlight/IHighlighter.swift
+++ b/Source/Charts/Highlight/IHighlighter.swift
@@ -18,7 +18,6 @@ public protocol IHighlighter: class
     /// - Parameters:
     ///   - x:
     ///   - y:
-    /// - Returns:
     /// - Returns: A Highlight object corresponding to the given x- and y- touch positions in pixels.
     func getHighlight(x: CGFloat, y: CGFloat) -> Highlight?
 }

From a4cae7189df3602d5cac5cb42f20a98e61413e02 Mon Sep 17 00:00:00 2001
From: Kem Chen <chenkem@gmail.com>
Date: Sun, 21 Oct 2018 20:12:46 +0800
Subject: [PATCH 09/10] Add missing empty line between Summary and other
 section manually

---
 Source/Charts/Charts/BarChartView.swift                        | 1 +
 Source/Charts/Charts/ChartViewBase.swift                       | 2 ++
 .../Data/Implementations/Standard/BarChartDataEntry.swift      | 1 +
 Source/Charts/Data/Implementations/Standard/ChartDataSet.swift | 3 +++
 4 files changed, 7 insertions(+)

diff --git a/Source/Charts/Charts/BarChartView.swift b/Source/Charts/Charts/BarChartView.swift
index c630340ecd..4f9aaa0bc9 100644
--- a/Source/Charts/Charts/BarChartView.swift
+++ b/Source/Charts/Charts/BarChartView.swift
@@ -129,6 +129,7 @@ open class BarChartView: BarLineChartViewBase, BarChartDataProvider
     }
     
     /// Highlights the value at the given x-value in the given DataSet. Provide -1 as the dataSetIndex to undo all highlighting.
+    ///
     /// - Parameters:
     ///   - x:
     ///   - dataSetIndex:
diff --git a/Source/Charts/Charts/ChartViewBase.swift b/Source/Charts/Charts/ChartViewBase.swift
index ab949aa1be..ef3a9b7a46 100644
--- a/Source/Charts/Charts/ChartViewBase.swift
+++ b/Source/Charts/Charts/ChartViewBase.swift
@@ -457,6 +457,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Highlights any y-value at the given x-value in the given DataSet.
     /// Provide -1 as the dataSetIndex to undo all highlighting.
+    ///
     /// - Parameters:
     ///   - x: The x-value to highlight
     ///   - dataSetIndex: The dataset index to search in
@@ -469,6 +470,7 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
     
     /// Highlights the value at the given x-value and y-value in the given DataSet.
     /// Provide -1 as the dataSetIndex to undo all highlighting.
+    ///
     /// - Parameters:
     ///   - x: The x-value to highlight
     ///   - y: The y-value to highlight. Supply `NaN` for "any"
diff --git a/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift b/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
index 410e1c2361..09b58d2020 100644
--- a/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
+++ b/Source/Charts/Data/Implementations/Standard/BarChartDataEntry.swift
@@ -150,6 +150,7 @@ open class BarChartDataEntry: ChartDataEntry
     }
     
     /// Splits up the stack-values of the given bar-entry into Range objects.
+    ///
     /// - Parameters:
     ///   - entry:
     /// - Returns:
diff --git a/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift b/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
index bd3631579c..45002bf571 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
@@ -393,6 +393,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// Adds an Entry to the DataSet dynamically.
     /// Entries are added to the end of the list.
     /// This will also recalculate the current minimum and maximum values of the DataSet and the value-sum.
+    ///
     /// - Parameters:
     ///   - e: the entry to add
     /// - Returns: True
@@ -409,6 +410,7 @@ open class ChartDataSet: ChartBaseDataSet
     /// Adds an Entry to the DataSet dynamically.
     /// Entries are added to their appropriate index respective to it's x-index.
     /// This will also recalculate the current minimum and maximum values of the DataSet and the value-sum.
+    ///
     /// - Parameters:
     ///   - e: the entry to add
     /// - Returns: True
@@ -436,6 +438,7 @@ open class ChartDataSet: ChartBaseDataSet
     
     /// Removes an Entry from the DataSet dynamically.
     /// This will also recalculate the current minimum and maximum values of the DataSet and the value-sum.
+    ///
     /// - Parameters:
     ///   - entry: the entry to remove
     /// - Returns: `true` if the entry was removed successfully, else if the entry does not exist

From a4356691aa6bae6ec32697877d5bbeeedc29a8e0 Mon Sep 17 00:00:00 2001
From: Kem Chen <chenkem@gmail.com>
Date: Sun, 28 Oct 2018 21:33:07 +0800
Subject: [PATCH 10/10] Remove meaningless comment

---
 Source/Charts/Charts/ChartViewBase.swift                       | 2 --
 Source/Charts/Data/Implementations/Standard/ChartDataSet.swift | 2 --
 2 files changed, 4 deletions(-)

diff --git a/Source/Charts/Charts/ChartViewBase.swift b/Source/Charts/Charts/ChartViewBase.swift
index ef3a9b7a46..8e5d142706 100644
--- a/Source/Charts/Charts/ChartViewBase.swift
+++ b/Source/Charts/Charts/ChartViewBase.swift
@@ -776,8 +776,6 @@ open class ChartViewBase: NSUIView, ChartDataProvider, AnimatorDelegate
         return _xAxis.axisRange
     }
     
-    /// *
-    ///
     /// - Note: (Equivalent of getCenter() in MPAndroidChart, as center is already a standard in iOS that returns the center point relative to superview, and MPAndroidChart returns relative to self)*
     /// The center point of the chart (the whole View) in pixels.
     @objc open var midPoint: CGPoint
diff --git a/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift b/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
index 45002bf571..3f0b9a3313 100644
--- a/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
+++ b/Source/Charts/Data/Implementations/Standard/ChartDataSet.swift
@@ -54,8 +54,6 @@ open class ChartDataSet: ChartBaseDataSet
     
     // MARK: - Data functions and accessors
 
-    /// *
-    ///
     /// - Note: Calls `notifyDataSetChanged()` after setting a new value.
     /// - Returns: The array of y-values that this DataSet represents.
     /// the entries that this dataset represents / holds together