ALSA: Fix invalid kerneldoc markers

They are no real kerneldoc comments, so drop such markers.

Signed-off-by: Takashi Iwai <tiwai@suse.de>
This commit is contained in:
Takashi Iwai 2014-11-10 17:24:26 +01:00
parent 3f60c87d12
commit ddcecf6b6a
4 changed files with 32 additions and 32 deletions

View file

@ -74,14 +74,14 @@ struct hdspm_config {
#define SNDRV_HDSPM_IOCTL_GET_CONFIG \ #define SNDRV_HDSPM_IOCTL_GET_CONFIG \
_IOR('H', 0x41, struct hdspm_config) _IOR('H', 0x41, struct hdspm_config)
/** /*
* If there's a TCO (TimeCode Option) board installed, * If there's a TCO (TimeCode Option) board installed,
* there are further options and status data available. * there are further options and status data available.
* The hdspm_ltc structure contains the current SMPTE * The hdspm_ltc structure contains the current SMPTE
* timecode and some status information and can be * timecode and some status information and can be
* obtained via SNDRV_HDSPM_IOCTL_GET_LTC or in the * obtained via SNDRV_HDSPM_IOCTL_GET_LTC or in the
* hdspm_status struct. * hdspm_status struct.
**/ */
enum hdspm_ltc_format { enum hdspm_ltc_format {
format_invalid, format_invalid,
@ -113,11 +113,11 @@ struct hdspm_ltc {
#define SNDRV_HDSPM_IOCTL_GET_LTC _IOR('H', 0x46, struct hdspm_ltc) #define SNDRV_HDSPM_IOCTL_GET_LTC _IOR('H', 0x46, struct hdspm_ltc)
/** /*
* The status data reflects the device's current state * The status data reflects the device's current state
* as determined by the card's configuration and * as determined by the card's configuration and
* connection status. * connection status.
**/ */
enum hdspm_sync { enum hdspm_sync {
hdspm_sync_no_lock = 0, hdspm_sync_no_lock = 0,
@ -171,9 +171,9 @@ struct hdspm_status {
#define SNDRV_HDSPM_IOCTL_GET_STATUS \ #define SNDRV_HDSPM_IOCTL_GET_STATUS \
_IOR('H', 0x47, struct hdspm_status) _IOR('H', 0x47, struct hdspm_status)
/** /*
* Get information about the card and its add-ons. * Get information about the card and its add-ons.
**/ */
#define HDSPM_ADDON_TCO 1 #define HDSPM_ADDON_TCO 1

View file

@ -180,7 +180,7 @@ MODULE_PARM_DESC(enable, "Enable the EMU10K1X soundcard.");
/* From 0x50 - 0x5f, last samples captured */ /* From 0x50 - 0x5f, last samples captured */
/** /*
* The hardware has 3 channels for playback and 1 for capture. * The hardware has 3 channels for playback and 1 for capture.
* - channel 0 is the front channel * - channel 0 is the front channel
* - channel 1 is the rear channel * - channel 1 is the rear channel

View file

@ -175,7 +175,7 @@ enum buffer_flags {
BF_ZERO = 0x00, /* no flags (init).*/ BF_ZERO = 0x00, /* no flags (init).*/
}; };
/** /*
* Stream Flags definitions * Stream Flags definitions
*/ */
enum stream_flags { enum stream_flags {

View file

@ -2201,10 +2201,10 @@ static inline int hdspm_get_pll_freq(struct hdspm *hdspm)
return rate; return rate;
} }
/** /*
* Calculate the real sample rate from the * Calculate the real sample rate from the
* current DDS value. * current DDS value.
**/ */
static int hdspm_get_system_sample_rate(struct hdspm *hdspm) static int hdspm_get_system_sample_rate(struct hdspm *hdspm)
{ {
unsigned int rate; unsigned int rate;
@ -2270,9 +2270,9 @@ static int snd_hdspm_put_system_sample_rate(struct snd_kcontrol *kcontrol,
} }
/** /*
* Returns the WordClock sample rate class for the given card. * Returns the WordClock sample rate class for the given card.
**/ */
static int hdspm_get_wc_sample_rate(struct hdspm *hdspm) static int hdspm_get_wc_sample_rate(struct hdspm *hdspm)
{ {
int status; int status;
@ -2295,9 +2295,9 @@ static int hdspm_get_wc_sample_rate(struct hdspm *hdspm)
} }
/** /*
* Returns the TCO sample rate class for the given card. * Returns the TCO sample rate class for the given card.
**/ */
static int hdspm_get_tco_sample_rate(struct hdspm *hdspm) static int hdspm_get_tco_sample_rate(struct hdspm *hdspm)
{ {
int status; int status;
@ -2321,9 +2321,9 @@ static int hdspm_get_tco_sample_rate(struct hdspm *hdspm)
} }
/** /*
* Returns the SYNC_IN sample rate class for the given card. * Returns the SYNC_IN sample rate class for the given card.
**/ */
static int hdspm_get_sync_in_sample_rate(struct hdspm *hdspm) static int hdspm_get_sync_in_sample_rate(struct hdspm *hdspm)
{ {
int status; int status;
@ -2343,9 +2343,9 @@ static int hdspm_get_sync_in_sample_rate(struct hdspm *hdspm)
return 0; return 0;
} }
/** /*
* Returns the AES sample rate class for the given card. * Returns the AES sample rate class for the given card.
**/ */
static int hdspm_get_aes_sample_rate(struct hdspm *hdspm, int index) static int hdspm_get_aes_sample_rate(struct hdspm *hdspm, int index)
{ {
int timecode; int timecode;
@ -2361,10 +2361,10 @@ static int hdspm_get_aes_sample_rate(struct hdspm *hdspm, int index)
return 0; return 0;
} }
/** /*
* Returns the sample rate class for input source <idx> for * Returns the sample rate class for input source <idx> for
* 'new style' cards like the AIO and RayDAT. * 'new style' cards like the AIO and RayDAT.
**/ */
static int hdspm_get_s1_sample_rate(struct hdspm *hdspm, unsigned int idx) static int hdspm_get_s1_sample_rate(struct hdspm *hdspm, unsigned int idx)
{ {
int status = hdspm_read(hdspm, HDSPM_RD_STATUS_2); int status = hdspm_read(hdspm, HDSPM_RD_STATUS_2);
@ -2512,10 +2512,10 @@ static int snd_hdspm_get_autosync_sample_rate(struct snd_kcontrol *kcontrol,
} }
/** /*
* Returns the system clock mode for the given card. * Returns the system clock mode for the given card.
* @returns 0 - master, 1 - slave * @returns 0 - master, 1 - slave
**/ */
static int hdspm_system_clock_mode(struct hdspm *hdspm) static int hdspm_system_clock_mode(struct hdspm *hdspm)
{ {
switch (hdspm->io_type) { switch (hdspm->io_type) {
@ -2534,10 +2534,10 @@ static int hdspm_system_clock_mode(struct hdspm *hdspm)
} }
/** /*
* Sets the system clock mode. * Sets the system clock mode.
* @param mode 0 - master, 1 - slave * @param mode 0 - master, 1 - slave
**/ */
static void hdspm_set_system_clock_mode(struct hdspm *hdspm, int mode) static void hdspm_set_system_clock_mode(struct hdspm *hdspm, int mode)
{ {
hdspm_set_toggle_setting(hdspm, hdspm_set_toggle_setting(hdspm,
@ -2692,11 +2692,11 @@ static int snd_hdspm_put_clock_source(struct snd_kcontrol *kcontrol,
} }
/** /*
* Returns the current preferred sync reference setting. * Returns the current preferred sync reference setting.
* The semantics of the return value are depending on the * The semantics of the return value are depending on the
* card, please see the comments for clarification. * card, please see the comments for clarification.
**/ */
static int hdspm_pref_sync_ref(struct hdspm * hdspm) static int hdspm_pref_sync_ref(struct hdspm * hdspm)
{ {
switch (hdspm->io_type) { switch (hdspm->io_type) {
@ -2795,11 +2795,11 @@ static int hdspm_pref_sync_ref(struct hdspm * hdspm)
} }
/** /*
* Set the preferred sync reference to <pref>. The semantics * Set the preferred sync reference to <pref>. The semantics
* of <pref> are depending on the card type, see the comments * of <pref> are depending on the card type, see the comments
* for clarification. * for clarification.
**/ */
static int hdspm_set_pref_sync_ref(struct hdspm * hdspm, int pref) static int hdspm_set_pref_sync_ref(struct hdspm * hdspm, int pref)
{ {
int p = 0; int p = 0;
@ -4101,9 +4101,9 @@ static int snd_hdspm_get_sync_check(struct snd_kcontrol *kcontrol,
/** /*
* TCO controls * TCO controls
**/ */
static void hdspm_tco_write(struct hdspm *hdspm) static void hdspm_tco_write(struct hdspm *hdspm)
{ {
unsigned int tc[4] = { 0, 0, 0, 0}; unsigned int tc[4] = { 0, 0, 0, 0};
@ -5403,7 +5403,7 @@ static irqreturn_t snd_hdspm_interrupt(int irq, void *dev_id)
HDSPM_midi2IRQPending | HDSPM_midi3IRQPending); HDSPM_midi2IRQPending | HDSPM_midi3IRQPending);
/* now = get_cycles(); */ /* now = get_cycles(); */
/** /*
* LAT_2..LAT_0 period counter (win) counter (mac) * LAT_2..LAT_0 period counter (win) counter (mac)
* 6 4096 ~256053425 ~514672358 * 6 4096 ~256053425 ~514672358
* 5 2048 ~128024983 ~257373821 * 5 2048 ~128024983 ~257373821
@ -5412,7 +5412,7 @@ static irqreturn_t snd_hdspm_interrupt(int irq, void *dev_id)
* 2 256 ~16003039 ~32260176 * 2 256 ~16003039 ~32260176
* 1 128 ~7998738 ~16194507 * 1 128 ~7998738 ~16194507
* 0 64 ~3998231 ~8191558 * 0 64 ~3998231 ~8191558
**/ */
/* /*
dev_info(hdspm->card->dev, "snd_hdspm_interrupt %llu @ %llx\n", dev_info(hdspm->card->dev, "snd_hdspm_interrupt %llu @ %llx\n",
now-hdspm->last_interrupt, status & 0xFFC0); now-hdspm->last_interrupt, status & 0xFFC0);