Commit 255940e6 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab

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: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent 64dc6829
...@@ -492,7 +492,7 @@ static void free_imon_context(struct imon_context *ictx) ...@@ -492,7 +492,7 @@ static void free_imon_context(struct imon_context *ictx)
dev_dbg(dev, "%s: iMON context freed\n", __func__); dev_dbg(dev, "%s: iMON context freed\n", __func__);
} }
/** /*
* Called when the Display device (e.g. /dev/lcd0) * Called when the Display device (e.g. /dev/lcd0)
* is opened by the application. * is opened by the application.
*/ */
...@@ -542,7 +542,7 @@ static int display_open(struct inode *inode, struct file *file) ...@@ -542,7 +542,7 @@ static int display_open(struct inode *inode, struct file *file)
return retval; return retval;
} }
/** /*
* Called when the display device (e.g. /dev/lcd0) * Called when the display device (e.g. /dev/lcd0)
* is closed by the application. * is closed by the application.
*/ */
...@@ -575,7 +575,7 @@ static int display_close(struct inode *inode, struct file *file) ...@@ -575,7 +575,7 @@ static int display_close(struct inode *inode, struct file *file)
return retval; return retval;
} }
/** /*
* Sends a packet to the device -- this function must be called with * Sends a packet to the device -- this function must be called with
* ictx->lock held, or its unlock/lock sequence while waiting for tx * ictx->lock held, or its unlock/lock sequence while waiting for tx
* to complete can/will lead to a deadlock. * to complete can/will lead to a deadlock.
...@@ -664,7 +664,7 @@ static int send_packet(struct imon_context *ictx) ...@@ -664,7 +664,7 @@ static int send_packet(struct imon_context *ictx)
return retval; return retval;
} }
/** /*
* Sends an associate packet to the iMON 2.4G. * Sends an associate packet to the iMON 2.4G.
* *
* This might not be such a good idea, since it has an id collision with * 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,7 +694,7 @@ static int send_associate_24g(struct imon_context *ictx)
return retval; return retval;
} }
/** /*
* Sends packets to setup and show clock on iMON display * Sends packets to setup and show clock on iMON display
* *
* Arguments: year - last 2 digits of year, month - 1..12, * 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,7 +781,7 @@ static int send_set_imon_clock(struct imon_context *ictx,
return retval; return retval;
} }
/** /*
* These are the sysfs functions to handle the association on the iMON 2.4G LT. * These are the sysfs functions to handle the association on the iMON 2.4G LT.
*/ */
static ssize_t show_associate_remote(struct device *d, static ssize_t show_associate_remote(struct device *d,
...@@ -823,7 +823,7 @@ static ssize_t store_associate_remote(struct device *d, ...@@ -823,7 +823,7 @@ static ssize_t store_associate_remote(struct device *d,
return count; return count;
} }
/** /*
* sysfs functions to control internal imon clock * sysfs functions to control internal imon clock
*/ */
static ssize_t show_imon_clock(struct device *d, static ssize_t show_imon_clock(struct device *d,
...@@ -923,7 +923,7 @@ static const struct attribute_group imon_rf_attr_group = { ...@@ -923,7 +923,7 @@ static const struct attribute_group imon_rf_attr_group = {
.attrs = imon_rf_sysfs_entries .attrs = imon_rf_sysfs_entries
}; };
/** /*
* Writes data to the VFD. The iMON VFD is 2x16 characters * Writes data to the VFD. The iMON VFD is 2x16 characters
* and requires data in 5 consecutive USB interrupt packets, * and requires data in 5 consecutive USB interrupt packets,
* each packet but the last carrying 7 bytes. * each packet but the last carrying 7 bytes.
...@@ -1008,7 +1008,7 @@ static ssize_t vfd_write(struct file *file, const char __user *buf, ...@@ -1008,7 +1008,7 @@ static ssize_t vfd_write(struct file *file, const char __user *buf,
return (!retval) ? n_bytes : retval; return (!retval) ? n_bytes : retval;
} }
/** /*
* Writes data to the LCD. The iMON OEM LCD screen expects 8-byte * Writes data to the LCD. The iMON OEM LCD screen expects 8-byte
* packets. We accept data as 16 hexadecimal digits, followed by a * packets. We accept data as 16 hexadecimal digits, followed by a
* newline (to make it easy to drive the device from a command-line * newline (to make it easy to drive the device from a command-line
...@@ -1066,7 +1066,7 @@ static ssize_t lcd_write(struct file *file, const char __user *buf, ...@@ -1066,7 +1066,7 @@ static ssize_t lcd_write(struct file *file, const char __user *buf,
return (!retval) ? n_bytes : retval; return (!retval) ? n_bytes : retval;
} }
/** /*
* Callback function for USB core API: transmit data * Callback function for USB core API: transmit data
*/ */
static void usb_tx_callback(struct urb *urb) static void usb_tx_callback(struct urb *urb)
...@@ -1087,7 +1087,7 @@ static void usb_tx_callback(struct urb *urb) ...@@ -1087,7 +1087,7 @@ static void usb_tx_callback(struct urb *urb)
complete(&ictx->tx.finished); complete(&ictx->tx.finished);
} }
/** /*
* report touchscreen input * report touchscreen input
*/ */
static void imon_touch_display_timeout(struct timer_list *t) static void imon_touch_display_timeout(struct timer_list *t)
...@@ -1103,7 +1103,7 @@ static void imon_touch_display_timeout(struct timer_list *t) ...@@ -1103,7 +1103,7 @@ static void imon_touch_display_timeout(struct timer_list *t)
input_sync(ictx->touch); input_sync(ictx->touch);
} }
/** /*
* iMON IR receivers support two different signal sets -- those used by * iMON IR receivers support two different signal sets -- those used by
* the iMON remotes, and those used by the Windows MCE remotes (which is * the iMON remotes, and those used by the Windows MCE remotes (which is
* really just RC-6), but only one or the other at a time, as the signals * 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,7 +1191,7 @@ static inline int tv2int(const struct timeval *a, const struct timeval *b)
return sec; return sec;
} }
/** /*
* The directional pad behaves a bit differently, depending on whether this is * The directional pad behaves a bit differently, depending on whether this is
* one of the older ffdc devices or a newer device. Newer devices appear to * one of the older ffdc devices or a newer device. Newer devices appear to
* have a higher resolution matrix for more precise mouse movement, but it * 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,7 +1543,7 @@ static void imon_pad_to_keys(struct imon_context *ictx, unsigned char *buf)
} }
} }
/** /*
* figure out if these is a press or a release. We don't actually * figure out if these is a press or a release. We don't actually
* care about repeats, as those will be auto-generated within the IR * care about repeats, as those will be auto-generated within the IR
* subsystem for repeating scancodes. * subsystem for repeating scancodes.
...@@ -1592,10 +1592,10 @@ static int imon_parse_press_type(struct imon_context *ictx, ...@@ -1592,10 +1592,10 @@ static int imon_parse_press_type(struct imon_context *ictx,
return press_type; return press_type;
} }
/** /*
* Process the incoming packet * Process the incoming packet
*/ */
/** /*
* Convert bit count to time duration (in us) and submit * Convert bit count to time duration (in us) and submit
* the value to lirc_dev. * the value to lirc_dev.
*/ */
...@@ -1608,7 +1608,7 @@ static void submit_data(struct imon_context *context) ...@@ -1608,7 +1608,7 @@ static void submit_data(struct imon_context *context)
ir_raw_event_store_with_filter(context->rdev, &ev); ir_raw_event_store_with_filter(context->rdev, &ev);
} }
/** /*
* Process the incoming packet * Process the incoming packet
*/ */
static void imon_incoming_ir_raw(struct imon_context *context, static void imon_incoming_ir_raw(struct imon_context *context,
...@@ -1831,7 +1831,7 @@ static void imon_incoming_scancode(struct imon_context *ictx, ...@@ -1831,7 +1831,7 @@ static void imon_incoming_scancode(struct imon_context *ictx,
} }
} }
/** /*
* Callback function for USB core API: receive data * Callback function for USB core API: receive data
*/ */
static void usb_rx_callback_intf0(struct urb *urb) static void usb_rx_callback_intf0(struct urb *urb)
...@@ -2485,7 +2485,7 @@ static void imon_init_display(struct imon_context *ictx, ...@@ -2485,7 +2485,7 @@ static void imon_init_display(struct imon_context *ictx,
} }
/** /*
* Callback function for USB core API: Probe * Callback function for USB core API: Probe
*/ */
static int imon_probe(struct usb_interface *interface, static int imon_probe(struct usb_interface *interface,
...@@ -2583,7 +2583,7 @@ static int imon_probe(struct usb_interface *interface, ...@@ -2583,7 +2583,7 @@ static int imon_probe(struct usb_interface *interface,
return ret; return ret;
} }
/** /*
* Callback function for USB core API: disconnect * Callback function for USB core API: disconnect
*/ */
static void imon_disconnect(struct usb_interface *interface) static void imon_disconnect(struct usb_interface *interface)
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment