Add an explanatory note that would have saved me an hour or two
of confusion had it been there when I started reading the code..