as reported on the dev mailing list by António Menezes Leitao
suite to make sure the example code in the manual doesn't get stale)