Re: Code commenting

2013-09-15 Thread Corneliu I. Tusnea
If it was hard to write it should be hard to read :)
Why comment?


On Fri, Sep 13, 2013 at 5:56 PM, Davy Jones djones...@gmail.com wrote:

 Hello
 If you are doing this in code. It points to the fact that someone is not
 pulling their weight.
 Code should not have comments. If you need them to explain something, the
 code is too complex.
 If you add them so modifications on one bit of code come back to you so
 you can fix. Make it simpler.
 If you add them to Blame later, you should be doing peer reviewed checkins
 to bring everyone up to the same level.
 If you are commenting code because it might be useful later. Delete it!
 That is what source control is for.

 There is no excuse for comments in code.

 Davy

 Sent from my starfleet datapad.

 On 13 sept. 2013, at 08:56, mike smith meski...@gmail.com wrote:

 Blame is a useful tool, ofttimes though, I'd call it credit.  For
 instance, you receive a crashdump from an old version, it shows you where
 the app crashed, and maybe you have a slight idea why.  Use blame on a
 current version, look at changes around the crash line and you've got a lot
 of the info you might need to generate a hotfix.  With all the caveats that
 hotfixes imply :)  If your devs are diligent linking the svn comment with a
 number from your CR system, that's another link.

 But I'd hate to see it actually present in the code.




 On Fri, Sep 13, 2013 at 2:50 PM, Craig van Nieuwkerk crai...@gmail.comwrote:

 A lot of source control systems give you that out of the box. I know Git
 and SVN both do with the BLAME command. I wouldn't want the comments
 scattered throughout the code.


 On Fri, Sep 13, 2013 at 2:45 PM, anthonyatsmall...@mail.com wrote:

 Anyone suggest a method to autmaticlly comment code when lines have
 changed?  Would be great to be able to see who changed what when viewing
 the code.

 ** **

 At the moment,, we write comments like //xxMOD 12AUG13   XX=PROGRAMMER
 INITIALS

 ** **

 WE use TFS but we like to write comments in code sometimes.  Any
 extensions able to do this?

 ** **

 Anthony

 Melbourne StuffUps…learn from others, share with others!

 http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/
 



 --
 NOTICE : The information contained in this electronic mail message is
 privileged and confidential, and is intended only for use of the addressee.
 If you are not the intended recipient, you are hereby notified that any
 disclosure, reproduction, distribution or other use of this communication
 is strictly prohibited.
 If you have received this communication in error, please notify the
 sender by reply transmission and delete the message without copying or
 disclosing it. (*13POrtC*)

 ---
 

 ** **





 --
 Meski

http://courteous.ly/aAOZcv

 Going to Starbucks for coffee is like going to prison for sex. Sure,
 you'll get it, but it's going to be rough - Adam Hills




Re: Code commenting

2013-09-15 Thread mike smith
Just run it thru an obfuscator before committing it


