# *********************************************************************
# csa-tbl2rdf.txt: help text
#
# Copyright (c) 2003,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: csa-tbl2rdf.txt 43 2007-09-24 08:30:21Z carlo $

                      CSA operator: csa-tbl2rdf

Takes a NoSQL table and turns it into a proper RDF definitions.

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

    --trim (-t)
      Strip leading and trailing blanks from each input field
      name and field value.

    --last (-l)
      If the input table contains duplicated column names pick
      the last occurrence of each. The default is to pick the
      first one.

    --call (-c)
      Output RDF is to be used as a CSA-RPC call payload as
      opposed to the default response payload.

    --count (-C) 'n'
      Use 'n' as the start argument index in output, as opposed
      to the default '1'.

Notes:

This program tries to auto-detect the datatype of the input data. The
auto-detection code handles "double", "int", "string" and one special
case of "dateTime". The latter test, is trivial and may fail in some
cases. The program has no way to distinguish a numeric "boolean" type
from an integer, so the latter type is used in either case. Furthermore,
datatypes are referred to each single piece of data, as this program has
no notion of "table column", in the sense of an entity that spans scross
multiple rows with a uniform tipification.

If the input table contains no data, than nothing is printed. If the
input data contains XML special characters <&"' they are encoded into
the corresponding predefined entity references &lt; &amp; &quot; and
&apos; respectively.

The output produced by this program requires a CDATA-type output template.

