Skip to contentSkip to conversation

docs: typofixes

PATCH Superseded Linus Arver via GitGitGadget 4 participants 6 messages Jun 7, 2023 Documentation

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 docs: typofixes

From: Linus Arver <[email protected]>

These were found with an automated CLI tool [1]. Only the "Documentation" subfolder (and not source code files) was considered because the docs are user-facing.

[1]: https://crates.io/crates/typos-cli

---
docs: typofixes

Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-1542%2Flistx%2Ftypofixes-v1
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-1542/listx/typofixes-v1
Pull-Request: https://github.com/gitgitgadget/git/pull/1542

 Documentation/CodingGuidelines                  | 2 +-
 Documentation/config.txt                        | 2 +-
 Documentation/git-cvsserver.txt                 | 2 +-
 Documentation/git-describe.txt                  | 4 ++--
 Documentation/git-format-patch.txt              | 2 +-
 Documentation/git-ls-tree.txt                   | 2 +-
 Documentation/git-mktag.txt                     | 2 +-
 Documentation/git-sparse-checkout.txt           | 2 +-
 Documentation/git-stash.txt                     | 2 +-
 Documentation/gitweb.txt                        | 2 +-
 Documentation/technical/remembering-renames.txt | 2 +-
 Documentation/urls-remotes.txt                  | 2 +-
 12 files changed, 13 insertions(+), 13 deletions(-)
Documentation/CodingGuidelines +1 -1
index 003393ed161..1f3290f1736 100644
@@ -687,7 +687,7 @@ Writing Documentation:
    Do: [-q | --quiet]
    Don't: [-q|--quiet]
 
- Don't use spacing around "|" tokens when they're used to seperate the
+ Don't use spacing around "|" tokens when they're used to separate the
  alternate arguments of an option:
     Do: --track[=(direct|inherit)]
     Don't: --track[=(direct | inherit)]
Documentation/config.txt +1 -1
index 0e93aef8626..229b63a454c 100644
@@ -182,7 +182,7 @@ included, Git breaks the cycle by prohibiting these files from affecting
 the resolution of these conditions (thus, prohibiting them from
 declaring remote URLs).
 +
-As for the naming of this keyword, it is for forwards compatibiliy with
+As for the naming of this keyword, it is for forwards compatibility with
 a naming scheme that supports more variable-based include conditions,
 but currently Git only supports the exact keyword described above.
 
Documentation/git-cvsserver.txt +1 -1
index 53f111bc0ac..cf4a5a283ec 100644
@@ -118,7 +118,7 @@ for example:
    myuser:$5$.NqmNH1vwfzGpV8B$znZIcumu1tNLATgV2l6e1/mY8RzhUDHMOaVOeL1cxV3
 ------
 You can use the 'htpasswd' facility that comes with Apache to make these
-files, but only with the -d option (or -B if your system suports it).
+files, but only with the -d option (or -B if your system supports it).
 
 Preferably use the system specific utility that manages password hash
 creation in your platform (e.g. mkpasswd in Linux, encrypt in OpenBSD or
Documentation/git-describe.txt +2 -2
index c6a79c2a0f2..08ff715709c 100644
@@ -140,7 +140,7 @@ at the end.
 
 The number of additional commits is the number
 of commits which would be displayed by "git log v1.0.4..parent".
-The hash suffix is "-g" + an unambigous abbreviation for the tip commit
+The hash suffix is "-g" + an unambiguous abbreviation for the tip commit
 of parent (which was `2414721b194453f058079d897d13c4e377f92dc6`). The
 length of the abbreviation scales as the repository grows, using the
 approximate number of objects in the repository and a bit of math
@@ -203,7 +203,7 @@ BUGS
 
 Tree objects as well as tag objects not pointing at commits, cannot be described.
 When describing blobs, the lightweight tags pointing at blobs are ignored,
-but the blob is still described as <committ-ish>:<path> despite the lightweight
+but the blob is still described as <commit-ish>:<path> despite the lightweight
 tag being favorable.
 
 GIT
Documentation/git-format-patch.txt +1 -1
index b1c13fb39a0..caaa71d30a8 100644
@@ -245,7 +245,7 @@ populated with placeholder text.
 	or "--reroll-count=4rev2" are allowed), but the downside of
 	using such a reroll-count is that the range-diff/interdiff
 	with the previous version does not state exactly which
