[X2Go-Commits] [libx2goclient] 121/132: src/x2goclient-{network-{ssh, stub}, openssh-{bugs, version}}.c: add missing documentation.

git-admin at x2go.org git-admin at x2go.org
Fri Dec 3 15:26:36 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 7a9d3995edd5cd5bfdfb8b86f0c99d5035ceb21b
Author: Mihai Moldovan <ionic at ionic.de>
Date:   Fri Dec 3 13:03:37 2021 +0100

    src/x2goclient-{network-{ssh,stub},openssh-{bugs,version}}.c: add missing documentation.
---
 src/x2goclient-network-ssh.c     | 15 +++++++++++++++
 src/x2goclient-network-stub.c    | 13 +++++++++++++
 src/x2goclient-openssh-bugs.c    | 34 ++++++++++++++++++++++++++++++++++
 src/x2goclient-openssh-version.c | 34 ++++++++++++++++++++++++++++++++++
 4 files changed, 96 insertions(+)

diff --git a/src/x2goclient-network-ssh.c b/src/x2goclient-network-ssh.c
index badb642..8c11e7f 100644
--- a/src/x2goclient-network-ssh.c
+++ b/src/x2goclient-network-ssh.c
@@ -265,6 +265,21 @@ static void x2goclient_network_ssh_init (X2GoClientNetworkSSH * const self) {
   self->check_thread_loop = NULL;
 }
 
+/**
+ * x2goclient_network_ssh_new:
+ * @session_path: (in) (transfer none): the session path root to be used for
+ *                                      temporary session data.
+ *
+ * Creates a new #X2GoClientNetworkSSH instance, rooted at the path indicated
+ * by @session_path.
+ *
+ * No connection is being established by just creating such an object, which
+ * is also showcased by it not taking a remote location.
+ *
+ * Returns: (transfer full): the new #X2GoClientNetworkSSH instance
+ *
+ * Since: 0.0.0
+ */
 X2GoClientNetworkSSH* x2goclient_network_ssh_new (const char * const session_path) {
   X2GoClientNetworkSSH *ret = NULL;
 
diff --git a/src/x2goclient-network-stub.c b/src/x2goclient-network-stub.c
index b947df4..5e35eed 100644
--- a/src/x2goclient-network-stub.c
+++ b/src/x2goclient-network-stub.c
@@ -88,6 +88,19 @@ static void x2goclient_network_stub_init (X2GoClientNetworkStub * const self) {
   (void) self;
 }
 
+/**
+ * x2goclient_network_stub_new:
+ *
+ * Creates a new #X2GoClientNetworkStub instance, with everything initialized
+ * to the default value.
+ *
+ * No connection is being established by just creating such an object, which
+ * is also showcased by it not taking a remote location.
+ *
+ * Returns: (transfer full): the new #X2GoClientNetworkStub instance
+ *
+ * Since: 0.0.0
+ */
 X2GoClientNetworkStub* x2goclient_network_stub_new (void) {
   X2GoClientNetworkStub *ret = NULL;
 
diff --git a/src/x2goclient-openssh-bugs.c b/src/x2goclient-openssh-bugs.c
index a0e9df3..9b722d0 100644
--- a/src/x2goclient-openssh-bugs.c
+++ b/src/x2goclient-openssh-bugs.c
@@ -48,14 +48,48 @@
  * Since: 0.0.0
  */
 
+/**
+ * x2goclient_openssh_bugs_new:
+ *
+ * Creates a new #X2GoClientOpenSSHBugs instance with all quirks
+ * disabled by default.
+ *
+ * Returns: (transfer full): the new #X2GoClientOpenSSHBugs instance
+ *
+ * Since: 0.0.0
+ */
 X2GoClientOpenSSHBugs* x2goclient_openssh_bugs_new (void) {
   return (g_slice_new0 (X2GoClientOpenSSHBugs));
 }
 
+/**
+ * x2goclient_openssh_bugs_free:
+ * @openssh_bugs: (in) (nullable) (transfer full):
+ *                a pointer to an #X2GoClientOpenSSHBugs instance.
+ *
+ * Deletes memory allocated for the #X2GoClientOpenSSHBugs instance.
+ *
+ * While a %NULL input is supported, avoid that, since it will essentially
+ * degrade into a no-op with additional overhead.
+ *
+ * Since: 0.0.0
+ */
 void x2goclient_openssh_bugs_free (X2GoClientOpenSSHBugs * const openssh_bugs) {
   g_slice_free (X2GoClientOpenSSHBugs, openssh_bugs);
 }
 
+/**
+ * x2goclient_openssh_bugs_copy:
+ * @openssh_bugs: (in) (not nullable) (transfer none):
+ *                a pointer to an #X2GoClientOpenSSHBugs instance.
+ *
+ * Copies an #X2GoClientOpenSSHBugs instance.
+ *
+ * Returns: (transfer full): a new #X2GoClientOpenSSHBugs instance with the
+ *                           same internal data on success, %NULL on error
+ *
+ * Since: 0.0.0
+ */
 static X2GoClientOpenSSHBugs* x2goclient_openssh_bugs_copy (const X2GoClientOpenSSHBugs * const src) {
   X2GoClientOpenSSHBugs *dst = NULL;
 
diff --git a/src/x2goclient-openssh-version.c b/src/x2goclient-openssh-version.c
index c25636e..5d94413 100644
--- a/src/x2goclient-openssh-version.c
+++ b/src/x2goclient-openssh-version.c
@@ -52,14 +52,48 @@
  * Since: 0.0.0
  */
 
+/**
+ * x2goclient_openssh_version_new:
+ *
+ * Creates a new #X2GoClientOpenSSHVersion instance with every member
+ * initialized to the default value.
+ *
+ * Returns: (transfer full): the new #X2GoClientOpenSSHVersion instance
+ *
+ * Since: 0.0.0
+ */
 X2GoClientOpenSSHVersion* x2goclient_openssh_version_new (void) {
   return (g_slice_new0 (X2GoClientOpenSSHVersion));
 }
 
+/**
+ * x2goclient_openssh_version_free:
+ * @openssh_version: (in) (nullable) (transfer full):
+ *                   a pointer to an #X2GoClientOpenSSHVersion instance.
+ *
+ * Deletes memory allocated for the #X2GoClientOpenSSHVersion instance.
+ *
+ * While a %NULL input is supported, avoid that, since it will essentially
+ * degrade into a no-op with additional overhead.
+ *
+ * Since: 0.0.0
+ */
 void x2goclient_openssh_version_free (X2GoClientOpenSSHVersion * const openssh_version) {
   g_slice_free (X2GoClientOpenSSHVersion, openssh_version);
 }
 
+/**
+ * x2goclient_openssh_version_copy:
+ * @openssh_version: (in) (not nullable) (transfer none):
+ *                   a pointer to an #X2GoClientOpenSSHVersion instance.
+ *
+ * Copies an #X2GoClientOpenSSHVersion instance.
+ *
+ * Returns: (transfer full): a new #X2GoClientOpenSSHVersion instance with the
+ *                           same internal data on success, %NULL on error
+ *
+ * Since: 0.0.0
+ */
 static X2GoClientOpenSSHVersion* x2goclient_openssh_version_copy (const X2GoClientOpenSSHVersion * const src) {
   X2GoClientOpenSSHVersion *dst = NULL;
 

--
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