From ce2bfb4d3a49a27bde7c8bbc6c6b1ef6f80054aa Mon Sep 17 00:00:00 2001
From: KatolaZ <katolaz@freaknet.org>
Date: Fri, 16 Aug 2019 23:43:24 +0100
Subject: add position marks (Ma/g'a)

---
 gramscii.1 | 48 ++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 38 insertions(+), 10 deletions(-)

(limited to 'gramscii.1')

diff --git a/gramscii.1 b/gramscii.1
index 3370c24..b130530 100644
--- a/gramscii.1
+++ b/gramscii.1
@@ -86,6 +86,17 @@ command).
 Load (edit) an existing file from disk, discarding any change to the
 current screen.
 .TP 5m
+.BI M a
+Mark (label) the current cursor position as 'a'. The label 'a' must be
+one of the 26 ASCII alphabetic characters. The cursor can be moved to a
+previously marked position using the global positioning command
+.B g
+(see below). Position marks are case-insensitive, meaning that both 
+.I 'c'
+and
+.I 'C'
+indicate the same mark.
+.TP 5m
 .BI N
 Start a new empty screen. If the current screen has been modified since
 the last
@@ -178,11 +189,13 @@ units at a time (defaults to 5, change LONG_STEP in config.h as you
 wish).
 .TP 5m
 .BI g
-Initiate a global positioning command (go). These are two-letter
-commands starting with a
+Initiate a global positioning command (go). These are two- or
+three-letter commands starting with a
 .BI g
-and followed by a direction command or by a character that indicates a
-global position, namely:
+and followed by a direction command, or by a character that indicates a
+global position, or by a valid position mark previously defined with 
+.B M
+and preceded by a single quote. In particular:
 .RS
 .TP 5m
 .BI h
@@ -205,9 +218,24 @@ move the cursor to the bottom-right corner of the screen
 .TP 5m
 .BI m
 move the cursor to the middle of the screen.
+.TP 5m
+.BI 'a
+(single-quote followed by a character) move the cursor to the position
+previously marked (labelled) with character
+.BI 'a'
+by the command
+.B M
+(mark). The character 'a' must be one of the 26 ASCII alphabetic
+characters. Notice that position marks are case-insensitive, so the two
+commands:
+.B g'b
+and
+.B g'B
+move the cursor to the position mark associated to the letter 'b', if it
+exists.
 .PP
-For instance, if you want to move the cursor to the first row of the
-current column, you would use the two-letter command 
+If you want to move the cursor to the first row of the current
+column, you could use the two-letter command 
 .B gk 
 (which can be read as "go-up"). Similarly, the command
 .B gh
@@ -227,13 +255,13 @@ is equivalent to
 ).
 .PP
 Global positioning commands are available in 
-.B box, arrow, visual,
+.B box, arrow, visual, parallelogram, 
 and 
 .B erase
 mode. Notice that
-.B gg, gG, 
-and 
-.B gm, 
+.B gg, gG, gm 
+and moves to position marks like
+.B g'b, 
 are not available in 
 .B arrow
 mode.
-- 
cgit v1.2.3