[X2Go-Commits] [libx2goclient] 128/132: src/x2goclient-utils.c: the style guide says to determinate parameter descriptions with a period, so do that.

git-admin at x2go.org git-admin at x2go.org
Fri Dec 3 15:26:37 CET 2021


This is an automated email from the git hooks/post-receive script.

x2go pushed a commit to branch master
in repository libx2goclient.

commit 69a80c8b20fa2ac1f0ea9fc491c8ac32c0cd29e3
Author: Mihai Moldovan <ionic at ionic.de>
Date:   Fri Dec 3 13:40:31 2021 +0100

    src/x2goclient-utils.c: the style guide says to determinate parameter descriptions with a period, so do that.
---
 src/x2goclient-utils.c | 31 ++++++++++++++++---------------
 1 file changed, 16 insertions(+), 15 deletions(-)

diff --git a/src/x2goclient-utils.c b/src/x2goclient-utils.c
index ac1a16c..dce7288 100644
--- a/src/x2goclient-utils.c
+++ b/src/x2goclient-utils.c
@@ -50,7 +50,7 @@
 
 /**
  * x2goclient_clear_strings:
- * @data: (in) (nullable): input string
+ * @data: (in) (nullable): input string.
  *
  * Frees the string passed as @data. It's safe to pass %NULL.
  *
@@ -62,22 +62,22 @@ void x2goclient_clear_strings (gpointer data) {
 
 /**
  * x2goclient_str_to_int:
- * @str: (in) (not nullable): input string
- * @min: (in): true if a minimum limit should be checked for
- * @limit_min: (in): the minimum limit to check for
- * @max: (in): true if a maximum limit should be checked for
- * @limit_max: (in): the maximum limit to check for
+ * @str: (in) (not nullable): input string.
+ * @min: (in): true if a minimum limit should be checked for.
+ * @limit_min: (in): the minimum limit to check for.
+ * @max: (in): true if a maximum limit should be checked for.
+ * @limit_max: (in): the maximum limit to check for.
  * @end: (out) (optional) (nullable): pointer to final string after the scanned
- *                                    value
+ *                                    value.
  * @conv_err: (out) (not nullable) (type gboolean*): will be set to true on
- *                                                   conversion errors
+ *                                                   conversion errors.
  * @min_err: (out) (not nullable) (type gboolean*): will be set to true if
  *                                                  value falls short of
  *                                                  minimum limit and on
- *                                                  underflows
+ *                                                  underflows.
  * @max_err: (out) (not nullable) (type gboolean*): will be set to true if
  *                                                  value exceeds maximum limit
- *                                                  and on overflows
+ *                                                  and on overflows.
  *
  * Takes a string and converts it into a #long long int.
  *
@@ -182,11 +182,12 @@ long long int x2goclient_str_to_int (const gchar * const restrict str, const _Bo
 
 /**
  * x2goclient_strbrk_dup:
- * @haystack: (inout) (not nullable) (transfer none): pointer to input string
- * @needle: (in): character to split/break at
- * @free_orig: (in): request that the original string be g_free()'d at the end
+ * @haystack: (inout) (not nullable) (transfer none): pointer to input string.
+ * @needle: (in): character to split/break at.
+ * @free_orig: (in): request that the original string be g_free()'d at the
+ *                   end.
  * @new_size: (out) (nullable): will be set to the copied string's size if a
- *                              copy was created
+ *                              copy was created.
  *
  * Searches for the first occurrence of a specific character in a string and
  * returns a copy of the string up to that location, potentially freeing the
@@ -266,7 +267,7 @@ gchar* x2goclient_strbrk_dup (gchar * restrict * const haystack, const char need
 
 /**
  * x2goclient_bool_to_str:
- * @in: (in): input boolean
+ * @in: (in): input boolean.
  *
  * Takes a boolean and converts it to a (static) string.
  *

--
Alioth's /home/x2go-admin/maintenancescripts/git/hooks/post-receive-email on /srv/git/code.x2go.org/libx2goclient.git


More information about the x2go-commits mailing list