On Mon, Sep 16, 2013 at 9:46 AM, Corneliu I. Tusnea
corne...@acorns.com.auwrote:

 If it was hard to write it should be hard to read :)
 Why comment?


 On Fri, Sep 13, 2013 at 5:56 PM, Davy Jones djones...@gmail.com wrote:

 Hello
 If you are doing this in code. It points to the fact that someone is not
 pulling their weight.
 Code should not have comments. If you need them to explain something, the
 code is too complex.
 If you add them so modifications on one bit of code come back to you so
 you can fix. Make it simpler.
 If you add them to Blame later, you should be doing peer reviewed
 checkins to bring everyone up to the same level.
 If you are commenting code because it might be useful later. Delete it!
 That is what source control is for.

 There is no excuse for comments in code.

 Davy

 Sent from my starfleet datapad.

 On 13 sept. 2013, at 08:56, mike smith meski...@gmail.com wrote:

 Blame is a useful tool, ofttimes though, I'd call it credit.  For
 instance, you receive a crashdump from an old version, it shows you where
 the app crashed, and maybe you have a slight idea why.  Use blame on a
 current version, look at changes around the crash line and you've got a lot
 of the info you might need to generate a hotfix.  With all the caveats that
 hotfixes imply :)  If your devs are diligent linking the svn comment with a
 number from your CR system, that's another link.

 But I'd hate to see it actually present in the code.




 On Fri, Sep 13, 2013 at 2:50 PM, Craig van Nieuwkerk 
 crai...@gmail.comwrote:

 A lot of source control systems give you that out of the box. I know Git
 and SVN both do with the BLAME command. I wouldn't want the comments
 scattered throughout the code.


 On Fri, Sep 13, 2013 at 2:45 PM, anthonyatsmall...@mail.com wrote:

 Anyone suggest a method to autmaticlly comment code when lines have
 changed?  Would be great to be able to see who changed what when viewing
 the code.

 ** **

 At the moment,, we write comments like //xxMOD 12AUG13   XX=PROGRAMMER
 INITIALS

 ** **

 WE use TFS but we like to write comments in code sometimes.  Any
 extensions able to do this?

 ** **

 Anthony

 Melbourne StuffUps…learn from others, share with others!


 http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/
 



 --
 NOTICE : The information contained in this electronic mail message is
 privileged and confidential, and is intended only for use of the addressee.
 If you are not the intended recipient, you are hereby notified that any
 disclosure, reproduction, distribution or other use of this communication
 is strictly prohibited.
 If you have received this communication in error, please notify the
 sender by reply transmission and delete the message without copying or
 disclosing it. (*13POrtC*)

 ---
 

 ** **





 --
 Meski

http://courteous.ly/aAOZcv

 Going to Starbucks for coffee is like going to prison for sex. Sure,
 you'll get it, but it's going to be rough - Adam Hills





-- 
Meski

 http://courteous.ly/aAOZcv

Going to Starbucks for coffee is like going to prison for sex. Sure,
you'll get it, but it's going to be rough - Adam Hills


Re: Code commenting

2013-09-13 Thread William Luu
With Visual Studio 2013 Ultimate/TFS2013 there's a new feature called
CodeLens which will probably give you something similar to what you're
after.

See -
http://msdn.microsoft.com/en-us/library/vstudio/dn269218(v=vs.120).aspx
And -
http://blogs.msdn.com/b/zainnab/archive/2013/07/09/visual-studio-2013-preview-codelens-aka-code-information-indicators.aspx

Basically, there is functionality to show you recent changes, by who and
the checkin comment.


On 13 September 2013 15:11, Preet Sangha preetsan...@gmail.com wrote:

 Anthony, you're asking about some form of automated tool and seriously
 you're not using the annotate function within TFS?






 On 13 September 2013 16:55, anthonyatsmall...@mail.com wrote:

 I like to comment code and remove some of them after a while.  

 ** **

 Anthony

 Melbourne StuffUps…learn from others, share with others!

 http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/
 



 --
 NOTICE : The information contained in this electronic mail message is
 privileged and confidential, and is intended only for use of the addressee.
 If you are not the intended recipient, you are hereby notified that any
 disclosure, reproduction, distribution or other use of this communication
 is strictly prohibited.
 If you have received this communication in error, please notify the
 sender by reply transmission and delete the message without copying or
 disclosing it. (*13POrtC*)

 ---
 

 ** **

 *From:* ozdotnet-boun...@ozdotnet.com [mailto:
 ozdotnet-boun...@ozdotnet.com] *On Behalf Of *Craig van Nieuwkerk
 *Sent:* Friday, 13 September 2013 2:50 PM
 *To:* ozDotNet
 *Subject:* Re: Code commenting

 ** **

 A lot of source control systems give you that out of the box. I know Git
 and SVN both do with the BLAME command. I wouldn't want the comments
 scattered throughout the code.

 ** **

 On Fri, Sep 13, 2013 at 2:45 PM, anthonyatsmall...@mail.com wrote:

 Anyone suggest a method to autmaticlly comment code when lines have
 changed?  Would be great to be able to see who changed what when viewing
 the code.

  

 At the moment,, we write comments like //xxMOD 12AUG13   XX=PROGRAMMER
 INITIALS

  

 WE use TFS but we like to write comments in code sometimes.  Any
 extensions able to do this?

  

 Anthony

 Melbourne StuffUps…learn from others, share with others!

 http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/
 



 --
 NOTICE : The information contained in this electronic mail message is
 privileged and confidential, and is intended only for use of the addressee.
 If you are not the intended recipient, you are hereby notified that any
 disclosure, reproduction, distribution or other use of this communication
 is strictly prohibited.
 If you have received this communication in error, please notify the
 sender by reply transmission and delete the message without copying or
 disclosing it. (*13POrtC*)

 ---
 

  

 ** **




 --
 regards,
 Preet, Overlooking the Ocean, Auckland