-	version the new interation is compared against.
+	version the new interaction is compared against.
 
 --to=<email>::
 	Add a `To:` header to the email headers. This is in addition
Documentation/git-ls-tree.txt +1 -1
index 0240adb8eec..fa9a6b9f2cb 100644
@@ -145,7 +145,7 @@ FIELD NAMES
 -----------
 
 Various values from structured fields can be used to interpolate
-into the resulting output. For each outputing line, the following
+into the resulting output. For each outputting line, the following
 names can be used:
 
 objectmode::
Documentation/git-mktag.txt +1 -1
index 466a6975191..b2a2e80d421 100644
@@ -33,7 +33,7 @@ from warnings to errors (so e.g. a missing "tagger" line is an error).
 
 Extra headers in the object are also an error under mktag, but ignored
 by linkgit:git-fsck[1]. This extra check can be turned off by setting
-the appropriate `fsck.<msg-id>` varible:
+the appropriate `fsck.<msg-id>` variable:
 
     git -c fsck.extraHeaderEntry=ignore mktag <my-tag-with-headers
 
Documentation/git-sparse-checkout.txt +1 -1
index 53dc17aa77a..529a8edd9c1 100644
@@ -286,7 +286,7 @@ patterns in non-cone mode has a number of shortcomings:
     problem above?  Also, if it suggests paths, what if the user has a
     file or directory that begins with either a '!' or '#' or has a '*',
     '\', '?', '[', or ']' in its name?  And if it suggests paths, will
-    it complete "/pro" to "/proc" (in the root filesytem) rather than to
+    it complete "/pro" to "/proc" (in the root filesystem) rather than to
     "/progress.txt" in the current directory?  (Note that users are
     likely to want to start paths with a leading '/' in non-cone mode,
     for the same reason that .gitignore files often have one.)
Documentation/git-stash.txt +1 -1
index f4bb6114d91..06fb7f1d18c 100644
@@ -366,7 +366,7 @@ only the commit ends-up being in the stash and not on the current branch.
 # ... hack hack hack ...
 $ git add --patch foo           # add unrelated changes to the index
 $ git stash push --staged       # save these changes to the stash
-# ... hack hack hack, finish curent changes ...
+# ... hack hack hack, finish current changes ...
 $ git commit -m 'Massive'       # commit fully tested changes
 $ git switch fixup-branch       # switch to another branch
 $ git stash pop                 # to finish work on the saved changes
Documentation/gitweb.txt +1 -1
index 7cee9d36899..af6bf3c45ec 100644
@@ -503,7 +503,7 @@ repositories, you can configure Apache like this:
 
 The above configuration expects your public repositories to live under
 `/pub/git` and will serve them as `http://git.domain.org/dir-under-pub-git`,
-both as clonable Git URL and as browseable gitweb interface.  If you then
+both as clonable Git URL and as browsable gitweb interface.  If you then
 start your linkgit:git-daemon[1] with `--base-path=/pub/git --export-all`
 then you can even use the `git://` URL with exactly the same path.
 
Documentation/technical/remembering-renames.txt +1 -1
index 1e34d913901..73f41761e20 100644
@@ -664,7 +664,7 @@ skip-irrelevant-renames optimization means we sometimes don't detect
 renames for any files within a directory that was renamed, in which
 case we will not have been able to detect any rename for the directory
 itself.  In such a case, we do not know whether the directory was
-renamed; we want to be careful to avoid cacheing some kind of "this
+renamed; we want to be careful to avoid caching some kind of "this
 directory was not renamed" statement.  If we did, then a subsequent
 commit being rebased could add a file to the old directory, and the
 user would expect it to end up in the correct directory -- something
Documentation/urls-remotes.txt +1 -1
index e410912fe52..ae8c2db427b 100644
@@ -35,7 +35,7 @@ config file would appear like this:
 The `<pushurl>` is used for pushes only. It is optional and defaults
 to `<URL>`. Pushing to a remote affects all defined pushurls or to all
 defined urls if no pushurls are defined. Fetch, however, will only
-fetch from the first defined url if muliple urls are defined.
+fetch from the first defined url if multiple urls are defined.
 
 Named file in `$GIT_DIR/remotes`
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

