staging: gpib: ni_usb: fixes multiline comments style
authorPaul Retourné <paul.retourne@orange.fr>
Sat, 12 Apr 2025 07:07:54 +0000 (00:07 -0700)
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Tue, 15 Apr 2025 14:49:29 +0000 (16:49 +0200)
Fixes the style of multiline comments to comply with the linux kernel
coding style.

Signed-off-by: Paul Retourné <paul.retourne@orange.fr>
Link: https://lore.kernel.org/r/4b2762d349e06db8f541a86ca0ec429bc1351097.1744438358.git.paul.retourne@orange.fr
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
drivers/staging/gpib/ni_usb/ni_usb_gpib.c
drivers/staging/gpib/ni_usb/ni_usb_gpib.h

index f0b64ef1f44cb9dc36a00bfc1cbe11e1ed4acd47..00f788a59dcc6e2602962fc3038c1e1d2f8da788 100644 (file)
@@ -74,7 +74,8 @@ static unsigned short ni_usb_timeout_code(unsigned int usec)
                return 0xff;
        else if  (usec <= 300000000)
                return 0x01;
-       /* NI driver actually uses 0xff for timeout T1000s, which is a bug in their code.
+       /*
+        * NI driver actually uses 0xff for timeout T1000s, which is a bug in their code.
         * I've verified on a usb-b that a code of 0x2 is correct for a 1000 sec timeout
         */
        else if (usec <= 1000000000)
