# *********************************************************************
# envtotable.txt: help text
# Copyright (c) 1998,2006 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.
#
# *********************************************************************
# $Id: envtotable.txt,v 1.4 2006/03/10 11:26:13 carlo Exp $

                      NoSQL operator: envtotable

Convert environment variables into a NoSQL table.

Usage: envtotable [options]

Options:

    --match (-m) 'pattern'
      Process only those variables that match 'pattern'. If both '-d'
      and '-b' are specified, they can affect each other, in that '-d'
      is done before '-b'.

    --ignore (-I) 'pattern'
      This is the opposit of '-m', and if specified it overrides the
      latter.

    --help (-h)
      Display this help text.

    --delete (-d) 'pattern'
      Delete anything that matches 'pattern' in variable values. If both
      '-d' and '-b' are specified, they can affect each other, in that
      '-d' is done before '-b'.

    --blank (-b) 'pattern'
      Anything that matches 'pattern' in variable values is replaced
      with one single blank. If both '-d' and '-b' are specified, they
      can affect each other, in that '-d' is done before '-b'.

    --strip-names (-s) 'pattern'
      Strip anything that matches 'pattern' from variable names.

    --output (-o) 'file'
      Write output to 'file' instead of STDOUT.

    --no-header (-N)
      Strip the table header from output.

    --prefix (-p) 'string'
      Prefix each output column name with 'string'.

Notes:

In the option explanations above, the term 'pattern' refers
to a valid AWK regular expression, without surrounding slashes.

Environment variable names that do not match the AWK regular
expression /^[A-Za-z0-9_]+$/ are silently skipped.

