Re: clarification on git-update-index --remove

"David Tweed" [off-list ref] writes:

--remove::
	If a specified file is in the index but is missing then it's
	removed.
	Default behavior is to ignore removed file.

If necessary, better rewording to remove confusion is very much
appreciated.

"update-index <path>..." without options (that is "Default
behaviour") updates the index using the contents of the named
<path> found on the filesystem.  It does _not_ add new paths to
the index, nor remove paths (that exists in the index) from the
index.

Giving --add allows new paths to be added to the index if named
paths are found on the filesystem.  Giving --remove allows
existing paths to be removed from the index if named paths are
not found on the filesystem.