From 205161a025d4a955f79fdf3844a42c2c0da20e67 Mon Sep 17 00:00:00 2001
From: KatolaZ <katolaz@freaknet.org>
Date: Fri, 9 Aug 2019 07:08:59 +0100
Subject: document read-at-point and re-organise options in manpage

---
 gramscii.1 | 64 ++++++++++++++++++++++++++++++++++----------------------------
 1 file changed, 35 insertions(+), 29 deletions(-)

diff --git a/gramscii.1 b/gramscii.1
index 96dfb47..22e8074 100644
--- a/gramscii.1
+++ b/gramscii.1
@@ -69,20 +69,52 @@ General commands available in
 .B move
 mode:
 .TP 5m
-.BI R
-Redraw the screen
-.TP 5m
 .BI C
 Crop chart to the largest non-blank region. The first line and the first
 column of the cropped chart will contain the first non-blank line and
 the first non-blank column of the original chart, respectively.
 .TP 5m
+.BI e
+Load (edit) an existing file from disk. gramscii asks the user if they
+want to save the current screen (only if the screen has been modified
+since the
+last 
+.BI w
+command).
+.TP 5m
+.BI E
+Load (edit) an existing file from disk, discarding any change to the
+current screen.
+.TP 5m
+.BI N
+Start a new empty screen. If the current screen has been modified since
+the last
+.BI w
+command, gramscii will ask the user if they want to save the current
+screen before creating a new one.
+.TP 5m
 .BI p
 Paste the content of the yank buffer at the cursor position. The yank
 buffer contains the rectangle yanked/cut in
 .B visual
 mode. 
 .TP 5m
+.BI q
+Quit gramscii, and prompt for a filename if the current screen contains
+unsaved changes.
+.TP 5m
+.BI Q
+Quit gramscii and discard any change to the current screen.
+.TP 5m
+.BI r
+Read a file at the current cursor position. gramscii will prompt for the
+name of the file to read. If the first non-blank character of the name
+given is a '!', gramscii will run the command specified after '!' in a
+shell, and will import its standard output. 
+.TP 5m
+.BI R
+Redraw the screen
+.TP 5m
 .BI u
 Undo the last change. gramscii supports an undo history of indefinite
 length. The command 
@@ -103,13 +135,6 @@ moves to the following change, if possible. For instance, the sequence
 will go back two changes, and then forward one, effectively resetting
 the state of the screen to what it was before the last change occurred.
 .TP 5m
-.BI q
-Quit gramscii, and prompt for a filename if the current screen contains
-unsaved changes.
-.TP 5m
-.BI Q
-Quit gramscii and discard any change to the current screen.
-.TP 5m
 .BI w
 Write the current screen to a file. If the current screen has already
 been associated to a file, use the same filename. Otherwise, the user is
@@ -119,25 +144,6 @@ prompted for a filename to save the screen to.
 Write the current screen to a new file. This commands acts like
 .B w
 but always prompts for a file name to use. 
-.TP 5m
-.BI e
-Load (edit) an existing file from disk. gramscii asks the user if they
-want to save the current screen (only if the screen has been modified
-since the
-last 
-.BI w
-command).
-.TP 5m
-.BI E
-Load (edit) an existing file from disk, discarding any change to the
-current screen.
-.TP 5m
-.BI N
-Start a new empty screen. If the current screen has been modified since
-the last
-.BI w
-command, gramscii will ask the user if they want to save the current
-screen before creating a new one.
    
 .SS MOVEMENTS
 The following movement commands are available in any mode where cursor
-- 
cgit v1.2.3