update readme with macro notes.