aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMattias Andrée <maandree@operamail.com>2015-11-28 13:39:20 +0100
committerMattias Andrée <maandree@operamail.com>2015-11-28 13:39:20 +0100
commit9398f4863bfe2116ba2ddd75cdb0cc8a65ef81fe (patch)
treeee53570ce0e11675063cd22fbf9f96c9d28fe89f
parenttypo (diff)
downloadgpp-9398f4863bfe2116ba2ddd75cdb0cc8a65ef81fe.tar.gz
gpp-9398f4863bfe2116ba2ddd75cdb0cc8a65ef81fe.tar.bz2
gpp-9398f4863bfe2116ba2ddd75cdb0cc8a65ef81fe.tar.xz
m info + improve readme
Signed-off-by: Mattias Andrée <maandree@operamail.com>
-rw-r--r--README101
-rw-r--r--info/gpp.texinfo16
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