Thank the Lord for code comments
-
because I never would have figured this out
'this sets the engine type to singleline.
engineType.Value = xxxxxxx.EngineEnumType.SinglelineYes, the one thing worse that no comments, is comments so bad that you get used to just not reading them.
Christian Graus Driven to the arms of OSX by Vista. Read my blog to find out how I've worked around bugs in Microsoft tools and frameworks.
-
because I never would have figured this out
'this sets the engine type to singleline.
engineType.Value = xxxxxxx.EngineEnumType.Singleline'this sets the engine type to singleline.
engineType.Value = xxxxxxx.EngineEnumType.Keyfinder:)
If the Lord God Almighty had consulted me before embarking upon the Creation, I would have recommended something simpler. -- Alfonso the Wise, 13th Century King of Castile.
This is going on my arrogant assumptions. You may have a superb reason why I'm completely wrong. -- Iain Clarke
[My articles] -
because I never would have figured this out
'this sets the engine type to singleline.
engineType.Value = xxxxxxx.EngineEnumType.SinglelineAt least you got a comment, however meaningless: most developers seem to think that code is self-commenting.
me, me, me "The dinosaurs became extinct because they didn't have a space program. And if we become extinct because we don't have a space program, it'll serve us right!" Larry Niven
-
'this sets the engine type to singleline.
engineType.Value = xxxxxxx.EngineEnumType.Keyfinder:)
If the Lord God Almighty had consulted me before embarking upon the Creation, I would have recommended something simpler. -- Alfonso the Wise, 13th Century King of Castile.
This is going on my arrogant assumptions. You may have a superb reason why I'm completely wrong. -- Iain Clarke
[My articles] -
because I never would have figured this out
'this sets the engine type to singleline.
engineType.Value = xxxxxxx.EngineEnumType.SinglelineCheck to see if the developer used ndepends. There are measures in there that partially determine the amount of undocumented code per method (where the size of the method is taken into account), and this crap is the usual response rather than actually doing something about the size of the method.
"WPF has many lovers. It's a veritable porn star!" - Josh Smith
As Braveheart once said, "You can take our freedom but you'll never take our Hobnobs!" - Martin Hughes.
-
At least you got a comment, however meaningless: most developers seem to think that code is self-commenting.
me, me, me "The dinosaurs became extinct because they didn't have a space program. And if we become extinct because we don't have a space program, it'll serve us right!" Larry Niven
Guilty as charged, but at least my code is pretty much self-explaining.
The narrow specialist in the broad sense of the word is a complete idiot in the narrow sense of the word. Advertise here – minimum three posts per day are guaranteed.
-
because I never would have figured this out
'this sets the engine type to singleline.
engineType.Value = xxxxxxx.EngineEnumType.Singleline// prepare for code on next line, this will take the value of a variable of type System.Int32 and add 1 to it
// after completing the addition, the resultant value will be assigned to the variable.
// NOTE: a prefixed ++ indicates the increment will happen before the expression is executed
// NOTE: a suffixed ++ indicates the increment will happen after the expression is executed
// SEE ALSO: -- in both prefix and suffix forms
// REMARK: the value will silently overflow if the variable's value is System.Int32.MaxValue.
// REMARK (cont.): To have an exception throw on overflow, wrap code in checked { ... }.
// ALSO NOTE: If the variable has not been initialized, the result is undefined.
i++;xacc.ide
IronScheme - 1.0 RC 1 - out now!
((λ (x) `(,x ',x)) '(λ (x) `(,x ',x))) The Scheme Programming Language – Fourth Edition -
because I never would have figured this out
'this sets the engine type to singleline.
engineType.Value = xxxxxxx.EngineEnumType.SinglelineThis sort of thing is why I hate my places policy on warnings-as-errors and comments required on every single class/method or they break the build combined with nearly all the comments being autogenerated using tools like ghostdoc. Personally I'd rather have no comments there at all compared to auto-generated ones.
-
This sort of thing is why I hate my places policy on warnings-as-errors and comments required on every single class/method or they break the build combined with nearly all the comments being autogenerated using tools like ghostdoc. Personally I'd rather have no comments there at all compared to auto-generated ones.
That's why we have selective warn as error :) Here is my list of warnings that are marked as errors: 0067;0105;0108;0109;0114;0162;0168;0169;0219;0414;0429;0472;0642;0649;1717
xacc.ide
IronScheme - 1.0 RC 1 - out now!
((λ (x) `(,x ',x)) '(λ (x) `(,x ',x))) The Scheme Programming Language – Fourth Edition -
// prepare for code on next line, this will take the value of a variable of type System.Int32 and add 1 to it
// after completing the addition, the resultant value will be assigned to the variable.
// NOTE: a prefixed ++ indicates the increment will happen before the expression is executed
// NOTE: a suffixed ++ indicates the increment will happen after the expression is executed
// SEE ALSO: -- in both prefix and suffix forms
// REMARK: the value will silently overflow if the variable's value is System.Int32.MaxValue.
// REMARK (cont.): To have an exception throw on overflow, wrap code in checked { ... }.
// ALSO NOTE: If the variable has not been initialized, the result is undefined.
i++;xacc.ide
IronScheme - 1.0 RC 1 - out now!
((λ (x) `(,x ',x)) '(λ (x) `(,x ',x))) The Scheme Programming Language – Fourth Editionlmao
-
// prepare for code on next line, this will take the value of a variable of type System.Int32 and add 1 to it
// after completing the addition, the resultant value will be assigned to the variable.
// NOTE: a prefixed ++ indicates the increment will happen before the expression is executed
// NOTE: a suffixed ++ indicates the increment will happen after the expression is executed
// SEE ALSO: -- in both prefix and suffix forms
// REMARK: the value will silently overflow if the variable's value is System.Int32.MaxValue.
// REMARK (cont.): To have an exception throw on overflow, wrap code in checked { ... }.
// ALSO NOTE: If the variable has not been initialized, the result is undefined.
i++;xacc.ide
IronScheme - 1.0 RC 1 - out now!
((λ (x) `(,x ',x)) '(λ (x) `(,x ',x))) The Scheme Programming Language – Fourth Edition// prepare for code on next line, this will take the value of a variable of type System.Int32 and add 1 to it
// after completing the addition, the resultant value will be assigned to the variable.
// NOTE: a prefixed ++ indicates the increment will happen before the expression is executed
// NOTE: a suffixed ++ indicates the increment will happen after the expression is executed
// SEE ALSO: -- in both prefix and suffix forms
// SEE ALSO: this statement is the equivalent of += 1;
// REMARK: the value will silently overflow if the variable's value is System.Int32.MaxValue.
// REMARK (cont.): To have an exception throw on overflow, wrap code in checked { ... }.
// ALSO NOTE: If the variable has not been initialized, the result is undefined.
i++;You weren't very thorough.
"WPF has many lovers. It's a veritable porn star!" - Josh Smith
As Braveheart once said, "You can take our freedom but you'll never take our Hobnobs!" - Martin Hughes.
-
At least you got a comment, however meaningless: most developers seem to think that code is self-commenting.
me, me, me "The dinosaurs became extinct because they didn't have a space program. And if we become extinct because we don't have a space program, it'll serve us right!" Larry Niven
-
Guilty as charged, but at least my code is pretty much self-explaining.
The narrow specialist in the broad sense of the word is a complete idiot in the narrow sense of the word. Advertise here – minimum three posts per day are guaranteed.
Deyan Georgiev wrote:
but at least my code is pretty much self-explaining.
No it isn't! (Well, maybe yours is - mine isn't so I always make sure I write something to help whomever comes next).
me, me, me "The dinosaurs became extinct because they didn't have a space program. And if we become extinct because we don't have a space program, it'll serve us right!" Larry Niven
-
// prepare for code on next line, this will take the value of a variable of type System.Int32 and add 1 to it
// after completing the addition, the resultant value will be assigned to the variable.
// NOTE: a prefixed ++ indicates the increment will happen before the expression is executed
// NOTE: a suffixed ++ indicates the increment will happen after the expression is executed
// SEE ALSO: -- in both prefix and suffix forms
// SEE ALSO: this statement is the equivalent of += 1;
// REMARK: the value will silently overflow if the variable's value is System.Int32.MaxValue.
// REMARK (cont.): To have an exception throw on overflow, wrap code in checked { ... }.
// ALSO NOTE: If the variable has not been initialized, the result is undefined.
i++;You weren't very thorough.
"WPF has many lovers. It's a veritable porn star!" - Josh Smith
As Braveheart once said, "You can take our freedom but you'll never take our Hobnobs!" - Martin Hughes.
// prepare for code on next line, this will take the value of a variable of type System.Int32 and add 1 to it
// after completing the addition, the resultant value will be assigned to the variable.
// NOTE: a prefixed ++ indicates the increment will happen before the expression is executed
// NOTE: a suffixed ++ indicates the increment will happen after the expression is executed
// SEE ALSO: -- in both prefix and suffix forms
// SEE ALSO: this statement is the equivalent of += 1;
// SEE ALSO: this statement is also the equivalent of var = var + 1;
// REMARK: the value will silently overflow if the variable's value is System.Int32.MaxValue.
// REMARK (cont.): To have an exception throw on overflow, wrap code in checked { ... }.
// ALSO NOTE: If the variable has not been initialized, the result is undefined.
i++;Neither were you :)
xacc.ide
IronScheme - 1.0 RC 1 - out now!
((λ (x) `(,x ',x)) '(λ (x) `(,x ',x))) The Scheme Programming Language – Fourth Edition -
because I never would have figured this out
'this sets the engine type to singleline.
engineType.Value = xxxxxxx.EngineEnumType.SinglelineWow "Lord for code comments" working with "VB" :doh: Whats next ;P
It is Good to be Important but! it is more Important to be Good
-
// prepare for code on next line, this will take the value of a variable of type System.Int32 and add 1 to it
// after completing the addition, the resultant value will be assigned to the variable.
// NOTE: a prefixed ++ indicates the increment will happen before the expression is executed
// NOTE: a suffixed ++ indicates the increment will happen after the expression is executed
// SEE ALSO: -- in both prefix and suffix forms
// REMARK: the value will silently overflow if the variable's value is System.Int32.MaxValue.
// REMARK (cont.): To have an exception throw on overflow, wrap code in checked { ... }.
// ALSO NOTE: If the variable has not been initialized, the result is undefined.
i++;xacc.ide
IronScheme - 1.0 RC 1 - out now!
((λ (x) `(,x ',x)) '(λ (x) `(,x ',x))) The Scheme Programming Language – Fourth Edition-1, not enough xml
Religiously blogging on the intarwebs since the early 21st century: Kineti L'Tziyon
Judah Himango -
because I never would have figured this out
'this sets the engine type to singleline.
engineType.Value = xxxxxxx.EngineEnumType.Singleline -
Deyan Georgiev wrote:
but at least my code is pretty much self-explaining.
No it isn't! (Well, maybe yours is - mine isn't so I always make sure I write something to help whomever comes next).
me, me, me "The dinosaurs became extinct because they didn't have a space program. And if we become extinct because we don't have a space program, it'll serve us right!" Larry Niven
-
// prepare for code on next line, this will take the value of a variable of type System.Int32 and add 1 to it
// after completing the addition, the resultant value will be assigned to the variable.
// NOTE: a prefixed ++ indicates the increment will happen before the expression is executed
// NOTE: a suffixed ++ indicates the increment will happen after the expression is executed
// SEE ALSO: -- in both prefix and suffix forms
// REMARK: the value will silently overflow if the variable's value is System.Int32.MaxValue.
// REMARK (cont.): To have an exception throw on overflow, wrap code in checked { ... }.
// ALSO NOTE: If the variable has not been initialized, the result is undefined.
i++;xacc.ide
IronScheme - 1.0 RC 1 - out now!
((λ (x) `(,x ',x)) '(λ (x) `(,x ',x))) The Scheme Programming Language – Fourth EditionNow if I had been drinking something I would have surely spewed it all over my monitor.
Why is common sense not common? Never argue with an idiot. They will drag you down to their level where they are an expert. Sometimes it takes a lot of work to be lazy Individuality is fine, as long as we do it together - F. Burns
-
-1, not enough xml
Religiously blogging on the intarwebs since the early 21st century: Kineti L'Tziyon
Judah HimangoI dont like the color ;P
xacc.ide
IronScheme - 1.0 RC 1 - out now!
((λ (x) `(,x ',x)) '(λ (x) `(,x ',x))) The Scheme Programming Language – Fourth Edition