aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMattias Andrée <maandree@operamail.com>2015-11-28 14:10:09 +0100
committerMattias Andrée <maandree@operamail.com>2015-11-28 14:10:13 +0100
commita81ce983d6c340d323ffc032d92131ebc6d11484 (patch)
tree8a671abef4d7b4262bf49c9dbc86d95ddb925ab5
parentimprove makefile and file structure (diff)
downloadgpp-a81ce983d6c340d323ffc032d92131ebc6d11484.tar.gz
gpp-a81ce983d6c340d323ffc032d92131ebc6d11484.tar.bz2
gpp-a81ce983d6c340d323ffc032d92131ebc6d11484.tar.xz
add manpage
Signed-off-by: Mattias Andrée <maandree@operamail.com>
-rw-r--r--Makefile16
-rw-r--r--README2
-rw-r--r--doc/man/gpp.1134
3 files changed, 146 insertions, 6 deletions
diff --git a/Makefile b/Makefile
index b89863c..8ab3ca5 100644
--- a/Makefile
+++ b/Makefile
@@ -81,7 +81,7 @@ obj/fdl.texinfo: doc/info/fdl.texinfo
.PHONY: install
-install: install-core install-info
+install: install-core install-info install-man
.PHONY: install
install-all: install-core install-doc
@@ -100,7 +100,7 @@ install-license:
install -m644 COPYING LICENSE -- "$(DESTDIR)$(LICENSEDIR)/$(PKGNAME)"
.PHONY: install-doc
-install-doc: install-info install-pdf install-dvi install-ps
+install-doc: install-info install-pdf install-dvi install-ps install-man
.PHONY: install-info
install-info: bin/gpp.info
@@ -110,17 +110,22 @@ install-info: bin/gpp.info
.PHONY: install-pdf
install-pdf: bin/gpp.pdf
install -dm755 -- "$(DESTDIR)$(DOCDIR)"
- install -m644 -- "$<" "$(DESTDIR)$(DOCDIR)/$(PKGNAME).pdf"
+ install -m644 $< -- "$(DESTDIR)$(DOCDIR)/$(PKGNAME).pdf"
.PHONY: install-dvi
install-dvi: bin/gpp.dvi
install -dm755 -- "$(DESTDIR)$(DOCDIR)"
- install -m644 -- "$<" "$(DESTDIR)$(DOCDIR)/$(PKGNAME).dvi"
+ install -m644 $< -- "$(DESTDIR)$(DOCDIR)/$(PKGNAME).dvi"
.PHONY: install-ps
install-ps: bin/gpp.ps
install -dm755 -- "$(DESTDIR)$(DOCDIR)"
- install -m644 -- "$<" "$(DESTDIR)$(DOCDIR)/$(PKGNAME).ps"
+ install -m644 $< -- "$(DESTDIR)$(DOCDIR)/$(PKGNAME).ps"
+
+.PHONY: install-man
+install-man: doc/man/gpp.1
+ install -dm755 -- "$(DESTDIR)$(MAN1DIR)"
+ install -m644 $< -- "$(DESTDIR)$(MAN1DIR)/$(COMMAND).1"
@@ -134,6 +139,7 @@ uninstall:
-rm -- "$(DESTDIR)$(DOCDIR)/$(PKGNAME).pdf"
-rm -- "$(DESTDIR)$(DOCDIR)/$(PKGNAME).dvi"
-rm -- "$(DESTDIR)$(DOCDIR)/$(PKGNAME).ps"
+ -rm -- "$(DESTDIR)$(MAN1DIR)/$(COMMAND).1"
diff --git a/README b/README
index 45021dc..055d4df 100644
--- a/README
+++ b/README
@@ -72,7 +72,7 @@ OPTIONS
Set the environment variable NAME to hold
the value 1.
- -v, --verion
+ -v, --version
Print program name and version and exit.
-c, --copying
diff --git a/doc/man/gpp.1 b/doc/man/gpp.1
new file mode 100644
index 0000000..275a15e
--- /dev/null
+++ b/doc/man/gpp.1
@@ -0,0 +1,134 @@
+.TH GPP 1 GPP
+.SH NAME
+gpp - Bash-based preprocessor for anything
+.PP
+gpp: General Preprocessor
+.SH SYNOPSIS
+.BR gpp
+.RI [ OPTION ]...
+.SH DESCRIPTION
+.B gpp
+lets a developer embed directives written in
+.B GNU Bash
+into any text document. These directives are used
+to automate the writting of parts of the document.
+.PP
+The preprocessing directives start with a symbol (or
+text string) specified by the developer. By default
+this symbol is \fB@\fP (at).
+.PP
+Any line starting with \fB@<\fP (where \fB@\fP is
+the selected symbol for preprocessing directives)
+or \fB@>\fP, or is between a line starting with
+\fB@<\fP and a line starting with \fB@>\fP, is parsed
+as a line, written in
+.BR bash (1),
+that is executed during preprocessing. A \fB@<\fP
+line must have an associated \fB@>\fP line somewhere
+after it, all lines between them are parsed as
+preprocessing directives. A \fB@>\fP does however
+not need an associated \fB@<\fP line somewhere before
+it, making \fB@>\fP suitable for single line directives.
+.PP
+Preprocessing directives can also be inline. For this,
+use
+.BI @( COMMAND )
+where
+.I COMMAND
+is the
+.BR bash (1)
+code to run. Additionally,
+.B gpp
+supports variable substitution.
+.BI @{ VARIABLE }
+will be replaces by the value if the variable
+(possibility environment variable)
+.IR VARIABLE .
+.B gpp
+supports all modifiers that
+.BR bash (1)
+supports. For example, if you want the value to be
+included but uppercase you can write
+.BR @{ \fIVARIABLE\fP ^^} ,
+or
+.BI @{ VARIABLE ,,}
+for lowercase.
+.PP
+Everything that is not preprocessing directives is
+threaded as
+.BR echo (1):ed
+lines.
+.SH OPTIONS
+.TP
+.BR \-s ,\ \-\-symbol \ \fISYMBOL\fP
+Set the prefix symbol for preprocessor directives.
+Defaults to @ (at).
+.TP
+.BR \-e ,\ \-\-encoding \ \fIENCODING\fP
+Specifies the encoding of the file.
+.TP
+.BR \-n ,\ \-\-iterations \ \fIN\fP
+The the processing \fIN\fP times. Defaults to 1 time.
+.TP
+.BR \-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.
+.TP
+.BR \-i ,\ \-\-input \ \fIFILE\fP
+Select file to process. Defaults to /dev/stdin.
+.TP
+.BR \-o ,\ \-\-output \ \fIFILE\fP
+Select output file. Defaults to /dev/stdout.
+.TP
+.BR \-f ,\ \-\-file \ \fIFILE\fP
+Equivalent to \-i \fIFILE\fP \-o \fIFILE\fP.
+.TP
+.BR \-D ,\ \-\-export \ \fINAME\fP=\fIVALUE\fP
+Set the environment variable \fINAME\fP to hold
+the value \fIVALUE\fP.
+.TP
+.BR \-D ,\ \-\-export \ \fINAME\fP
+Set the environment variable \fINAME\fP to hold
+the value 1.
+.TP
+.BR \-v ,\ \-\-version
+Print program name and version and exit.
+.TP
+.BR \-c ,\ \-\-copying
+Print copyright notice and exit.
+.PP
+Short options must be joined. The value of a flag must
+be in a separate argument from the flag itself.
+.SH 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.
+.PP
+C is one of the few languages that includes a preprocessor,
+some times it is not enough; and all languages need
+preprocessors.
+.SH "SEE ALSO"
+.BR bash (1),
+.BR jpp (1),
+.BR cpp (1)
+.PP
+Full documentation available locally via: info \(aq(gpp)\(aq
+.SH AUTHORS
+Principal author, Mattias Andrée. See the COPYING file for the full
+list of authors.
+.SH LICENSE
+Copyright \(co 2013, 2014, 2015 Mattias Andrée
+.br
+License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
+.br
+This is free software: you are free to change and redistribute it.
+.br
+There is NO WARRANTY, to the extent permitted by law.
+.SH BUGS
+Please report bugs to https://github.com/maandree/passcheck/issues or to
+maandree@member.fsf.org