Re: Man-Page mkdir

[Jim Meyering]

Heiko Marr <address@hidden> wrote:
> there seems to be a mistake in the description of SYNOPSIS for mkdir.
> You wrote:
>
> mkdir [OPTION] DIRECTORY...
>
> but it has to be:
>
> mkdir [OPTION]... DIRECTORY...

Thank you for reporting that.
The same problem affects several other programs.
Here's how I've fixed it:

>From 9396eb903752ad4a1375235f62dcb094a5ae2cf0 Mon Sep 17 00:00:00 2001
From: Jim Meyering <address@hidden>
Date: Sat, 28 Jun 2008 09:53:03 +0200
Subject: [PATCH] doc: add "..." to Usage, to indicate there may be multiple 
OPTIONs

* src/base64.c (usage): Likewise.
* src/cat.c (usage): Likewise.
* src/md5sum.c (usage): Likewise.
* src/mkdir.c (usage): Likewise.
* src/mkfifo.c (usage): Likewise.
* src/split.c (usage): Likewise.
* src/stat.c (usage): Likewise.
Heiko Marr reported the problem with mkdir.
---
 THANKS       |    1 +
 src/base64.c |    2 +-
 src/cat.c    |    2 +-
 src/md5sum.c |    2 +-
 src/mkdir.c  |    2 +-
 src/mkfifo.c |    2 +-
 src/split.c  |    2 +-
 src/stat.c   |    2 +-
 8 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/THANKS b/THANKS
index b269dd9..40b33ba 100644
--- a/THANKS
+++ b/THANKS
@@ -213,6 +213,7 @@ Harald Dunkel                       address@hidden
 Harry Liu                           address@hidden
 Harti Brandt                        address@hidden
 Harvey Eneman                       address@hidden
+Heiko Marr                          address@hidden
 Helen Faulkner                      address@hidden
 Herbert Xu                          address@hidden
 Holger Berger                       address@hidden
diff --git a/src/base64.c b/src/base64.c
index 416e573..bfbd9e0 100644
--- a/src/base64.c
+++ b/src/base64.c
@@ -57,7 +57,7 @@ usage (int status)
   else
     {
       printf (_("\
-Usage: %s [OPTION] [FILE]\n\
+Usage: %s [OPTION]... [FILE]\n\
 Base64 encode or decode FILE, or standard input, to standard output.\n\
 \n"), program_name);
       fputs (_("\
diff --git a/src/cat.c b/src/cat.c
index d762f45..9c1996a 100644
--- a/src/cat.c
+++ b/src/cat.c
@@ -90,7 +90,7 @@ usage (int status)
   else
     {
       printf (_("\
-Usage: %s [OPTION] [FILE]...\n\
+Usage: %s [OPTION]... [FILE]...\n\
 "),
              program_name);
       fputs (_("\
diff --git a/src/md5sum.c b/src/md5sum.c
index a92113b..238c02e 100644
--- a/src/md5sum.c
+++ b/src/md5sum.c
@@ -150,7 +150,7 @@ usage (int status)
   else
     {
       printf (_("\
-Usage: %s [OPTION] [FILE]...\n\
+Usage: %s [OPTION]... [FILE]...\n\
 Print or check %s (%d-bit) checksums.\n\
 With no FILE, or when FILE is -, read standard input.\n\
 \n\
diff --git a/src/mkdir.c b/src/mkdir.c
index 9644f4c..e408f29 100644
--- a/src/mkdir.c
+++ b/src/mkdir.c
@@ -55,7 +55,7 @@ usage (int status)
             program_name);
   else
     {
-      printf (_("Usage: %s [OPTION] DIRECTORY...\n"), program_name);
+      printf (_("Usage: %s [OPTION]... DIRECTORY...\n"), program_name);
       fputs (_("\
 Create the DIRECTORY(ies), if they do not already exist.\n\
 \n\
diff --git a/src/mkfifo.c b/src/mkfifo.c
index 06075c8..690766b 100644
--- a/src/mkfifo.c
+++ b/src/mkfifo.c
@@ -49,7 +49,7 @@ usage (int status)
             program_name);
   else
     {
-      printf (_("Usage: %s [OPTION] NAME...\n"), program_name);
+      printf (_("Usage: %s [OPTION]... NAME...\n"), program_name);
       fputs (_("\
 Create named pipes (FIFOs) with the given NAMEs.\n\
 \n\
diff --git a/src/split.c b/src/split.c
index c70e0c4..85687c4 100644
--- a/src/split.c
+++ b/src/split.c
@@ -100,7 +100,7 @@ usage (int status)
   else
     {
       printf (_("\
-Usage: %s [OPTION] [INPUT [PREFIX]]\n\
+Usage: %s [OPTION]... [INPUT [PREFIX]]\n\
 "),
              program_name);
     fputs (_("\
diff --git a/src/stat.c b/src/stat.c
index a97687a..491c190 100644
--- a/src/stat.c
+++ b/src/stat.c
@@ -908,7 +908,7 @@ usage (int status)
             program_name);
   else
     {
-      printf (_("Usage: %s [OPTION] FILE...\n"), program_name);
+      printf (_("Usage: %s [OPTION]... FILE...\n"), program_name);
       fputs (_("\
 Display file or file system status.\n\
 \n\
--
1.5.6.1.91.gc2a16