Re: Code commenting

2013-09-13 Thread mike smith
Blame is a useful tool, ofttimes though, I'd call it credit.  For instance,
you receive a crashdump from an old version, it shows you where the app
crashed, and maybe you have a slight idea why.  Use blame on a current
version, look at changes around the crash line and you've got a lot of the
info you might need to generate a hotfix.  With all the caveats that
hotfixes imply :)  If your devs are diligent linking the svn comment with a
number from your CR system, that's another link.

But I'd hate to see it actually present in the code.




On Fri, Sep 13, 2013 at 2:50 PM, Craig van Nieuwkerk crai...@gmail.comwrote:

 A lot of source control systems give you that out of the box. I know Git
 and SVN both do with the BLAME command. I wouldn't want the comments
 scattered throughout the code.


 On Fri, Sep 13, 2013 at 2:45 PM, anthonyatsmall...@mail.com wrote:

 Anyone suggest a method to autmaticlly comment code when lines have
 changed?  Would be great to be able to see who changed what when viewing
 the code.

 ** **

 At the moment,, we write comments like //xxMOD 12AUG13   XX=PROGRAMMER
 INITIALS

 ** **

 WE use TFS but we like to write comments in code sometimes.  Any
 extensions able to do this?

 ** **

 Anthony

 Melbourne StuffUps…learn from others, share with others!

 http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/
 



 --
 NOTICE : The information contained in this electronic mail message is
 privileged and confidential, and is intended only for use of the addressee.
 If you are not the intended recipient, you are hereby notified that any
 disclosure, reproduction, distribution or other use of this communication
 is strictly prohibited.
 If you have received this communication in error, please notify the
 sender by reply transmission and delete the message without copying or
 disclosing it. (*13POrtC*)

 ---
 

 ** **





-- 
Meski

 http://courteous.ly/aAOZcv

Going to Starbucks for coffee is like going to prison for sex. Sure,
you'll get it, but it's going to be rough - Adam Hills


Re: Code commenting

2013-09-13 Thread Davy Jones
Hello
If you are doing this in code. It points to the fact that someone is not
pulling their weight.
Code should not have comments. If you need them to explain something, the
code is too complex.
If you add them so modifications on one bit of code come back to you so you
can fix. Make it simpler.
If you add them to Blame later, you should be doing peer reviewed checkins
to bring everyone up to the same level.
If you are commenting code because it might be useful later. Delete it!
That is what source control is for.

There is no excuse for comments in code.

Davy

Sent from my starfleet datapad.

On 13 sept. 2013, at 08:56, mike smith meski...@gmail.com wrote:

Blame is a useful tool, ofttimes though, I'd call it credit.  For instance,
you receive a crashdump from an old version, it shows you where the app
crashed, and maybe you have a slight idea why.  Use blame on a current
version, look at changes around the crash line and you've got a lot of the
info you might need to generate a hotfix.  With all the caveats that
hotfixes imply :)  If your devs are diligent linking the svn comment with a
number from your CR system, that's another link.

But I'd hate to see it actually present in the code.




