======================================================================

runawk: small wrapper for AWK interpreter that impements modules system and helps one to write the standalone AWK programs.

author: Aleksey Cheusov vle@gmx.net

project's home page: http://sourceforge.net/projects/runawk

licence: MIT license

======================================================================

                          MOTIVATION

See section MOTIVATION of runawk.1 or runawk.pod.

======================================================================

                       INSTALLATION

See INSTALL file.

======================================================================

                       MODULES

RunAWK provides lots of AWK modules ready for use. All of them are under modules/ subdirectory. They are installed by default.

abort.awk,  alt_assert.awk
                 - power abort() and assert()
alt_join.awk     - join :-)
braceexpand.awk  - awk equivalent to shell's braceexpand functionality
basename.awk, dirname.awk
                 - equivalents to basename(1) and dirname(1)
embed_str.awk    - reads strings from AWK code
exitnow.awk      -
has_prefix.awk, has_suffix.awk
                 - trivial string functions
match_br.awk     - find pair closed brackets in a string
max.awk, min.awk, isnum.awk, abs.awk
                 - trivial math functions
modinfo.awk      - routines to get an information about modules that
                   are in use
multisub.awk     - another replacement functions
pow.awk          - synonym for ^
init_getopt.awk, alt_getopt.awk, power_getopt.awk
                 - POSIX/SUS compatible routines
                   for handling options EASILY ;-)
readfile.awk     - read an entire file into variable
runcmd.awk       - safe wrapper over system()
shquote.awk      - escapes shell's special characters
heapsort.awk, quicksort.awk, sort.awk
                 - sorting functions
str2regexp.awk   - string to regexp routines
tokenre.awk      - alternative mechanism for separating input into tokens
xclose.awk, xgetline.awk, xsystem.awk
                 - functions to write robust programs
tmpfile.awk      - generates names of automatically deleted tempfiles
fieldwidths.awk  - portable equivalent of GNU awk's FIELDWIDTHS ;-)
CR_in.awk        - removes CR symbols from input lines.
trim.awk         - functions for trimming spaces from the string.
trim_in.awk      - trims spaces from input lines.
backslash_in.awk - treats backslash symbol at the end of line as
                   "this line will continue on the next one".
ini.awk          - functions for reading Win .ini files.
ftrans_in.awk    - handle data file transitions
ord.awk          - character to id and id to character convertors

======================================================================

                       SCRIPTS

RunAWK also provides a few scripts:

alt_getopt - program arguments parser aware of long options, alternative to POSIX getopts and getopt(1). In addition to alt_getopt(1) utility alt_getopt.sh shell library is also provided that provides an alternative way for handling options. alt_getopt.sh - shell library functionally equivalent to alt_getopt(1)

======================================================================

                       EXAMPLES

Lots of examples are available in examples/ subdirectory.