9term, acme: autoscroll

Ignore scroll/noscroll window setting.
Instead, scroll when the write begins in
or immediately after the displayed window content.

In the new scrolling discipline, executing
"Noscroll" is replaced by typing Page Up or
using the mouse to scroll higher in the buffer,
and executing "Scroll" is replaced by typing End
or using the mouse to scroll to the bottom of
the buffer.

R=r, r2
http://codereview.appspot.com/4433060

4 files changed, 16 insertions, 25 deletions

diff --git a/man/man1/9term.1 b/man/man1/9term.1
index a9f687c2..33a5b05b 100644
--- a/man/man1/9term.1
+++ b/man/man1/9term.1
@@ -30,8 +30,9 @@ Otherwise button 2 brings up a menu, described below.
 .PP
 The
 .B -s
-option initializes the window so that text scrolls;
-the default is not to scroll.
+option has no effect.  It formerly set the scrolling mode,
+and is recognized to avoid breaking scripts that create new windows.
+See below for a description of scrolling behavior.
 .PP
 The
 .B -c
@@ -205,10 +206,9 @@ always treats the DEL keystroke as an interrupt request.
 In response it sends the terminal's current interrupt character
 (which need not be DEL).
 .PP
-Normally, written output to a window blocks when
-the text reaches the end of the screen and the terminal
-buffer fills;
-a button 2 menu item toggles scrolling.
+Written output to a window is appended to the end of the window.
+The window scrolls to display the new output only if the
+end of the window was visible before the write.
 .PP
 .I 9term
 changes behavior according to
diff --git a/man/man1/acme.1 b/man/man1/acme.1
index d08ff92a..2d24f331 100644
--- a/man/man1/acme.1
+++ b/man/man1/acme.1
@@ -646,13 +646,17 @@ window and runs a
 (default
 .BR $SHELL )
 in it, turning the window into something analogous to an
-.IR rio (1)
+.IR 9term (1)
 window.
 Executing text in a
 .I win
 window with button
 2 is similar to using
 .BR Send .
+.I Win
+windows follow the same scrolling heuristic as in
+.IR 9term (1):
+the window scrolls on output only if the window is displaying the end of the buffer.
 .PP
 .I Awd
 loads the tag line of its window with the directory in which it's running, suffixed
diff --git a/man/man1/rio.1 b/man/man1/rio.1
index 3c31b616..1fc0619d 100644
--- a/man/man1/rio.1
+++ b/man/man1/rio.1
@@ -73,13 +73,11 @@ and then to fall back to
 .IR xterm (1).
 The
 .B \-s
-option causes
-.I rio
-to add
-.B -s
-to
-.IR 9term 's
-command-line, starting the window in scrolling mode.
+option has no effect.  It formerly set the scrolling mode for
+new windows and is recognized to avoid breaking scripts.
+See
+.IR 9term (1)
+for a description of scrolling behavior.
 .PP
 The
 .B \-version
diff --git a/man/man4/acme.4 b/man/man4/acme.4
index 40cde759..78214cad 100644
--- a/man/man4/acme.4
+++ b/man/man4/acme.4
@@ -236,22 +236,11 @@ may be undone in a single
 .B Undo
 interactive command.
 .TP
-.B noscroll
-Turn off automatic `scrolling' of the window to show text written to the body.
-.TP
 .B put
 Equivalent to the
 .B Put
 interactive command with no arguments; accepts no arguments.
 .TP
-.B scroll
-Cancel a
-.B noscroll
-message, returning the window to the default state wherein each write
-to the
-.B body
-file causes the window to `scroll' to display the new text.
-.TP
 .B show
 Guarantee at least some of the selected text is visible on the display.
 .RE