base-commit: fe86abd7511a9a6862d5706c6fa1d9b57a63ba09

Signature · 1 line
gitgitgadget
#1 lore raw
Quoted 7 lines · Linus Arver via GitGitGadget

These were found with an automated CLI tool [1]. Only the "Documentation" subfolder (and not source code files) was considered because the docs are user-facing.

[1]: https://crates.io/crates/typos-cli

Quoted 13 lines
---
 Documentation/CodingGuidelines                  | 2 +-
 Documentation/config.txt                        | 2 +-
 Documentation/git-cvsserver.txt                 | 2 +-
 Documentation/git-describe.txt                  | 4 ++--
 Documentation/git-format-patch.txt              | 2 +-
 Documentation/git-ls-tree.txt                   | 2 +-
 Documentation/git-mktag.txt                     | 2 +-
 Documentation/git-sparse-checkout.txt           | 2 +-
 Documentation/git-stash.txt                     | 2 +-
 Documentation/gitweb.txt                        | 2 +-
 Documentation/technical/remembering-renames.txt | 2 +-
 Documentation/urls-remotes.txt                  | 2 +-

These changes all look sensible. Thanks.

#2 lore raw
Quoted 23 lines · Eric Sunshine
Quoted 7 lines · Linus Arver via GitGitGadget

These were found with an automated CLI tool [1]. Only the "Documentation" subfolder (and not source code files) was considered because the docs are user-facing.

[1]: https://crates.io/crates/typos-cli

Quoted 13 lines
---
  Documentation/CodingGuidelines                  | 2 +-
  Documentation/config.txt                        | 2 +-
  Documentation/git-cvsserver.txt                 | 2 +-
  Documentation/git-describe.txt                  | 4 ++--
  Documentation/git-format-patch.txt              | 2 +-
  Documentation/git-ls-tree.txt                   | 2 +-
  Documentation/git-mktag.txt                     | 2 +-
  Documentation/git-sparse-checkout.txt           | 2 +-
  Documentation/git-stash.txt                     | 2 +-
  Documentation/gitweb.txt                        | 2 +-
  Documentation/technical/remembering-renames.txt | 2 +-
  Documentation/urls-remotes.txt                  | 2 +-
Quoted 1 line

These changes all look sensible. Thanks.

Thanks for the review --- but on second inspection I messed up the fix to git-format-patch.txt. The tool suggested "interaction" which I followed mechanically, but I noticed just now that the real fix should have been "iteration". I have a v2 of this ready to got but GitGitGadget is delayed due to GitHub experiencing an issue at the moment, so expect some delay before the v2 gets pushed to the list.

#4 lore raw
Quoted 1 line · Kristoffer Haugsbakk

Hi

Hello, nice to meet you.

Quoted 6 lines · Linus Arver via GitGitGadget
Quoted 3 lines

From: Linus Arver <[email protected]>

These were found with an automated CLI tool [1]. [1]: https://crates.io/crates/typos-cli

Did you run a command or a script without any manual afterwork?

I simply ran the tool without any configuration, which just outputs a list of suggested fixes. There were many false positives, but not enough to make the manual examination of it too difficult.

Quoted 2 lines

If so,
do you know what that command invocation/script was?

FWIW the tool appears to be heavily customizable [1]. I considered exploring options to automate this some way (either as a script or maybe into the CI that runs as part of GitGitGadget submissions), but have not done so yet. I am currently more interested in reading the C sources in this project, so any immediate automation effort in this area will probably have to come from someone else on the list.

[1]: https://github.com/crate-ci/typos#false-positives

#5 lore raw

PATCH v2 1/1 docs: typofixes

In reply to Linus Arver via GitGitGadget

From: Linus Arver <[email protected]>

These were found with an automated CLI tool [1]. Only the "Documentation" subfolder (and not source code files) was considered because the docs are user-facing.

[1]: https://crates.io/crates/typos-cli

---
docs: typofixes

Changes from v1 to v2
=====================

The typo fix "interation" was wrongly corrected to "interaction" (as suggested by the tool). Instead this has been fixed to be "iteration" to match the surrounding context.

Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-1542%2Flistx%2Ftypofixes-v2
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-1542/listx/typofixes-v2
Pull-Request: https://github.com/gitgitgadget/git/pull/1542

