warn about attempts to call non-callable macros;

inspired by a similar warning in the groff_mdoc(7) macros

1 files changed, 7 insertions, 0 deletions

diff --git a/mandoc.1 b/mandoc.1
index 51028fe9..cd1b206b 100644
--- a/mandoc.1
+++ b/mandoc.1
@@ -803,6 +803,13 @@ Probably, there are author names lacking markup.
 See the
 .Xr mdoc 7
 manual for replacements.
+.It Sy "macro neither callable nor escaped"
+.Pq mdoc
+The name of a macro that is not callable appears on a macro line.
+It is printed verbatim.
+If the intention is to call it, move it to its own line;
+otherwise, escape it by prepending
+.Sq \e& .
 .It Sy "skipping paragraph macro"
 In
 .Xr mdoc 7