Update programmers manual to cover llvm::function_ref, and add a note to the