summary refs log tree commit diff
path: root/sound/hda/hdac_device.c
diff options
context:
space:
mode:
authorTakashi Iwai <tiwai@suse.de>2015-10-28 12:26:48 +0100
committerTakashi Iwai <tiwai@suse.de>2015-10-28 12:37:29 +0100
commit78dd5e21b075053e67194ea8f496439bebc52728 (patch)
tree8bf5d26f13b6189a5bbc6b9bca10bc4bb3074b4a /sound/hda/hdac_device.c
parente5e113cf0d19392f26c6b63e63ad4680ee4ec5da (diff)
downloadlinux-78dd5e21b075053e67194ea8f496439bebc52728.tar.gz
ALSA: hda - Add / fix kernel doc comments
Give some readable comment in kernel doc style for each exported
function, as I promised in the previous meetings.  While we're at it,
fix the wrong comments, too.

Signed-off-by: Takashi Iwai <tiwai@suse.de>
Diffstat (limited to 'sound/hda/hdac_device.c')
-rw-r--r--sound/hda/hdac_device.c10
1 files changed, 6 insertions, 4 deletions
diff --git a/sound/hda/hdac_device.c b/sound/hda/hdac_device.c
index bbdb25f5bbb9..e361024eabb6 100644
--- a/sound/hda/hdac_device.c
+++ b/sound/hda/hdac_device.c
@@ -629,8 +629,10 @@ int snd_hdac_power_down_pm(struct hdac_device *codec)
 EXPORT_SYMBOL_GPL(snd_hdac_power_down_pm);
 #endif
 
-/*
- * Enable/disable the link power for a codec.
+/**
+ * snd_hdac_link_power - Enable/disable the link power for a codec
+ * @codec: the codec object
+ * @bool: enable or disable the link power
  */
 int snd_hdac_link_power(struct hdac_device *codec, bool enable)
 {
@@ -1048,8 +1050,8 @@ int snd_hdac_codec_write(struct hdac_device *hdac, hda_nid_t nid,
 }
 EXPORT_SYMBOL_GPL(snd_hdac_codec_write);
 
-/*
- * snd_hdac_check_power_state: check whether the actual power state matches
+/**
+ * snd_hdac_check_power_state - check whether the actual power state matches
  * with the target state
  *
  * @hdac: the HDAC device