On Fri, Sep 13, 2013 at 2:50 PM, Craig van Nieuwkerk crai...@gmail.comwrote:

 A lot of source control systems give you that out of the box. I know Git
 and SVN both do with the BLAME command. I wouldn't want the comments
 scattered throughout the code.


 On Fri, Sep 13, 2013 at 2:45 PM, anthonyatsmall...@mail.com wrote:

 Anyone suggest a method to autmaticlly comment code when lines have
 changed?  Would be great to be able to see who changed what when viewing
 the code.

 ** **

 At the moment,, we write comments like //xxMOD 12AUG13   XX=PROGRAMMER
 INITIALS

 ** **

 WE use TFS but we like to write comments in code sometimes.  Any
 extensions able to do this?

 ** **

 Anthony

 Melbourne StuffUps…learn from others, share with others!

 http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/
 



 --
 NOTICE : The information contained in this electronic mail message is
 privileged and confidential, and is intended only for use of the addressee.
 If you are not the intended recipient, you are hereby notified that any
 disclosure, reproduction, distribution or other use of this communication
 is strictly prohibited.
 If you have received this communication in error, please notify the
 sender by reply transmission and delete the message without copying or
 disclosing it. (*13POrtC*)

 ---
 

 ** **





-- 
Meski

   http://courteous.ly/aAOZcv

Going to Starbucks for coffee is like going to prison for sex. Sure,
you'll get it, but it's going to be rough - Adam Hills


Re: Code commenting

2013-09-13 Thread Sam Lai
No comments at all is a bit extreme. I get what you're saying, but there
are still valid reasons for comments. For example, if you had to do an
unusual hack because of a bug in the framework, you'd want to leave a
comment in the code so the next person who comes along doesn't spend hours
re-writing it so it is done properly only to realise after that a bug
exists.

Do docstrings/javadocs count as comments?

I agree about no 'person x made this change on y because of issue z'
comments though; if your source control doesn't make that easy to
determine, then get a new source control system.


On 13 September 2013 17:56, Davy Jones djones...@gmail.com wrote:

 Hello
 If you are doing this in code. It points to the fact that someone is not
 pulling their weight.
 Code should not have comments. If you need them to explain something, the
 code is too complex.
 If you add them so modifications on one bit of code come back to you so
 you can fix. Make it simpler.
 If you add them to Blame later, you should be doing peer reviewed checkins
 to bring everyone up to the same level.
 If you are commenting code because it might be useful later. Delete it!
 That is what source control is for.

 There is no excuse for comments in code.

 Davy

 Sent from my starfleet datapad.

 On 13 sept. 2013, at 08:56, mike smith meski...@gmail.com wrote:

 Blame is a useful tool, ofttimes though, I'd call it credit.  For
 instance, you receive a crashdump from an old version, it shows you where
 the app crashed, and maybe you have a slight idea why.  Use blame on a
 current version, look at changes around the crash line and you've got a lot
 of the info you might need to generate a hotfix.  With all the caveats that
 hotfixes imply :)  If your devs are diligent linking the svn comment with a
 number from your CR system, that's another link.

 But I'd hate to see it actually present in the code.




 On Fri, Sep 13, 2013 at 2:50 PM, Craig van Nieuwkerk crai...@gmail.comwrote:

 A lot of source control systems give you that out of the box. I know Git
 and SVN both do with the BLAME command. I wouldn't want the comments
 scattered throughout the code.


 On Fri, Sep 13, 2013 at 2:45 PM, anthonyatsmall...@mail.com wrote:

 Anyone suggest a method to autmaticlly comment code when lines have
 changed?  Would be great to be able to see who changed what when viewing
 the code.

 ** **

 At the moment,, we write comments like //xxMOD 12AUG13   XX=PROGRAMMER
 INITIALS

 ** **

 WE use TFS but we like to write comments in code sometimes.  Any
 extensions able to do this?

 ** **

 Anthony

 Melbourne StuffUps…learn from others, share with others!

 http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/
 



 --
 NOTICE : The information contained in this electronic mail message is
 privileged and confidential, and is intended only for use of the addressee.
 If you are not the intended recipient, you are hereby notified that any
 disclosure, reproduction, distribution or other use of this communication
 is strictly prohibited.
 If you have received this communication in error, please notify the
 sender by reply transmission and delete the message without copying or
 disclosing it. (*13POrtC*)

 ---
 

 ** **





 --
 Meski

http://courteous.ly/aAOZcv

 Going to Starbucks for coffee is like going to prison for sex. Sure,
 you'll get it, but it's going to be rough - Adam Hills




