Codegen: proper docstrings for "friendly" codegen, routine

Also added examples to routine.
Codegen: docstring updates.

Lines to 75 chars, follow numpy style.
Codegen: clean-up docstrings, slightly simplify Arguments

Some FIXMEs in there.
Codegen: tests use the new routine() helper