Bug 5000 - REFACTORING FANCLUB
Status: NEW
Alias: None
Product: Tremulous
Classification: Unclassified
Component: Misc
Version: SVN HEAD
Hardware: All All
: P5 enhancement
Assignee: Tim Angus
QA Contact: Tremulous Bugs
URL: https://bugzilla.icculus.org/show_bug...
Depends on:
Blocks: 5005 5040 5089 5158
 
Reported: 2011-05-23 20:23 EDT by /dev/humancontroller
Modified: 2012-07-12 21:18:58 EDT
2 users (show)

See Also:


Attachments
a refactoring package (2011-05-25) (27.61 KB, patch)
2011-05-23 20:25 EDT, /dev/humancontroller
refactor some bg_misc.c comments (69.42 KB, patch)
2011-05-25 17:46 EDT, /dev/humancontroller
a refactoring package (2011-06-14) (8.52 KB, patch)
2011-06-14 04:49 EDT, /dev/humancontroller
refactoring is a life (13.74 KB, patch)
2011-07-17 04:26 EDT, /dev/humancontroller

Description /dev/humancontroller 2011-05-23 20:23:09 EDT
this is the place to submit large refactoring patches, containing:
- code cleanups
- grammar corrections
- removal of unused stuff
- improvements to documentation (comments)
- etc.
Comment 1 /dev/humancontroller 2011-05-23 20:25:34 EDT
Created attachment 2737 [details]
a refactoring package (2011-05-25)
Comment 2 /dev/humancontroller 2011-05-25 17:46:41 EDT
Created attachment 2750 [details]
refactor some bg_misc.c comments
Comment 3 /dev/humancontroller 2011-06-14 04:49:19 EDT
Created attachment 2779 [details]
a refactoring package (2011-06-14)
Comment 4 /dev/humancontroller 2011-07-17 04:26:39 EDT
Created attachment 2841 [details]
refactoring is a life
Comment 5 Ben Millwood 2011-08-01 07:30:54 EDT
I'm interested in some of these changes but not others. Copyediting comments or variable names is a waste of time and only makes patches more difficult to merge. 

My inclination is nearly all of this is not worth the time, and I won't commit any of your patches that have zero effect on functionality. Code should be refactored if you have to change it anyway, otherwise you're just making old patches less likely to apply.
Comment 6 M. Kristall 2012-07-11 22:59:55 EDT
I committed the important parts of attachment 2737 [details] at revision 2267. I did not commit the grammar/spelling fixes in comments because that is entirely unnecessary and annoying or some things that were not obviously the right thing

Attachment 2750 [details] only corrects comments which would be fine if it weren't such a huge patch for nothing

Attachment 2779 [details] is again a patch with a bunch of random stuff, but nothing particularly significant. I'd probably commit it if it only removed unused things

Attachment 2841 [details]: in many cases changing passive voice to active voice can make a big improvement on readability, but the opposite is rarely true. Even if it made a significant improvement in the prose that is C code, I wouldn't commit it