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.
Updated. Put a complete list of designators below.