From 9184e1a55b60d3044e19c3a7896e55ba629219ea Mon Sep 17 00:00:00 2001
From: John MacFarlane <jgm@berkeley.edu>
Date: Sun, 14 Jan 2018 16:05:13 -0800
Subject: [PATCH] Clarified `latex_macros` extension.

---
 MANUAL.txt | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/MANUAL.txt b/MANUAL.txt
index bedc6ae62..a615731bc 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -3388,14 +3388,17 @@ all output formats, not just LaTeX:
 
     $\tuple{a, b, c}$
 
-In LaTeX output, the macro definitions will not be passed
-through as raw LaTeX.
+Note that LaTeX macros will not be applied if they occur
+inside inside a raw span or block marked with the
+[`raw_attribute` extension](#extension-raw_attribute).
 
-When `latex_macros` is disabled, the macro definitions will
-be passed through as raw LaTeX, and the raw LaTeX and math will
+When `latex_macros` is disabled, the raw LaTeX and math will
 not have macros applied. This is usually a better approach when
 you are targeting LaTeX or PDF.
 
+Whether or not `latex_macros` is enabled, the macro definitions
+will still be passed through as raw LaTeX.
+
 Links
 -----