# [PATCH] [TRIVIAL] Documentation: add: <filepattern>... is optional

3 messages from 2009-08-11 to 2009-08-11. Participants: Paul Bolle, Nicolas Sebrecht.
Thread: https://gitlist.dev/t/20534

## Paul Bolle, 2009-08-11 13:03

Subject: [PATCH] [TRIVIAL] Documentation: add: <filepattern>... is optional
Message-ID: <1249995790.1589.2.camel@localhost.localdomain>
URL: https://gitlist.dev/e/1249995790.1589.2.camel%40localhost.localdomain

```
<filepattern>... is optional (e.g. when the --all or --update
options are used) so use square brackets in the synopsis.

Signed-off-by: Paul Bolle <pebolle@tiscali.nl>
---
 Documentation/git-add.txt |    2 +-
 1 files changed, 1 insertions(+), 1 deletions(-)

diff --git a/Documentation/git-add.txt b/Documentation/git-add.txt
index ab1943c..e67b7e8 100644
--- a/Documentation/git-add.txt
+++ b/Documentation/git-add.txt
@@ -10,7 +10,7 @@ SYNOPSIS
 [verse]
 'git add' [-n] [-v] [--force | -f] [--interactive | -i] [--patch | -p]
 	  [--edit | -e] [--all | [--update | -u]] [--intent-to-add | -N]
-	  [--refresh] [--ignore-errors] [--] <filepattern>...
+	  [--refresh] [--ignore-errors] [--] [<filepattern>...]
 
 DESCRIPTION
 -----------
-- 
1.6.4

```

## Nicolas Sebrecht, 2009-08-11 14:50

Subject: [PATCH] Re: [TRIVIAL] Documentation: add: <filepattern>... is optional
Message-ID: <20090811145041.GB12956@vidovic>
URL: https://gitlist.dev/e/20090811145041.GB12956%40vidovic
In-Reply-To: <1249995790.1589.2.camel@localhost.localdomain>

```
The 11/08/09, Paul Bolle wrote:

> <filepattern>... is optional (e.g. when the --all or --update
> options are used) so use square brackets in the synopsis.

So <filepattern> is needed in all other cases. The '-u' description
already has

	" If no paths are specified, all tracked files in the current
  directory and its subdirectories are updated. "

and '-a' refers to '-u'

  "(same as --update)"

.

-- 
Nicolas Sebrecht

```

## Paul Bolle, 2009-08-11 15:06

Subject: Re: [PATCH] Re: [TRIVIAL] Documentation: add: <filepattern>... is optional
Message-ID: <1250003205.2707.11.camel@localhost.localdomain>
URL: https://gitlist.dev/e/1250003205.2707.11.camel%40localhost.localdomain
In-Reply-To: <20090811145041.GB12956@vidovic>

```
On Tue, 2009-08-11 at 16:50 +0200, Nicolas Sebrecht wrote:
> The 11/08/09, Paul Bolle wrote:
> 
> > <filepattern>... is optional (e.g. when the --all or --update
> > options are used) so use square brackets in the synopsis.
> 
> So <filepattern> is needed in all other cases.

Since it is an optional argument in those cases I'd say it is better to
indicate that it is optional in the synopsis too.


Paul Bolle

```