style message about missing blank before trailing delimiter;

inspired by mdoclint(1), and jmc@ considers it useful

1 files changed, 5 insertions, 0 deletions

diff --git a/mandoc.1 b/mandoc.1
index d7cc0f72..a2ca109b 100644
--- a/mandoc.1
+++ b/mandoc.1
@@ -798,6 +798,11 @@ number.
 Do not use punctuation at the end of an
 .Ic \&Nd
 block.
+.It Sy "no blank before trailing delimiter"
+The last argument of a macro that supports trailing delimiter
+arguments is longer than one byte and ends with a trailing delimiter.
+Consider inserting a blank such that the delimiter becomes a separate
+argument, thus moving it out of the scope of the macro.
 .El
 .Ss Warnings related to the document prologue
 .Bl -ohang