AuxXxilium/linux_dsm_epyc7002
1
0
Fork 0
mirror of https://github.com/AuxXxilium/linux_dsm_epyc7002.git synced 2024-11-24 16:30:52 +07:00
Code Issues Actions Packages Projects Releases Wiki Activity

drm/bridge: Use recommened kerneldoc for struct member refs

Browse Source 
I just learned that &struct_name.member_name works and looks pretty
even. It doesn't (yet) link to the member directly though, which would
be really good for big structures or vfunc tables (where the
per-member kerneldoc tends to be long).

Also some minor drive-by polish where it makes sense, I read a lot
of docs ...

Cc: Archit Taneja <architt@codeaurora.org>
Cc: Jani Nikula <jani.nikula@linux.intel.com>
Cc: Chris Wilson <chris@chris-wilson.co.uk>
Reviewed-by: Archit Taneja <architt@codeaurora.org>
[danvet: Remove spurious hunk that Archit spotted.]
Signed-off-by: Daniel Vetter <daniel.vetter@intel.com>
Link: http://patchwork.freedesktop.org/patch/msgid/1483044517-5770-13-git-send-email-daniel.vetter@ffwll.ch
This commit is contained in:
Daniel Vetter 2017-01-02 09:17:26 +01:00
parent 421242aab3
commit 4541d31e2a
2 changed files with 36 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
drivers/gpu/drm/drm_bridge.c
View File

