public function getExamples() {

		return array(
			'api.php?action=compare&fromrev=1&torev=2',
		);

}

I'm guessing we should just change it to

public function getExamples() {

		return array(
			'api.php?action=compare&fromrev=1&torev=2' => 'Does a diff between revid 1 and 2',
		);

}

Then we've just got to display it on the html dump, and via paraminfo

We know if the key is a number, we don't have a description, so we can allow fallback of no extra information for other stuff that hasn't been updated

r106439 does the core parts

Still all the documentations to update...

r106441 and r106521 I think cover the ones where descriptions are already available, and reformats them

Will log a new bug to actually do the rest of adding new example descriptions

reverted with r106879

Re-instated r107393