From: Thierry Reding <treding@nvidia.com>
Date: Wed, 28 Jan 2015 14:25:54 +0000 (+0100)
Subject: drm/tegra: dc: Document tegra_dc_state_setup_clock()
X-Git-Tag: v4.1-rc1~69^2~14^2~4
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=9d910b6068be9b6670d0ebba2ddc3e7816dd8881;p=platform%2Fkernel%2Flinux-exynos.git

drm/tegra: dc: Document tegra_dc_state_setup_clock()

This function is called by output drivers so should be documented. While
at it, move it to a more appropriate location.

Signed-off-by: Thierry Reding <treding@nvidia.com>
---

diff --git a/drivers/gpu/drm/tegra/dc.c b/drivers/gpu/drm/tegra/dc.c
index 1ec24c3..076769a 100644
--- a/drivers/gpu/drm/tegra/dc.c
+++ b/drivers/gpu/drm/tegra/dc.c
@@ -1164,6 +1164,18 @@ static int tegra_dc_set_timings(struct tegra_dc *dc,
 	return 0;
 }
 
+/**
+ * tegra_dc_state_setup_clock - check clock settings and store them in atomic
+ *     state
+ * @dc: display controller
+ * @crtc_state: CRTC atomic state
+ * @clk: parent clock for display controller
+ * @pclk: pixel clock
+ * @div: shift clock divider
+ *
+ * Returns:
+ * 0 on success or a negative error-code on failure.
+ */
 int tegra_dc_state_setup_clock(struct tegra_dc *dc,
 			       struct drm_crtc_state *crtc_state,
 			       struct clk *clk, unsigned long pclk,