summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRobert Schwebel <r.schwebel@pengutronix.de>2010-10-18 21:12:49 +0200
committerSascha Hauer <s.hauer@pengutronix.de>2010-11-01 16:23:09 +0100
commit7a21761d03f38f7d42c91fea1fe791889309fe4e (patch)
tree6c0c8e7097778a076febb632204e26e486f8039d
parent6723d7e6f04b5915a767595e30e638d85db745f7 (diff)
downloadbarebox-7a21761d03f38f7d42c91fea1fe791889309fe4e.tar.gz
barebox-7a21761d03f38f7d42c91fea1fe791889309fe4e.tar.xz
doc: unify documentation for 'delpart'
Signed-off-by: Robert Schwebel <r.schwebel@pengutronix.de>
-rw-r--r--commands/partition.c35
1 files changed, 21 insertions, 14 deletions
diff --git a/commands/partition.c b/commands/partition.c
index dd37bc265f..db9b9fb0df 100644
--- a/commands/partition.c
+++ b/commands/partition.c
@@ -158,11 +158,12 @@ BAREBOX_CMD_HELP_END
/**
* @page addpart_command
-Size and offset can be given in decimal hex (prefixed with 0x). Both
-can have an optional suffix K, M or G. The size of the last partition
-can be specified as '-' for the remaining space on the device. This
-format is the same as used by the Linux kernel or cmdline mtd
-partitions.
+
+The size and the offset can be given in decimal (without any prefix) and
+in hex (prefixed with 0x). Both can have an optional suffix K, M or G.
+The size of the last partition can be specified as '-' for the remaining
+space on the device. This format is the same as used by the Linux
+kernel or cmdline mtd partitions.
\todo This command has to be reworked and will probably change it's API.
*/
@@ -188,9 +189,21 @@ static int do_delpart(struct command * cmdtp, int argc, char *argv[])
return 1;
}
-static const __maybe_unused char cmd_delpart_help[] =
-"Usage: delpart FILE...\n"
-"Delete partitions previously added to a device with addpart.\n";
+BAREBOX_CMD_HELP_START(delpart)
+BAREBOX_CMD_HELP_USAGE("delpart <part 1> [<part n>] \n")
+BAREBOX_CMD_HELP_SHORT("Delete partitions previously added to a device with addpart.\n")
+BAREBOX_CMD_HELP_END
+
+/**
+ * @page delpart_command
+
+Partitions are created by adding their description with the addpart
+command. If you want to get rid of a partition again, use delpart. The
+argument list is taken as a list of partitions to be deleted.
+
+\todo Add an example
+
+ */
BAREBOX_CMD_START(delpart)
.cmd = do_delpart,
@@ -198,9 +211,3 @@ BAREBOX_CMD_START(delpart)
BAREBOX_CMD_HELP(cmd_delpart_help)
BAREBOX_CMD_END
-/** @page delpart_command delpart Delete a partition
- *
- * Usage is: delpart \<partions>
- *
- * Delete a partition previously added to a device with addpart.
- */