[jira] [Created] (COLLECTIONS-749) Better documentation needed for HashFunctionIdentity.Signedness

["Claude Warren (Jira)" <ji...@apache.org>]

Claude Warren created COLLECTIONS-749:
-----------------------------------------

             Summary: Better documentation needed for HashFunctionIdentity.Signedness
                 Key: COLLECTIONS-749
                 URL: https://issues.apache.org/jira/browse/COLLECTIONS-749
             Project: Commons Collections
          Issue Type: Improvement
          Components: Collection
    Affects Versions: 4.5
            Reporter: Claude Warren


From Alex Herbert:

HashFunctionIdentity.Signedness
 
 This is not fully documented as to what the sign applies to. There is no 
 javadoc on the enum values for SIGNED and UNSIGNED. The current javadoc 
 states "Identifies the signedness of the calculations for this function".
 
 I assume this applies to the Hash computation in 'long 
 HashFunction.apply(byte[], int)'
 
 Does this mean the hash algorithm has a variant that can treat the 
 bytes/seed as signed or unsigned. If so which one because 2 enum values 
 cannot cover all 4 possibilities. Since there is no javadoc it is 
 unclear exactly what this property is supposed to indicate.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)