Thread (1 message) 1 message, 1 author, 2016-06-15

Re: [PATCH] added a built-in alias for 'stage' to the 'add' command

From: Junio C Hamano <hidden>
Date: 2016-06-15 22:45:43

Scott Chacon [off-list ref] writes:
Subject: Re: [PATCH] added a built-in alias for 'stage' to the 'add' command
s/added/Add/;

Write your commit log message in present tense (recall David Brown's talk
at GitTogether '08? ;-)
this comes from conversation at the GitTogether where we thought it would
s/this/This/;
be helpful to be able to teach people to 'stage' files because it tends
to cause confusion when told that they have to keep 'add'ing them.

This continues the movement to start referring to the index as a
staging area (eg: the --staged alias to 'git diff'). Also added a
doc file for 'git stage' that basically points to the docs for
'git add'.

Signed-off-by: Scott Chacon <redacted>
I think this is fine but I'd rather not risk the documentation getting
stale over time, so...
+SYNOPSIS
+--------
+[verse]
+'git stage' [-n] [-v] [--force | -f] [--interactive | -i] [--patch | -p]
+	  [--all | [--update | -u]] [--intent-to-add | -N]
+	  [--refresh] [--ignore-errors] [--] <filepattern>...
...I think this should read something like

	'git stage' args...
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help