Skip to content

Commit

Permalink
The name of the hash function is "SHA-1", not "SHA1"
Browse files Browse the repository at this point in the history
Use "SHA-1" instead of "SHA1" whenever we talk about the hash function.
When used as a programming symbol, we keep "SHA1".

Signed-off-by: Thomas Ackermann <[email protected]>
Signed-off-by: Junio C Hamano <[email protected]>
  • Loading branch information
tacker66 authored and gitster committed Apr 15, 2013
1 parent 3ab5012 commit d5fa1f1
Show file tree
Hide file tree
Showing 31 changed files with 68 additions and 68 deletions.
2 changes: 1 addition & 1 deletion Documentation/config.txt
Original file line number Diff line number Diff line change
Expand Up @@ -412,7 +412,7 @@ repository's usual working tree).
core.logAllRefUpdates::
Enable the reflog. Updates to a ref <ref> is logged to the file
"$GIT_DIR/logs/<ref>", by appending the new and old
SHA1, the date/time and the reason of the update, but
SHA-1, the date/time and the reason of the update, but
only when the file exists. If this configuration
variable is set to true, missing "$GIT_DIR/logs/<ref>"
file is automatically created for branch heads (i.e. under
Expand Down
6 changes: 3 additions & 3 deletions Documentation/git-cat-file.txt
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ object type, or '-s' is used to find the object size, or '--textconv' is used
(which implies type "blob").

In the second form, a list of objects (separated by linefeeds) is provided on
stdin, and the SHA1, type, and size of each object is printed on stdout.
stdin, and the SHA-1, type, and size of each object is printed on stdout.

OPTIONS
-------
Expand Down Expand Up @@ -58,11 +58,11 @@ OPTIONS
to apply the filter to the content recorded in the index at <path>.

--batch::
Print the SHA1, type, size, and contents of each object provided on
Print the SHA-1, type, size, and contents of each object provided on
stdin. May not be combined with any other options or arguments.

--batch-check::
Print the SHA1, type, and size of each object provided on stdin. May not
Print the SHA-1, type, and size of each object provided on stdin. May not
be combined with any other options or arguments.

OUTPUT
Expand Down
2 changes: 1 addition & 1 deletion Documentation/git-describe.txt
Original file line number Diff line number Diff line change
Expand Up @@ -149,7 +149,7 @@ is found, its name will be output and searching will stop.
If an exact match was not found, 'git describe' will walk back
through the commit history to locate an ancestor commit which
has been tagged. The ancestor's tag will be output along with an
abbreviation of the input committish's SHA1.
abbreviation of the input committish's SHA-1.

If multiple tags were found during the walk then the tag which
has the fewest commits different from the input committish will be
Expand Down
4 changes: 2 additions & 2 deletions Documentation/git-fsck.txt
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ OPTIONS
An object to treat as the head of an unreachability trace.
+
If no objects are given, 'git fsck' defaults to using the
index file, all SHA1 references in `refs` namespace, and all reflogs
index file, all SHA-1 references in `refs` namespace, and all reflogs
(unless --no-reflogs is given) as heads.

--unreachable::
Expand Down Expand Up @@ -89,7 +89,7 @@ index file, all SHA1 references in `refs` namespace, and all reflogs
DISCUSSION
----------

git-fsck tests SHA1 and general object sanity, and it does full tracking
git-fsck tests SHA-1 and general object sanity, and it does full tracking
of the resulting reachability and everything else. It prints out any
corruption it finds (missing or bad objects), and if you use the
'--unreachable' flag it will also print out objects that exist but that
Expand Down
2 changes: 1 addition & 1 deletion Documentation/git-index-pack.txt
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ Note
----

Once the index has been created, the list of object names is sorted
and the SHA1 hash of that list is printed to stdout. If --stdin was
and the SHA-1 hash of that list is printed to stdout. If --stdin was
also used then this is prefixed by either "pack\t", or "keep\t" if a
new .keep file was successfully created. This is useful to remove a
.keep file used as a lock to prevent the race with 'git repack'
Expand Down
2 changes: 1 addition & 1 deletion Documentation/git-ls-files.txt
Original file line number Diff line number Diff line change
Expand Up @@ -164,7 +164,7 @@ which case it outputs:
'git ls-files --unmerged' and 'git ls-files --stage' can be used to examine
detailed information on unmerged paths.

For an unmerged path, instead of recording a single mode/SHA1 pair,
For an unmerged path, instead of recording a single mode/SHA-1 pair,
the index records up to three such pairs; one from tree O in stage
1, A in stage 2, and B in stage 3. This information can be used by
the user (or the porcelain) to see what should eventually be recorded at the
Expand Down
2 changes: 1 addition & 1 deletion Documentation/git-merge-index.txt
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ SYNOPSIS
DESCRIPTION
-----------
This looks up the <file>(s) in the index and, if there are any merge
entries, passes the SHA1 hash for those files as arguments 1, 2, 3 (empty
entries, passes the SHA-1 hash for those files as arguments 1, 2, 3 (empty
argument if no file), and <file> as argument 4. File modes for the three
files are passed as arguments 5, 6 and 7.

Expand Down
2 changes: 1 addition & 1 deletion Documentation/git-pack-objects.txt
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ base-name::
Write into a pair of files (.pack and .idx), using
<base-name> to determine the name of the created file.
When this option is used, the two files are written in
<base-name>-<SHA1>.{pack,idx} files. <SHA1> is a hash
<base-name>-<SHA-1>.{pack,idx} files. <SHA-1> is a hash
of the sorted object names to make the resulting filename
based on the pack content, and written to the standard
output of the command.
Expand Down
2 changes: 1 addition & 1 deletion Documentation/git-patch-id.txt
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ SYNOPSIS

DESCRIPTION
-----------
A "patch ID" is nothing but a SHA1 of the diff associated with a patch, with
A "patch ID" is nothing but a SHA-1 of the diff associated with a patch, with
whitespace and line numbers ignored. As such, it's "reasonably stable", but at
the same time also reasonably unique, i.e., two patches that have the same "patch
ID" are almost guaranteed to be the same thing.
Expand Down
4 changes: 2 additions & 2 deletions Documentation/git-replace.txt
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ DESCRIPTION
-----------
Adds a 'replace' reference in `refs/replace/` namespace.

The name of the 'replace' reference is the SHA1 of the object that is
replaced. The content of the 'replace' reference is the SHA1 of the
The name of the 'replace' reference is the SHA-1 of the object that is
replaced. The content of the 'replace' reference is the SHA-1 of the
replacement object.

Unless `-f` is given, the 'replace' reference must not yet exist.
Expand Down
4 changes: 2 additions & 2 deletions Documentation/git-rev-parse.txt
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ OPTIONS
one.

--symbolic::
Usually the object names are output in SHA1 form (with
Usually the object names are output in SHA-1 form (with
possible '{caret}' prefix); this option makes them output in a
form as close to the original input as possible.

Expand Down Expand Up @@ -169,7 +169,7 @@ print a message to stderr and exit with nonzero status.

--short::
--short=number::
Instead of outputting the full SHA1 values of object names try to
Instead of outputting the full SHA-1 values of object names try to
abbreviate them to a shorter unique name. When no length is specified
7 is used. The minimum length is 4.

Expand Down
4 changes: 2 additions & 2 deletions Documentation/git-show-branch.txt
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ no <rev> nor <glob> is given on the command line.
OPTIONS
-------
<rev>::
Arbitrary extended SHA1 expression (see linkgit:gitrevisions[7])
Arbitrary extended SHA-1 expression (see linkgit:gitrevisions[7])
that typically names a branch head or a tag.

<glob>::
Expand Down Expand Up @@ -142,7 +142,7 @@ displayed, indented N places. If a commit is on the I-th
branch, the I-th indentation character shows a `+` sign;
otherwise it shows a space. Merge commits are denoted by
a `-` sign. Each commit shows a short name that
can be used as an extended SHA1 to name that commit.
can be used as an extended SHA-1 to name that commit.

The following example shows three branches, "master", "fixes"
and "mhf":
Expand Down
2 changes: 1 addition & 1 deletion Documentation/git-show-index.txt
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Reads given idx file for packed Git archive created with

The information it outputs is subset of what you can get from
'git verify-pack -v'; this command only shows the packfile
offset and SHA1 of each object.
offset and SHA-1 of each object.

GIT
---
Expand Down
4 changes: 2 additions & 2 deletions Documentation/git-show-ref.txt
Original file line number Diff line number Diff line change
Expand Up @@ -50,8 +50,8 @@ OPTIONS
-s::
--hash[=<n>]::

Only show the SHA1 hash, not the reference name. When combined with
--dereference the dereferenced tag will still be shown after the SHA1.
Only show the SHA-1 hash, not the reference name. When combined with
--dereference the dereferenced tag will still be shown after the SHA-1.

--verify::

Expand Down
2 changes: 1 addition & 1 deletion Documentation/git-tag.txt
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ in the tag message.
If `-m <msg>` or `-F <file>` is given and `-a`, `-s`, and `-u <key-id>`
are absent, `-a` is implied.

Otherwise just a tag reference for the SHA1 object name of the commit object is
Otherwise just a tag reference for the SHA-1 object name of the commit object is
created (i.e. a lightweight tag).

A GnuPG signed tag object will be created when `-s` or `-u
Expand Down
2 changes: 1 addition & 1 deletion Documentation/git-update-index.txt
Original file line number Diff line number Diff line change
Expand Up @@ -247,7 +247,7 @@ $ git update-index --index-info
------------

The first line of the input feeds 0 as the mode to remove the
path; the SHA1 does not matter as long as it is well formatted.
path; the SHA-1 does not matter as long as it is well formatted.
Then the second and third line feeds stage 1 and stage 2 entries
for that path. After the above, we would end up with this:

Expand Down
4 changes: 2 additions & 2 deletions Documentation/git-verify-pack.txt
Original file line number Diff line number Diff line change
Expand Up @@ -40,11 +40,11 @@ OUTPUT FORMAT
-------------
When specifying the -v option the format used is:

SHA1 type size size-in-pack-file offset-in-packfile
SHA-1 type size size-in-pack-file offset-in-packfile

for objects that are not deltified in the pack, and

SHA1 type size size-in-packfile offset-in-packfile depth base-SHA1
SHA-1 type size size-in-packfile offset-in-packfile depth base-SHA-1

for objects that are deltified.

Expand Down
2 changes: 1 addition & 1 deletion Documentation/git-verify-tag.txt
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ OPTIONS
Print the contents of the tag object before validating it.

<tag>...::
SHA1 identifiers of Git tag objects.
SHA-1 identifiers of Git tag objects.

GIT
---
Expand Down
10 changes: 5 additions & 5 deletions Documentation/git.txt
Original file line number Diff line number Diff line change
Expand Up @@ -741,7 +741,7 @@ where:

<old|new>-file:: are files GIT_EXTERNAL_DIFF can use to read the
contents of <old|new>,
<old|new>-hex:: are the 40-hexdigit SHA1 hashes,
<old|new>-hex:: are the 40-hexdigit SHA-1 hashes,
<old|new>-mode:: are the octal representation of the file modes.
+
The file parameters can point at the user's working file
Expand Down Expand Up @@ -864,7 +864,7 @@ The commit, equivalent to what other systems call a "changeset" or
represents an immediately preceding step. Commits with more than one
parent represent merges of independent lines of development.

All objects are named by the SHA1 hash of their contents, normally
All objects are named by the SHA-1 hash of their contents, normally
written as a string of 40 hex digits. Such names are globally unique.
The entire history leading up to a commit can be vouched for by signing
just that commit. A fourth object type, the tag, is provided for this
Expand All @@ -874,9 +874,9 @@ When first created, objects are stored in individual files, but for
efficiency may later be compressed together into "pack files".

Named pointers called refs mark interesting points in history. A ref
may contain the SHA1 name of an object or the name of another ref. Refs
with names beginning `ref/head/` contain the SHA1 name of the most
recent commit (or "head") of a branch under development. SHA1 names of
may contain the SHA-1 name of an object or the name of another ref. Refs
with names beginning `ref/head/` contain the SHA-1 name of the most
recent commit (or "head") of a branch under development. SHA-1 names of
tags of interest are stored under `ref/tags/`. A special ref named
`HEAD` contains the name of the currently checked-out branch.

Expand Down
8 changes: 4 additions & 4 deletions Documentation/gitcore-tutorial.txt
Original file line number Diff line number Diff line change
Expand Up @@ -106,9 +106,9 @@ branch. A number of the Git tools will assume that `.git/HEAD` is
valid, though.

[NOTE]
An 'object' is identified by its 160-bit SHA1 hash, aka 'object name',
An 'object' is identified by its 160-bit SHA-1 hash, aka 'object name',
and a reference to an object is always the 40-byte hex
representation of that SHA1 name. The files in the `refs`
representation of that SHA-1 name. The files in the `refs`
subdirectory are expected to contain these hex references
(usually with a final `\n` at the end), and you should thus
expect to see a number of 41-byte files containing these
Expand Down Expand Up @@ -763,7 +763,7 @@ already discussed, the `HEAD` branch is nothing but a symlink to one of
these object pointers.

You can at any time create a new branch by just picking an arbitrary
point in the project history, and just writing the SHA1 name of that
point in the project history, and just writing the SHA-1 name of that
object into a file under `.git/refs/heads/`. You can use any filename you
want (and indeed, subdirectories), but the convention is that the
"normal" branch is called `master`. That's just a convention, though,
Expand Down Expand Up @@ -1233,7 +1233,7 @@ file (the first tree goes to stage 1, the second to stage 2,
etc.). After reading three trees into three stages, the paths
that are the same in all three stages are 'collapsed' into stage
0. Also paths that are the same in two of three stages are
collapsed into stage 0, taking the SHA1 from either stage 2 or
collapsed into stage 0, taking the SHA-1 from either stage 2 or
stage 3, whichever is different from stage 1 (i.e. only one side
changed from the common ancestor).

Expand Down
2 changes: 1 addition & 1 deletion Documentation/gitdiffcore.txt
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,7 @@ it changes it to:
For the purpose of breaking a filepair, diffcore-break examines
the extent of changes between the contents of the files before
and after modification (i.e. the contents that have "bcd1234..."
and "0123456..." as their SHA1 content ID, in the above
and "0123456..." as their SHA-1 content ID, in the above
example). The amount of deletion of original contents and
insertion of new material are added together, and if it exceeds
the "break score", the filepair is broken into two. The break
Expand Down
10 changes: 5 additions & 5 deletions Documentation/githooks.txt
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,7 @@ given); `template` (if a `-t` option was given or the
configuration option `commit.template` is set); `merge` (if the
commit is a merge or a `.git/MERGE_MSG` file exists); `squash`
(if a `.git/SQUASH_MSG` file exists); or `commit`, followed by
a commit SHA1 (if a `-c`, `-C` or `--amend` option was given).
a commit SHA-1 (if a `-c`, `-C` or `--amend` option was given).

If the exit status is non-zero, 'git commit' will abort.

Expand Down Expand Up @@ -196,11 +196,11 @@ hook would receive a line like the following:

refs/heads/master 67890 refs/heads/foreign 12345

although the full, 40-character SHA1s would be supplied. If the foreign ref
does not yet exist the `<remote SHA1>` will be 40 `0`. If a ref is to be
although the full, 40-character SHA-1s would be supplied. If the foreign ref
does not yet exist the `<remote SHA-1>` will be 40 `0`. If a ref is to be
deleted, the `<local ref>` will be supplied as `(delete)` and the `<local
SHA1>` will be 40 `0`. If the local commit was specified by something other
than a name which could be expanded (such as `HEAD~`, or a SHA1) it will be
SHA-1>` will be 40 `0`. If the local commit was specified by something other
than a name which could be expanded (such as `HEAD~`, or a SHA-1) it will be
supplied as it was originally given.

If this hook exits with a non-zero status, 'git push' will abort without
Expand Down
2 changes: 1 addition & 1 deletion Documentation/gitrepository-layout.txt
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ refs/remotes/`name`::
from a remote repository.

refs/replace/`<obj-sha1>`::
records the SHA1 of the object that replaces `<obj-sha1>`.
records the SHA-1 of the object that replaces `<obj-sha1>`.
This is similar to info/grafts and is internally used and
maintained by linkgit:git-replace[1]. Such refs can be exchanged
between repositories while grafts are not.
Expand Down
16 changes: 8 additions & 8 deletions Documentation/gittutorial-2.txt
Original file line number Diff line number Diff line change
Expand Up @@ -46,17 +46,17 @@ What are the 7 digits of hex that Git responded to the commit with?

We saw in part one of the tutorial that commits have names like this.
It turns out that every object in the Git history is stored under
a 40-digit hex name. That name is the SHA1 hash of the object's
a 40-digit hex name. That name is the SHA-1 hash of the object's
contents; among other things, this ensures that Git will never store
the same data twice (since identical data is given an identical SHA1
the same data twice (since identical data is given an identical SHA-1
name), and that the contents of a Git object will never change (since
that would change the object's name as well). The 7 char hex strings
here are simply the abbreviation of such 40 character long strings.
Abbreviations can be used everywhere where the 40 character strings
can be used, so long as they are unambiguous.

It is expected that the content of the commit object you created while
following the example above generates a different SHA1 hash than
following the example above generates a different SHA-1 hash than
the one shown above because the commit object records the time when
it was created and the name of the person performing the commit.

Expand All @@ -80,14 +80,14 @@ A tree can refer to one or more "blob" objects, each corresponding to
a file. In addition, a tree can also refer to other tree objects,
thus creating a directory hierarchy. You can examine the contents of
any tree using ls-tree (remember that a long enough initial portion
of the SHA1 will also work):
of the SHA-1 will also work):

------------------------------------------------
$ git ls-tree 92b8b694
100644 blob 3b18e512dba79e4c8300dd08aeb37f8e728b8dad file.txt
------------------------------------------------

Thus we see that this tree has one file in it. The SHA1 hash is a
Thus we see that this tree has one file in it. The SHA-1 hash is a
reference to that file's data:

------------------------------------------------
Expand All @@ -106,7 +106,7 @@ Note that this is the old file data; so the object that Git named in
its response to the initial tree was a tree with a snapshot of the
directory state that was recorded by the first commit.

All of these objects are stored under their SHA1 names inside the Git
All of these objects are stored under their SHA-1 names inside the Git
directory:

------------------------------------------------
Expand Down Expand Up @@ -142,7 +142,7 @@ ref: refs/heads/master

As you can see, this tells us which branch we're currently on, and it
tells us this by naming a file under the .git directory, which itself
contains a SHA1 name referring to a commit object, which we can
contains a SHA-1 name referring to a commit object, which we can
examine with cat-file:

------------------------------------------------
Expand Down Expand Up @@ -208,7 +208,7 @@ project's history:

Note, by the way, that lots of commands take a tree as an argument.
But as we can see above, a tree can be referred to in many different
ways--by the SHA1 name for that tree, by the name of a commit that
ways--by the SHA-1 name for that tree, by the name of a commit that
refers to the tree, by the name of a branch whose head refers to that
tree, etc.--and most such commands can accept any of these names.

Expand Down
Loading

0 comments on commit d5fa1f1

Please sign in to comment.