aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMauro Carvalho Chehab <mchehab@s-opensource.com>2017-11-27 10:27:54 -0500
committerMauro Carvalho Chehab <mchehab@s-opensource.com>2017-11-27 10:35:35 -0500
commit255940e642387ffe886fd881ffc9917f31fe0564 (patch)
tree99e8f7664e6e6d5e4f9f690cbb001ec06c15c503
parent64dc6829a0080e3c8e70d52a98e9b0e30d968bd8 (diff)
media: imon: don't use kernel-doc "/**" markups
The function documentation here doesn't follow kernel-doc, as parameters aren't documented. So, stop abusing on "/**" markups. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
-rw-r--r--drivers/media/rc/imon.c40
1 files changed, 20 insertions, 20 deletions
diff --git a/drivers/media/rc/imon.c b/drivers/media/rc/imon.c
index b25b35b3f6da..eb943e862515 100644
--- a/drivers/media/rc/imon.c
+++ b/drivers/media/rc/imon.c
@@ -492,7 +492,7 @@ static void free_imon_context(struct imon_context *ictx)
492 dev_dbg(dev, "%s: iMON context freed\n", __func__); 492 dev_dbg(dev, "%s: iMON context freed\n", __func__);
493} 493}
494 494
495/** 495/*
496 * Called when the Display device (e.g. /dev/lcd0) 496 * Called when the Display device (e.g. /dev/lcd0)
497 * is opened by the application. 497 * is opened by the application.
498 */ 498 */
@@ -542,7 +542,7 @@ exit:
542 return retval; 542 return retval;
543} 543}
544 544
545/** 545/*
546 * Called when the display device (e.g. /dev/lcd0) 546 * Called when the display device (e.g. /dev/lcd0)
547 * is closed by the application. 547 * is closed by the application.
548 */ 548 */
@@ -575,7 +575,7 @@ static int display_close(struct inode *inode, struct file *file)
575 return retval; 575 return retval;
576} 576}
577 577
578/** 578/*
579 * Sends a packet to the device -- this function must be called with 579 * Sends a packet to the device -- this function must be called with
580 * ictx->lock held, or its unlock/lock sequence while waiting for tx 580 * ictx->lock held, or its unlock/lock sequence while waiting for tx
581 * to complete can/will lead to a deadlock. 581 * to complete can/will lead to a deadlock.
@@ -664,7 +664,7 @@ static int send_packet(struct imon_context *ictx)
664 return retval; 664 return retval;
665} 665}
666 666
667/** 667/*
668 * Sends an associate packet to the iMON 2.4G. 668 * Sends an associate packet to the iMON 2.4G.
669 * 669 *
670 * This might not be such a good idea, since it has an id collision with 670 * This might not be such a good idea, since it has an id collision with
@@ -694,7 +694,7 @@ static int send_associate_24g(struct imon_context *ictx)
694 return retval; 694 return retval;
695} 695}
696 696
697/** 697/*
698 * Sends packets to setup and show clock on iMON display 698 * Sends packets to setup and show clock on iMON display
699 * 699 *
700 * Arguments: year - last 2 digits of year, month - 1..12, 700 * Arguments: year - last 2 digits of year, month - 1..12,
@@ -781,7 +781,7 @@ static int send_set_imon_clock(struct imon_context *ictx,
781 return retval; 781 return retval;
782} 782}
783 783
784/** 784/*
785 * These are the sysfs functions to handle the association on the iMON 2.4G LT. 785 * These are the sysfs functions to handle the association on the iMON 2.4G LT.
786 */ 786 */
787static ssize_t show_associate_remote(struct device *d, 787static ssize_t show_associate_remote(struct device *d,
@@ -823,7 +823,7 @@ static ssize_t store_associate_remote(struct device *d,
823 return count; 823 return count;
824} 824}
825 825
826/** 826/*
827 * sysfs functions to control internal imon clock 827 * sysfs functions to control internal imon clock
828 */ 828 */
829static ssize_t show_imon_clock(struct device *d, 829static ssize_t show_imon_clock(struct device *d,
@@ -923,7 +923,7 @@ static const struct attribute_group imon_rf_attr_group = {
923 .attrs = imon_rf_sysfs_entries 923 .attrs = imon_rf_sysfs_entries
924}; 924};
925 925
926/** 926/*
927 * Writes data to the VFD. The iMON VFD is 2x16 characters 927 * Writes data to the VFD. The iMON VFD is 2x16 characters
928 * and requires data in 5 consecutive USB interrupt packets, 928 * and requires data in 5 consecutive USB interrupt packets,
929 * each packet but the last carrying 7 bytes. 929 * each packet but the last carrying 7 bytes.
@@ -1008,7 +1008,7 @@ exit:
1008 return (!retval) ? n_bytes : retval; 1008 return (!retval) ? n_bytes : retval;
1009} 1009}
1010 1010
1011/** 1011/*
1012 * Writes data to the LCD. The iMON OEM LCD screen expects 8-byte 1012 * Writes data to the LCD. The iMON OEM LCD screen expects 8-byte
1013 * packets. We accept data as 16 hexadecimal digits, followed by a 1013 * packets. We accept data as 16 hexadecimal digits, followed by a
1014 * newline (to make it easy to drive the device from a command-line 1014 * newline (to make it easy to drive the device from a command-line
@@ -1066,7 +1066,7 @@ exit:
1066 return (!retval) ? n_bytes : retval; 1066 return (!retval) ? n_bytes : retval;
1067} 1067}
1068 1068
1069/** 1069/*
1070 * Callback function for USB core API: transmit data 1070 * Callback function for USB core API: transmit data
1071 */ 1071 */
1072static void usb_tx_callback(struct urb *urb) 1072static void usb_tx_callback(struct urb *urb)
@@ -1087,7 +1087,7 @@ static void usb_tx_callback(struct urb *urb)
1087 complete(&ictx->tx.finished); 1087 complete(&ictx->tx.finished);
1088} 1088}
1089 1089
1090/** 1090/*
1091 * report touchscreen input 1091 * report touchscreen input
1092 */ 1092 */
1093static void imon_touch_display_timeout(struct timer_list *t) 1093static void imon_touch_display_timeout(struct timer_list *t)
@@ -1103,7 +1103,7 @@ static void imon_touch_display_timeout(struct timer_list *t)
1103 input_sync(ictx->touch); 1103 input_sync(ictx->touch);
1104} 1104}
1105 1105
1106/** 1106/*
1107 * iMON IR receivers support two different signal sets -- those used by 1107 * iMON IR receivers support two different signal sets -- those used by
1108 * the iMON remotes, and those used by the Windows MCE remotes (which is 1108 * the iMON remotes, and those used by the Windows MCE remotes (which is
1109 * really just RC-6), but only one or the other at a time, as the signals 1109 * really just RC-6), but only one or the other at a time, as the signals
@@ -1191,7 +1191,7 @@ static inline int tv2int(const struct timeval *a, const struct timeval *b)
1191 return sec; 1191 return sec;
1192} 1192}
1193 1193
1194/** 1194/*
1195 * The directional pad behaves a bit differently, depending on whether this is 1195 * The directional pad behaves a bit differently, depending on whether this is
1196 * one of the older ffdc devices or a newer device. Newer devices appear to 1196 * one of the older ffdc devices or a newer device. Newer devices appear to
1197 * have a higher resolution matrix for more precise mouse movement, but it 1197 * have a higher resolution matrix for more precise mouse movement, but it
@@ -1543,7 +1543,7 @@ static void imon_pad_to_keys(struct imon_context *ictx, unsigned char *buf)
1543 } 1543 }
1544} 1544}
1545 1545
1546/** 1546/*
1547 * figure out if these is a press or a release. We don't actually 1547 * figure out if these is a press or a release. We don't actually
1548 * care about repeats, as those will be auto-generated within the IR 1548 * care about repeats, as those will be auto-generated within the IR
1549 * subsystem for repeating scancodes. 1549 * subsystem for repeating scancodes.
@@ -1592,10 +1592,10 @@ static int imon_parse_press_type(struct imon_context *ictx,
1592 return press_type; 1592 return press_type;
1593} 1593}
1594 1594
1595/** 1595/*
1596 * Process the incoming packet 1596 * Process the incoming packet
1597 */ 1597 */
1598/** 1598/*
1599 * Convert bit count to time duration (in us) and submit 1599 * Convert bit count to time duration (in us) and submit
1600 * the value to lirc_dev. 1600 * the value to lirc_dev.
1601 */ 1601 */
@@ -1608,7 +1608,7 @@ static void submit_data(struct imon_context *context)
1608 ir_raw_event_store_with_filter(context->rdev, &ev); 1608 ir_raw_event_store_with_filter(context->rdev, &ev);
1609} 1609}
1610 1610
1611/** 1611/*
1612 * Process the incoming packet 1612 * Process the incoming packet
1613 */ 1613 */
1614static void imon_incoming_ir_raw(struct imon_context *context, 1614static void imon_incoming_ir_raw(struct imon_context *context,
@@ -1831,7 +1831,7 @@ not_input_data:
1831 } 1831 }
1832} 1832}
1833 1833
1834/** 1834/*
1835 * Callback function for USB core API: receive data 1835 * Callback function for USB core API: receive data
1836 */ 1836 */
1837static void usb_rx_callback_intf0(struct urb *urb) 1837static void usb_rx_callback_intf0(struct urb *urb)
@@ -2485,7 +2485,7 @@ static void imon_init_display(struct imon_context *ictx,
2485 2485
2486} 2486}
2487 2487
2488/** 2488/*
2489 * Callback function for USB core API: Probe 2489 * Callback function for USB core API: Probe
2490 */ 2490 */
2491static int imon_probe(struct usb_interface *interface, 2491static int imon_probe(struct usb_interface *interface,
@@ -2583,7 +2583,7 @@ fail:
2583 return ret; 2583 return ret;
2584} 2584}
2585 2585
2586/** 2586/*
2587 * Callback function for USB core API: disconnect 2587 * Callback function for USB core API: disconnect
2588 */ 2588 */
2589static void imon_disconnect(struct usb_interface *interface) 2589static void imon_disconnect(struct usb_interface *interface)