Document expected function signature in std.range.recurrence

Fixed: https://issues.dlang.org/show_bug.cgi?id=9535

Also, switch to ddoc's unittest to make sure code samples actually work!