diff mbox series

cmd: mmc: update the mmc command's usage about argument

Message ID 20201214100953.8108-1-jh80.chung@samsung.com
State Superseded
Delegated to: Peng Fan
Headers show
Series cmd: mmc: update the mmc command's usage about argument | expand

Commit Message

Jaehoon Chung Dec. 14, 2020, 10:09 a.m. UTC
It's confused what is optional or mandantary argument.
Update the command's usage to clarify how to use.

Signed-off-by: Jaehoon Chung <jh80.chung@samsung.com>
---
 cmd/mmc.c | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

Comments

Simon Glass Dec. 15, 2020, 4 a.m. UTC | #1
Hi Jaehoon,

On Mon, 14 Dec 2020 at 03:09, Jaehoon Chung <jh80.chung@samsung.com> wrote:
>
> It's confused what is optional or mandantary argument.

how about: It's confusing whether arguments are optional or mandatory

> Update the command's usage to clarify how to use.

Are you using <> to indicate optional? I see [] used more commonly.

>
> Signed-off-by: Jaehoon Chung <jh80.chung@samsung.com>
> ---
>  cmd/mmc.c | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)

Regards,
Simon
Jaehoon Chung Dec. 15, 2020, 4:18 a.m. UTC | #2
Hi Simon,

On 12/15/20 1:00 PM, Simon Glass wrote:
> Hi Jaehoon,
> 
> On Mon, 14 Dec 2020 at 03:09, Jaehoon Chung <jh80.chung@samsung.com> wrote:
>>
>> It's confused what is optional or mandantary argument.
> 
> how about: It's confusing whether arguments are optional or mandatory

Okay, will update.

> 
>> Update the command's usage to clarify how to use.
> 
> Are you using <> to indicate optional? I see [] used more commonly.

No, i'm using [] to indicated optional.
AFFIK, "<> -> mandatory, []  -> optional", doesn't it?


Best Regards,
Jaehoon Chung

> 
>>
>> Signed-off-by: Jaehoon Chung <jh80.chung@samsung.com>
>> ---
>>  cmd/mmc.c | 6 +++---
>>  1 file changed, 3 insertions(+), 3 deletions(-)
> 
> Regards,
> Simon
>
Simon Glass Dec. 15, 2020, 4:29 a.m. UTC | #3
Hi Jaehoon,

On Mon, 14 Dec 2020 at 21:17, Jaehoon Chung <jh80.chung@samsung.com> wrote:
>
> Hi Simon,
>
> On 12/15/20 1:00 PM, Simon Glass wrote:
> > Hi Jaehoon,
> >
> > On Mon, 14 Dec 2020 at 03:09, Jaehoon Chung <jh80.chung@samsung.com> wrote:
> >>
> >> It's confused what is optional or mandantary argument.
> >
> > how about: It's confusing whether arguments are optional or mandatory
>
> Okay, will update.
>
> >
> >> Update the command's usage to clarify how to use.
> >
> > Are you using <> to indicate optional? I see [] used more commonly.
>
> No, i'm using [] to indicated optional.
> AFFIK, "<> -> mandatory, []  -> optional", doesn't it?

Ah OK, got it.

Reviewed-by: Simon Glass <sjg@chromium.org>
diff mbox series

Patch

diff --git a/cmd/mmc.c b/cmd/mmc.c
index 1529a3e05ddd..cb6b59f36a43 100644
--- a/cmd/mmc.c
+++ b/cmd/mmc.c
@@ -1017,13 +1017,13 @@  U_BOOT_CMD(
 	"  Power cycling is required to initialize partitions after set to complete.\n"
 #endif
 #ifdef CONFIG_SUPPORT_EMMC_BOOT
-	"mmc bootbus dev boot_bus_width reset_boot_bus_width boot_mode\n"
+	"mmc bootbus <dev> <boot_bus_width> <reset_boot_bus_width> <boot_mode>\n"
 	" - Set the BOOT_BUS_WIDTH field of the specified device\n"
 	"mmc bootpart-resize <dev> <boot part size MB> <RPMB part size MB>\n"
 	" - Change sizes of boot and RPMB partitions of specified device\n"
-	"mmc partconf dev [boot_ack boot_partition partition_access]\n"
+	"mmc partconf <dev> [boot_ack boot_partition partition_access]\n"
 	" - Show or change the bits of the PARTITION_CONFIG field of the specified device\n"
-	"mmc rst-function dev value\n"
+	"mmc rst-function <dev> <value>\n"
 	" - Change the RST_n_FUNCTION field of the specified device\n"
 	"   WARNING: This is a write-once field and 0 / 1 / 2 are the only valid values.\n"
 #endif