News for hackers. Stuff that matters.
Re:Types of Comments to Avoid Making when Programming by pvg on Saturday July 24, 2010 @08:12PM (#1544662)
Hard to tell without context but these read very much version control commit messages, an audit trail nicely maintained by a VCS, along with the code it refers to. I think the main reason you see those sort of 'history of the world' comments is force of habit and the more cumbersome operation of older VC systems.
Re:Types of Comments to Avoid Making when Programming by Poiesis on Sunday July 25, 2010 @12:51AM (#1544996)
Unfortunately, companies do occasionally change version control systems. History also tends to get lost when the codebase of one project is imported as the beginning of another.
Re:Types of Comments to Avoid Making when Programming by pvg on Sunday July 25, 2010 @09:38AM (#1545521)
I don't think 'history tends to get lost'. It happens, both intentionally and unintentionally but preservation of history is a big, often deciding factor in such a switch.

These types of comments are common, I think, not so much because it's so hard to migrate history but because the VCS in use doesn't have facilities for cheap local commit and there's no immediate local history. The workaround is to place important version-change information straight in the source. Which is perfectly sensible in those circumstances, I just disagree with the OP's idea that this is somehow a desirable or best practice.

Re:Types of Comments to Avoid Making when Programming by ondrasej on Sunday July 25, 2010 @04:02AM (#1545182)
However, the current version control systems usually have compatibility layers and/or import tools.

We have a project that started wih CVS, then moved to SVN and now runs on Hg, and we have the complete commit log (including commits from the CVS and SVN days) in the current repository.

Re:Types of Comments to Avoid Making when Programming by brown9-2 on Sunday July 25, 2010 @10:35AM (#1545600)
If you treat the source code history as an essential artifact of the development process, and a piece of the product's history (which it is), then it is complete foolishness to switch systems without bringing the history over.