-
Notifications
You must be signed in to change notification settings - Fork 1.4k
Rename Compile to Compiling to fix tense #1877
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
ac5b0da
to
b56de66
Compare
b56de66
to
ea54cbc
Compare
I don't think we want to change this. It is consistent with Xcode's log reporting as well. |
But it’s inconsistent in tense to the « Linking » tool and to Ninja’s « Building » messages. |
Maybe we should rename Linking.. to Link.. then? |
Makes less sense to me, but I'll bow down to whatever decision is taken. |
I don't remember the exact reason for this wording but maybe @ddunbar does? |
We definitely should be consistent. I think Xcode's log may be different, because it is usually viewed after the fact, so its not actually compiling any more. The running status in the console is more often viewed as a status of the progress, but not a persistent artifact in a log (even though it does appear as both). I'd probably use "Compiling", but don't have a strong opinion other than that we should be consistent. |
ok, then I am also fine with anything. |
I definitely agree that we should be consistent, whichever wording is chosen. I'd give a slight nod toward the existing 'compile' phrasing, giving a +1 to Ankit's comment about changing 'Linking' to 'Link'. When stated as 'compiling' it feels like it should be followed by a 'done' statement somewhere, which is complexity that I am not sure is really necessary. |
I originally went with Compiling because:
|
As usual, consistency trumps everything, but I lean slightly towards the "summary of action" phrasing that we currently use in Xcode, for example "Compile Foo.c", "Link Bar". Status in a progress bar can be reported separately of the phrasing of the action itself. For example, I've seen build tools use Unicode symbols to indicate this in a rather nice way (I might not have picked the right characters that have metrics consistent to each other in whatever font they'll show up with, but you get the point):
Otherwise, I think you have to argue that the phrasing itself should change depending on how the log is being viewed. If "Compiling Foo.c" shows up in a log after the build has finished, it reads awkwardly. Similarly, "Compiled Foo.c" doesn't work for an in-progress build. Logs won't always be displayed in an environment where their content can be dynamically updated (like the Xcode build log or Ninja progress thingy) -- they have to be committed to static files eventually. "Compile Foo.c" is more grammatically neutral, and can read well in past, present, and future tenses. |
Let's take this change. |
@swift-ci smoke test |
This only applies to Clang targets. Swift targets will be fixed in llbuild separately, but the tests have been modified in preperation.