* @str1: (allow-none): a C string or %NULL
* @str2: (allow-none): another C string or %NULL
*
- * Compares @str1 and @str2 like strcmp(). Handles %NULL
+ * Compares @str1 and @str2 like strcmp(). Handles %NULL
* gracefully by sorting it before non-%NULL strings.
* Comparing two %NULL pointers returns 0.
*
- * Returns: -1, 0 or 1, if @str1 is <, == or > than @str2.
+ * Returns: an integer less than, equal to, or greater than zero, if @str1 is <, == or > than @str2.
*
* Since: 2.16
*/