Fix documentation in PSA crypto metadata tests

Fix and improve the documentation of the test_parity() function in
PSA crypto metadata tests:
. Align the short description of the function with the function
name: "Test ..." instead of "Check ..."
. Fix the description of the returned value: the returned value
is nonzero, not zero, if the parity is even.
. Add documentation explaining the needs for parity testing and
that the parity is expected to be even.

Signed-off-by: Ronald Cron <[email protected]>

Author: ronald-cron-arm

tests/suites/test_suite_psa_crypto_metadata.function

@@ -56,8 +56,13 @@
 #define TEST_CLASSIFICATION_MACRO( flag, alg, flags )           \
     TEST_ASSERT( PSA_##flag( alg ) == !! ( ( flags ) & flag ) )
 
-/* Check the parity of value.
- * Return 0 if value has even parity and a nonzero value otherwise. */
+/* Test the parity of value.
+ * Numerical encodings of key types and related values such as EC curves and
+ * DH groups should all have the same parity. This guarantees that a
+ * single-bit error will be detected.
+ * The expected parity is even because this makes all-bits-zero valid.
+ * The function returns a nonzero value if the parity is even, zero otherwise.
+ */
 int test_parity( uint32_t value )
 {
     value ^= value >> 16;