Re: Code commenting

2013-09-13 Thread David Rhys Jones
For the last 5 years or so the only comments that I have left in code. are
the public interface XML comments that are well written with examples. not
the usual you find.
/// summary
/// Gets the User by Id
/// /summary
public void GetUserById(long id){}

I have left comments that point out that a bug exists in something we can't
control.
like a Log.Debug in a tight loop that I've put if log.IsDebug around
for performance reasons.

a couple of years ago, we were working on a project that was full stylecop
and code analysis doing it by TDD.  When the company changed it's
acceptance rules to be more strict, we were 90% compliant. However they
complained that there were only 12 comments in the entire solution.

if you have to make comments in the code, always prefix it with something
that is constant so the task list picks it up.  The HACK, TODO and UNDONE
are adequate, I've found that customizing this list is counter productive
because you miss the other developers tags if they add them without consent
of the team.

2c
Davy

Davy,

The US Congress voted Pizza sauce a vegetable. Don't even try to convince
me of anything in the states is sane any more!


On Fri, Sep 13, 2013 at 10:38 AM, Sam Lai samuel@gmail.com wrote:

 No comments at all is a bit extreme. I get what you're saying, but there
 are still valid reasons for comments. For example, if you had to do an
 unusual hack because of a bug in the framework, you'd want to leave a
 comment in the code so the next person who comes along doesn't spend hours
 re-writing it so it is done properly only to realise after that a bug
 exists.

 Do docstrings/javadocs count as comments?

 I agree about no 'person x made this change on y because of issue z'
 comments though; if your source control doesn't make that easy to
 determine, then get a new source control system.


 On 13 September 2013 17:56, Davy Jones djones...@gmail.com wrote:

 Hello
 If you are doing this in code. It points to the fact that someone is not
 pulling their weight.
 Code should not have comments. If you need them to explain something, the
 code is too complex.
 If you add them so modifications on one bit of code come back to you so
 you can fix. Make it simpler.
 If you add them to Blame later, you should be doing peer reviewed
 checkins to bring everyone up to the same level.
 If you are commenting code because it might be useful later. Delete it!
 That is what source control is for.

 There is no excuse for comments in code.

 Davy

 Sent from my starfleet datapad.

 On 13 sept. 2013, at 08:56, mike smith meski...@gmail.com wrote:

 Blame is a useful tool, ofttimes though, I'd call it credit.  For
 instance, you receive a crashdump from an old version, it shows you where
 the app crashed, and maybe you have a slight idea why.  Use blame on a
 current version, look at changes around the crash line and you've got a lot
 of the info you might need to generate a hotfix.  With all the caveats that
 hotfixes imply :)  If your devs are diligent linking the svn comment with a
 number from your CR system, that's another link.

 But I'd hate to see it actually present in the code.




 On Fri, Sep 13, 2013 at 2:50 PM, Craig van Nieuwkerk 
 crai...@gmail.comwrote:

 A lot of source control systems give you that out of the box. I know Git
 and SVN both do with the BLAME command. I wouldn't want the comments
 scattered throughout the code.


 On Fri, Sep 13, 2013 at 2:45 PM, anthonyatsmall...@mail.com wrote:

 Anyone suggest a method to autmaticlly comment code when lines have
 changed?  Would be great to be able to see who changed what when viewing
 the code.

 ** **

 At the moment,, we write comments like //xxMOD 12AUG13   XX=PROGRAMMER
 INITIALS

 ** **

 WE use TFS but we like to write comments in code sometimes.  Any
 extensions able to do this?

 ** **

 Anthony

 Melbourne StuffUps…learn from others, share with others!


 http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/
 



 --
 NOTICE : The information contained in this electronic mail message is
 privileged and confidential, and is intended only for use of the addressee.
 If you are not the intended recipient, you are hereby notified that any
 disclosure, reproduction, distribution or other use of this communication
 is strictly prohibited.
 If you have received this communication in error, please notify the
 sender by reply transmission and delete the message without copying or
 disclosing it. (*13POrtC*)

 ---
 

 ** **





 --
 Meski

