summaryrefslogtreecommitdiffstats
path: root/libfdisk/src/partition.c
diff options
context:
space:
mode:
Diffstat (limited to 'libfdisk/src/partition.c')
-rw-r--r--libfdisk/src/partition.c11
1 files changed, 7 insertions, 4 deletions
diff --git a/libfdisk/src/partition.c b/libfdisk/src/partition.c
index d27c161b4..95baea0c2 100644
--- a/libfdisk/src/partition.c
+++ b/libfdisk/src/partition.c
@@ -702,11 +702,14 @@ int fdisk_partition_is_wholedisk(struct fdisk_partition *pa)
* @cxt: context
* @n: returns partition number
*
- * If partno-follow-default (see fdisk_partition_partno_follow_default())
- * enabled then returns next expected partno, otherwise use Ask API to ask user
- * for the next partno.
+ * If @pa specified and partno-follow-default (see fdisk_partition_partno_follow_default())
+ * enabled then returns next expected partno or -ERANGE on error.
*
- * Returns: 0 on success, <0 on error
+ * If @pa is NULL, or @pa does not specify any sepamntic for the next partno
+ * then use Ask API to ask user for the next partno. In this case returns 1 if
+ * no free partition avaialble.
+ *
+ * Returns: 0 on success, <0 on error, or 1 for non-free partno by Ask API.
*/
int fdisk_partition_next_partno(
struct fdisk_partition *pa,