Skip to content

Conversation

@bobtista
Copy link

Fix spelling errors in code comments.

@greptile-apps
Copy link

greptile-apps bot commented Jan 18, 2026

Greptile Summary

This PR corrects spelling errors in code comments across 69 files in the GeneralsMD/Code/GameEngine directory. All changes are documentation-only and do not affect code logic or functionality.

Key corrections made:

  • Fixed common misspellings: extentionextension (18 occurrences in AIDock.cpp), heighheight, dumdump, wontwon't, thisethose
  • Corrected technical terms: implemtationimplementation, propogatedpropagated, heirarchyhierarchy
  • Fixed grammar: neversnever, carraigecarriage, theresthere
  • Improved clarity: debuggindebugging, widnowwindow, compairedcompared

The corrections span across include headers, source files for AI systems, game logic, GUI components, and object behaviors. All 138 line changes are purely cosmetic improvements to comment readability.

Confidence Score: 5/5

  • This PR is completely safe to merge with zero risk
  • All changes are exclusively to code comments with no modifications to executable code, logic, or functionality. Spelling corrections improve documentation quality without any possibility of introducing bugs or runtime issues.
  • No files require special attention

Important Files Changed

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
Loading

Copy link

@greptile-apps greptile-apps bot left a 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

Edit Code Review Agent Settings | Greptile


/// 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.

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.

Copy link
Author

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? :)

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.

@xezon xezon added the Documentation Is documentation or complementary resource label Jan 19, 2026
@xezon
Copy link

xezon commented Jan 19, 2026

It looks like not all Stubbjax comments are addressed.

@bobtista bobtista force-pushed the fix/typos-generalsmd-engine branch from 0be45b4 to 64fc1d0 Compare January 19, 2026 22:07
@bobtista
Copy link
Author

It looks like not all Stubbjax comments are addressed.

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

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'.

@xezon
Copy link

xezon commented Jan 20, 2026

@Stubbjax happy with this?

@xezon xezon requested review from Skyaero42, Stubbjax and xezon January 21, 2026 07:29
@Stubbjax
Copy link

@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

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

Copy link
Author

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.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

throughout

Copy link
Author

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

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

falloff

Copy link
Author

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

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

resets

Copy link
Author

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

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

assigned

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed in 2145

Copy link

@Skyaero42 Skyaero42 left a 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.

@xezon
Copy link

xezon commented Jan 21, 2026

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.

@Stubbjax
Copy link

I also have the impression that the spelling error fix effort is very incomplete.

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.

It would have been great if we just make one fixing pass and everything is done. This is currently the second pass.

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.

@xezon
Copy link

xezon commented Jan 21, 2026

Ok that is fair. I agree the smaller reviews help the GitHub process, because of its limitations.

@xezon xezon requested a review from Skyaero42 January 22, 2026 14:55
Copy link

@Skyaero42 Skyaero42 left a 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.

@xezon
Copy link

xezon commented Jan 22, 2026

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.

bobtista and others added 17 commits January 22, 2026 15:28
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>
@bobtista bobtista force-pushed the fix/typos-generalsmd-engine branch from c7aa065 to e66f7ba Compare January 22, 2026 21:29
@bobtista
Copy link
Author

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.

If we squash or rebase main the changes are right

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Is documentation or complementary resource

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants