* Overview

Xenv is a text preprocessor.  It reads input from files (or the
standard input, if none are supplied) and prints it on the standard
output, replacing references to environment variables with their actual
values.

Variables are referenced using POSIX-compatible shell syntax: $NAME,
${NAME}, ${NAME:-word}, ${NAME+=word}, ${NAME:=word}, ${NAME:?word}.

A special ternary construct is provided: ${NAME:|word1|word2}, which
substitutes the expansion of word1 if NAME is set and the expansion of
word2 otherwise.

Conditional preprocessor statements are provided, that allow parts of
input to be excluded depending on whether a variable is set.

For a detailed discussion, please see the accompanying man page
xenv(1).  An online copy is available at http://man.gnu.org.ua/1/xenv.

* Bug reports

Send bug reports and suggestions to <gray@gnu.org>.  Be sure to
mention "xenv" somewhere in the Subject line.

* Compiling

To compile the program, run `make'.  To test it, run
`make check'.  To install it, run `make install'.  The following make
variables control where it will be installed:

** PREFIX
  Installation prefix.
  Defaults to /usr/local.

** BINDIR
  Directory to install the xenv binary to.
  Defaults to $(PREFIX)/bin

** MANDIR
  Root directory for manpage hierarchy.
  Defaults to $(PREFIX)/share/man

** MAN1DIR
  Directory for section 1 manpages.
  Defaults to $(MANDIR)/man1

For example, to install the package under /usr, use

  make install PREFIX=/usr

See the Makefile for a deeper insight.

* Building from git sources

If you have cloned the package from git, you will need the following
tools to build it:

** Flex
** A C compiler
** GNU make
** autoconf

* Downloading

Xenv can be downloaded from

  http://download.gnu.org.ua/release/xenv


* Copyright information:

Copyright (C) 2021 Sergey Poznyakoff

   Permission is granted to anyone to make or distribute verbatim copies
   of this document as received, in any medium, provided that the
   copyright notice and this permission notice are preserved,
   thus giving the recipient permission to redistribute in turn.

   Permission is granted to distribute modified versions
   of this document, or of portions of it,
   under the above conditions, provided also that they
   carry prominent notices stating who last changed them.


Local Variables:
mode: outline
paragraph-separate: "[ 	]*$"
version-control: never
End:
