Fix http URLs and improve comments.

Signed-off-by: Daira Hopwood <daira@jacaranda.org>