NAME

gffprint - Print Gff structures

SYNOPSIS

gffprint --help

DESCRIPTION

gffprint prints gff structures to human readable or machine editable format. The output of the gffprint can be converted back to gff by using gffencode(1) (you most likely need to use -t and -b options).

filename is read in and selected fields are printed out from it. The output is normally prefixed with the label (unless -l is given), and it can be prefixed with filename (if -f is given), or basefilename (if -b is given). If -t is given then also the internal type information is printed (this is needed in case of the output needs to be converted back to gff).

OPTIONS

--help -h: Prints out the usage information.
--version -V: Prints out the version information.
--verbose -v: Enables the verbose prints. This option can be given multiple times, and each time it enables more verbose prints.
--config config-file: All options given by the command line can also be given in the configuration file. This option is used to read another configuration file in addition to the default configuration file.
--print-types -t: Print also the gff specific type information. This option is needed in case the output of gffprint is wanted to convert back to the gff using gffencode(1).
--print-filename -f: Prefix the output with the full file name.
--print-basename -b: Prefix the output with the base filename, i.e. the file name where the path component is removed.
--print-code -c: Print out the gff as a perl code.
--exclude -e exclude-regexp: Exclude the given regexp when reading the data in. This will skip the whole structure behind the given structure, meaning that --include cannot be used to get parts of that back. This can be used to speed up the processing if only specific parts of the tree is required. Normally this should be something like ^/Creature List meaning that all creature list information is skipped when reading gff.
--include -i include-regexp: Only include the given regexp when reading the data in. This will skip all other structures which do not match the regexp. This can be used to speed up the processing if only specific parts of the tree is required. Normally this should be something like ^/Creature List meaning that only creature list information is read in.
--exclude-field exclude-regexp: Exclude given fields to be read in in case their labels match the given regexp. This only matches the end labels, not intermediate structure labels.
--include-field include-regexp: Only include given fields matching the given regexp to the structures. This only matches the end labels, not intermediate structure labels.
--no-labels -l: Do not print the labels for each field, only print the value (and the file name if requested)
--separator -s separator: Use the given string as a separator between the label and value instead of default :\t.
--skip-empty -S: Skip all empty fields from the output.
--dialog -d filename.tlk: Pointer to the tlk file. If given then it is used to convert string references to strings in case there is no strings in the item item itself.

EXAMPLES

    gffprint cereaadminbuildi.git
    gffprint -b cereaadminbuildi.git
    gffprint -b -t cereaadminbuildi.git | sed 's/foo/bar/g' | gffencode -f

FILES

~/.gffprintrc: Default configuration file.

AUTHOR

Tero Kivinen <kivinen@iki.fi>.

HISTORY

This program originally appeared as gffparse, which mostly was a test program for the GffRead(3) library. It was renamed to gffprint(1) after the test program came large enough.