Minor fixes in Javadoc

Author: manuelbl

java-does-usb/src/main/java/net/codecrete/usb/UsbAlternateInterface.java

@@ -24,6 +24,7 @@ public interface UsbAlternateInterface {
      * Gets the alternate setting number.
      * <p>
      * It is equal to the {@code bAlternateSetting} field of the interface descriptor.
+     * </p>
      *
      * @return the alternate setting number
      */
@@ -60,7 +61,7 @@ public interface UsbAlternateInterface {
     int getProtocolCode();
 
     /**
-     * Gets the endpoints of this alternate interface settings.
+     * Gets the endpoints of this alternate interface setting.
      * <p>
      * The endpoint list does not include endpoint 0, which
      * is always available and reserved for control transfers.

java-does-usb/src/main/java/net/codecrete/usb/UsbControlTransfer.java

@@ -20,9 +20,9 @@
  *
  * @param requestType request type (bits 5 and 6 of {@code bmRequestType})
  * @param recipient   recipient (bits 0–4 of {@code bmRequestType})
- * @param request     request code (value between 0 and 255, called {@code bRequest} in USB specification)
- * @param value       value (value between 0 and 65535, called {@code wValue} in USB specification)
- * @param index       index (value between 0 and 65535, called {@code wIndex} in USB specification).
+ * @param request     request code (value between 0 and 255, called {@code bRequest} in the USB specification)
+ * @param value       value (value between 0 and 65535, called {@code wValue} in the USB specification)
+ * @param index       index (value between 0 and 65535, called {@code wIndex} in the USB specification)
  */
 public record UsbControlTransfer(
         UsbRequestType requestType,

java-does-usb/src/main/java/net/codecrete/usb/UsbDevice.java

@@ -18,7 +18,7 @@
  * USB device.
  * <p>
  * In order to make control requests and transfer data, the device must be
- * opened and an interface must be claimed. In the open state, this current
+ * opened and an interface must be claimed. In the open state, the current
  * process has exclusive access to the device.
  * </p>
  * <p>
@@ -50,14 +50,14 @@ public interface UsbDevice {
     String getProduct();
 
     /**
-     * Manufacturer name
+     * Manufacturer name.
      *
      * @return manufacturer name or {@code null} if not provided by the device
      */
     String getManufacturer();
 
     /**
-     * Serial number
+     * Serial number.
      * <p>
      * Even though this is supposed to be a human-readable string,
      * some devices are known to provide binary data.
@@ -144,7 +144,7 @@ public interface UsbDevice {
      * <p>
      * On Linux, this method changes the behavior of {@link #claimInterface(int)}. Standard drivers will no longer be
      * detached when the interface is claimed. Standard drivers are automatically reattached when the interfaces
-     * are released, at the lasted when the device is closed.
+     * are released, at the latest when the device is closed.
      * </p>
      * <p>
      * On Windows, this method does nothing.

java-does-usb/src/main/java/net/codecrete/usb/UsbDevicePredicate.java

@@ -23,12 +23,12 @@ public interface UsbDevicePredicate {
      * Evaluates this predicate on the given USB device.
      *
      * @param device the USB device
-     * @return {@code true} of the devices matches the predicate, otherwise {@code false}
+     * @return {@code true} if the device matches the predicate, otherwise {@code false}
      */
     boolean matches(@NotNull UsbDevice device);
 
     /**
-     * Test if the USB devices matches any of the filter conditions.
+     * Tests whether the USB device matches any of the filter conditions.
      *
      * @param device  the USB device
      * @param predicates a list of filter predicates

java-does-usb/src/main/java/net/codecrete/usb/UsbInterface.java

@@ -40,15 +40,15 @@ public interface UsbInterface {
     /**
      * Gets the currently selected alternate interface setting.
      * <p>
-     * Initially, the alternate settings with number 0 is selected.
+     * Initially, the alternate setting with number 0 is selected.
      * </p>
      *
      * @return the alternate interface setting.
      */
     @NotNull UsbAlternateInterface getCurrentAlternate();
 
     /**
-     * Gets the alternate interface settings with the specified number.
+     * Gets the alternate interface setting with the specified number.
      *
      * @param alternateNumber alternate setting number
      * @return alternate interface setting

java-does-usb/src/main/java/net/codecrete/usb/UsbStallException.java

@@ -10,13 +10,13 @@
 import org.jetbrains.annotations.NotNull;
 
 /**
- * Exception thrown if a communication on a USB endpoint failed.
+ * Exception thrown if communication on a USB endpoint fails.
  * <p>
  * If a USB endpoint stalls, it is halted and the halt condition must be cleared
  * using {@link UsbDevice#clearHalt(UsbDirection, int)} before communication can resume.
  * </p>
  * <p>
- * If the control endpoint 0 stalls, it throws this exception but is not halted.
+ * If the control endpoint 0 stalls, this exception is thrown but the endpoint is not halted.
  * </p>
  */
 public class UsbStallException extends UsbException {

java-does-usb/src/main/java/net/codecrete/usb/Version.java

@@ -19,7 +19,7 @@ public final class Version {
      * <p>
      * {@code bcdVersion} contains the version: the high byte is the major
      * version. The low byte is split into two nibbles (4 bits), the high one
-     * is minor version, the low one is the subminor version. As an example,
+     * is the minor version, the low one is the subminor version. As an example,
      * 0x0321 represents the version 3.2.1.
      * </p>
      *