[ci skip] Correct javadoc for Weapon Component (#13096)

Author: JustAHuman-xD

paper-api/src/main/java/io/papermc/paper/datacomponent/item/Weapon.java

@@ -19,12 +19,16 @@ static Builder weapon() {
     }
 
     /**
-     * The damage that the weapon deals per attack.
+     * Amount of durability to remove each time the weapon is used to attack.
+     *
+     * @return durability
      */
     int itemDamagePerAttack();
 
     /**
      * The number of seconds that blocking is disabled.
+     *
+     * @return seconds
      */
     float disableBlockingForSeconds();
 
@@ -36,10 +40,11 @@ static Builder weapon() {
     interface Builder extends DataComponentBuilder<Weapon> {
 
         /**
-         * Sets the damage per attack.
+         * Controls the amount of durability to remove each time the weapon is used to attack.
          *
-         * @param damage the damage value.
-         * @return the builder for chaining.
+         * @param damage durability to remove
+         * @return the builder for chaining
+         * @see #itemDamagePerAttack()
          */
         Builder itemDamagePerAttack(int damage);