Paul wrote:

When you read man pages in Linux for example, it shows you as much doc
as can fit in the number of lines for the current shell window. If that
number of lines is 10, it shows you what can fit in 10 including the
indication that you can press a key to view more. If that number of
lines is 50, it shows you what can fit in 50 including the indication
that you can press a key to view more.
In JShell, for long docs, it always shows the same number of lines (at
least on Windows—i have not tried others yet). That means depending on
the user’s shell window number of lines, sometimes all the doc will be
shown, sometimes a portion will be shown and sometimes what’s show will
scroll by. It should not show more than what can be viewed in the
current number of lines on the screen.

In JShell, for long docs, it always shows the same number of lines (at
least on Windows—i have not tried others yet). That means depending on
the user’s shell window number of lines, sometimes all the doc will be
shown, sometimes a portion will be shown and sometimes what’s show will
scroll by. It should not show more than what can be viewed in the
current number of lines on the screen.

I just confirmed that it appears to work on mac as well, so this does look like a Windows command prompt specific issue.

Jan wrote:
The documentation in jshell should do paging as well (and is doing it for me on Linux). It might be that the detection of # of lines on Windows is broken, I will try after my winter break.