-
Notifications
You must be signed in to change notification settings - Fork 151
docs: Fix spelling errors in GeneralsMD/Code/GameEngine comments #2146
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
base: main
Are you sure you want to change the base?
docs: Fix spelling errors in GeneralsMD/Code/GameEngine comments #2146
Conversation
|
| Filename | Overview |
|---|---|
| GeneralsMD/Code/GameEngine/Include/GameClient/GameWindow.h | Fixed 7 spelling errors in comments: propagated, additional, system, hierarchy, point, child, parameter, regardless |
| GeneralsMD/Code/GameEngine/Source/GameLogic/AI/AIDock.cpp | Fixed repeated spelling error 'extention' to 'extension' in 18 comments throughout docking behavior states |
| GeneralsMD/Code/GameEngine/Source/GameLogic/Object/Object.cpp | Fixed 10 spelling errors: definitely, never (2x), implementation (2x), those, and grammatical corrections |
| GeneralsMD/Code/GameEngine/Source/GameClient/GUI/GameWindowManager.cpp | Fixed 7 spelling errors: status, propagate, debugging, window, compared, initialize (2x), lengths |
| GeneralsMD/Code/GameEngine/Source/GameLogic/Object/Update/AIUpdate/RailroadGuideAIUpdate.cpp | Fixed 6 spelling errors: won't, building, resetting, carriage (3x), there |
Sequence Diagram
sequenceDiagram
participant Dev as Developer
participant Tool as Spell Checker
participant Code as Codebase
Dev->>Tool: Run spelling check on comments
Tool->>Code: Scan 69 files in GeneralsMD/Code/GameEngine
Code-->>Tool: Return misspellings found
Note over Tool: Common errors identified:<br/>extention→extension (18x)<br/>heigh→height<br/>dum→dump<br/>wont→won't<br/>thise→those
Tool->>Code: Apply corrections to comments only
Code-->>Dev: 138 lines corrected
Note over Code: No functional changes<br/>Comments only<br/>Safe to merge
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
105 files reviewed, 1 comment
Generals/Code/GameEngine/Source/GameClient/GUI/ControlBar/ControlBarCommand.cpp
Outdated
Show resolved
Hide resolved
Generals/Code/GameEngine/Source/GameClient/GUI/ControlBar/ControlBarCommand.cpp
Show resolved
Hide resolved
GeneralsMD/Code/GameEngine/Source/GameClient/GUI/GUICallbacks/Menus/KeyboardOptionsMenu.cpp
Outdated
Show resolved
Hide resolved
GeneralsMD/Code/GameEngine/Source/GameClient/GUI/GUICallbacks/Menus/KeyboardOptionsMenu.cpp
Outdated
Show resolved
Hide resolved
GeneralsMD/Code/GameEngine/Source/GameLogic/Object/Behavior/BunkerBusterBehavior.cpp
Outdated
Show resolved
Hide resolved
|
|
||
| /// A convenience function to reveal shroud at some location | ||
| // Queueing does not give you control of the timestamp to enforce the queue. I own the delay, you don't. | ||
| // Queuing does not give you control of the timestamp to enforce the queue. I own the delay, you don't. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Both spellings are technically correct.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Whichever doesn't make Xezon's IDE complain then? :)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Although not exclusively, queuing aligns more to American English, while queueing is used more in British English.
We use American English as that was the language that EA used. So I would say this change is correct.
GeneralsMD/Code/GameEngine/Source/GameLogic/Object/SpecialPower/SpecialPowerModule.cpp
Outdated
Show resolved
Hide resolved
|
It looks like not all Stubbjax comments are addressed. |
0be45b4 to
64fc1d0
Compare
addressed and rebased main |
| // | ||
| // since we're assuming all inventory exit commands appear in a continuous order, | ||
| // we need to also need to keep track of what is the last valid inventory commadn index | ||
| // we need to also need to keep track of what is the last valid inventory command index |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remove duplicate instance of 'need to'.
|
@Stubbjax happy with this? |
There are still a few unresolved comments. |
| AsciiString m_decayName; ///< This is the filename that should be used during the decay. | ||
|
|
||
| AudioPriority m_priority; ///< This should be the priority as given by the event info, or the overrided priority. | ||
| Real m_volume; ///< This is the override for the volume. It will either be the normal |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"It will either be the normal" is an unfinished sentence
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fixed in 2147 (core)
|
|
||
| /** | ||
| * LANGameInfo class - maintains information about the LAN game and | ||
| * the contents of its slot list hroughout the game. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
throughout
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
fixed in 2147 (core)
| virtual void enableWaterGrid( Bool enable ); | ||
| /// set min/max height values allowed in water grid pointed to by waterTable | ||
| virtual void setWaterGridHeightClamps( const WaterHandle *waterTable, Real minZ, Real maxZ ); | ||
| /// adjust fallof parameters for grid change method |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
falloff
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
fixed in 2147 (Core)
| StatsCollector( void ); | ||
| ~StatsCollector( void ); | ||
|
|
||
| void reset( void ); ///< Reset's all values and writes the file header |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
resets
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
fixed in 2145 (Generals)
|
|
||
| UnsignedInt m_startTimestamp; ///< timestamp when this particle system was (re)started | ||
| UnsignedInt m_systemLifetimeLeft; ///< lifetime remaining for entire particle system | ||
| UnsignedInt m_personalityStore; ///< increments each time it is aggigned to each new particle |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
assigned
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
fixed in 2145
Skyaero42
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I only checked a few files before/after existing changes and I'm finding a lot more spelling issues.
Recommend using AI checking each file and pointing out spelling errors in comments.
|
I also have the impression that the spelling error fix effort is very incomplete. Where ever I look in Source Code, there are a ton of spelling errors. It would be interesting to know how you verify completeness and correctness of fixes. Some spelling error fixes are also choosing the wrong word, implying a not too rigerous approach to this. It would have been great if we just make one fixing pass and everything is done. This is currently the second pass. |
I think these PRs are meant to incrementally cover some common misspellings and not fix everything in one go to make things manageable. There are infinitely more spelling / grammatical issues than just the ones made visible here.
That would take a long time to review. The problem is there are too many inconsistencies - not just in the code base, but in English itself - and likely no amount of automation is going to completely cover everything. |
|
Ok that is fair. I agree the smaller reviews help the GitHub process, because of its limitations. |
Skyaero42
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Agreeing with the several passes.
|
I do not understand the splitting of this change. The title claims one thing, but the actual changes files are in all sorts of unrelated folders that do correspond to what the title says. |
Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
…rolBarCommand.cpp Co-authored-by: Stubbjax <stubbjax02@hotmail.com>
…er.cpp Co-authored-by: Stubbjax <stubbjax02@hotmail.com>
…rolBarCommand.cpp Co-authored-by: Stubbjax <stubbjax02@hotmail.com>
Co-authored-by: Stubbjax <stubbjax02@hotmail.com>
…Menus/KeyboardOptionsMenu.cpp Co-authored-by: Stubbjax <stubbjax02@hotmail.com>
Co-authored-by: Stubbjax <stubbjax02@hotmail.com>
…Menus/KeyboardOptionsMenu.cpp Co-authored-by: Stubbjax <stubbjax02@hotmail.com>
…nkerBusterBehavior.cpp Co-authored-by: Stubbjax <stubbjax02@hotmail.com>
Co-authored-by: Stubbjax <stubbjax02@hotmail.com>
c7aa065 to
e66f7ba
Compare
If we squash or rebase main the changes are right |
Fix spelling errors in code comments.