# *********************************************************************
#  Written by and copyright Carlo Strozzi <carlos@linux.it>.
#
#  filetolist.txt: help text
#  Copyright (C) 2001 Carlo Strozzi <carlos@linux.it>
# 
#  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.
#
# *********************************************************************

                      NoSQL operator: filetolist

Turns a file into a one-entry NoSQL list.
The file content is encoded on-the-fly in base64 format.

Usage: filetolist [options] column file

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

    --chomp (-c)
      Do not print the trailing newline. Used to produce a list
      that can be appended to.

    --chop (-C)
      Do not print the leading newline. Used to produce a list
      that is to be appended to another.

    --mime (-M) 'type charset'
      Prepend an extra entry to the output list, with proper MIME
      information that tells the receiving party how to handle
      the file contents. Both 'type' and 'charset' must be
      specified in one single command line argument through
      proper shell quoting. If either parameter is missing then
      the whole '--mime' directive is ignored. For instance:

      filetolist --mime "text/plain iso-8859-1" SomeLabel myfile.txt

Notes:

Apart from encoding into base64, the program makes no other change
to the file contents: not even charset conversion. The file name
is discarded during the conversion. The conversion process
increases the size of the data by about 30%.

$Id$
