# *********************************************************************
# compute.txt: help text
#
# Copyright (c) 2001,2007 Carlo Strozzi
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 2 dated June, 1991.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
#
# *********************************************************************

                      NoSQL operator: compute

Applies arbitrary AWK expressions to table data, using column names.

Usage: compute [options] [--] expression

Options:

    -i 'file'
      Read input from 'file' instead of STDIN.

    -h
      Display this help text.

    -N
      Remove header from output.

    -p
      Display the resulting AWK program instead of running it.


Notes:

This program is meant to be used interactively at the command-line,
where speed does not matter much. Programs and scripts should 
preferably use 'awktable' and the relevant native syntax.

The following names are reserved to the AWK language, and should not
be used to indicate column names:

BEGIN, END, break, continue, else, exit, exp, for, getline, if, in,
index, int, length, log, next, print, printf, split, sprintf, sqrt,
substr, while, and possibly others. See awk(1) for more on this.
Furthermore, the '_nosql_' prefix is reserved for internal NoSQL use,
and should never be used at the beginning of column names.

This NoSQL operator reads a table from STDIN and writes a
table to STDOUT.

