make macro implementation notes consistent