@@ -232,7 +233,8 @@ static int ni_usb_nonblocking_receive_bulk_msg(struct ni_usb_priv *ni_priv,
        mutex_unlock(&ni_priv->bulk_transfer_lock);
        if (interruptible) {
                if (wait_for_completion_interruptible(&context->complete)) {
-                       /* If we got interrupted by a signal while
+                       /*
+                        * If we got interrupted by a signal while
                         * waiting for the usb gpib to respond, we
                         * should send a stop command so it will
                         * finish up with whatever it was doing and
@@ -240,8 +242,9 @@ static int ni_usb_nonblocking_receive_bulk_msg(struct ni_usb_priv *ni_priv,
                         */
                        ni_usb_stop(ni_priv);
                        retval = -ERESTARTSYS;
-                       /* now do an uninterruptible wait, it shouldn't take long
-                        *      for the board to respond now.
+                       /*
+                        * now do an uninterruptible wait, it shouldn't take long
+                        * for the board to respond now.
                         */
                        wait_for_completion(&context->complete);
                }
@@ -684,7 +687,8 @@ static int ni_usb_read(struct gpib_board *board, uint8_t *buffer, size_t length,
                retval = 0;
                break;
        case NIUSB_ABORTED_ERROR:
-               /* this is expected if ni_usb_receive_bulk_msg got
+               /*
+                * this is expected if ni_usb_receive_bulk_msg got
                 * interrupted by a signal and returned -ERESTARTSYS
                 */
                break;
@@ -794,7 +798,8 @@ static int ni_usb_write(struct gpib_board *board, uint8_t *buffer, size_t length
                retval = 0;
                break;
        case NIUSB_ABORTED_ERROR:
-               /* this is expected if ni_usb_receive_bulk_msg got
+               /*
+                * this is expected if ni_usb_receive_bulk_msg got
                 * interrupted by a signal and returned -ERESTARTSYS
                 */
                break;
@@ -893,7 +898,8 @@ static int ni_usb_command_chunk(struct gpib_board *board, uint8_t *buffer, size_
        case NIUSB_NO_ERROR:
                break;
        case NIUSB_ABORTED_ERROR:
-               /* this is expected if ni_usb_receive_bulk_msg got
+               /*
+                * this is expected if ni_usb_receive_bulk_msg got
                 * interrupted by a signal and returned -ERESTARTSYS
                 */
                break;
@@ -1192,8 +1198,9 @@ static int ni_usb_enable_eos(struct gpib_board *board, uint8_t eos_byte, int com
 static void ni_usb_disable_eos(struct gpib_board *board)
 {
        struct ni_usb_priv *ni_priv = board->private_data;
-       /* adapter gets unhappy if you don't zero all the bits
-        *      for the eos mode and eos char (returns error 4 on reads).
+       /*
+        * adapter gets unhappy if you don't zero all the bits
+        * for the eos mode and eos char (returns error 4 on reads).
         */
        ni_priv->eos_mode = 0;
        ni_priv->eos_char = 0;
@@ -2045,8 +2052,10 @@ static int ni_usb_hs_wait_for_ready(struct ni_usb_priv *ni_priv)
                        unexpected = 1;
                }
                ++j;
-               // MC usb-488 (and sometimes NI-USB-HS?) sends 0x8 here; MC usb-488A sends 0x7 here
-               // NI-USB-HS+ sends 0x0
+               /*
+                * MC usb-488 (and sometimes NI-USB-HS?) sends 0x8 here; MC usb-488A sends 0x7 here
+                * NI-USB-HS+ sends 0x0
+                */
                if (buffer[j] != 0x1 && buffer[j] != 0x8 && buffer[j] != 0x7 && buffer[j] != 0x0) {
                        // [3]
                        dev_err(&usb_dev->dev, "unexpected data: buffer[%i]=0x%x, expected 0x0, 0x1, 0x7 or 0x8\n",
@@ -2127,7 +2136,8 @@ ready_out:
        return retval;
 }
 
-/* This does some extra init for HS+ models, as observed on Windows.  One of the
+/*
+ * This does some extra init for HS+ models, as observed on Windows.  One of the
  * control requests causes the LED to stop blinking.
  * I'm not sure what the other 2 requests do.  None of these requests are actually required
  * for the adapter to work, maybe they do some init for the analyzer interface
@@ -2343,8 +2353,10 @@ static void ni_usb_detach(struct gpib_board *board)
        struct ni_usb_priv *ni_priv;
 
        mutex_lock(&ni_usb_hotplug_lock);
-// under windows, software unplug does chip_reset nec7210 aux command,
-// then writes 0x0 to address 0x10 of device 3
+       /*
+        * under windows, software unplug does chip_reset nec7210 aux command,
+        * then writes 0x0 to address 0x10 of device 3
+        */
        ni_priv = board->private_data;
        if (ni_priv) {
                if (ni_priv->bus_interface) {
index 4b297db09a9bf567e08209764bfe0eab7c2ad621..b011e131201c1927bbdaf82263ec96d1845e8de8 100644 (file)
@@ -113,27 +113,37 @@ enum ni_usb_bulk_ids {
 
 enum ni_usb_error_codes {
        NIUSB_NO_ERROR = 0,
-       /* NIUSB_ABORTED_ERROR occurs when I/O is interrupted early by
-        *      doing a NI_USB_STOP_REQUEST on the control endpoint.
+       /*
+        * NIUSB_ABORTED_ERROR occurs when I/O is interrupted early by
+        * doing a NI_USB_STOP_REQUEST on the control endpoint.
         */
        NIUSB_ABORTED_ERROR = 1,
-       // NIUSB_READ_ATN_ERROR occurs when you do a board read while
-       // ATN is set
+       /*
+        * NIUSB_READ_ATN_ERROR occurs when you do a board read while
+        * ATN is set
+        */
        NIUSB_ATN_STATE_ERROR = 2,
-       // NIUSB_ADDRESSING_ERROR occurs when you do a board
-       // read/write as CIC but are not in LACS/TACS
+       /*
+        * NIUSB_ADDRESSING_ERROR occurs when you do a board
+        * read/write as CIC but are not in LACS/TACS
+        */
        NIUSB_ADDRESSING_ERROR = 3,
-       /* NIUSB_EOSMODE_ERROR occurs on reads if any eos mode or char
+       /*
+        * NIUSB_EOSMODE_ERROR occurs on reads if any eos mode or char
         * bits are set when REOS is not set.
         * Have also seen error 4 if you try to send more than 16
         * command bytes at once on a usb-b.
         */
        NIUSB_EOSMODE_ERROR = 4,
-       // NIUSB_NO_BUS_ERROR occurs when you try to write a command
-       // byte but there are no devices connected to the gpib bus
+       /*
+        * NIUSB_NO_BUS_ERROR occurs when you try to write a command
+        * byte but there are no devices connected to the gpib bus
+        */
        NIUSB_NO_BUS_ERROR = 5,
-       // NIUSB_NO_LISTENER_ERROR occurs when you do a board write as
-       // CIC with no listener
+       /*
+        * NIUSB_NO_LISTENER_ERROR occurs when you do a board write as
+        * CIC with no listener
+        */
        NIUSB_NO_LISTENER_ERROR = 8,
        // get NIUSB_TIMEOUT_ERROR on board read/write timeout
        NIUSB_TIMEOUT_ERROR = 10,