From b91d57b505f560db25b66deff3bae80695c05703 Mon Sep 17 00:00:00 2001
From: Mattias Andrée <maandree@kth.se>
Date: Thu, 5 Aug 2021 00:10:46 +0200
Subject: Standardise @(( )), add -R option, and fix critical bug
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The bug was that if the code buffered was increased,
the new character that should have been pushed to it
was not pushed into the code buffer, leaving out some
characters before preprocessing takes place.

Signed-off-by: Mattias Andrée <maandree@kth.se>
---
 README | 27 ++++++++++++++++++---------
 1 file changed, 18 insertions(+), 9 deletions(-)

(limited to 'README')

diff --git a/README b/README
index 9d39bdf..8e7137f 100644
--- a/README
+++ b/README
@@ -3,7 +3,8 @@ NAME
 
 SYNOPSIS
 	gpp [-D name[=value]] [-f file | [-i input-file]
-	    [-o output-file]] [-n count] [-s symbol] [-u [-u]]
+	    [-o output-file]] [-n count] [-s symbol]
+	    [-R macroline-replacement-text] [-u [-u]]
 	    [shell [argument] ...]
 
 ETYMOLOGY
@@ -35,10 +36,13 @@ DESCRIPTION
 	Additionally, gpp supports variable substitution.
 	@{VARIABLE} will be replaces by the value if the
 	variable (possibility environment variable) VARIABLE.
-	gpp supports all modifiers thats Bash supports. For
-	example, if you want the value to be included but
-	uppercase you can write @{VARIABLE^^}, or @{VARIABLE,,}
-	for lowercase.
+	gpp supports all modifiers thats Bash (or which ever
+	shell is selected) supports. For example, if you want
+	the value to be included but uppercase you can write
+	@{VARIABLE^^}, or @{VARIABLE,,} for lowercase. gpp
+	also supports mathematical expressions that the via
+	the shells $((EXPRESSION)) syntax, by using
+	@((EXPRESSION)).
 
 	Everything that is not a preprocessing directive is
 	echo verbatim, except all @@ are replaced by @.
@@ -56,18 +60,23 @@ OPTIONS
 		Equivalent to -i FILE -o FILE.
 
 	-i input-file
-		Select file to process. Defaults to /dev/stdin.
+		Select file to process. Default value is /dev/stdin.
 
 	-n count
 		Process the file recursively count times.
-		Defaults to 1 time.
+		Default value is 1.
 
 	-o output-file
-		Select output file. Defaults to /dev/stdout.
+		Select output file. Defaults value is /dev/stdout.
+
+	-R macroline-replacement-text
+		Text to replace macrolines with in the output.
+		You may for example want to use % for TeX files.
+		Default value is the empty string.
 
 	-s symbol
 		Set the prefix symbol for preprocessor directives.
-		Defaults to @.
+		Default value is @.
 
 	-u
 		Clear the shebang line, remove it if this flag
-- 
cgit v1.2.3-70-g09d2