ok, add ay // comments to the core replacing the // with a ;
maybe even remove them if they are useless.
I'd like to see an example, but what do you do with weapons used by more than 1 unit?
personally, in R:ROTC, i deleted the comments(i actually moved the large comment block to a different file, but i lost it 3 formats ago.) and sectioned everything up.
theres the top crap and lists part at the top, where vehicle and infantry lists are sorted by side, extras, unbuildables(to fix the 100 units bug), then just before the Infantry section, theres my "New units and buildings" section, which is sorted by Infantry (Misc, Allied, Soviet, Yuri, CDA, Cross, Mode), then vehicles in same order, and buildings after that, where each new weapon is listed under the first unit/building to use it, (You might find units pointing to weapons listed near the end of the file, or under another unit, aswell as weapons pointing to warheads or projectiles that are somewhere else) after that is the "existing infantry, units, buildings and weapons" section. some stuff that i've modified, such as base defences have had weapons pulled upto the defence, and some modified units have even been moved to my new section, such as the engineers, and the yuri hero.
in any case, the search function is still used a lot, but just about all units used in my mod, i can remember where abouts in the file they are, aswell as what header they use.