Text Compare

Where a diff earns its keep

The moment you have two versions of anything and a suspicion that they differ, a diff saves you from reading both in full. A contract comes back from the other side's lawyers with the assurance that they have made 'a few small changes'; a diff shows you in seconds that clause fourteen has quietly acquired a new sentence. A configuration file that worked yesterday does not work today, and comparing it against the backup finds the one changed value. A colleague sends a revised draft with no track changes; a diff reconstructs what they actually did. In every case the value is the same: the differences are a tiny fraction of the text, and a diff shows you only those, instead of asking you to hold two documents in your head at once.

Reading a diff properly

A line-based diff has one systematic blind spot worth knowing about. Because it works a line at a time, changing a single character on a long line marks that entire line as changed — the diff will tell you the line differs but not that only one word within it moved. Conversely, adding a single line break can make many subsequent lines appear to have shifted, producing an alarming-looking diff for a trivial edit. And a diff shows you what changed, never why: it will faithfully report that a number went from 30 to 300 without any opinion about whether that was a deliberate decision or a catastrophic typo. The tool narrows your attention to the right places; judging what you find there is still your job.