m info + improve readme

Signed-off-by: Mattias Andrée <maandree@operamail.com>

2 files changed, 112 insertions, 5 deletions

diff --git a/README b/README
index 61fbd1d..9f48b34 100644
--- a/README
+++ b/README
@@ -1,4 +1,101 @@
-General Perprocessor
+NAME
+	gpp - Bash-based preprocessor for anything
 
-Bash-based preprocessor for anything.
+	gpp: General Preprocessor
+
+SYNOPSIS
+	gpp [OPTION]...
+
+DESCRIPTION
+	gpp lets a developer embed directives written in GNU
+	Bash into any text document. These directives are used
+	to automate the writting of parts of the document.
+
+	The preprocessing directives start with a symbol
+	(or text string) specified by the developer. By default
+	this symbol is @ (at).
+
+	Any line starting with @< (where @ is the selected
+	symbol for preprocessing directives) or @>, or is
+	between a line starting with @< and a line starting
+	with @>, is parsed as a line, written in Bash, that
+	is executed during preprocessing.
+	A @< line must have an associated @> line somewhere
+	after it, all lines between them are parsed as
+	preprocessing directives. A @> does however not need
+	an associated @< line somewhere before it, making
+	@> suitable for single line directives.
+
+	Preprocessing directives can also be inline. For this,
+	use @(COMMAND) where COMMAND is the Bash code to run.
+	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.
+
+	Everything that is not preprocessing directives is
+	threaded as echo(1):ed lines.
+
+OPTIONS
+	-s, --symbol SYMBOL
+		Set the prefix symbol for preprocessor directives.
+		Defaults to @.
+
+	-e, --encoding ENCODING
+		Specifies the encoding of the file.
+
+	-n, --iterations N
+		The the processing N times. Defaults to 1 time.
+
+	-u, --unshebang
+		Clear the shebang line, remove it if this flag
+		is used twice. If used twice, an empty line
+		will be inserted after the new first line.
+
+	-i, --input FILE
+		Select file to process. Defaults to /dev/stdin.
+
+	-o, --output FILE
+		Select output file. Defaults to /dev/stdout.
+
+	-f, --file FILE
+		Equivalent to -i FILE -o FILE.
+
+	-D, --export NAME=VALUE
+		Set the environment variable NAME to hold
+		the value VALUE.
+
+	-D, --export NAME
+		Set the environment variable NAME to hold
+		the value 1.
+
+	-v, --verion
+		Print program name and version and exit.
+
+	-c, --copying
+		Print copyright notice and exit.
+
+	Short options must joined. The value of a flag must be
+	in a separate argument from the flag itself.
+
+RATIONALE
+	Programmers need more automation when we write software
+	and documentation. An unrestricted preprocessor lets
+	you automate just about anything. Of course, it can be
+	used for anything, must just writing software and
+	documentation. Preprocessing can be used for more than
+	automation, it can also be used to increase the flexibility
+	of the work.
+
+	C is one of the few languages that includes a preprocessor,
+	some times it is not enough; and all languages need
+	preprocessors.
+
+SEE ALSO
+	bash(1), jpp(1), cpp(1)
+
+	Full documentation available locally via: info '(gpp)'
 
diff --git a/info/gpp.texinfo b/info/gpp.texinfo
index c2991b3..fcc566a 100644
--- a/info/gpp.texinfo
+++ b/info/gpp.texinfo
@@ -110,7 +110,7 @@ Set the prefix symbol for preprocessor directives. (Default: @@)
 
 @item -e
 @itemx --encoding
-Set the encoding of file. (Default: UTF-8)
+Set the encoding of file.
 
 @item -n
 @itemx --iterations
@@ -119,8 +119,8 @@ Number of iterations to run the preprocessing in. (Default: 1)
 @item -u
 @itemx --unshebang
 Blank out the shebang line. Notice that the line is not removed,
-it is just cleared. You can use a shebang line make gpp preprocess
-the file when executed.
+it is just cleared. You can use a shebang line make to gpp
+preprocess the file when executed.
 
 If @option{--unshebang} is used twice, the second line in the
 file will be moved up to the top of the file and the initial
@@ -228,12 +228,22 @@ logged in as `twilight'
 Your are logged in as @@@{USER@}.
 @end example
 
+@noindent
 will after preprocessing say
 
 @example
 Your are logged in as twilight.
 @end example
 
+@noindent
+@command{gpp} supports all modifications to the
+result that Bash does. For example, if you want
+the value to be uppercased you can write
+
+@example
+Your are logged in as @@@{USER^^@}.
+@end example
+
 
 
 @node GNU Free Documentation License