NAME

recs-decollate

recs-decollate --help-all

Help from: --help-basic:
Usage: recs-decollate <args> [<files>]
   Decollate records of input (or records from <files>) into output records.

Arguments:
   --dldeaggregator ...                Specify a domain language aggregate. See "Domain Language Integration" below.
   --deaggregator|-d <deaggregators>   Colon separated list of aggregate field specifiers. See "Deaggregates" section below.
   --list-deaggregators                Bail and output a list of deaggregators.
   --show-deaggregator <deaggregator>  Bail and output this deaggregator's detailed usage.
   --filename-key|fk <keyspec>         Add a key with the source filename (if no filename is applicable will put NONE)

  Help Options:
      --help-all             Output all help for this script
      --help                 This help screen
      --help-deaggregators   List the deaggregators
      --help-domainlanguage  Help on the recs domain language, a [very complicated] way of specifying valuations (which act like keys) or aggregators

Deaggregates:
   Deaggregates are specified as <deaggregator>[,<arguments>]. See --list-deaggregators for a list of available deaggregators.

   In general, key name arguments to deaggregators may be key specs, but not key groups

Domain Lanuage Integration:
   __FORMAT_TEXT__ The normal mechanism for specifying keys and aggregators allows one to concisely instantiate the objects that back them in the platform and is certainly the easiest way to use recs. The record stream domain language
   allows the creation of these objects in a programmatic way, with neither the syntactic issues of the normal way nor its guiding hand.

   The domain language is itself just PERL with a collection of library functions for creating platform objects included. Your favorite aggregators are all here with constructors matching their normal token. For convenience of e.g.
   last, aggregators are also included with a prefixed underscore.

   Below you can find documentation on all the "built in" functions. Most aggregators and deaggregators should be present with arguments comparable to their normal instantiation arugments, but with keyspec parameters replaced with
   valuations parameters.

   Deaggregates may be specified using the recs domain language.
   --dldeaggregator requires the code evaluate as a deaggregator.

   See --help-domainlanguage for a more complete description of its workings
   and a list of available functions.

   See the examples below for a more gentle introduction.

Help from: --help-deaggregators:
split: split the provided field
unarray: split the provided array
unhash: split the provided hash

See Also

RecordStream(3) - Overview of the scripts and the system
recs-examples(3) - A set of simple recs examples
recs-story(3) - A humorous introduction to RecordStream
SCRIPT --help - every script has a --help option, like the output above