Range-diff vs v1:

1: 99d9e137f09 ! 1: 037fac6a10e docs: typofixes
@@ Documentation/git-format-patch.txt: populated with placeholder text.
using such a reroll-count is that the range-diff/interdiff with the previous version does not state exactly which
- version the new interation is compared against.
-+ version the new interaction is compared against.
++ version the new iteration is compared against.

--to=<email>::
Add a To: header to the email headers. This is in addition

 Documentation/CodingGuidelines                  | 2 +-
 Documentation/config.txt                        | 2 +-
 Documentation/git-cvsserver.txt                 | 2 +-
 Documentation/git-describe.txt                  | 4 ++--
 Documentation/git-format-patch.txt              | 2 +-
 Documentation/git-ls-tree.txt                   | 2 +-
 Documentation/git-mktag.txt                     | 2 +-
 Documentation/git-sparse-checkout.txt           | 2 +-
 Documentation/git-stash.txt                     | 2 +-
 Documentation/gitweb.txt                        | 2 +-
 Documentation/technical/remembering-renames.txt | 2 +-
 Documentation/urls-remotes.txt                  | 2 +-
 12 files changed, 13 insertions(+), 13 deletions(-)
Documentation/CodingGuidelines +1 -1
index 003393ed161..1f3290f1736 100644
@@ -687,7 +687,7 @@ Writing Documentation:
    Do: [-q | --quiet]
    Don't: [-q|--quiet]
 
- Don't use spacing around "|" tokens when they're used to seperate the
+ Don't use spacing around "|" tokens when they're used to separate the
  alternate arguments of an option:
     Do: --track[=(direct|inherit)]
     Don't: --track[=(direct | inherit)]
Documentation/config.txt +1 -1
index 0e93aef8626..229b63a454c 100644
@@ -182,7 +182,7 @@ included, Git breaks the cycle by prohibiting these files from affecting
 the resolution of these conditions (thus, prohibiting them from
 declaring remote URLs).
 +
-As for the naming of this keyword, it is for forwards compatibiliy with
+As for the naming of this keyword, it is for forwards compatibility with
 a naming scheme that supports more variable-based include conditions,
 but currently Git only supports the exact keyword described above.
 
Documentation/git-cvsserver.txt +1 -1
index 53f111bc0ac..cf4a5a283ec 100644
@@ -118,7 +118,7 @@ for example:
    myuser:$5$.NqmNH1vwfzGpV8B$znZIcumu1tNLATgV2l6e1/mY8RzhUDHMOaVOeL1cxV3
 ------
 You can use the 'htpasswd' facility that comes with Apache to make these
-files, but only with the -d option (or -B if your system suports it).
+files, but only with the -d option (or -B if your system supports it).
 
 Preferably use the system specific utility that manages password hash
 creation in your platform (e.g. mkpasswd in Linux, encrypt in OpenBSD or
Documentation/git-describe.txt +2 -2
index c6a79c2a0f2..08ff715709c 100644
@@ -140,7 +140,7 @@ at the end.
 
 The number of additional commits is the number
 of commits which would be displayed by "git log v1.0.4..parent".
-The hash suffix is "-g" + an unambigous abbreviation for the tip commit
+The hash suffix is "-g" + an unambiguous abbreviation for the tip commit
 of parent (which was `2414721b194453f058079d897d13c4e377f92dc6`). The
 length of the abbreviation scales as the repository grows, using the
 approximate number of objects in the repository and a bit of math
@@ -203,7 +203,7 @@ BUGS
 
 Tree objects as well as tag objects not pointing at commits, cannot be described.
 When describing blobs, the lightweight tags pointing at blobs are ignored,
-but the blob is still described as <committ-ish>:<path> despite the lightweight
+but the blob is still described as <commit-ish>:<path> despite the lightweight
 tag being favorable.
 
 GIT
Documentation/git-format-patch.txt +1 -1
index b1c13fb39a0..373b46fc0de 100644
@@ -245,7 +245,7 @@ populated with placeholder text.
 	or "--reroll-count=4rev2" are allowed), but the downside of
 	using such a reroll-count is that the range-diff/interdiff
 	with the previous version does not state exactly which
