Documentation: fix misuses of "nor"
Signed-off-by: Justin Lebar <jlebar@google.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
parent
cee0c2750b
commit
a58088abe2
@ -91,13 +91,13 @@ For shell scripts specifically (not exhaustive):
|
|||||||
E.g.: my_function () {
|
E.g.: my_function () {
|
||||||
|
|
||||||
- As to use of grep, stick to a subset of BRE (namely, no \{m,n\},
|
- As to use of grep, stick to a subset of BRE (namely, no \{m,n\},
|
||||||
[::], [==], nor [..]) for portability.
|
[::], [==], or [..]) for portability.
|
||||||
|
|
||||||
- We do not use \{m,n\};
|
- We do not use \{m,n\};
|
||||||
|
|
||||||
- We do not use -E;
|
- We do not use -E;
|
||||||
|
|
||||||
- We do not use ? nor + (which are \{0,1\} and \{1,\}
|
- We do not use ? or + (which are \{0,1\} and \{1,\}
|
||||||
respectively in BRE) but that goes without saying as these
|
respectively in BRE) but that goes without saying as these
|
||||||
are ERE elements not BRE (note that \? and \+ are not even part
|
are ERE elements not BRE (note that \? and \+ are not even part
|
||||||
of BRE -- making them accessible from BRE is a GNU extension).
|
of BRE -- making them accessible from BRE is a GNU extension).
|
||||||
|
@ -78,8 +78,8 @@ be escaped: use `\"` for `"` and `\\` for `\`.
|
|||||||
|
|
||||||
The following escape sequences (beside `\"` and `\\`) are recognized:
|
The following escape sequences (beside `\"` and `\\`) are recognized:
|
||||||
`\n` for newline character (NL), `\t` for horizontal tabulation (HT, TAB)
|
`\n` for newline character (NL), `\t` for horizontal tabulation (HT, TAB)
|
||||||
and `\b` for backspace (BS). No other char escape sequence, nor octal
|
and `\b` for backspace (BS). Other char escape sequences (including octal
|
||||||
char sequences are valid.
|
escape sequences) are invalid.
|
||||||
|
|
||||||
Variable values ending in a `\` are continued on the next line in the
|
Variable values ending in a `\` are continued on the next line in the
|
||||||
customary UNIX fashion.
|
customary UNIX fashion.
|
||||||
@ -827,7 +827,7 @@ color.diff::
|
|||||||
commands will only use color when output is to the terminal.
|
commands will only use color when output is to the terminal.
|
||||||
Defaults to false.
|
Defaults to false.
|
||||||
+
|
+
|
||||||
This does not affect linkgit:git-format-patch[1] nor the
|
This does not affect linkgit:git-format-patch[1] or the
|
||||||
'git-diff-{asterisk}' plumbing commands. Can be overridden on the
|
'git-diff-{asterisk}' plumbing commands. Can be overridden on the
|
||||||
command line with the `--color[=<when>]` option.
|
command line with the `--color[=<when>]` option.
|
||||||
|
|
||||||
|
@ -174,7 +174,7 @@ added, from the point of view of that parent).
|
|||||||
In the above example output, the function signature was changed
|
In the above example output, the function signature was changed
|
||||||
from both files (hence two `-` removals from both file1 and
|
from both files (hence two `-` removals from both file1 and
|
||||||
file2, plus `++` to mean one line that was added does not appear
|
file2, plus `++` to mean one line that was added does not appear
|
||||||
in either file1 nor file2). Also eight other lines are the same
|
in either file1 or file2). Also eight other lines are the same
|
||||||
from file1 but do not appear in file2 (hence prefixed with `+`).
|
from file1 but do not appear in file2 (hence prefixed with `+`).
|
||||||
|
|
||||||
When shown by `git diff-tree -c`, it compares the parents of a
|
When shown by `git diff-tree -c`, it compares the parents of a
|
||||||
|
@ -358,7 +358,7 @@ endif::git-log[]
|
|||||||
--irreversible-delete::
|
--irreversible-delete::
|
||||||
Omit the preimage for deletes, i.e. print only the header but not
|
Omit the preimage for deletes, i.e. print only the header but not
|
||||||
the diff between the preimage and `/dev/null`. The resulting patch
|
the diff between the preimage and `/dev/null`. The resulting patch
|
||||||
is not meant to be applied with `patch` nor `git apply`; this is
|
is not meant to be applied with `patch` or `git apply`; this is
|
||||||
solely for people who want to just concentrate on reviewing the
|
solely for people who want to just concentrate on reviewing the
|
||||||
text after the change. In addition, the output obviously lack
|
text after the change. In addition, the output obviously lack
|
||||||
enough information to apply such a patch in reverse, even manually,
|
enough information to apply such a patch in reverse, even manually,
|
||||||
|
@ -263,7 +263,7 @@ that are not quite ready.
|
|||||||
<5> create topic branch as needed and apply, again with my
|
<5> create topic branch as needed and apply, again with my
|
||||||
sign-offs.
|
sign-offs.
|
||||||
<6> rebase internal topic branch that has not been merged to the
|
<6> rebase internal topic branch that has not been merged to the
|
||||||
master, nor exposed as a part of a stable branch.
|
master or exposed as a part of a stable branch.
|
||||||
<7> restart `pu` every time from the next.
|
<7> restart `pu` every time from the next.
|
||||||
<8> and bundle topic branches still cooking.
|
<8> and bundle topic branches still cooking.
|
||||||
<9> backport a critical fix.
|
<9> backport a critical fix.
|
||||||
|
@ -296,9 +296,9 @@ patch::
|
|||||||
|
|
||||||
y - stage this hunk
|
y - stage this hunk
|
||||||
n - do not stage this hunk
|
n - do not stage this hunk
|
||||||
q - quit; do not stage this hunk nor any of the remaining ones
|
q - quit; do not stage this hunk or any of the remaining ones
|
||||||
a - stage this hunk and all later hunks in the file
|
a - stage this hunk and all later hunks in the file
|
||||||
d - do not stage this hunk nor any of the later hunks in the file
|
d - do not stage this hunk or any of the later hunks in the file
|
||||||
g - select a hunk to go to
|
g - select a hunk to go to
|
||||||
/ - search for a hunk matching the given regex
|
/ - search for a hunk matching the given regex
|
||||||
j - leave this hunk undecided, see next undecided hunk
|
j - leave this hunk undecided, see next undecided hunk
|
||||||
|
@ -33,8 +33,8 @@ size-pack: disk space consumed by the packs, in KiB (unless -H is specified)
|
|||||||
prune-packable: the number of loose objects that are also present in
|
prune-packable: the number of loose objects that are also present in
|
||||||
the packs. These objects could be pruned using `git prune-packed`.
|
the packs. These objects could be pruned using `git prune-packed`.
|
||||||
+
|
+
|
||||||
garbage: the number of files in object database that are not valid
|
garbage: the number of files in object database that are neither valid loose
|
||||||
loose objects nor valid packs
|
objects nor valid packs
|
||||||
+
|
+
|
||||||
size-garbage: disk space consumed by garbage files, in KiB (unless -H is
|
size-garbage: disk space consumed by garbage files, in KiB (unless -H is
|
||||||
specified)
|
specified)
|
||||||
|
@ -158,8 +158,8 @@ $ git diff --name-status <2>
|
|||||||
$ git diff arch/i386 include/asm-i386 <3>
|
$ git diff arch/i386 include/asm-i386 <3>
|
||||||
------------
|
------------
|
||||||
+
|
+
|
||||||
<1> Show only modification, rename and copy, but not addition
|
<1> Show only modification, rename, and copy, but not addition
|
||||||
nor deletion.
|
or deletion.
|
||||||
<2> Show only names and the nature of change, but not actual
|
<2> Show only names and the nature of change, but not actual
|
||||||
diff output.
|
diff output.
|
||||||
<3> Limit diff output to named subtrees.
|
<3> Limit diff output to named subtrees.
|
||||||
|
@ -56,7 +56,7 @@ OPTIONS
|
|||||||
EXAMPLE
|
EXAMPLE
|
||||||
-------
|
-------
|
||||||
|
|
||||||
To prune objects not used by your repository nor another that
|
To prune objects not used by your repository or another that
|
||||||
borrows from your repository via its
|
borrows from your repository via its
|
||||||
`.git/objects/info/alternates`:
|
`.git/objects/info/alternates`:
|
||||||
|
|
||||||
|
@ -385,7 +385,7 @@ will now start building on top of B.
|
|||||||
The command by default does not allow an update that is not a fast-forward
|
The command by default does not allow an update that is not a fast-forward
|
||||||
to prevent such loss of history.
|
to prevent such loss of history.
|
||||||
|
|
||||||
If you do not want to lose your work (history from X to B) nor the work by
|
If you do not want to lose your work (history from X to B) or the work by
|
||||||
the other person (history from X to A), you would need to first fetch the
|
the other person (history from X to A), you would need to first fetch the
|
||||||
history from the repository, create a history that contains changes done
|
history from the repository, create a history that contains changes done
|
||||||
by both parties, and push the result back.
|
by both parties, and push the result back.
|
||||||
|
@ -57,7 +57,7 @@ OPTIONS
|
|||||||
-n::
|
-n::
|
||||||
--dry-run::
|
--dry-run::
|
||||||
Check if the command would error out, without updating the index
|
Check if the command would error out, without updating the index
|
||||||
nor the files in the working tree for real.
|
or the files in the working tree for real.
|
||||||
|
|
||||||
-v::
|
-v::
|
||||||
Show the progress of checking files out.
|
Show the progress of checking files out.
|
||||||
|
@ -21,7 +21,7 @@ to HEAD in all forms.
|
|||||||
|
|
||||||
'git reset' [-q] [<tree-ish>] [--] <paths>...::
|
'git reset' [-q] [<tree-ish>] [--] <paths>...::
|
||||||
This form resets the index entries for all <paths> to their
|
This form resets the index entries for all <paths> to their
|
||||||
state at <tree-ish>. (It does not affect the working tree, nor
|
state at <tree-ish>. (It does not affect the working tree or
|
||||||
the current branch.)
|
the current branch.)
|
||||||
+
|
+
|
||||||
This means that `git reset <paths>` is the opposite of `git add
|
This means that `git reset <paths>` is the opposite of `git add
|
||||||
@ -51,7 +51,7 @@ section of linkgit:git-add[1] to learn how to operate the `--patch` mode.
|
|||||||
+
|
+
|
||||||
--
|
--
|
||||||
--soft::
|
--soft::
|
||||||
Does not touch the index file nor the working tree at all (but
|
Does not touch the index file or the working tree at all (but
|
||||||
resets the head to <commit>, just like all modes do). This leaves
|
resets the head to <commit>, just like all modes do). This leaves
|
||||||
all your changed files "Changes to be committed", as 'git status'
|
all your changed files "Changes to be committed", as 'git status'
|
||||||
would put it.
|
would put it.
|
||||||
@ -115,7 +115,7 @@ and changes with these files are distracting.
|
|||||||
<2> Somebody asks you to pull, and the changes sounds worthy of merging.
|
<2> Somebody asks you to pull, and the changes sounds worthy of merging.
|
||||||
<3> However, you already dirtied the index (i.e. your index does
|
<3> However, you already dirtied the index (i.e. your index does
|
||||||
not match the HEAD commit). But you know the pull you are going
|
not match the HEAD commit). But you know the pull you are going
|
||||||
to make does not affect frotz.c nor filfre.c, so you revert the
|
to make does not affect frotz.c or filfre.c, so you revert the
|
||||||
index changes for these two files. Your changes in working tree
|
index changes for these two files. Your changes in working tree
|
||||||
remain there.
|
remain there.
|
||||||
<4> Then you can pull and merge, leaving frotz.c and filfre.c
|
<4> Then you can pull and merge, leaving frotz.c and filfre.c
|
||||||
|
@ -25,7 +25,7 @@ and/or refs/tags) semi-visually.
|
|||||||
It cannot show more than 29 branches and commits at a time.
|
It cannot show more than 29 branches and commits at a time.
|
||||||
|
|
||||||
It uses `showbranch.default` multi-valued configuration items if
|
It uses `showbranch.default` multi-valued configuration items if
|
||||||
no <rev> nor <glob> is given on the command line.
|
no <rev> or <glob> is given on the command line.
|
||||||
|
|
||||||
|
|
||||||
OPTIONS
|
OPTIONS
|
||||||
|
@ -89,7 +89,7 @@ OPTIONS
|
|||||||
Show references matching one or more patterns. Patterns are matched from
|
Show references matching one or more patterns. Patterns are matched from
|
||||||
the end of the full name, and only complete parts are matched, e.g.
|
the end of the full name, and only complete parts are matched, e.g.
|
||||||
'master' matches 'refs/heads/master', 'refs/remotes/origin/master',
|
'master' matches 'refs/heads/master', 'refs/remotes/origin/master',
|
||||||
'refs/tags/jedi/master' but not 'refs/heads/mymaster' nor
|
'refs/tags/jedi/master' but not 'refs/heads/mymaster' or
|
||||||
'refs/remotes/master/jedi'.
|
'refs/remotes/master/jedi'.
|
||||||
|
|
||||||
OUTPUT
|
OUTPUT
|
||||||
|
@ -139,7 +139,7 @@ You fetch from upstream, but not merge.
|
|||||||
$ git fetch upstream
|
$ git fetch upstream
|
||||||
|
|
||||||
This leaves the updated upstream head in .git/FETCH_HEAD but
|
This leaves the updated upstream head in .git/FETCH_HEAD but
|
||||||
does not touch your .git/HEAD nor .git/refs/heads/master.
|
does not touch your .git/HEAD or .git/refs/heads/master.
|
||||||
You run "git rebase" now.
|
You run "git rebase" now.
|
||||||
|
|
||||||
$ git rebase FETCH_HEAD master
|
$ git rebase FETCH_HEAD master
|
||||||
|
@ -54,7 +54,7 @@ where C and D are to fix what was broken in A and B, and you may already
|
|||||||
have some other changes on the mainline after W.
|
have some other changes on the mainline after W.
|
||||||
|
|
||||||
If you merge the updated side branch (with D at its tip), none of the
|
If you merge the updated side branch (with D at its tip), none of the
|
||||||
changes made in A nor B will be in the result, because they were reverted
|
changes made in A or B will be in the result, because they were reverted
|
||||||
by W. That is what Alan saw.
|
by W. That is what Alan saw.
|
||||||
|
|
||||||
Linus explains the situation:
|
Linus explains the situation:
|
||||||
@ -90,7 +90,7 @@ with:
|
|||||||
$ git revert W
|
$ git revert W
|
||||||
|
|
||||||
This history would (ignoring possible conflicts between what W and W..Y
|
This history would (ignoring possible conflicts between what W and W..Y
|
||||||
changed) be equivalent to not having W nor Y at all in the history:
|
changed) be equivalent to not having W or Y at all in the history:
|
||||||
|
|
||||||
---o---o---o---M---x---x-------x----
|
---o---o---o---M---x---x-------x----
|
||||||
/
|
/
|
||||||
|
@ -137,7 +137,7 @@ $ make clean test ;# make sure it did not cause other breakage.
|
|||||||
------------------------------------------------
|
------------------------------------------------
|
||||||
|
|
||||||
Everything is in the good order. I do not need the temporary branch
|
Everything is in the good order. I do not need the temporary branch
|
||||||
nor tag anymore, so remove them:
|
or tag anymore, so remove them:
|
||||||
|
|
||||||
------------------------------------------------
|
------------------------------------------------
|
||||||
$ rm -f .git/refs/tags/pu-anchor
|
$ rm -f .git/refs/tags/pu-anchor
|
||||||
|
@ -63,14 +63,13 @@ merge.
|
|||||||
|
|
||||||
--squash::
|
--squash::
|
||||||
--no-squash::
|
--no-squash::
|
||||||
Produce the working tree and index state as if a real
|
Produce the working tree and index state as if a real merge
|
||||||
merge happened (except for the merge information),
|
happened (except for the merge information), but do not actually
|
||||||
but do not actually make a commit or
|
make a commit, move the `HEAD`, or record `$GIT_DIR/MERGE_HEAD`
|
||||||
move the `HEAD`, nor record `$GIT_DIR/MERGE_HEAD` to
|
(to cause the next `git commit` command to create a merge
|
||||||
cause the next `git commit` command to create a merge
|
commit). This allows you to create a single commit on top of
|
||||||
commit. This allows you to create a single commit on
|
the current branch whose effect is the same as merging another
|
||||||
top of the current branch whose effect is the same as
|
branch (or more in case of an octopus).
|
||||||
merging another branch (or more in case of an octopus).
|
|
||||||
+
|
+
|
||||||
With --no-squash perform the merge and commit the result. This
|
With --no-squash perform the merge and commit the result. This
|
||||||
option can be used to override --squash.
|
option can be used to override --squash.
|
||||||
|
@ -78,7 +78,7 @@ The 'raw' format shows the entire commit exactly as
|
|||||||
stored in the commit object. Notably, the SHA-1s are
|
stored in the commit object. Notably, the SHA-1s are
|
||||||
displayed in full, regardless of whether --abbrev or
|
displayed in full, regardless of whether --abbrev or
|
||||||
--no-abbrev are used, and 'parents' information show the
|
--no-abbrev are used, and 'parents' information show the
|
||||||
true parent commits, without taking grafts nor history
|
true parent commits, without taking grafts or history
|
||||||
simplification into account.
|
simplification into account.
|
||||||
|
|
||||||
* 'format:<string>'
|
* 'format:<string>'
|
||||||
|
@ -39,7 +39,7 @@ people using 80-column terminals.
|
|||||||
Show the notes (see linkgit:git-notes[1]) that annotate the
|
Show the notes (see linkgit:git-notes[1]) that annotate the
|
||||||
commit, when showing the commit log message. This is the default
|
commit, when showing the commit log message. This is the default
|
||||||
for `git log`, `git show` and `git whatchanged` commands when
|
for `git log`, `git show` and `git whatchanged` commands when
|
||||||
there is no `--pretty`, `--format` nor `--oneline` option given
|
there is no `--pretty`, `--format`, or `--oneline` option given
|
||||||
on the command line.
|
on the command line.
|
||||||
+
|
+
|
||||||
By default, the notes shown are from the notes refs listed in the
|
By default, the notes shown are from the notes refs listed in the
|
||||||
|
@ -237,7 +237,7 @@ list.
|
|||||||
reflog entries from the most recent one to older ones.
|
reflog entries from the most recent one to older ones.
|
||||||
When this option is used you cannot specify commits to
|
When this option is used you cannot specify commits to
|
||||||
exclude (that is, '{caret}commit', 'commit1..commit2',
|
exclude (that is, '{caret}commit', 'commit1..commit2',
|
||||||
nor 'commit1\...commit2' notations cannot be used).
|
and 'commit1\...commit2' notations cannot be used).
|
||||||
+
|
+
|
||||||
With `--pretty` format other than `oneline` (for obvious reasons),
|
With `--pretty` format other than `oneline` (for obvious reasons),
|
||||||
this causes the output to have two extra lines of information
|
this causes the output to have two extra lines of information
|
||||||
|
@ -99,7 +99,7 @@ static void setup_check(void)
|
|||||||
The attribute is Unset, by listing the name of the
|
The attribute is Unset, by listing the name of the
|
||||||
attribute prefixed with a dash - for the path.
|
attribute prefixed with a dash - for the path.
|
||||||
} else if (ATTR_UNSET(value)) {
|
} else if (ATTR_UNSET(value)) {
|
||||||
The attribute is not set nor unset for the path.
|
The attribute is neither set nor unset for the path.
|
||||||
} else if (!strcmp(value, "input")) {
|
} else if (!strcmp(value, "input")) {
|
||||||
If none of ATTR_TRUE(), ATTR_FALSE(), or ATTR_UNSET() is
|
If none of ATTR_TRUE(), ATTR_FALSE(), or ATTR_UNSET() is
|
||||||
true, the value is a string set in the gitattributes
|
true, the value is a string set in the gitattributes
|
||||||
|
@ -237,10 +237,10 @@ The client now sends the maximum commit history depth it wants for
|
|||||||
this transaction, which is the number of commits it wants from the
|
this transaction, which is the number of commits it wants from the
|
||||||
tip of the history, if any, as a 'deepen' line. A depth of 0 is the
|
tip of the history, if any, as a 'deepen' line. A depth of 0 is the
|
||||||
same as not making a depth request. The client does not want to receive
|
same as not making a depth request. The client does not want to receive
|
||||||
any commits beyond this depth, nor objects needed only to complete
|
any commits beyond this depth, nor does it want objects needed only to
|
||||||
those commits. Commits whose parents are not received as a result are
|
complete those commits. Commits whose parents are not received as a
|
||||||
defined as shallow and marked as such in the server. This information
|
result are defined as shallow and marked as such in the server. This
|
||||||
is sent back to the client in the next step.
|
information is sent back to the client in the next step.
|
||||||
|
|
||||||
Once all the 'want's and 'shallow's (and optional 'deepen') are
|
Once all the 'want's and 'shallow's (and optional 'deepen') are
|
||||||
transferred, clients MUST send a flush-pkt, to tell the server side
|
transferred, clients MUST send a flush-pkt, to tell the server side
|
||||||
|
@ -39,7 +39,7 @@ More specifically, they:
|
|||||||
caret `^`, colon `:`, question-mark `?`, asterisk `*`,
|
caret `^`, colon `:`, question-mark `?`, asterisk `*`,
|
||||||
or open bracket `[` anywhere.
|
or open bracket `[` anywhere.
|
||||||
|
|
||||||
. They cannot end with a slash `/` nor a dot `.`.
|
. They cannot end with a slash `/` or a dot `.`.
|
||||||
|
|
||||||
. They cannot end with the sequence `.lock`.
|
. They cannot end with the sequence `.lock`.
|
||||||
|
|
||||||
|
@ -4074,7 +4074,7 @@ the `HEAD` tree, and stage 3 to the `$target` tree.
|
|||||||
|
|
||||||
Earlier we said that trivial merges are done inside
|
Earlier we said that trivial merges are done inside
|
||||||
`git read-tree -m`. For example, if the file did not change
|
`git read-tree -m`. For example, if the file did not change
|
||||||
from `$orig` to `HEAD` nor `$target`, or if the file changed
|
from `$orig` to `HEAD` or `$target`, or if the file changed
|
||||||
from `$orig` to `HEAD` and `$orig` to `$target` the same way,
|
from `$orig` to `HEAD` and `$orig` to `$target` the same way,
|
||||||
obviously the final outcome is what is in `HEAD`. What the
|
obviously the final outcome is what is in `HEAD`. What the
|
||||||
above example shows is that file `hello.c` was changed from
|
above example shows is that file `hello.c` was changed from
|
||||||
|
Loading…
Reference in New Issue
Block a user