Changes in uspace/lib/usb/src/recognise.c [bc1c6fb:3f0ef89d] in mainline

File:

• uspace/lib/usb/src/recognise.c (modified) (5 diffs)

uspace/lib/usb/src/recognise.c

@@ -31 +31 @@
  */
 /** @file
- * Functions for recognition of attached devices.
+ * @brief Functions for recognising kind of attached devices.
  */
 #include <sys/types.h>
@@ -44 +44 @@
 #include <assert.h>
 
-/** Index to append after device name for uniqueness. */
 static size_t device_name_index = 0;
-/** Mutex guard for device_name_index. */
 static FIBRIL_MUTEX_INITIALIZE(device_name_index_mutex);
 
-/** DDF operations of child devices. */
 ddf_dev_ops_t child_ops = {
         .interfaces[USB_DEV_IFACE] = &usb_iface_hub_child_impl
 };
 
-/** Get integer part from BCD coded number. */
 #define BCD_INT(a) (((unsigned int)(a)) / 256)
-/** Get fraction part from BCD coded number (as an integer, no less). */
 #define BCD_FRAC(a) (((unsigned int)(a)) % 256)
 
-/** Format for BCD coded number to be used in printf. */
 #define BCD_FMT "%x.%x"
-/** Arguments to printf for BCD coded number. */
 #define BCD_ARGS(a) BCD_INT((a)), BCD_FRAC((a))
 
@@ -120 +113 @@
 }
 
-/** Add match id to list or return with error code.
- *
- * @param match_ids List of match ids.
- * @param score Match id score.
- * @param format Format of the matching string
- * @param ... Arguments for the format.
- */
 #define ADD_MATCHID_OR_RETURN(match_ids, score, format, ...) \
         do { \
@@ -138 +124 @@
 /** Create device match ids based on its interface.
  *
- * @param[in] desc_device Device descriptor.
- * @param[in] desc_interface Interface descriptor.
+ * @param[in] descriptor Interface descriptor.
  * @param[out] matches Initialized list of match ids.
  * @return Error code (the two mentioned are not the only ones).
  * @retval EINVAL Invalid input parameters (expects non NULL pointers).
- * @retval ENOENT Device class is not "use interface".
+ * @retval ENOENT Interface does not specify class.
  */
 int usb_device_create_match_ids_from_interface(
@@ -334 +319 @@
  * @param[in] parent Parent device.
  * @param[out] child_handle Handle of the child device.
- * @param[in] dev_ops Child device ops.
- * @param[in] dev_data Arbitrary pointer to be stored in the child
- *      as @c driver_data.
- * @param[out] child_fun Storage where pointer to allocated child function
- *      will be written.
  * @return Error code.
  */