korg/linux
0
0
Fork 0
mirror of https://mirrors.bfsu.edu.cn/git/linux.git synced 2024-11-11 12:28:41 +08:00
Code Issues Packages Projects Releases Wiki Activity

rtc: interface: fix kerneldoc comments

Browse Source 
Fix kerneldoc warnings:

drivers/rtc/interface.c:619: warning: Function parameter or member 'num' not described in 'rtc_handle_legacy_irq'
drivers/rtc/interface.c:619: warning: Function parameter or member 'mode' not described in 'rtc_handle_legacy_irq'
drivers/rtc/interface.c:804: warning: Function parameter or member 'rtc' not described in 'rtc_timer_enqueue'
drivers/rtc/interface.c:804: warning: Function parameter or member 'timer' not described in 'rtc_timer_enqueue'
drivers/rtc/interface.c:864: warning: Function parameter or member 'rtc' not described in 'rtc_timer_remove'
drivers/rtc/interface.c:864: warning: Function parameter or member 'timer' not described in 'rtc_timer_remove'
drivers/rtc/interface.c:900: warning: Function parameter or member 'work' not described in 'rtc_timer_do_work'
drivers/rtc/interface.c:1035: warning: Function parameter or member 'rtc' not described in 'rtc_read_offset'
drivers/rtc/interface.c:1035: warning: Function parameter or member 'offset' not described in 'rtc_read_offset'
drivers/rtc/interface.c:1070: warning: Function parameter or member 'rtc' not described in 'rtc_set_offset'
drivers/rtc/interface.c:1070: warning: Function parameter or member 'offset' not described in 'rtc_set_offset'

Link: https://lore.kernel.org/r/20191127082932.666869-1-alexandre.belloni@bootlin.com
Signed-off-by: Alexandre Belloni <alexandre.belloni@bootlin.com>
This commit is contained in:
Alexandre Belloni 2019-11-27 09:29:32 +01:00
parent 32c4d9e8a4
commit 55dcf7a21d
1 changed files with 11 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
drivers/rtc/interface.c
View File

@ -610,6 +610,8 @@ EXPORT_SYMBOL_GPL(rtc_update_irq_enable);
/** /**
* rtc_handle_legacy_irq - AIE, UIE and PIE event hook * rtc_handle_legacy_irq - AIE, UIE and PIE event hook
* @rtc: pointer to the rtc device * @rtc: pointer to the rtc device
* @num: number of occurence of the event
* @mode: type of the event, RTC_AF, RTC_UF of RTC_PF
* *
* This function is called when an AIE, UIE or PIE mode interrupt * This function is called when an AIE, UIE or PIE mode interrupt
* has occurred (or been emulated). * has occurred (or been emulated).
@ -790,8 +792,8 @@ int rtc_irq_set_freq(struct rtc_device *rtc, int freq)
/** /**
* rtc_timer_enqueue - Adds a rtc_timer to the rtc_device timerqueue * rtc_timer_enqueue - Adds a rtc_timer to the rtc_device timerqueue
* @rtc rtc device * @rtc: rtc device
* @timer timer being added. * @timer: timer being added.
* *
* Enqueues a timer onto the rtc devices timerqueue and sets * Enqueues a timer onto the rtc devices timerqueue and sets
* the next alarm event appropriately. * the next alarm event appropriately.
@ -850,8 +852,8 @@ static void rtc_alarm_disable(struct rtc_device *rtc)
/** /**
* rtc_timer_remove - Removes a rtc_timer from the rtc_device timerqueue * rtc_timer_remove - Removes a rtc_timer from the rtc_device timerqueue
* @rtc rtc device * @rtc: rtc device
* @timer timer being removed. * @timer: timer being removed.
* *
* Removes a timer onto the rtc devices timerqueue and sets * Removes a timer onto the rtc devices timerqueue and sets
* the next alarm event appropriately. * the next alarm event appropriately.
@ -888,8 +890,7 @@ static void rtc_timer_remove(struct rtc_device *rtc, struct rtc_timer *timer)
/** /**
* rtc_timer_do_work - Expires rtc timers * rtc_timer_do_work - Expires rtc timers
* @rtc rtc device * @work: work item
* @timer timer being removed.
* *
* Expires rtc timers. Reprograms next alarm event if needed. * Expires rtc timers. Reprograms next alarm event if needed.
* Called via worktask. * Called via worktask.
@ -1022,8 +1023,8 @@ void rtc_timer_cancel(struct rtc_device *rtc, struct rtc_timer *timer)
/** /**
* rtc_read_offset - Read the amount of rtc offset in parts per billion * rtc_read_offset - Read the amount of rtc offset in parts per billion
* @ rtc: rtc device to be used * @rtc: rtc device to be used
* @ offset: the offset in parts per billion * @offset: the offset in parts per billion
* *
* see below for details. * see below for details.
* *
@ -1051,8 +1052,8 @@ int rtc_read_offset(struct rtc_device *rtc, long *offset)
/** /**
* rtc_set_offset - Adjusts the duration of the average second * rtc_set_offset - Adjusts the duration of the average second
* @ rtc: rtc device to be used * @rtc: rtc device to be used
* @ offset: the offset in parts per billion * @offset: the offset in parts per billion
* *
* Some rtc's allow an adjustment to the average duration of a second * Some rtc's allow an adjustment to the average duration of a second
* to compensate for differences in the actual clock rate due to temperature, * to compensate for differences in the actual clock rate due to temperature,