Signed-off-by: Horst H. von Brand <vonbrand@xxxxxxxxxxxx> --- Documentation/config.txt | 2 +- Documentation/core-tutorial.txt | 8 ++++---- Documentation/diff-format.txt | 8 ++++---- Documentation/diffcore.txt | 2 +- Documentation/git-branch.txt | 2 +- Documentation/git-cat-file.txt | 2 +- Documentation/git-checkout.txt | 2 +- Documentation/git-cherry.txt | 2 +- Documentation/git-diff-index.txt | 8 ++++---- Documentation/git-fsck-objects.txt | 8 ++++---- Documentation/git-init-db.txt | 2 +- Documentation/git-ls-files.txt | 2 +- Documentation/git-merge-index.txt | 2 +- Documentation/git-mktag.txt | 2 +- Documentation/git-pack-objects.txt | 2 +- Documentation/git-push.txt | 2 +- Documentation/git-rev-parse.txt | 8 ++++---- Documentation/git-show-branch.txt | 4 ++-- Documentation/git-unpack-file.txt | 2 +- Documentation/git-update-index.txt | 2 +- Documentation/git-verify-pack.txt | 4 ++-- Documentation/git-verify-tag.txt | 2 +- Documentation/git.txt | 2 +- Documentation/glossary.txt | 6 +++--- Documentation/tutorial-2.txt | 14 +++++++------- 25 files changed, 50 insertions(+), 50 deletions(-) diff --git a/Documentation/config.txt b/Documentation/config.txt index bb93dc5..4195713 100644 --- a/Documentation/config.txt +++ b/Documentation/config.txt @@ -72,7 +72,7 @@ core.preferSymlinkRefs:: core.logAllRefUpdates:: If true, `git-update-ref` will append a line to - "$GIT_DIR/logs/<ref>" listing the new SHA1 and the date/time + "$GIT_DIR/logs/<ref>" listing the new SHA-1 and the date/time of the update. If the file does not exist it will be created automatically. This information can be used to determine what commit was the tip of a branch "2 days ago". diff --git a/Documentation/core-tutorial.txt b/Documentation/core-tutorial.txt index b59153e..59f86ee 100644 --- a/Documentation/core-tutorial.txt +++ b/Documentation/core-tutorial.txt @@ -100,9 +100,9 @@ branch. A number of the git tools will a 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 @@ -772,7 +772,7 @@ already discussed, the `HEAD` branch is 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, @@ -1260,7 +1260,7 @@ file (the first tree goes to stage 1, th 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). diff --git a/Documentation/diff-format.txt b/Documentation/diff-format.txt index 89607c8..859e527 100644 --- a/Documentation/diff-format.txt +++ b/Documentation/diff-format.txt @@ -35,9 +35,9 @@ That is, from the left to the right: . a space. . mode for "dst"; 000000 if deletion or unmerged. . a space. -. sha1 for "src"; 0\{40\} if creation or unmerged. +. SHA-1 for "src"; 0\{40\} if creation or unmerged. . a space. -. sha1 for "dst"; 0\{40\} if creation, unmerged or "look at work tree". +. SHA-1 for "dst"; 0\{40\} if creation, unmerged or "look at work tree". . a space. . status, followed by optional "score" number. . a tab or a NUL when `-z` option is used. @@ -46,7 +46,7 @@ That is, from the left to the right: . path for "dst"; only exists for C or R. . an LF or a NUL when `-z` option is used, to terminate the record. -<sha1> is shown as all 0's if a file is new on the filesystem +<SHA-1> is shown as all 0's if a file is new on the filesystem and it is out of sync with the index. Example: @@ -97,7 +97,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. + diff --git a/Documentation/diffcore.txt b/Documentation/diffcore.txt index 5492669..2d45ea0 100644 --- a/Documentation/diffcore.txt +++ b/Documentation/diffcore.txt @@ -115,7 +115,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 diff --git a/Documentation/git-branch.txt b/Documentation/git-branch.txt index 29b102d..36100c0 100644 --- a/Documentation/git-branch.txt +++ b/Documentation/git-branch.txt @@ -38,7 +38,7 @@ OPTIONS -l:: Create the branch's ref log. This activates recording of all changes to made the branch ref, enabling use of date - based sha1 expressions such as "<branchname>@{yesterday}". + based SHA-1 expressions such as "<branchname>@{yesterday}". -f:: Force the creation of a new branch even if it means deleting diff --git a/Documentation/git-cat-file.txt b/Documentation/git-cat-file.txt index 85fb9ae..760d4b3 100644 --- a/Documentation/git-cat-file.txt +++ b/Documentation/git-cat-file.txt @@ -19,7 +19,7 @@ or `-s` is used to find the object size. OPTIONS ------- <object>:: - The sha1 identifier of the object. + The SHA-1 identifier of the object. -t:: Instead of the content, show the object type identified by diff --git a/Documentation/git-checkout.txt b/Documentation/git-checkout.txt index 90fc318..9b6c719 100644 --- a/Documentation/git-checkout.txt +++ b/Documentation/git-checkout.txt @@ -43,7 +43,7 @@ OPTIONS -l:: Create the new branch's ref log. This activates recording of all changes to made the branch ref, enabling use of date - based sha1 expressions such as "<branchname>@{yesterday}". + based SHA-1 expressions such as "<branchname>@{yesterday}". -m:: If you have local modifications to one or more files that diff --git a/Documentation/git-cherry.txt b/Documentation/git-cherry.txt index cccb781..35f11cd 100644 --- a/Documentation/git-cherry.txt +++ b/Documentation/git-cherry.txt @@ -15,7 +15,7 @@ The changeset (or "diff") of each commit is compared against each commit between the fork-point and <upstream>. Every commit with a changeset that doesn't exist in the other branch -has its id (sha1) reported, prefixed by a symbol. Those existing only +has its id (SHA-1) reported, prefixed by a symbol. Those existing only in the <upstream> branch are prefixed with a minus (-) sign, and those that only exist in the <head> branch are prefixed with a plus (+) symbol. diff --git a/Documentation/git-diff-index.txt b/Documentation/git-diff-index.txt index 39d3b99..cdace11 100644 --- a/Documentation/git-diff-index.txt +++ b/Documentation/git-diff-index.txt @@ -93,7 +93,7 @@ you *could* commit. Again, the output ma output to a tee, but with a twist. The twist is that if some file doesn't match the index, we don't have -a backing store thing for it, and we use the magic "all-zero" sha1 to +a backing store thing for it, and we use the magic "all-zero" SHA-1 to show that. So let's say that you have edited `kernel/sched.c`, but have not actually done a `git update-index` on it yet - there is no "object" associated with the new state, and you get: @@ -102,7 +102,7 @@ have not actually done a `git update-ind *100644->100664 blob 7476bb......->000000...... kernel/sched.c i.e., it shows that the tree has changed, and that `kernel/sched.c` has is -not up-to-date and may contain new stuff. The all-zero sha1 means that to +not up-to-date and may contain new stuff. The all-zero SHA-1 means that to get the real diff, you need to look at the object in the working directory directly rather than do an object-to-object diff. @@ -115,8 +115,8 @@ touched it. In either case, it's a note NOTE: You can have a mixture of files show up as "has been updated" and "is still dirty in the working directory" together. You can always tell which file is in which state, since the "has been updated" ones -show a valid sha1, and the "not in sync with the index" ones will -always have the special all-zero sha1. +show a valid SHA-1, and the "not in sync with the index" ones will +always have the special all-zero SHA-1. Author diff --git a/Documentation/git-fsck-objects.txt b/Documentation/git-fsck-objects.txt index e842bfd..1413f77 100644 --- a/Documentation/git-fsck-objects.txt +++ b/Documentation/git-fsck-objects.txt @@ -22,7 +22,7 @@ OPTIONS An object to treat as the head of an unreachability trace. + If no objects are given, git-fsck-objects defaults to using the -index file and all SHA1 references in .git/refs/* as heads. +index file and all SHA-1 references in .git/refs/* as heads. --unreachable:: Print out objects that exist but that aren't readable from any @@ -55,7 +55,7 @@ index file and all SHA1 references in .g objects that triggers this check, but it is recommended to check new projects with this flag. -It tests SHA1 and general object sanity, and it does full tracking of +It 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 @@ -87,7 +87,7 @@ expect dangling commits - potential head root nodes. missing sha1 directory '<dir>':: - The directory holding the sha1 objects is missing. + The directory holding the SHA-1 objects is missing. unreachable <type> <object>:: The <type> object <object>, isn't actually referred to directly @@ -109,7 +109,7 @@ warning: git-fsck-objects: tree <tree> h And it shouldn't... sha1 mismatch <object>:: - The database has an object who's sha1 doesn't match the + The database has an object who's SHA-1 doesn't match the database value. This indicates a serious data integrity problem. diff --git a/Documentation/git-init-db.txt b/Documentation/git-init-db.txt index 6e32f88..7f83f7e 100644 --- a/Documentation/git-init-db.txt +++ b/Documentation/git-init-db.txt @@ -39,7 +39,7 @@ If the `$GIT_DIR` environment variable i to use instead of `./.git` for the base of the repository. If the object storage directory is specified via the `$GIT_OBJECT_DIRECTORY` -environment variable then the sha1 directories are created underneath - +environment variable then the SHA-1 directories are created underneath - otherwise the default `$GIT_DIR/objects` directory is used. A shared repository allows users belonging to the same group to push into that diff --git a/Documentation/git-ls-files.txt b/Documentation/git-ls-files.txt index 7567323..4bb0f5f 100644 --- a/Documentation/git-ls-files.txt +++ b/Documentation/git-ls-files.txt @@ -123,7 +123,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 dircache 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 diff --git a/Documentation/git-merge-index.txt b/Documentation/git-merge-index.txt index af79688..7348682 100644 --- a/Documentation/git-merge-index.txt +++ b/Documentation/git-merge-index.txt @@ -13,7 +13,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. diff --git a/Documentation/git-mktag.txt b/Documentation/git-mktag.txt index ca0f48a..26b2a6e 100644 --- a/Documentation/git-mktag.txt +++ b/Documentation/git-mktag.txt @@ -21,7 +21,7 @@ Tag Format ---------- A tag signature file has a very simple fixed format: three lines of - object <sha1> + object <SHA-1> type <typename> tag <tagname> diff --git a/Documentation/git-pack-objects.txt b/Documentation/git-pack-objects.txt index d968afe..bbe2afa 100644 --- a/Documentation/git-pack-objects.txt +++ b/Documentation/git-pack-objects.txt @@ -46,7 +46,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 object names (currently in random order so it does not have any useful meaning) to make the resulting filename reasonably unique, and written to the standard diff --git a/Documentation/git-push.txt b/Documentation/git-push.txt index 52be715..b299045 100644 --- a/Documentation/git-push.txt +++ b/Documentation/git-push.txt @@ -34,7 +34,7 @@ OPTIONS the destination ref. + The <src> side can be an -arbitrary "SHA1 expression" that can be used as an +arbitrary "SHA-1 expression" that can be used as an argument to `git-cat-file -t`. E.g. `master~4` (push four parents before the current master head). + diff --git a/Documentation/git-rev-parse.txt b/Documentation/git-rev-parse.txt index 5a4e6b5..6235834 100644 --- a/Documentation/git-rev-parse.txt +++ b/Documentation/git-rev-parse.txt @@ -59,7 +59,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. @@ -90,7 +90,7 @@ OPTIONS Show `$GIT_DIR` if defined else show the path to the .git directory. --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. @@ -110,10 +110,10 @@ SPECIFYING REVISIONS -------------------- A revision parameter typically, but not necessarily, names a -commit object. They use what is called an 'extended SHA1' +commit object. They use what is called an 'extended SHA-1' syntax. -* The full SHA1 object name (40-byte hexadecimal string), or +* The full SHA-1 object name (40-byte hexadecimal string), or a substring of such that is unique within the repository. E.g. dae86e1950b1277e545cee180551750029cfe735 and dae86e both name the same commit object if there are no other object in diff --git a/Documentation/git-show-branch.txt b/Documentation/git-show-branch.txt index 424b97b..7afdea3 100644 --- a/Documentation/git-show-branch.txt +++ b/Documentation/git-show-branch.txt @@ -28,7 +28,7 @@ no <rev> nor <glob> is given on the comm OPTIONS ------- <rev>:: - Arbitrary extended SHA1 expression (see `git-rev-parse`) + Arbitrary extended SHA-1 expression (see `git-rev-parse`) that typically names a branch HEAD or a tag. <glob>:: @@ -97,7 +97,7 @@ displayed, indented N places. If a comm 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": diff --git a/Documentation/git-unpack-file.txt b/Documentation/git-unpack-file.txt index 259df2c..c9da258 100644 --- a/Documentation/git-unpack-file.txt +++ b/Documentation/git-unpack-file.txt @@ -13,7 +13,7 @@ SYNOPSIS DESCRIPTION ----------- -Creates a file holding the contents of the blob specified by sha1. It +Creates a file holding the contents of the blob specified by SHA-1. It returns the name of the temporary file in the following format: .merge_file_XXXXX diff --git a/Documentation/git-update-index.txt b/Documentation/git-update-index.txt index 56a2b15..10eabd7 100644 --- a/Documentation/git-update-index.txt +++ b/Documentation/git-update-index.txt @@ -167,7 +167,7 @@ Using --index-info multiple entry definitions from the standard input, and designed specifically for scripts. It can take inputs of three formats: - . mode SP sha1 TAB path + . mode SP SHA-1 TAB path + The first format is what "git-apply --index-info" reports, and used to reconstruct a partial tree diff --git a/Documentation/git-verify-pack.txt b/Documentation/git-verify-pack.txt index d10454c..e0e503f 100644 --- a/Documentation/git-verify-pack.txt +++ b/Documentation/git-verify-pack.txt @@ -32,11 +32,11 @@ OUTPUT FORMAT ------------- When specifying the -v option the format used is: - SHA1 type size offset-in-packfile + SHA-1 type size offset-in-packfile for objects that are not deltified in the pack, and - SHA1 type size offset-in-packfile depth base-SHA1 + SHA-1 type size offset-in-packfile depth base-SHA-1 for objects that are deltified. diff --git a/Documentation/git-verify-tag.txt b/Documentation/git-verify-tag.txt index 1a150f6..7c9835c 100644 --- a/Documentation/git-verify-tag.txt +++ b/Documentation/git-verify-tag.txt @@ -16,7 +16,7 @@ Validates the gpg signature created by g OPTIONS ------- <tag>:: - SHA1 identifier of a git tag object. + SHA-1 identifier of a git tag object. Author ------ diff --git a/Documentation/git.txt b/Documentation/git.txt index d4472b5..2d454f8 100644 --- a/Documentation/git.txt +++ b/Documentation/git.txt @@ -585,7 +585,7 @@ git so take care if using Cogito etc. 'GIT_OBJECT_DIRECTORY':: If the object storage directory is specified via this - environment variable then the sha1 directories are created + environment variable then the SHA-1 directories are created underneath - otherwise the default `$GIT_DIR/objects` directory is used. diff --git a/Documentation/glossary.txt b/Documentation/glossary.txt index 116ddb7..3a0215c 100644 --- a/Documentation/glossary.txt +++ b/Documentation/glossary.txt @@ -163,7 +163,7 @@ merge:: object:: The unit of storage in git. It is uniquely identified by - the SHA1 of its contents. Consequently, an object can not + the SHA-1 of its contents. Consequently, an object can not be changed. object database:: @@ -243,7 +243,7 @@ rebase:: changes from that branch. ref:: - A 40-byte hex representation of a SHA1 or a name that denotes + A 40-byte hex representation of a SHA-1 or a name that denotes a particular object. These may be stored in `$GIT_DIR/refs/`. refspec:: @@ -279,7 +279,7 @@ rewind:: SCM:: Source code management (tool). -SHA1:: +SHA-1:: Synonym for object name. topic branch:: diff --git a/Documentation/tutorial-2.txt b/Documentation/tutorial-2.txt index 894ca5e..0dc91e7 100644 --- a/Documentation/tutorial-2.txt +++ b/Documentation/tutorial-2.txt @@ -32,9 +32,9 @@ 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 -such a 40-digit hex name. That name is the SHA1 hash of the object's +such 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). @@ -51,14 +51,14 @@ A tree can refer to one or more "blob" o 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: ------------------------------------------------ @@ -77,7 +77,7 @@ Note that this is the old file data; so 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: ------------------------------------------------ @@ -114,7 +114,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: ------------------------------------------------ @@ -180,7 +180,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. -- 1.4.0.g1b2d - : send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html