core/trivial: clearify code comment on error for nm_utils_ascii_str_to_int64()

Signed-off-by: Thomas Haller <thaller@redhat.com>

2 files changed, 7 insertions, 6 deletions

diff --git a/src/NetworkManagerUtils.c b/src/NetworkManagerUtils.c
index fbd69129b9..d41bf169bc 100644
--- a/src/NetworkManagerUtils.c
+++ b/src/NetworkManagerUtils.c
@@ -864,12 +864,13 @@ nm_utils_match_connection (GSList *connections,
  *
  * A wrapper for g_ascii_strtoll, that checks whether the whole string
  * can be successfully converted to a number and is within a given
- * range. On any error, @fallback will be returned and @errno will be set
- * to a non-zero value. Check @errno for errors. Any trailing or leading
- * (ascii) white space is ignored and the functions is locale independent.
+ * range. On any error, @fallback will be returned and %errno will be set
+ * to a non-zero value. On success, %errno will be set to zero, check %errno
+ * for errors. Any trailing or leading (ascii) white space is ignored and the
+ * functions is locale independent.
  *
  * The function is guaranteed to return a value between @min and @max
- * (included) or @fallback. Also, the parsing is rather strict, it does
+ * (inclusive) or @fallback. Also, the parsing is rather strict, it does
  * not allow for any unrecognized characters, except leading and trailing
  * white space.
  **/
diff --git a/src/platform/nm-platform.c b/src/platform/nm-platform.c
index ad39084c69..b8d1d8a1f1 100644
--- a/src/platform/nm-platform.c
+++ b/src/platform/nm-platform.c
@@ -274,8 +274,8 @@ nm_platform_sysctl_get (const char *path)
  * as decimal integer.
  *
  * Returns: contents of the sysctl file parsed as s32 integer, or
- * @fallback on error. Also, on error, @errno will be set to a non-zero
- * value.
+ * @fallback on error. On error, %errno will be set to a non-zero
+ * value, on success %errno will be set to zero.
  */
 gint32
 nm_platform_sysctl_get_int32 (const char *path, gint32 fallback)