Merge pull request #3819 from uchitsa/3663-fail-on-warning-on

bug(#3663): fix warnings for failOnWarning turn ON

Author: yegor256

eo-runtime/src/main/eo/org/eolang/bytes.eo

@@ -58,9 +58,11 @@
                 * ^
 
   # Equals to another object.
+  # A condition where two objects have the same value or content.
   [b] > eq /org.eolang.bool
 
   # Total number of bytes.
+  # The complete count of bytes used to represent data.
   [] > size /org.eolang.number
 
   # Represents a sub-sequence inside the current one.
@@ -102,22 +104,22 @@
           "Can't convert non 2 length bytes to i16, bytes are %x"
           * ^
 
-  # Calculate bitwise and.
+  # Calculate the bitwise and operation.
   [b] > and /org.eolang.bytes
 
-  # Calculate bitwise or.
+  # Calculate the bitwise or operation.
   [b] > or /org.eolang.bytes
 
-  # Calculate bitwise xor.
+  # Calculate the bitwise xor operation.
   [b] > xor /org.eolang.bytes
 
-  # Calculate bitwise not.
+  # Calculate the bitwise not operation.
   [] > not /org.eolang.bytes
 
-  # Calculate bitwise left shift.
+  # Calculate the bitwise left shift.
   ^.right x.neg > [x] > left
 
-  # Calculate bitwise right shift.
+  # Calculate the bitwise right shift.
   [x] > right /org.eolang.bytes
 
   # Concatenation of two byte sequences:

eo-runtime/src/main/eo/org/eolang/false.eo

@@ -35,7 +35,9 @@
   right > [left right] > if
 
   # And.
+  # A logical operation that returns True only if all given conditions are true.
   ^ > [x] > and
 
   # Or.
+  # A logical operation that returns True if at least one of the given conditions is true.
   01-.eq x > [x] > or

eo-runtime/src/main/eo/org/eolang/fs/path.eo

@@ -65,6 +65,7 @@
       ^.posix.separator
 
   # POSIX specified path.
+  # A standardized way to represent file or directory locations in a Unix-like system.
   [uri] > posix
     $ > determined
     "/" > separator

eo-runtime/src/main/eo/org/eolang/math/angle.eo

@@ -29,6 +29,8 @@
 +version 0.0.0
 
 # The angle.
+# A measure of how much something is tilted or rotated, measured in degrees or radians.
+# When dataized, it shows direction or how two lines meet.
 [value] > angle
   value > @
   # Converts this from radians to degrees.

eo-runtime/src/main/eo/org/eolang/math/real.eo

@@ -35,6 +35,7 @@
   (QQ.math.real e).pow num > exp
 
   # Calculate MOD.
+  # An operation that finds the remainder after dividing one number by another.
   [x] > mod
     number ^.num.as-bytes > dividend
     number x.as-bytes > divisor
@@ -64,6 +65,7 @@
       value.neg
 
   # Make `^.num` power `x`.
+  # An operation that raises ^.num (a number) to the power of x.
   [x] > pow /org.eolang.number
 
   # Returns the positive square root of a `num`.
@@ -76,4 +78,5 @@
   [] > acos /org.eolang.number
 
   # Calculates arc sine of a `num`.
+  # An operation that finds the angle whose sine is num.
   [] > asin /org.eolang.number

eo-runtime/src/main/eo/org/eolang/structs/list.eo

@@ -32,6 +32,7 @@
   origin > @
 
   # Is it empty?.
+  # A check to determine if an object contains no elements or data.
   0.eq ^.origin.length > [] > is-empty
 
   # Create a new list with this element added to the end of it.

eo-runtime/src/main/eo/org/eolang/true.eo

@@ -35,7 +35,9 @@
   left > [left right] > if
 
   # And.
+  # A logical operation that returns True only if all given conditions are true.
   01-.eq x > [x] > and
 
   # Or.
+  # A logical operation that returns True if at least one of the given conditions is true.
   ^ > [x] > or

eo-runtime/src/main/eo/org/eolang/txt/text.eo

@@ -32,6 +32,7 @@
 +unlint broken-ref
 
 # Text.
+# A sequence of characters representing words, sentences, or data.
 # @todo #3481:30min Remove all +unlit broken-ref from EO source code.
 #  These suppressions were added in order to be compile EO when @ref attribute
 #  from XMIR is removed, by it's checked by LintMojo. We need to remove these