diff --git a/gas/doc/as-all.texinfo b/gas/doc/as-all.texinfo
index f25eb61da0e..930f5dd5c01 100644
--- a/gas/doc/as-all.texinfo
+++ b/gas/doc/as-all.texinfo
@@ -4709,7 +4709,8 @@ Immediate data @var{xx}.
 @cindex Z8000 directives
 @cindex directives, Z8000
 The Z8000 port of as includes these additional assembler directives,
-for compatibility with other Z8000 assemblers:
+for compatibility with other Z8000 assemblers.  As shown, these do not
+begin with @samp{.} (unlike the ordinary as directives).
 
 @table @code
 @item segm
diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo
index 90264be17a3..e95f934af91 100644
--- a/gas/doc/as.texinfo
+++ b/gas/doc/as.texinfo
@@ -5369,7 +5369,8 @@ _CHAPSEC__(1+_GENERIC__) Assembler Directives for the Z8000
 @cindex Z8000 directives
 @cindex directives, Z8000
 The Z8000 port of _AS__ includes these additional assembler directives,
-for compatibility with other Z8000 assemblers:
+for compatibility with other Z8000 assemblers.  As shown, these do not
+begin with @samp{.} (unlike the ordinary _AS__ directives).
 
 @table @code
 @item segm