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 section could be named "variadic macros". [variadic = can take different number of arguments](https://en.wikipedia.org/wiki/Variadic_macro).