Expand macro section on repetition operators and syntax.

This is to give more details on how macro repetition works and to address https://github.com/japaric/rust-by-example/issues/110#issuecomment-48104754.
This is not quite right, `macro_rules` defines *macros*, not functions