# *********************************************************************
# addrow.txt: help text
# Copyright (c) 2001,2002,2003 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; either version 2 of the License, or
# (at your option) any later version.
#
# 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: addrow.txt,v 1.3 2003/10/09 10:53:30 carlo Exp $

                       NoSQL operator: addrow

Appends a new empty record to a NoSQL table.

Usage: addrow [options]

Options:
    --input (-i) 'file'
      Read input from 'file' instead of STDIN.

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

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

    --no-header (-N)
      Remove header from output.

    --highlight (-H)
      The new row is filled with '#' characters, to help the user
      entering the new data without overriding the TAB delimiters.
      This option is used mostly by 'edittable'.

    --key (-K) 'string'
      Set the leftmost field to 'string' in the new row.
      Any NoSQL special characters in 'string' are
      automatically escaped.

    --prime (-p)
      Print only the table header and a new empty row on
      output.

    --conditional (-c)
      Append the new row only if the specified key value does
      not exist yet. Option '-K' is also required.

    --delete='string' (-d 'string')
      Set the second field value to 'string' in the newly
      created row. If 'string' is not specified it defaults to
      '..DEL..'. This behaviour is used by the 'update'
      operator.