-	version the new interation is compared against.
+	version the new iteration is compared against.
 
 --to=<email>::
 	Add a `To:` header to the email headers. This is in addition
Documentation/git-ls-tree.txt +1 -1
index 0240adb8eec..fa9a6b9f2cb 100644
@@ -145,7 +145,7 @@ FIELD NAMES
 -----------
 
 Various values from structured fields can be used to interpolate
-into the resulting output. For each outputing line, the following
+into the resulting output. For each outputting line, the following
 names can be used:
 
 objectmode::
Documentation/git-mktag.txt +1 -1
index 466a6975191..b2a2e80d421 100644
@@ -33,7 +33,7 @@ from warnings to errors (so e.g. a missing "tagger" line is an error).
 
 Extra headers in the object are also an error under mktag, but ignored
 by linkgit:git-fsck[1]. This extra check can be turned off by setting
-the appropriate `fsck.<msg-id>` varible:
+the appropriate `fsck.<msg-id>` variable:
 
     git -c fsck.extraHeaderEntry=ignore mktag <my-tag-with-headers
 
Documentation/git-sparse-checkout.txt +1 -1
index 53dc17aa77a..529a8edd9c1 100644
@@ -286,7 +286,7 @@ patterns in non-cone mode has a number of shortcomings:
     problem above?  Also, if it suggests paths, what if the user has a
     file or directory that begins with either a '!' or '#' or has a '*',
     '\', '?', '[', or ']' in its name?  And if it suggests paths, will
-    it complete "/pro" to "/proc" (in the root filesytem) rather than to
+    it complete "/pro" to "/proc" (in the root filesystem) rather than to
     "/progress.txt" in the current directory?  (Note that users are
     likely to want to start paths with a leading '/' in non-cone mode,
     for the same reason that .gitignore files often have one.)
Documentation/git-stash.txt +1 -1
index f4bb6114d91..06fb7f1d18c 100644
@@ -366,7 +366,7 @@ only the commit ends-up being in the stash and not on the current branch.
 # ... hack hack hack ...
 $ git add --patch foo           # add unrelated changes to the index
 $ git stash push --staged       # save these changes to the stash
-# ... hack hack hack, finish curent changes ...
+# ... hack hack hack, finish current changes ...
 $ git commit -m 'Massive'       # commit fully tested changes
 $ git switch fixup-branch       # switch to another branch
 $ git stash pop                 # to finish work on the saved changes
Documentation/gitweb.txt +1 -1
index 7cee9d36899..af6bf3c45ec 100644
@@ -503,7 +503,7 @@ repositories, you can configure Apache like this:
 
 The above configuration expects your public repositories to live under
 `/pub/git` and will serve them as `http://git.domain.org/dir-under-pub-git`,
-both as clonable Git URL and as browseable gitweb interface.  If you then
+both as clonable Git URL and as browsable gitweb interface.  If you then
 start your linkgit:git-daemon[1] with `--base-path=/pub/git --export-all`
 then you can even use the `git://` URL with exactly the same path.
 
Documentation/technical/remembering-renames.txt +1 -1
index 1e34d913901..73f41761e20 100644
@@ -664,7 +664,7 @@ skip-irrelevant-renames optimization means we sometimes don't detect
 renames for any files within a directory that was renamed, in which
 case we will not have been able to detect any rename for the directory
 itself.  In such a case, we do not know whether the directory was
-renamed; we want to be careful to avoid cacheing some kind of "this
+renamed; we want to be careful to avoid caching some kind of "this
 directory was not renamed" statement.  If we did, then a subsequent
 commit being rebased could add a file to the old directory, and the
 user would expect it to end up in the correct directory -- something
Documentation/urls-remotes.txt +1 -1
index e410912fe52..ae8c2db427b 100644
@@ -35,7 +35,7 @@ config file would appear like this:
 The `<pushurl>` is used for pushes only. It is optional and defaults
 to `<URL>`. Pushing to a remote affects all defined pushurls or to all
 defined urls if no pushurls are defined. Fetch, however, will only
-fetch from the first defined url if muliple urls are defined.
+fetch from the first defined url if multiple urls are defined.
 
 Named file in `$GIT_DIR/remotes`
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

base-commit: fe86abd7511a9a6862d5706c6fa1d9b57a63ba09

Signature · 1 line
gitgitgadget