From: Karel Zak <kzak@redhat.com>
Date: Tue, 25 Feb 2020 11:25:17 +0000 (+0100)
Subject: libfdisk: add missing comments
X-Git-Tag: v2.36-rc1~213
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=f4189a087ad2b0faca38f6e0959b4186aa924776;p=thirdparty%2Futil-linux.git

libfdisk: add missing comments

Signed-off-by: Karel Zak <kzak@redhat.com>
---

diff --git a/libfdisk/src/partition.c b/libfdisk/src/partition.c
index 4af177d9b6..3aa1ea67c0 100644
--- a/libfdisk/src/partition.c
+++ b/libfdisk/src/partition.c
@@ -500,6 +500,13 @@ struct fdisk_parttype *fdisk_partition_get_type(struct fdisk_partition *pa)
 	return pa ? pa->type : NULL;
 }
 
+/**
+ * fdisk_partition_set_name:
+ * @pa: partition
+ * @name: partition name
+ *
+ * Returns: 0 on success, <0 on error.
+ */
 int fdisk_partition_set_name(struct fdisk_partition *pa, const char *name)
 {
 	if (!pa)
@@ -507,11 +514,24 @@ int fdisk_partition_set_name(struct fdisk_partition *pa, const char *name)
 	return strdup_to_struct_member(pa, name, name);
 }
 
+/**
+ * fdisk_partition_get_name:
+ * @pa: partition
+ *
+ * Returns: partition name
+ */
 const char *fdisk_partition_get_name(struct fdisk_partition *pa)
 {
 	return pa ? pa->name : NULL;
 }
 
+/**
+ * fdisk_partition_set_uuid:
+ * @pa: partition
+ * @uuid: UUID of the partition
+ *
+ * Returns: 0 on success, <0 on error.
+ */
 int fdisk_partition_set_uuid(struct fdisk_partition *pa, const char *uuid)
 {
 	if (!pa)