From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS53758 23.128.96.0/24 X-Spam-Status: No, score=-3.6 required=3.0 tests=AWL,BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, SPF_HELO_PASS,SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by dcvr.yhbt.net (Postfix) with ESMTP id DF8751F5AE for ; Tue, 11 May 2021 10:43:35 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231335AbhEKKoi (ORCPT ); Tue, 11 May 2021 06:44:38 -0400 Received: from mx2.suse.de ([195.135.220.15]:36350 "EHLO mx2.suse.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231300AbhEKKoh (ORCPT ); Tue, 11 May 2021 06:44:37 -0400 X-Virus-Scanned: by amavisd-new at test-mx.suse.de Received: from relay2.suse.de (unknown [195.135.221.27]) by mx2.suse.de (Postfix) with ESMTP id B5ADDB03E; Tue, 11 May 2021 10:43:27 +0000 (UTC) Date: Tue, 11 May 2021 12:43:26 +0200 From: Michal =?iso-8859-1?Q?Such=E1nek?= To: Varun Varada Cc: Jeff King , git@vger.kernel.org Subject: Re: [PATCH] doc: replace jargon word "impact" with "effect"/"affect" Message-ID: <20210511104326.GJ12700@kitsune.suse.cz> References: <20210428085838.GN6564@kitsune.suse.cz> <20210428184956.GS6564@kitsune.suse.cz> <20210430075924.GB6564@kitsune.suse.cz> <20210510173502.GH12700@kitsune.suse.cz> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: User-Agent: Mutt/1.10.1 (2018-07-13) Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org On Mon, May 10, 2021 at 01:37:45PM -0500, Varun Varada wrote: > On Mon, 10 May 2021 at 12:35, Michal Suchánek wrote: > > > > On Mon, May 10, 2021 at 12:19:05PM -0500, Varun Varada wrote: > > > On Fri, 30 Apr 2021 at 02:59, Michal Suchánek wrote: > > > > > > > > On Thu, Apr 29, 2021 at 08:51:07PM -0500, Varun Varada wrote: > > > > > On Wed, 28 Apr 2021 at 13:49, Michal Suchánek wrote: > > > > > > > > > > > > On Wed, Apr 28, 2021 at 01:15:07PM -0500, Varun Varada wrote: > > > > > > > On Wed, 28 Apr 2021 at 03:58, Michal Suchánek wrote: > > > > > > > > > > > > > > > > On Tue, Apr 27, 2021 at 07:39:57PM -0500, Varun Varada wrote: > > > > > > > > > Here's the updated diff: > > > > > > > > > > > > > > > > As already said multiple general purpose dictionaries recognize '(have) > > > > > > > > strong effect' as the meaning of 'impact', in some cases even the most > > > > > > > > common meaning. > > > > > > > > > > > > > > There's no contention here. That's the meaning I've been referring to as well. > > > > > > > > > > > > > > > > > > > > > > > In case you have some issue with the word 'jargon' Merriam-Webster gives > > > > > > > > this definition: > > > > > > > > > > > > > > > > 1: the technical terminology or characteristic idiom of a special activity or group > > > > > > > > 2: obscure and often pretentious language marked by circumlocutions and long words > > > > > > > > 3a: confused unintelligible language > > > > > > > > b: a strange, outlandish, or barbarous language or dialect > > > > > > > > c: a hybrid language or dialect simplified in vocabulary and grammar and used for communication between peoples of different speech > > > > > > > > > > > > > > > > which the word 'impact' does not fulfill. > > > > > > > > > > > > > > > > Further, you would rarely discuss and document an effect that is > > > > > > > > negligible so in vast majority of cases '(have) strong effect' (ie > > > > > > > > 'impact') is synonymous to 'affect' and 'affect', respectively. > > > > > > > > > > > > > > This is not true, especially in technical contexts. "Affect" doesn't > > > > > > > mean "has a slight effect on", but simply "has an effect on". This > > > > > > > suffices in most cases. In cases where one would like to highlight the > > > > > > > overwhelming/awesome/debilitating/marked/strong effect that something > > > > > > > has, "impact" can be used. To say that every effect is overwhelming or > > > > > > > strong is jargon. > > > > > > > > > > > > > > > > > > > > > > > If you can pick out a few places where the use is specifically confusing > > > > > > > > then please pick out those. Wholesale replacement of one word with > > > > > > > > another synonym is not desired. It creates useless churn. > > > > > > > > > > > > > > I've actually not done a wholesale replacement blindly; the ones I > > > > > > > replaced are the places where I couldn't find any case where it is > > > > > > > referring to a "strong/marked effect". This is especially true in the > > > > > > > negative constructions. If you could help me find places where you > > > > > > > think the intended meaning is indeed "a strong/marked effect", I can > > > > > > > remove those from the changes. > > > > > > > > > > > > As already pointed out before the mere fact that the author of the text > > > > > > bothered to document the effect ipmlies that the effect is strong/marked > > > > > > unless stated otherwise. At any rate 'strong' is always relative. Unless > > > > > > you have a specific reference of average strenth anything can be > > > > > > considered strong or weak depending on point of view. > > > > > > > > > > This doesn't seem like a plausible or strong argument given the > > > > > context of the places where I'm editing the text. Most of them are > > > > > negative constructions, where if one were to assume "strongly affect" > > > > > > > > That's not the case. There are some which include negation, and many > > > > that don't. I did not review all of the patch so can't really tell but > > > > it looks like the onse that include negation are a minority or about > > > > half of what you replace at best. > > > > > > There are 27 changes, 16 of which are negation. That's more than half, > > > and at least all of these need to be replaced. > > > > > > > > > > > > was intended, then that raises the question of what actual effect it > > > > > will have. The only convincing example of this I can see is the one > > > > > where it reads "which are tight with memory might be badly impacted by > > > > > this though". All of the other ones seem like they're binary in > > > > > whether they will have an effect at all or no, not graduated in terms > > > > > of the degree of the effect it will have. > > > > > > > > Which also means that the distinction between 'strong effect' and > > > > 'effect' is meaningless, and 'affect' vs 'impact' is synonymous. > > > > Replacing one with the other is useless churn then. > > > > > > I'm not sure I understand what you mean by "churn". No one would stop > > > using Git because of these single-word changes. > > > > It refers to redundant changes to the codebase which do not improve it in > > any way. > > I see. These changes remove the confusion about what the words mean, > so they are not changes for the sake of changes. > > > > > > > > > As for there being no distinction, there's no gradation within the > > > semantics of this context; this doesn't change the semantics of the > > > words themselves. Using "impact" when what is meant is just "effect" > > > or "affect" is incorrect in all such instances. > > > > That's your opinion not shared by the authors of the text. > > Are you referring to part about it changing the semantics of the > words, or that it is incorrect to use them as such? Because neither of > those are opinion; I've already cited sources that attest to this, and > you've also agreed about the meaning of the words in question. > > > already agreed. This necessarily means it might affect it, albeit not > > > strongly. > > > > Or not at all. > > Sure. So, which is it? And how will the reader know which it is? This > is my point. There's absolutely no reason to have this confusion. > > Also, I'm getting the sense that you are one of the authors of the > text being changed; am I correct in presuming this? No, I am not. > > > > > The authority you refer to is MIT which is known for technical > > brilliance but not as authority on linguistics. > > I also cited the Oxford English Dictionary and the Modern Language > Association (MLA), arguably *the* authorities on the English language > that are prevalent and popular for their guidance on usage. The dictionaries define 'impact' as '(having) strong effect'. They do not define when it is appropriate to use the word 'impact'. With the tendency of at least some English speakers to use superlatives needlessly the use of 'impact' as synonym for affect/effect is not surprising. Also there is no single authority on the English language. The language is spoken in multiple distinct countries, and even within one country there is some variation. It also evolves over time. Since you can look up the meaning of the word in a general purpose dictionary it should be an acceptable use even if it's less commonly used in some other English-speaking parts of the world. > > > > > > > > > > > > > > Also the cases I saw do not really look confusing in any way so the > > > > change does not improve the documentation in any way. > > > > > > Saying "will not impact" means "will not strongly affect", as you've > > > > > > This is confusing to anyone reading the documentation, and > > > > When the distinction is not meaningful it is not really confusing in > > this use, either. > > > > > is entirely unnecessary. > > > > Also you did not limit your patch to these cases that you say are > > confusing. > > > > > I don't understand the resistance here for > > > simple one-word changes that remove this confusion. Am I missing > > > something? > > > > There does not seem to be any confusion to remove, at least you have not > > pointed out any specific case that is particularly confusing. > > I've pointed out that all of the negation examples are confusing > because they are ambiguous. They are not confusing in the way they are used. That is 'does not impact' in the maning 'has no or negligible effect', and especially in the cases where the degree of effect is not considered and only there being an effect or not is discussed there is no room for confusion. > > > > > If you do wholesale word replacement in the project for no good reason > > it only makes working with the project history harder. > > I'm not sure I understand the sentiment here. As in, the Git history > will be polluted? Because the "git blame" command will only show > changes for the lines where I changed the single words. Yes, it will be polluted. And since we have an opinion of another native English speaker that the use of 'impact' as synonym for affect/effect is fine this is clearly a matter of opinion. Also we have the opinion of the author of the text that such use is fine which is the most relevant unless solid evidence is provided that such use is indeed wrong and/or generally impedes understanding of the text. Clearly even a native speakers of a language can be sometimes confused by one word or another, and unless it is shown to be a general problem we would get into a back and forth replacing words with another synonym that somebody happens to find less confusing. An interesting case of this is when correctors that come from different places change a line back and forth because in the place where they come from one word (order) is more common and sounds more natural than the other. This topic somewhat interests me so I was continuing this discussion in the hope that you either provide a specific very confusing use of the word impact in the documentation that triggered creating this patch or some solid evidence that the general use of word 'impact' as synonym for affect/effect is in some way problematic but niether happened. I think this topic has been discussed sufficiently and there is nothing more to add. Thanks Michal > > And it reduces ambiguity in the command output, let alone the > documentation; it is not pointless. If it wasn't confusing enough for > a native English-speaking everyday user of Git, I wouldn't have taken > the time to read through all of the documentation about how to submit > patches to Git, followed all of the procedures, learned to work with > some new Git commands, and actually made the changes to get all the > way here just to make changes to the repository for the sake of it; I > promise. > > > > > Thanks > > > > Michal > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > You could make a case that 'impact' is significantly less frequent word > > > > > > > > compared to effect/affect and thus makes the text harder to understand > > > > > > > > for non-native speakers. However, that's not the point you brought up, > > > > > > > > and even then it is very weak point to make, especially without any > > > > > > > > actual source for the frequency data. You could also counter that all of > > > > > > > > these are common loanwords in many languages and are thus easy to > > > > > > > > understand to non-native speakers anyway. > > > > > > > > > > > > > > > > Thanks > > > > > > > > > > > > > > > > Michal > > > > > > > > > > > > > > > > > > Documentation/MyFirstContribution.txt | 2 +- > > > > > > > > > Documentation/MyFirstObjectWalk.txt | 2 +- > > > > > > > > > Documentation/config/pack.txt | 2 +- > > > > > > > > > Documentation/git-fast-import.txt | 14 +++++++------- > > > > > > > > > Documentation/git-fetch.txt | 2 +- > > > > > > > > > .../technical/hash-function-transition.txt | 2 +- > > > > > > > > > Documentation/user-manual.txt | 4 ++-- > > > > > > > > > advice.c | 2 +- > > > > > > > > > builtin/fast-import.c | 2 +- > > > > > > > > > builtin/pack-objects.c | 2 +- > > > > > > > > > contrib/coccinelle/README | 2 +- > > > > > > > > > dir.c | 2 +- > > > > > > > > > t/perf/p5550-fetch-tags.sh | 2 +- > > > > > > > > > t/t0008-ignores.sh | 2 +- > > > > > > > > > t/t0303-credential-external.sh | 2 +- > > > > > > > > > t/t2020-checkout-detach.sh | 4 ++-- > > > > > > > > > t/t4013-diff-various.sh | 2 +- > > > > > > > > > t/t5000-tar-tree.sh | 2 +- > > > > > > > > > t/test-lib-functions.sh | 2 +- > > > > > > > > > 19 files changed, 27 insertions(+), 27 deletions(-) > > > > > > > > > > > > > > > > > > diff --git a/Documentation/MyFirstContribution.txt > > > > > > > > > b/Documentation/MyFirstContribution.txt > > > > > > > > > index af0a9da62e..8372a7e59e 100644 > > > > > > > > > --- a/Documentation/MyFirstContribution.txt > > > > > > > > > +++ b/Documentation/MyFirstContribution.txt > > > > > > > > > @@ -592,7 +592,7 @@ Now that you have a usage hint, you can teach Git > > > > > > > > > how to show it in the general > > > > > > > > > command list shown by `git help git` or `git help -a`, which is generated from > > > > > > > > > `command-list.txt`. Find the line for 'git-pull' so you can add your 'git-psuh' > > > > > > > > > line above it in alphabetical order. Now, we can add some attributes about the > > > > > > > > > -command which impacts where it shows up in the aforementioned help > > > > > > > > > commands. The > > > > > > > > > +command which affects where it shows up in the aforementioned help > > > > > > > > > commands. The > > > > > > > > > top of `command-list.txt` shares some information about what each attribute > > > > > > > > > means; in those help pages, the commands are sorted according to these > > > > > > > > > attributes. `git psuh` is user-facing, or porcelain - so we will mark it as > > > > > > > > > diff --git a/Documentation/MyFirstObjectWalk.txt > > > > > > > > > b/Documentation/MyFirstObjectWalk.txt > > > > > > > > > index 2d10eea7a9..fd5bb8fb7d 100644 > > > > > > > > > --- a/Documentation/MyFirstObjectWalk.txt > > > > > > > > > +++ b/Documentation/MyFirstObjectWalk.txt > > > > > > > > > @@ -786,7 +786,7 @@ Count all the objects within and modify the print statement: > > > > > > > > > By running your walk with and without the filter, you should find > > > > > > > > > that the total > > > > > > > > > object count in each case is identical. You can also time each invocation of > > > > > > > > > the `walken` subcommand, with and without `omitted` being passed in, to confirm > > > > > > > > > -to yourself the runtime impact of tracking all omitted objects. > > > > > > > > > +to yourself the runtime effect of tracking all omitted objects. > > > > > > > > > > > > > > > > > > === Changing the Order > > > > > > > > > > > > > > > > > > diff --git a/Documentation/config/pack.txt b/Documentation/config/pack.txt > > > > > > > > > index 3da4ea98e2..00fcc9d7c7 100644 > > > > > > > > > --- a/Documentation/config/pack.txt > > > > > > > > > +++ b/Documentation/config/pack.txt > > > > > > > > > @@ -55,7 +55,7 @@ pack.deltaCacheSize:: > > > > > > > > > This cache is used to speed up the writing object phase by not > > > > > > > > > having to recompute the final delta result once the best match > > > > > > > > > for all objects is found. Repacking large repositories on machines > > > > > > > > > - which are tight with memory might be badly impacted by this though, > > > > > > > > > + which are tight with memory might be badly affected by this though, > > > > > > > > > especially if this cache pushes the system into swapping. > > > > > > > > > A value of 0 means no limit. The smallest size of 1 byte may be > > > > > > > > > used to virtually disable this cache. Defaults to 256 MiB. > > > > > > > > > diff --git a/Documentation/git-fast-import.txt > > > > > > > > > b/Documentation/git-fast-import.txt > > > > > > > > > index 39cfa05b28..c6d8e4e1d7 100644 > > > > > > > > > --- a/Documentation/git-fast-import.txt > > > > > > > > > +++ b/Documentation/git-fast-import.txt > > > > > > > > > @@ -58,7 +58,7 @@ OPTIONS > > > > > > > > > allowing fast-import to access the filesystem outside of the > > > > > > > > > repository). These options are disabled by default, but can be > > > > > > > > > allowed by providing this option on the command line. This > > > > > > > > > - currently impacts only the `export-marks`, `import-marks`, and > > > > > > > > > + currently affects only the `export-marks`, `import-marks`, and > > > > > > > > > `import-marks-if-exists` feature commands. > > > > > > > > > + > > > > > > > > > Only enable this option if you trust the program generating the > > > > > > > > > @@ -687,7 +687,7 @@ that contains SP the path must be quoted. > > > > > > > > > > > > > > > > > > A `filecopy` command takes effect immediately. Once the source > > > > > > > > > location has been copied to the destination any future commands > > > > > > > > > -applied to the source location will not impact the destination of > > > > > > > > > +applied to the source location will not affect the destination of > > > > > > > > > the copy. > > > > > > > > > > > > > > > > > > `filerename` > > > > > > > > > @@ -708,7 +708,7 @@ that contains SP the path must be quoted. > > > > > > > > > A `filerename` command takes effect immediately. Once the source > > > > > > > > > location has been renamed to the destination any future commands > > > > > > > > > applied to the source location will create new files there and not > > > > > > > > > -impact the destination of the rename. > > > > > > > > > +affect the destination of the rename. > > > > > > > > > > > > > > > > > > Note that a `filerename` is the same as a `filecopy` followed by a > > > > > > > > > `filedelete` of the source location. There is a slight performance > > > > > > > > > @@ -1010,7 +1010,7 @@ The `LF` after the command is optional (it used > > > > > > > > > to be required). > > > > > > > > > ~~~~~~~~~~ > > > > > > > > > Causes fast-import to print the entire `progress` line unmodified to > > > > > > > > > its standard output channel (file descriptor 1) when the command is > > > > > > > > > -processed from the input stream. The command otherwise has no impact > > > > > > > > > +processed from the input stream. The command otherwise has no effect > > > > > > > > > on the current import, or on any of fast-import's internal state. > > > > > > > > > > > > > > > > > > .... > > > > > > > > > @@ -1035,7 +1035,7 @@ can safely access the refs that fast-import updated. > > > > > > > > > ~~~~~~~~~~ > > > > > > > > > Causes fast-import to print the SHA-1 corresponding to a mark to > > > > > > > > > stdout or to the file descriptor previously arranged with the > > > > > > > > > -`--cat-blob-fd` argument. The command otherwise has no impact on the > > > > > > > > > +`--cat-blob-fd` argument. The command otherwise has no effect on the > > > > > > > > > current import; its purpose is to retrieve SHA-1s that later commits > > > > > > > > > might want to refer to in their commit messages. > > > > > > > > > > > > > > > > > > @@ -1050,7 +1050,7 @@ this output safely. > > > > > > > > > ~~~~~~~~~~ > > > > > > > > > Causes fast-import to print a blob to a file descriptor previously > > > > > > > > > arranged with the `--cat-blob-fd` argument. The command otherwise > > > > > > > > > -has no impact on the current import; its main purpose is to > > > > > > > > > +has no effect on the current import; its main purpose is to > > > > > > > > > retrieve blobs that may be in fast-import's memory but not > > > > > > > > > accessible from the target repository. > > > > > > > > > > > > > > > > > > @@ -1366,7 +1366,7 @@ code considerably. > > > > > > > > > > > > > > > > > > The branch LRU builtin to fast-import tends to behave very well, and the > > > > > > > > > cost of activating an inactive branch is so low that bouncing around > > > > > > > > > -between branches has virtually no impact on import performance. > > > > > > > > > +between branches has virtually no effect on import performance. > > > > > > > > > > > > > > > > > > Handling Renames > > > > > > > > > ~~~~~~~~~~~~~~~~ > > > > > > > > > diff --git a/Documentation/git-fetch.txt b/Documentation/git-fetch.txt > > > > > > > > > index 9067c2079e..01cf3b3d16 100644 > > > > > > > > > --- a/Documentation/git-fetch.txt > > > > > > > > > +++ b/Documentation/git-fetch.txt > > > > > > > > > @@ -113,7 +113,7 @@ on remotes that have themselves deleted those branches. > > > > > > > > > If left to accumulate, these stale references might make performance > > > > > > > > > worse on big and busy repos that have a lot of branch churn, and > > > > > > > > > e.g. make the output of commands like `git branch -a --contains > > > > > > > > > -` needlessly verbose, as well as impacting anything else > > > > > > > > > +` needlessly verbose, as well as affecting anything else > > > > > > > > > that'll work with the complete set of known references. > > > > > > > > > > > > > > > > > > These remote-tracking references can be deleted as a one-off with > > > > > > > > > diff --git a/Documentation/technical/hash-function-transition.txt > > > > > > > > > b/Documentation/technical/hash-function-transition.txt > > > > > > > > > index 7c1630bf83..f4296faffc 100644 > > > > > > > > > --- a/Documentation/technical/hash-function-transition.txt > > > > > > > > > +++ b/Documentation/technical/hash-function-transition.txt > > > > > > > > > @@ -42,7 +42,7 @@ mitigations. > > > > > > > > > > > > > > > > > > If SHA-1 and its variants were to be truly broken, Git's hash function > > > > > > > > > could not be considered cryptographically secure any more. This would > > > > > > > > > -impact the communication of hash values because we could not trust > > > > > > > > > +affect the communication of hash values because we could not trust > > > > > > > > > that a given hash value represented the known good version of content > > > > > > > > > that the speaker intended. > > > > > > > > > > > > > > > > > > diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt > > > > > > > > > index fd480b8645..33c60c49d7 100644 > > > > > > > > > --- a/Documentation/user-manual.txt > > > > > > > > > +++ b/Documentation/user-manual.txt > > > > > > > > > @@ -302,7 +302,7 @@ Note: checking out 'v2.6.17'. > > > > > > > > > > > > > > > > > > You are in 'detached HEAD' state. You can look around, make experimental > > > > > > > > > changes and commit them, and you can discard any commits you make in this > > > > > > > > > -state without impacting any branches by performing another switch. > > > > > > > > > +state without affecting any branches by performing another switch. > > > > > > > > > > > > > > > > > > If you want to create a new branch to retain commits you create, you may > > > > > > > > > do so (now or later) by using -c with the switch command again. Example: > > > > > > > > > @@ -1189,7 +1189,7 @@ their histories forked. The work tree is > > > > > > > > > overwritten by the result of > > > > > > > > > the merge when this combining is done cleanly, or overwritten by a > > > > > > > > > half-merged results when this combining results in conflicts. > > > > > > > > > Therefore, if you have uncommitted changes touching the same files as > > > > > > > > > -the ones impacted by the merge, Git will refuse to proceed. Most of > > > > > > > > > +the ones affected by the merge, Git will refuse to proceed. Most of > > > > > > > > > the time, you will want to commit your changes before you can merge, > > > > > > > > > and if you don't, then linkgit:git-stash[1] can take these changes > > > > > > > > > away while you're doing the merge, and reapply them afterwards. > > > > > > > > > diff --git a/advice.c b/advice.c > > > > > > > > > index 164742305f..9cbbb824a9 100644 > > > > > > > > > --- a/advice.c > > > > > > > > > +++ b/advice.c > > > > > > > > > @@ -291,7 +291,7 @@ void detach_advice(const char *new_name) > > > > > > > > > "\n" > > > > > > > > > "You are in 'detached HEAD' state. You can look around, make experimental\n" > > > > > > > > > "changes and commit them, and you can discard any commits you make in this\n" > > > > > > > > > - "state without impacting any branches by switching back to a branch.\n" > > > > > > > > > + "state without affecting any branches by switching back to a branch.\n" > > > > > > > > > "\n" > > > > > > > > > "If you want to create a new branch to retain commits you create, you may\n" > > > > > > > > > "do so (now or later) by using -c with the switch command. Example:\n" > > > > > > > > > diff --git a/builtin/fast-import.c b/builtin/fast-import.c > > > > > > > > > index 3afa81cf9a..24f362d2f4 100644 > > > > > > > > > --- a/builtin/fast-import.c > > > > > > > > > +++ b/builtin/fast-import.c > > > > > > > > > @@ -3530,7 +3530,7 @@ int cmd_fast_import(int argc, const char **argv, > > > > > > > > > const char *prefix) > > > > > > > > > * We don't parse most options until after we've seen the set of > > > > > > > > > * "feature" lines at the start of the stream (which allows the command > > > > > > > > > * line to override stream data). But we must do an early parse of any > > > > > > > > > - * command-line options that impact how we interpret the feature lines. > > > > > > > > > + * command-line options that affect how we interpret the feature lines. > > > > > > > > > */ > > > > > > > > > for (i = 1; i < argc; i++) { > > > > > > > > > const char *arg = argv[i]; > > > > > > > > > diff --git a/builtin/pack-objects.c b/builtin/pack-objects.c > > > > > > > > > index 525c2d8552..749bbca241 100644 > > > > > > > > > --- a/builtin/pack-objects.c > > > > > > > > > +++ b/builtin/pack-objects.c > > > > > > > > > @@ -2042,7 +2042,7 @@ static void break_delta_chains(struct object_entry *entry) > > > > > > > > > /* > > > > > > > > > * Mark ourselves as active and see if the next step causes > > > > > > > > > * us to cycle to another active object. It's important to do > > > > > > > > > - * this _before_ we loop, because it impacts where we make the > > > > > > > > > + * this _before_ we loop, because it affects where we make the > > > > > > > > > * cut, and thus how our total_depth counter works. > > > > > > > > > * E.g., We may see a partial loop like: > > > > > > > > > * > > > > > > > > > diff --git a/contrib/coccinelle/README b/contrib/coccinelle/README > > > > > > > > > index f0e80bd7f0..92979ec770 100644 > > > > > > > > > --- a/contrib/coccinelle/README > > > > > > > > > +++ b/contrib/coccinelle/README > > > > > > > > > @@ -40,4 +40,4 @@ There are two types of semantic patches: > > > > > > > > > are ignored for checks, and can be applied using 'make coccicheck-pending'. > > > > > > > > > > > > > > > > > > This allows to expose plans of pending large scale refactorings without > > > > > > > > > - impacting the bad pattern checks. > > > > > > > > > + affecting the bad pattern checks. > > > > > > > > > diff --git a/dir.c b/dir.c > > > > > > > > > index 3474e67e8f..235e26a90e 100644 > > > > > > > > > --- a/dir.c > > > > > > > > > +++ b/dir.c > > > > > > > > > @@ -2144,7 +2144,7 @@ static enum path_treatment > > > > > > > > > treat_path_fast(struct dir_struct *dir, > > > > > > > > > /* > > > > > > > > > * We get path_recurse in the first run when > > > > > > > > > * directory_exists_in_index() returns index_nonexistent. We > > > > > > > > > - * are sure that new changes in the index does not impact the > > > > > > > > > + * are sure that new changes in the index does not affect the > > > > > > > > > * outcome. Return now. > > > > > > > > > */ > > > > > > > > > return path_recurse; > > > > > > > > > diff --git a/t/perf/p5550-fetch-tags.sh b/t/perf/p5550-fetch-tags.sh > > > > > > > > > index d0e0e019ea..1fcb98443c 100755 > > > > > > > > > --- a/t/perf/p5550-fetch-tags.sh > > > > > > > > > +++ b/t/perf/p5550-fetch-tags.sh > > > > > > > > > @@ -8,7 +8,7 @@ follows. > > > > > > > > > > > > > > > > > > The parent repository has a large number of tags which are disconnected from > > > > > > > > > the rest of history. That makes them candidates for tag-following, but we never > > > > > > > > > -actually grab them (and thus they will impact each subsequent fetch). > > > > > > > > > +actually grab them (and thus they will affect each subsequent fetch). > > > > > > > > > > > > > > > > > > The child repository is a clone of parent, without the tags, and is at least > > > > > > > > > one commit behind the parent (meaning that we will fetch one object and then > > > > > > > > > diff --git a/t/t0008-ignores.sh b/t/t0008-ignores.sh > > > > > > > > > index a594b4aa7d..95daba4000 100755 > > > > > > > > > --- a/t/t0008-ignores.sh > > > > > > > > > +++ b/t/t0008-ignores.sh > > > > > > > > > @@ -315,7 +315,7 @@ test_expect_success_multi 'needs work tree' '' ' > > > > > > > > > # test standard ignores > > > > > > > > > > > > > > > > > > # First make sure that the presence of a file in the working tree > > > > > > > > > -# does not impact results, but that the presence of a file in the > > > > > > > > > +# does not affect results, but that the presence of a file in the > > > > > > > > > # index does unless the --no-index option is used. > > > > > > > > > > > > > > > > > > for subdir in '' 'a/' > > > > > > > > > diff --git a/t/t0303-credential-external.sh b/t/t0303-credential-external.sh > > > > > > > > > index f028fd1418..a9348f655a 100755 > > > > > > > > > --- a/t/t0303-credential-external.sh > > > > > > > > > +++ b/t/t0303-credential-external.sh > > > > > > > > > @@ -41,7 +41,7 @@ test -z "$GIT_TEST_CREDENTIAL_HELPER_SETUP" || > > > > > > > > > eval "$GIT_TEST_CREDENTIAL_HELPER_SETUP" > > > > > > > > > > > > > > > > > > # clean before the test in case there is cruft left > > > > > > > > > -# over from a previous run that would impact results > > > > > > > > > +# over from a previous run that would affect results > > > > > > > > > helper_test_clean "$GIT_TEST_CREDENTIAL_HELPER" > > > > > > > > > > > > > > > > > > helper_test "$GIT_TEST_CREDENTIAL_HELPER" > > > > > > > > > diff --git a/t/t2020-checkout-detach.sh b/t/t2020-checkout-detach.sh > > > > > > > > > index bc46713a43..568c258c5a 100755 > > > > > > > > > --- a/t/t2020-checkout-detach.sh > > > > > > > > > +++ b/t/t2020-checkout-detach.sh > > > > > > > > > @@ -202,7 +202,7 @@ test_expect_success 'describe_detached_head prints > > > > > > > > > no SHA-1 ellipsis when not as > > > > > > > > > > > > > > > > > > You are in 'detached HEAD' state. You can look around, make experimental > > > > > > > > > changes and commit them, and you can discard any commits you make in this > > > > > > > > > - state without impacting any branches by switching back to a branch. > > > > > > > > > + state without affecting any branches by switching back to a branch. > > > > > > > > > > > > > > > > > > If you want to create a new branch to retain commits you create, you may > > > > > > > > > do so (now or later) by using -c with the switch command. Example: > > > > > > > > > @@ -284,7 +284,7 @@ test_expect_success 'describe_detached_head does > > > > > > > > > print SHA-1 ellipsis when asked > > > > > > > > > > > > > > > > > > You are in 'detached HEAD' state. You can look around, make experimental > > > > > > > > > changes and commit them, and you can discard any commits you make in this > > > > > > > > > - state without impacting any branches by switching back to a branch. > > > > > > > > > + state without affecting any branches by switching back to a branch. > > > > > > > > > > > > > > > > > > If you want to create a new branch to retain commits you create, you may > > > > > > > > > do so (now or later) by using -c with the switch command. Example: > > > > > > > > > diff --git a/t/t4013-diff-various.sh b/t/t4013-diff-various.sh > > > > > > > > > index 6cca8b84a6..97365a7786 100755 > > > > > > > > > --- a/t/t4013-diff-various.sh > > > > > > > > > +++ b/t/t4013-diff-various.sh > > > > > > > > > @@ -109,7 +109,7 @@ test_expect_success setup ' > > > > > > > > > git checkout -f master && > > > > > > > > > > > > > > > > > > # Same merge as master, but with parents reversed. Hide it in a > > > > > > > > > - # pseudo-ref to avoid impacting tests with --all. > > > > > > > > > + # pseudo-ref to avoid affecting tests with --all. > > > > > > > > > commit=$(echo reverse | > > > > > > > > > git commit-tree -p master^2 -p master^1 master^{tree}) && > > > > > > > > > git update-ref REVERSE $commit && > > > > > > > > > diff --git a/t/t5000-tar-tree.sh b/t/t5000-tar-tree.sh > > > > > > > > > index 7204799a0b..33a6efce2f 100755 > > > > > > > > > --- a/t/t5000-tar-tree.sh > > > > > > > > > +++ b/t/t5000-tar-tree.sh > > > > > > > > > @@ -379,7 +379,7 @@ test_expect_success 'catch non-matching pathspec' ' > > > > > > > > > # Pull the size and date of each entry in a tarfile using the system tar. > > > > > > > > > # > > > > > > > > > # We'll pull out only the year from the date; that avoids any question of > > > > > > > > > -# timezones impacting the result (as long as we keep our test times away from a > > > > > > > > > +# timezones affecting the result (as long as we keep our test times away from a > > > > > > > > > # year boundary; our reference times are all in August). > > > > > > > > > # > > > > > > > > > # The output of tar_info is expected to be " ", both in decimal. It > > > > > > > > > diff --git a/t/test-lib-functions.sh b/t/test-lib-functions.sh > > > > > > > > > index 6348e8d733..ff65f86f50 100644 > > > > > > > > > --- a/t/test-lib-functions.sh > > > > > > > > > +++ b/t/test-lib-functions.sh > > > > > > > > > @@ -1379,7 +1379,7 @@ mingw_read_file_strip_cr_ () { > > > > > > > > > } > > > > > > > > > > > > > > > > > > # Like "env FOO=BAR some-program", but run inside a subshell, which means > > > > > > > > > -# it also works for shell functions (though those functions cannot impact > > > > > > > > > +# it also works for shell functions (though those functions cannot affect > > > > > > > > > # the environment outside of the test_env invocation). > > > > > > > > > test_env () { > > > > > > > > > ( > > > > > > > > > -- > > > > > > > > > 2.17.1 > > > > > > > > > > > > > > > > > > On Tue, 6 Apr 2021 at 19:06, Varun Varada wrote: > > > > > > > > > > > > > > > > > > > > On Tue, 6 Apr 2021 at 18:01, Jeff King wrote: > > > > > > > > > > > > > > > > > > > > > > On Tue, Apr 06, 2021 at 02:36:27PM -0500, Varun Varada wrote: > > > > > > > > > > > > > > > > > > > > > > > > while using "will not impact" in an incorrect or unclear way may be a > > > > > > > > > > > > > problem the word "impact" in itself is not "jargon". > > > > > > > > > > > > > > > > > > > > > > > > The word means "to have a strong or marked effect on" (v.) and "a > > > > > > > > > > > > strong or market influence" (n.) when used figuratively; it is not > > > > > > > > > > > > synonymous with "affect" and "effect", respectively, as shown even by > > > > > > > > > > > > all of the entries you've cited. Using it as such is the incorrect > > > > > > > > > > > > part, so those are the instances I've changed in the diff. > > > > > > > > > > > > > > > > > > > > > > Er, is that true? From Michal's definitions: > > > > > > > > > > > > > > > > > > > > > > > > From The Collaborative International Dictionary of English v.0.48 : > > > > > > > > > > > > [...] > > > > > > > > > > > > > 2. To affect or influence, especially in a significant or > > > > > > > > > > > > > > > > > > > > > > It literally uses "affect" to define it. The "especially significant" > > > > > > > > > > > does not apply to many, but I don't think that makes it necessarily > > > > > > > > > > > wrong to use impact to mean "affect". > > > > > > > > > > > > > > > > > > > > I was drawing attention to the "especially significant" bit and the > > > > > > > > > > like being there in all the entries. I'm not sure about these > > > > > > > > > > dictionaries, but the definition is hyperbolic / violent / shocking in > > > > > > > > > > every reputable dictionary out there: the Oxford English Dictionary, > > > > > > > > > > Merriam-Webster, and Collins. > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > Likewise: > > > > > > > > > > > > > > > > > > > > > > > > From WordNet (r) 3.0 (2006) : > > > > > > > > > > > > [...] > > > > > > > > > > > > > v 1: press or wedge together; pack together > > > > > > > > > > > > > 2: have an effect upon; "Will the new rules affect me?" [syn: > > > > > > > > > > > > > affect, impact, bear upon, bear on, touch on, > > > > > > > > > > > > > touch] > > > > > > > > > > > > > > > > > > > > > > That is likewise listing "impact" and "affect" as synonyms. > > > > > > > > > > > > > > > > > > > > > > I do agree the word is over-used in some forms of writing, but I don't > > > > > > > > > > > find anything at all confusing or wrong about the uses that you changed > > > > > > > > > > > in your patch. I am a native speaker of English. I'm open to the > > > > > > > > > > > argument that non-native speakers may be more confused by the word. But > > > > > > > > > > > this seems like mostly a style preference thing, and I'd generally > > > > > > > > > > > prefer to leave the contributions and style of the original writers > > > > > > > > > > > intact unless there is a good reason not to. > > > > > > > > > > > > > > > > > > > > I am a native English speaker as well, and there were multiple places > > > > > > > > > > where I had to think twice about what the sentences mean. I agree with > > > > > > > > > > your sentiment about leaving stylistic preferences intact, but this is > > > > > > > > > > actually a semantic one. And given that there is a perfectly good > > > > > > > > > > alternative that doesn't have this confusion / jargon status, I wanted > > > > > > > > > > to make the change to improve it, especially where it says that in the > > > > > > > > > > output of the git command (`git checkout` when in detached HEAD mode). > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > Such changes are doubly unwanted in cases like this: > > > > > > > > > > > > > > > > > > > > > > > --- a/compat/nedmalloc/malloc.c.h > > > > > > > > > > > > +++ b/compat/nedmalloc/malloc.c.h > > > > > > > > > > > > @@ -2952,7 +2952,7 @@ static size_t traverse_and_check(mstate m); > > > > > > > > > > > > #endif /* (FOOTERS && !INSECURE) */ > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > -/* In gcc, use __builtin_expect to minimize impact of checks */ > > > > > > > > > > > > +/* In gcc, use __builtin_expect to minimize affect of checks */ > > > > > > > > > > > > #if !INSECURE > > > > > > > > > > > > #if defined(__GNUC__) && __GNUC__ >= 3 > > > > > > > > > > > > #define RTCHECK(e) __builtin_expect(e, 1) > > > > > > > > > > > > > > > > > > > > > > where the text is imported from another project, and we'd prefer to stay > > > > > > > > > > > as close to their version as possible (e.g., to avoid unnecessary > > > > > > > > > > > conflicts when pulling in new versions). > > > > > > > > > > > > > > > > > > > > That's fair; I wasn't aware that this was being pulled directly from > > > > > > > > > > another project. I can change this back. > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > Also, this one should be "effect" anyway, as it is a noun. > > > > > > > > > > > > > > > > > > > > This seems to have slipped through, as I used a text search tool. > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > -Peff >