@ -55,7 +55,7 @@
* just provide additional hooks to get the desired output at the end of the * just provide additional hooks to get the desired output at the end of the
* encoder chain. * encoder chain.
* *
* Bridges can also be chained up using the next pointer in &struct drm_bridge. * Bridges can also be chained up using the &drm_bridge.next pointer.
* *
* Both legacy CRTC helpers and the new atomic modeset helpers support bridges. * Both legacy CRTC helpers and the new atomic modeset helpers support bridges.
*/ */
@ -179,7 +179,7 @@ void drm_bridge_detach(struct drm_bridge *bridge)
* @mode: desired mode to be set for the bridge * @mode: desired mode to be set for the bridge
* @adjusted_mode: updated mode that works for this bridge * @adjusted_mode: updated mode that works for this bridge
* *
* Calls ->mode_fixup() &drm_bridge_funcs op for all the bridges in the * Calls &drm_bridge_funcs.mode_fixup for all the bridges in the
* encoder chain, starting from the first bridge to the last. * encoder chain, starting from the first bridge to the last.
* *
* Note: the bridge passed should be the one closest to the encoder * Note: the bridge passed should be the one closest to the encoder
@ -206,11 +206,10 @@ bool drm_bridge_mode_fixup(struct drm_bridge *bridge,
EXPORT_SYMBOL(drm_bridge_mode_fixup); EXPORT_SYMBOL(drm_bridge_mode_fixup);
/** /**
* drm_bridge_disable - calls ->disable() &drm_bridge_funcs op for all * drm_bridge_disable - disables all bridges in the encoder chain
* bridges in the encoder chain.
* @bridge: bridge control structure * @bridge: bridge control structure
* *
* Calls ->disable() &drm_bridge_funcs op for all the bridges in the encoder * Calls &drm_bridge_funcs.disable op for all the bridges in the encoder
* chain, starting from the last bridge to the first. These are called before * chain, starting from the last bridge to the first. These are called before
* calling the encoder's prepare op. * calling the encoder's prepare op.
* *
@ -229,11 +228,10 @@ void drm_bridge_disable(struct drm_bridge *bridge)
EXPORT_SYMBOL(drm_bridge_disable); EXPORT_SYMBOL(drm_bridge_disable);
/** /**
* drm_bridge_post_disable - calls ->post_disable() &drm_bridge_funcs op for * drm_bridge_post_disable - cleans up after disabling all bridges in the encoder chain
* all bridges in the encoder chain.
* @bridge: bridge control structure * @bridge: bridge control structure
* *
* Calls ->post_disable() &drm_bridge_funcs op for all the bridges in the * Calls &drm_bridge_funcs.post_disable op for all the bridges in the
* encoder chain, starting from the first bridge to the last. These are called * encoder chain, starting from the first bridge to the last. These are called
* after completing the encoder's prepare op. * after completing the encoder's prepare op.
* *
@ -258,7 +256,7 @@ EXPORT_SYMBOL(drm_bridge_post_disable);
* @mode: desired mode to be set for the bridge * @mode: desired mode to be set for the bridge
* @adjusted_mode: updated mode that works for this bridge * @adjusted_mode: updated mode that works for this bridge
* *
* Calls ->mode_set() &drm_bridge_funcs op for all the bridges in the * Calls &drm_bridge_funcs.mode_set op for all the bridges in the
* encoder chain, starting from the first bridge to the last. * encoder chain, starting from the first bridge to the last.
* *
* Note: the bridge passed should be the one closest to the encoder * Note: the bridge passed should be the one closest to the encoder
@ -278,11 +276,11 @@ void drm_bridge_mode_set(struct drm_bridge *bridge,
EXPORT_SYMBOL(drm_bridge_mode_set); EXPORT_SYMBOL(drm_bridge_mode_set);
/** /**
* drm_bridge_pre_enable - calls ->pre_enable() &drm_bridge_funcs op for all * drm_bridge_pre_enable - prepares for enabling all
* bridges in the encoder chain. * bridges in the encoder chain
* @bridge: bridge control structure * @bridge: bridge control structure
* *
* Calls ->pre_enable() &drm_bridge_funcs op for all the bridges in the encoder * Calls &drm_bridge_funcs.pre_enable op for all the bridges in the encoder
* chain, starting from the last bridge to the first. These are called * chain, starting from the last bridge to the first. These are called
* before calling the encoder's commit op. * before calling the encoder's commit op.
* *
@ -301,11 +299,10 @@ void drm_bridge_pre_enable(struct drm_bridge *bridge)
EXPORT_SYMBOL(drm_bridge_pre_enable); EXPORT_SYMBOL(drm_bridge_pre_enable);
/** /**
* drm_bridge_enable - calls ->enable() &drm_bridge_funcs op for all bridges * drm_bridge_enable - enables all bridges in the encoder chain
* in the encoder chain.
* @bridge: bridge control structure * @bridge: bridge control structure
* *
* Calls ->enable() &drm_bridge_funcs op for all the bridges in the encoder * Calls &drm_bridge_funcs.enable op for all the bridges in the encoder
* chain, starting from the first bridge to the last. These are called * chain, starting from the first bridge to the last. These are called
* after completing the encoder's commit op. * after completing the encoder's commit op.
* *

42
include/drm/drm_bridge.h
View File

@ -96,9 +96,10 @@ struct drm_bridge_funcs {
* This callback should disable the bridge. It is called right before * This callback should disable the bridge. It is called right before
* the preceding element in the display pipe is disabled. If the * the preceding element in the display pipe is disabled. If the
* preceding element is a bridge this means it's called before that * preceding element is a bridge this means it's called before that
* bridge's ->disable() function. If the preceding element is a * bridge's @disable vfunc. If the preceding element is a &drm_encoder
* &drm_encoder it's called right before the encoder's ->disable(), * it's called right before the &drm_encoder_helper_funcs.disable,
* ->prepare() or ->dpms() hook from &struct drm_encoder_helper_funcs. * &drm_encoder_helper_funcs.prepare or &drm_encoder_helper_funcs.dpms
* hook.
* *
* The bridge can assume that the display pipe (i.e. clocks and timing * The bridge can assume that the display pipe (i.e. clocks and timing
* signals) feeding it is still running when this callback is called. * signals) feeding it is still running when this callback is called.
@ -110,12 +111,13 @@ struct drm_bridge_funcs {
/** /**
* @post_disable: * @post_disable:
* *
* This callback should disable the bridge. It is called right after * This callback should disable the bridge. It is called right after the
* the preceding element in the display pipe is disabled. If the * preceding element in the display pipe is disabled. If the preceding
* preceding element is a bridge this means it's called after that * element is a bridge this means it's called after that bridge's
* bridge's ->post_disable() function. If the preceding element is a * @post_disable function. If the preceding element is a &drm_encoder
* &drm_encoder it's called right after the encoder's ->disable(), * it's called right after the encoder's
* ->prepare() or ->dpms() hook from &struct drm_encoder_helper_funcs. * &drm_encoder_helper_funcs.disable, &drm_encoder_helper_funcs.prepare
* or &drm_encoder_helper_funcs.dpms hook.
* *
* The bridge must assume that the display pipe (i.e. clocks and timing * The bridge must assume that the display pipe (i.e. clocks and timing
* singals) feeding it is no longer running when this callback is * singals) feeding it is no longer running when this callback is
@ -129,9 +131,11 @@ struct drm_bridge_funcs {
* @mode_set: * @mode_set:
* *
* This callback should set the given mode on the bridge. It is called * This callback should set the given mode on the bridge. It is called
* after the ->mode_set() callback for the preceding element in the * after the @mode_set callback for the preceding element in the display
* display pipeline has been called already. The display pipe (i.e. * pipeline has been called already. If the bridge is the first element
* clocks and timing signals) is off when this function is called. * then this would be &drm_encoder_helper_funcs.mode_set. The display
* pipe (i.e. clocks and timing signals) is off when this function is
* called.
*/ */
void (*mode_set)(struct drm_bridge *bridge, void (*mode_set)(struct drm_bridge *bridge,
struct drm_display_mode *mode, struct drm_display_mode *mode,
@ -142,9 +146,10 @@ struct drm_bridge_funcs {
* This callback should enable the bridge. It is called right before * This callback should enable the bridge. It is called right before
* the preceding element in the display pipe is enabled. If the * the preceding element in the display pipe is enabled. If the
* preceding element is a bridge this means it's called before that * preceding element is a bridge this means it's called before that
* bridge's ->pre_enable() function. If the preceding element is a * bridge's @pre_enable function. If the preceding element is a
* &drm_encoder it's called right before the encoder's ->enable(), * &drm_encoder it's called right before the encoder's
* ->commit() or ->dpms() hook from &struct drm_encoder_helper_funcs. * &drm_encoder_helper_funcs.enable, &drm_encoder_helper_funcs.commit or
* &drm_encoder_helper_funcs.dpms hook.
* *
* The display pipe (i.e. clocks and timing signals) feeding this bridge * The display pipe (i.e. clocks and timing signals) feeding this bridge
* will not yet be running when this callback is called. The bridge must * will not yet be running when this callback is called. The bridge must
@ -161,9 +166,10 @@ struct drm_bridge_funcs {
* This callback should enable the bridge. It is called right after * This callback should enable the bridge. It is called right after
* the preceding element in the display pipe is enabled. If the * the preceding element in the display pipe is enabled. If the
* preceding element is a bridge this means it's called after that * preceding element is a bridge this means it's called after that
* bridge's ->enable() function. If the preceding element is a * bridge's @enable function. If the preceding element is a
* &drm_encoder it's called right after the encoder's ->enable(), * &drm_encoder it's called right after the encoder's
* ->commit() or ->dpms() hook from &struct drm_encoder_helper_funcs. * &drm_encoder_helper_funcs.enable, &drm_encoder_helper_funcs.commit or
* &drm_encoder_helper_funcs.dpms hook.
* *
* The bridge can assume that the display pipe (i.e. clocks and timing * The bridge can assume that the display pipe (i.e. clocks and timing
* signals) feeding it is running when this callback is called. This * signals) feeding it is running when this callback is called. This