Techwizz/kernel-fxtec-pro1x
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

drm/doc: Integrate drm_modes.c kerneldoc

Browse source 
And clean it up so that there's no kerneldoc warnings. There's still a
lot to do with this one here.

Reviewed-by: Alex Deucher <alexander.deucher@amd.com>
Signed-off-by: Daniel Vetter <daniel.vetter@ffwll.ch>
This commit is contained in:
Daniel Vetter 2014-01-23 15:06:15 +01:00
parent 69fa5293bf
commit 3ec0db8193
2 changed files with 21 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
Documentation/DocBook/drm.tmpl
View file

@ -963,6 +963,10 @@ int max_width, max_height;</synopsis>
<para>Mode setting functions.</para> <para>Mode setting functions.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<sect2>
<title>Display Modes Function Reference</title>
!Edrivers/gpu/drm/drm_modes.c
</sect2>
<sect2> <sect2>
<title>Frame Buffer Creation</title> <title>Frame Buffer Creation</title>
<synopsis>struct drm_framebuffer *(*fb_create)(struct drm_device *dev, <synopsis>struct drm_framebuffer *(*fb_create)(struct drm_device *dev,

28
drivers/gpu/drm/drm_modes.c
View file

@ -39,12 +39,11 @@
#include <video/videomode.h> #include <video/videomode.h>
/** /**
* drm_mode_debug_printmodeline - debug print a mode * drm_mode_debug_printmodeline - print a mode to dmesg
* @dev: DRM device
* @mode: mode to print * @mode: mode to print
* *
* LOCKING: * LOCKING:
* None. * none.
* *
* Describe @mode using DRM_DEBUG. * Describe @mode using DRM_DEBUG.
*/ */
@ -68,6 +67,7 @@ EXPORT_SYMBOL(drm_mode_debug_printmodeline);
* @vrefresh : vrefresh rate * @vrefresh : vrefresh rate
* @reduced : Whether the GTF calculation is simplified * @reduced : Whether the GTF calculation is simplified
* @interlaced:Whether the interlace is supported * @interlaced:Whether the interlace is supported
* @margins: whether to add margins or not
* *
* LOCKING: * LOCKING:
* none. * none.
@ -83,11 +83,11 @@ EXPORT_SYMBOL(drm_mode_debug_printmodeline);
* And it is copied from xf86CVTmode in xserver/hw/xfree86/modes/xf86cvt.c. * And it is copied from xf86CVTmode in xserver/hw/xfree86/modes/xf86cvt.c.
* What I have done is to translate it by using integer calculation. * What I have done is to translate it by using integer calculation.
*/ */
#define HV_FACTOR 1000
struct drm_display_mode *drm_cvt_mode(struct drm_device *dev, int hdisplay, struct drm_display_mode *drm_cvt_mode(struct drm_device *dev, int hdisplay,
int vdisplay, int vrefresh, int vdisplay, int vrefresh,
bool reduced, bool interlaced, bool margins) bool reduced, bool interlaced, bool margins)
{ {
#define HV_FACTOR 1000
/* 1) top/bottom margin size (% of height) - default: 1.8, */ /* 1) top/bottom margin size (% of height) - default: 1.8, */
#define CVT_MARGIN_PERCENTAGE 18 #define CVT_MARGIN_PERCENTAGE 18
/* 2) character cell horizontal granularity (pixels) - default 8 */ /* 2) character cell horizontal granularity (pixels) - default 8 */
@ -289,7 +289,10 @@ EXPORT_SYMBOL(drm_cvt_mode);
* @vrefresh :vrefresh rate. * @vrefresh :vrefresh rate.
* @interlaced :whether the interlace is supported * @interlaced :whether the interlace is supported
* @margins :desired margin size * @margins :desired margin size
* @GTF_[MCKJ] :extended GTF formula parameters * @GTF_M: extended GTF formula parameters
* @GTF_2C: extended GTF formula parameters
* @GTF_K: extended GTF formula parameters
* @GTF_2J: extended GTF formula parameters
* *
* LOCKING. * LOCKING.
* none. * none.
@ -499,10 +502,11 @@ EXPORT_SYMBOL(drm_gtf_mode_complex);
*/ */
struct drm_display_mode * struct drm_display_mode *
drm_gtf_mode(struct drm_device *dev, int hdisplay, int vdisplay, int vrefresh, drm_gtf_mode(struct drm_device *dev, int hdisplay, int vdisplay, int vrefresh,
bool lace, int margins) bool interlaced, int margins)
{ {
return drm_gtf_mode_complex(dev, hdisplay, vdisplay, vrefresh, lace, return drm_gtf_mode_complex(dev, hdisplay, vdisplay, vrefresh,
margins, 600, 40 * 2, 128, 20 * 2); interlaced, margins,
600, 40 * 2, 128, 20 * 2);
} }
EXPORT_SYMBOL(drm_gtf_mode); EXPORT_SYMBOL(drm_gtf_mode);
@ -805,7 +809,8 @@ EXPORT_SYMBOL(drm_mode_copy);
/** /**
* drm_mode_duplicate - allocate and duplicate an existing mode * drm_mode_duplicate - allocate and duplicate an existing mode
* @m: mode to duplicate * @dev: drm_device to allocate the duplicated mode for
* @mode: mode to duplicate
* *
* LOCKING: * LOCKING:
* None. * None.
@ -1057,8 +1062,9 @@ EXPORT_SYMBOL(drm_mode_connector_list_update);
/** /**
* drm_mode_parse_command_line_for_connector - parse command line for connector * drm_mode_parse_command_line_for_connector - parse command line for connector
* @mode_option - per connector mode option * @mode_option: per connector mode option
* @connector - connector to parse line for * @connector: connector to parse line for
* @mode: preallocated mode structure to fill out
* *
* This parses the connector specific then generic command lines for * This parses the connector specific then generic command lines for
* modes and options to configure the connector. * modes and options to configure the connector.