diff --git a/doc/nano.1 b/doc/nano.1
index b835eb065011b5f936a891eb364379ba62d189b6..2394e9ac8333d2d89d376a9e4057e14955072a96 100644
--- a/doc/nano.1
+++ b/doc/nano.1
@@ -298,6 +298,10 @@ that is not immediately undone, earlier edits
 cannot be undone any more.  The workaround is, of course, to exit without
 saving.
 .sp
+The recording and playback of keyboard macros works correctly only on a
+terminal emulator, not on a Linux console (VT), because the latter is a
+deficient terminal.  And it works only with recent versions of ncurses.
+.sp
 Please report any other bugs that you encounter via:
 .br
 \fIhttps://savannah.gnu.org/bugs/?group=nano\fR.
diff --git a/doc/nano.texi b/doc/nano.texi
index aee414806b0922f309d321d12ac4ac20e76e96e1..93c40f681cdab4062ca96079e0c95afc360b291e 100644
--- a/doc/nano.texi
+++ b/doc/nano.texi
@@ -422,7 +422,7 @@ Ignored, for compatibility with Pico.
 * Screen Layout::
 * Search and Replace::
 * Using the Mouse::
-* Limitation::
+* Limitations::
 @end menu
 
 @node Entering Text
@@ -552,8 +552,8 @@ Shift key during those actions.
 The mouse will work in the X Window System, and on the console when gpm
 is running.
 
-@node Limitation
-@section Limitation
+@node Limitations
+@section Limitations
 
 Justifications (@kbd{^J})
 are not yet covered by the general undo system.  So after a justification
@@ -561,6 +561,9 @@ that is not immediately undone, earlier edits
 cannot be undone any more.  The workaround is, of course, to exit without
 saving.
 
+The recording and playback of keyboard macros works correctly only on a
+terminal emulator, not on a Linux console (VT), because the latter is a
+deficient terminal.  And it works only with recent versions of ncurses.
 
 @node Built-in Help
 @chapter Built-in Help