http://courteous.ly/aAOZcv

 Going to Starbucks for coffee is like going to prison for sex. Sure,
 you'll get it, but it's going to be rough - Adam Hills





Re: Code commenting

2013-09-12 Thread Joseph Cooney
TFS annotate?
On 13 Sep 2013 14:47, anthonyatsmall...@mail.com wrote:

 Anyone suggest a method to autmaticlly comment code when lines have
 changed?  Would be great to be able to see who changed what when viewing
 the code.

 ** **

 At the moment,, we write comments like //xxMOD 12AUG13   XX=PROGRAMMER
 INITIALS

 ** **

 WE use TFS but we like to write comments in code sometimes.  Any
 extensions able to do this?

 ** **

 Anthony

 Melbourne StuffUps…learn from others, share with others!

 http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/*
 ***



 --
 NOTICE : The information contained in this electronic mail message is
 privileged and confidential, and is intended only for use of the addressee.
 If you are not the intended recipient, you are hereby notified that any
 disclosure, reproduction, distribution or other use of this communication
 is strictly prohibited.
 If you have received this communication in error, please notify the sender
 by reply transmission and delete the message without copying or disclosing
 it. (*13POrtC*)

 ---
 

 ** **



Re: Code commenting

2013-09-12 Thread Craig van Nieuwkerk
A lot of source control systems give you that out of the box. I know Git
and SVN both do with the BLAME command. I wouldn't want the comments
scattered throughout the code.


On Fri, Sep 13, 2013 at 2:45 PM, anthonyatsmall...@mail.com wrote:

 Anyone suggest a method to autmaticlly comment code when lines have
 changed?  Would be great to be able to see who changed what when viewing
 the code.

 ** **

 At the moment,, we write comments like //xxMOD 12AUG13   XX=PROGRAMMER
 INITIALS

 ** **

 WE use TFS but we like to write comments in code sometimes.  Any
 extensions able to do this?

 ** **

 Anthony

 Melbourne StuffUps…learn from others, share with others!

 http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/*
 ***



 --
 NOTICE : The information contained in this electronic mail message is
 privileged and confidential, and is intended only for use of the addressee.
 If you are not the intended recipient, you are hereby notified that any
 disclosure, reproduction, distribution or other use of this communication
 is strictly prohibited.
 If you have received this communication in error, please notify the sender
 by reply transmission and delete the message without copying or disclosing
 it. (*13POrtC*)

 ---
 

 ** **



RE: Code commenting

2013-09-12 Thread anthonyatsmallbiz
I like to comment code and remove some of them after a while.  

 

Anthony

Melbourne StuffUps.learn from others, share with others!

http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/



--
NOTICE : The information contained in this electronic mail message is
privileged and confidential, and is intended only for use of the addressee.
If you are not the intended recipient, you are hereby notified that any
disclosure, reproduction, distribution or other use of this communication is
strictly prohibited. 
If you have received this communication in error, please notify the sender
by reply transmission and delete the message without copying or disclosing
it. (*13POrtC*)

--- 

 

From: ozdotnet-boun...@ozdotnet.com [mailto:ozdotnet-boun...@ozdotnet.com]
On Behalf Of Craig van Nieuwkerk
Sent: Friday, 13 September 2013 2:50 PM
To: ozDotNet
Subject: Re: Code commenting

 

A lot of source control systems give you that out of the box. I know Git and
SVN both do with the BLAME command. I wouldn't want the comments scattered
throughout the code.

 

On Fri, Sep 13, 2013 at 2:45 PM, anthonyatsmall...@mail.com wrote:

Anyone suggest a method to autmaticlly comment code when lines have changed?
Would be great to be able to see who changed what when viewing the code.

 

At the moment,, we write comments like //xxMOD 12AUG13   XX=PROGRAMMER
INITIALS

 

WE use TFS but we like to write comments in code sometimes.  Any extensions
able to do this?

 

Anthony

Melbourne StuffUps.learn from others, share with others!

http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/



--
NOTICE : The information contained in this electronic mail message is
privileged and confidential, and is intended only for use of the addressee.
If you are not the intended recipient, you are hereby notified that any
disclosure, reproduction, distribution or other use of this communication is
strictly prohibited. 
If you have received this communication in error, please notify the sender
by reply transmission and delete the message without copying or disclosing
it. (*13POrtC*)

--- 

 

 



Re: Code commenting

2013-09-12 Thread Preet Sangha
Anthony, you're asking about some form of automated tool and seriously
you're not using the annotate function within TFS?






On 13 September 2013 16:55, anthonyatsmall...@mail.com wrote:

 I like to comment code and remove some of them after a while.  

 ** **

 Anthony

 Melbourne StuffUps…learn from others, share with others!

 http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/*
 ***



 --
 NOTICE : The information contained in this electronic mail message is
 privileged and confidential, and is intended only for use of the addressee.
 If you are not the intended recipient, you are hereby notified that any
 disclosure, reproduction, distribution or other use of this communication
 is strictly prohibited.
 If you have received this communication in error, please notify the sender
 by reply transmission and delete the message without copying or disclosing
 it. (*13POrtC*)

 ---
 

 ** **

 *From:* ozdotnet-boun...@ozdotnet.com [mailto:
 ozdotnet-boun...@ozdotnet.com] *On Behalf Of *Craig van Nieuwkerk
 *Sent:* Friday, 13 September 2013 2:50 PM
 *To:* ozDotNet
 *Subject:* Re: Code commenting

 ** **

 A lot of source control systems give you that out of the box. I know Git
 and SVN both do with the BLAME command. I wouldn't want the comments
 scattered throughout the code.

 ** **

 On Fri, Sep 13, 2013 at 2:45 PM, anthonyatsmall...@mail.com wrote:

 Anyone suggest a method to autmaticlly comment code when lines have
 changed?  Would be great to be able to see who changed what when viewing
 the code.

  

 At the moment,, we write comments like //xxMOD 12AUG13   XX=PROGRAMMER
 INITIALS

  

 WE use TFS but we like to write comments in code sometimes.  Any
 extensions able to do this?

  

 Anthony

 Melbourne StuffUps…learn from others, share with others!

 http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/*
 ***



 --
 NOTICE : The information contained in this electronic mail message is
 privileged and confidential, and is intended only for use of the addressee.
 If you are not the intended recipient, you are hereby notified that any
 disclosure, reproduction, distribution or other use of this communication
 is strictly prohibited.
 If you have received this communication in error, please notify the sender
 by reply transmission and delete the message without copying or disclosing
 it. (*13POrtC*)

 ---
 

  

 ** **




-- 
regards,
Preet, Overlooking the Ocean, Auckland


Re: Code commenting

2013-09-12 Thread Joseph Cooney
Annotate is the 'glass is half full' name for blame in TFS.
On 13 Sep 2013 14:50, Craig van Nieuwkerk crai...@gmail.com wrote:

 A lot of source control systems give you that out of the box. I know Git
 and SVN both do with the BLAME command. I wouldn't want the comments
 scattered throughout the code.


 On Fri, Sep 13, 2013 at 2:45 PM, anthonyatsmall...@mail.com wrote:

 Anyone suggest a method to autmaticlly comment code when lines have
 changed?  Would be great to be able to see who changed what when viewing
 the code.

 ** **

 At the moment,, we write comments like //xxMOD 12AUG13   XX=PROGRAMMER
 INITIALS

 ** **

 WE use TFS but we like to write comments in code sometimes.  Any
 extensions able to do this?

 ** **

 Anthony

 Melbourne StuffUps…learn from others, share with others!

 http://www.meetup.com/Melbourne-Ideas-Incubator-Stuffups-Failed-Startups/
 



 --
 NOTICE : The information contained in this electronic mail message is
 privileged and confidential, and is intended only for use of the addressee.
 If you are not the intended recipient, you are hereby notified that any
 disclosure, reproduction, distribution or other use of this communication
 is strictly prohibited.
 If you have received this communication in error, please notify the
 sender by reply transmission and delete the message without copying or
 disclosing it. (*13POrtC*)

 ---
 

 ** **