View previous topic - View next topic |
Author |
Message |
DeveloperX 202192397
Joined: 04 May 2003 Posts: 1626 Location: Decatur, IL, USA
|
Posted: Sun Jan 14, 2007 7:10 pm Post subject: |
[quote] |
|
RedSlash wrote: |
However, I too can point out the example of inconsistant naming conventions.
|
You are right. I overlooked a few, and I will fix them when I upload the next site-update. Thanks.
game_state was from the old article, however, the function naming convention is not inconsistent.
I use lowercaseCapsCapsCaps () instead of CapsCapsCaps for functions.
the Allegro functions are then easily seperated from mine because Allegro uses lower_lower () format.
I didn't want to use CapsCaps () for functions and variables, because it can be confusing for a newbie.
I am going to write up a naming convention document so that readers can quickly understand why I do things the way I do them.
No one is perfect. I'm not claiming that my way is perfect, its just I have my style. No one is forcing anyone to use it. Just accept that it is MY style. _________________ Principal Software Architect
Rambling Indie Games, LLC
See my professional portfolio
|
|
Back to top |
|
|
Nodtveidt Demon Hunter
Joined: 11 Nov 2002 Posts: 786 Location: Camuy, PR
|
Posted: Mon Jan 15, 2007 10:57 am Post subject: |
[quote] |
|
Everyone seems to complain about style these days. Let me take a look at the coding style of these whiners...I will poke many holes in their coding style, citing reference after reference to why their style is inferior to the professionals. Before one whines about style, maybe they should take a look at their own and make some "corrections"...or maybe they should just leave a person's individual coding style the hell alone and whine about something else worth whining about (or perhaps stop whining altogether, since whining accomplishes NOTHING!). _________________ If you play a Microsoft CD backwards you can hear demonic voices. The scary part is that if you play it forwards it installs Windows. - wallace
|
|
Back to top |
|
|
DeveloperX 202192397
Joined: 04 May 2003 Posts: 1626 Location: Decatur, IL, USA
|
Posted: Tue Jan 16, 2007 4:02 am Post subject: |
[quote] |
|
nodtveidt wrote: | Everyone seems to complain about style these days. Let me take a look at the coding style of these whiners...I will poke many holes in their coding style, citing reference after reference to why their style is inferior to the professionals. Before one whines about style, maybe they should take a look at their own and make some "corrections"...or maybe they should just leave a person's individual coding style the hell alone and whine about something else worth whining about (or perhaps stop whining altogether, since whining accomplishes NOTHING!). |
Hehe, thanks Nod. You've always been a good friend to me. _________________ Principal Software Architect
Rambling Indie Games, LLC
See my professional portfolio
|
|
Back to top |
|
|
tunginobi Wandering Minstrel
Joined: 13 Dec 2005 Posts: 91
|
Posted: Tue Jan 16, 2007 9:13 am Post subject: |
[quote] |
|
Good style: anything that can be read and understood by other people.
I can look at anybody's code and easily mimic their style. Capital letters, underscores, camel case, tabs versus spaces... in many places, none of that really matters, so long as it's consistent.
Obviously a team needs to agree to a naming convention when implementing an API to whatever library they're working on. But really, I'm happy if I can read it.
|
|
Back to top |
|
|
Nodtveidt Demon Hunter
Joined: 11 Nov 2002 Posts: 786 Location: Camuy, PR
|
Posted: Tue Jan 16, 2007 12:32 pm Post subject: |
[quote] |
|
Those "other people" are going to vary though. No one's code can be read and understood by everyone. For example: People have been parroting for ages about how great the NeHe tutorials are, but I can't make heads or tails of that crap, and I don't exactly think I'm an idiot or inconsequential. Great style? Completely open to interpretation. Furthermore, when working on a team, obviously you have to have some accepted standards, but when working on your own stuff, the only person who needs to understand it is you yourself. There are a few norms that everyone should probably follow to make their own code more readable to even themselves that in no way hinders the effectiveness of the compiler (using things such as int iVariableName is VERY effective), but beyond that, coding style is fair game. _________________ If you play a Microsoft CD backwards you can hear demonic voices. The scary part is that if you play it forwards it installs Windows. - wallace
|
|
Back to top |
|
|
white_wolf Pretty, Pretty Fairy Princess
Joined: 13 Nov 2006 Posts: 10
|
Posted: Tue Jan 16, 2007 4:08 pm Post subject: |
[quote] |
|
nodtveidt wrote: | Those "other people" are going to vary though. No one's code can be read and understood by everyone. For example: People have been parroting for ages about how great the NeHe tutorials are, but I can't make heads or tails of that crap, and I don't exactly think I'm an idiot or inconsequential. Great style? Completely open to interpretation. Furthermore, when working on a team, obviously you have to have some accepted standards, but when working on your own stuff, the only person who needs to understand it is you yourself. There are a few norms that everyone should probably follow to make their own code more readable to even themselves that in no way hinders the effectiveness of the compiler (using things such as int iVariableName is VERY effective), but beyond that, coding style is fair game. |
qft. I don't understand why DeveloperX is receiving so much criticism about this. The articles are for total noobs and as long as they understand it, who cares. And, if you're so great at coding, then write one up yourself.
good job for getting 'em out there, Dev.X.
|
|
Back to top |
|
|
Nodtveidt Demon Hunter
Joined: 11 Nov 2002 Posts: 786 Location: Camuy, PR
|
Posted: Tue Jan 16, 2007 4:22 pm Post subject: |
[quote] |
|
white_wolf, are you completely airheaded? I was DEFENDING DevX, not criticizing him. Get a clue! _________________ If you play a Microsoft CD backwards you can hear demonic voices. The scary part is that if you play it forwards it installs Windows. - wallace
|
|
Back to top |
|
|
LeoDraco Demon Hunter
Joined: 24 Jun 2003 Posts: 584 Location: Riverside, South Cali
|
Posted: Tue Jan 16, 2007 6:34 pm Post subject: |
[quote] |
|
Eww, Hungarian Notation! I personally find that to be the single most ugly thing ever. Modern editors usually have discovery techniques which make it quite old. Good languages, conversely, would hardly be agile if it were used.
I do agree with the consistency thing, too. For any who care, my criticism earlier in this thread had nothing to do with the coding style of DeveloperX's code; I just don't think his abstraction is usable, even for a neophyte. A properly written abstraction should make code easier to read, not obscure it behind a bunch of meaningless, inconsistent cruft. _________________ "...LeoDraco is a pompus git..." -- Mandrake
|
|
Back to top |
|
|
DeveloperX 202192397
Joined: 04 May 2003 Posts: 1626 Location: Decatur, IL, USA
|
Posted: Tue Jan 16, 2007 7:26 pm Post subject: |
[quote] |
|
white_wolf wrote: | [
qft. I don't understand why DeveloperX is receiving so much criticism about this. The articles are for total noobs and as long as they understand it, who cares. And, if you're so great at coding, then write one up yourself. |
Nod has always been there defending me man, any input he has on anything is always appreciated.I think you may have misread his post, if you felt that he was 'against' me.
And, Nod, please lighten up on the wolf. ;) He's new, and I don't want him to feel the way I used to back when I had started here.
LeoDraco:
I use Hungarian notation when I work on a large project with others, because it makes it easier to quickly glance at, and understand the code. I tend to use my own subsets of it though, and as such I do make sure that I provide a 'legend' for the coding standard that was used. Sure, it IS ugly, but who said code had to be pretty? ;)
Also, I may not have said this before, but if you want to write an article that 'properly' (to you) uses an abstraction then please, by all means go ahead. I'll stick it on my site, with your name on it. _________________ Principal Software Architect
Rambling Indie Games, LLC
See my professional portfolio
|
|
Back to top |
|
|
LeoDraco Demon Hunter
Joined: 24 Jun 2003 Posts: 584 Location: Riverside, South Cali
|
Posted: Tue Jan 16, 2007 7:45 pm Post subject: |
[quote] |
|
DeveloperX wrote: | Sure, it IS ugly, but who said code had to be pretty? ;) |
Far be it for a developer who has to look at code all day to desire the code to read well and look pretty.
"Pretty" code writes faster; there are less special cases that need to be remembered and maintained. As a developer, writing code quickly is a good goal to aim toward; anything that hinders that should be deprecated, and anything that promotes that should be lauded. _________________ "...LeoDraco is a pompus git..." -- Mandrake
|
|
Back to top |
|
|
RedSlash Mage
Joined: 12 May 2005 Posts: 331
|
Posted: Wed Jan 17, 2007 1:10 am Post subject: |
[quote] |
|
Quote: | however, the function naming convention is not inconsistent.
I use lowercaseCapsCapsCaps () instead of CapsCapsCaps for functions. |
Acutally, I was trying pointing out that DebugBox() and initializeGameEngine() were inconsistant because DebugBox() uses the CapCapCap() style whereas initializeGameEngine() uses lowerCapCap() style. Since you have established to use lowerCapCap() style, then it would make more sense to lowercase the "d" in DebugBox() as in debugBox().
Quote: |
I didn't want to use CapsCaps () for functions and variables, because it can be confusing for a newbie. |
Definately not! Usually most people define a different style for functions, variables and constants. This is definately a good way to go!
|
|
Back to top |
|
|
DeveloperX 202192397
Joined: 04 May 2003 Posts: 1626 Location: Decatur, IL, USA
|
Posted: Wed Jan 17, 2007 4:22 am Post subject: |
[quote] |
|
RedSlash wrote: | Acutally, I was trying pointing out that DebugBox() and initializeGameEngine() were inconsistant because DebugBox() uses the CapCapCap() style whereas initializeGameEngine() uses lowerCapCap() style. Since you have established to use lowerCapCap() style, then it would make more sense to lowercase the "d" in DebugBox() as in debugBox().
|
Overlooked. Sorry, I'll fix that next update. _________________ Principal Software Architect
Rambling Indie Games, LLC
See my professional portfolio
|
|
Back to top |
|
|
Nodtveidt Demon Hunter
Joined: 11 Nov 2002 Posts: 786 Location: Camuy, PR
|
Posted: Wed Jan 17, 2007 10:38 am Post subject: |
[quote] |
|
DeveloperX wrote: | And, Nod, please lighten up on the wolf. ;) He's new, and I don't want him to feel the way I used to back when I had started here. |
No problem, I'll be nice to the wolfie. :D _________________ If you play a Microsoft CD backwards you can hear demonic voices. The scary part is that if you play it forwards it installs Windows. - wallace
|
|
Back to top |
|
|
DeveloperX 202192397
Joined: 04 May 2003 Posts: 1626 Location: Decatur, IL, USA
|
|
Back to top |
|
|
tcaudilllg Dragonmaster
Joined: 20 Jun 2002 Posts: 1731 Location: Cedar Bluff, VA
|
Posted: Sat Jan 20, 2007 8:04 pm Post subject: |
[quote] |
|
Have you made this into a comprehensive engine, like the kind that you can make a complete game relatively quick with?
|
|
Back to top |
|
|
|
|
You cannot post new topics in this forum You cannot reply to topics in this forum You cannot edit your posts in this forum You cannot delete your posts in this forum You cannot vote in polls in this forum
|
|