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

                      NoSQL operator: rndtable

Pick one or more records at random from a table.

Usage: rndtable [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.

    --lines (-L) 'N'
      Pick at most 'N' input records. By default only one
      input record is printed.

    --zero (-z)
      By default at least one record is selected. This option
      specifies that selecting no records is ok.

    --key (-K)
      Instead of printing complete records, just print their
      first (leftmost) field, supposedly the record key.
      This will save us a subsequent call to 'column' if all
      we need is to extract the record keys.

Notes:

Not many tests have been done to assess how uniform is the random
selection of input records.

