vislcg31

Usage

Overview

vislcg3 is the grammar parser and disambiguator in the VISL constraint grammar system. It chooses between different analyses (or "readings") of a word delivered by a morphological analyser based on a set of grammatical rules.

By default, vislcg3 reads input from stdin and writes output to stdout.

Options

-h, --help

shows this help

-?, --?

shows this help

-V, --version

prints copyright and version information

-g, --grammar

specifies the grammar file to use for disambiguation

--grammar-out

writes the compiled grammar in textual form to a file

--grammar-bin

writes the compiled grammar in binary form to a file

--grammar-only

only compiles the grammar; implies --verbose

--ordered

(will in future allow full ordered matching)

-u, --unsafe

allows the removal of all readings in a cohort, even the last one

-s, --sections

number or ranges of sections to run; defaults to all sections

--rules

number or ranges of rules to run; defaults to all rules

--rule

a name or number of a single rule to run

-d, --debug

enables debug output (very noisy)

-v, --verbose

increases verbosity

-2, --vislcg-compat

enables compatibility mode for older CG-2 and vislcg grammars

-I, --stdin

file to read input from instead of stdin

-O, --stdout

file to print output to instead of stdout

-E, --stderr

file to print errors to instead of stderr

-C, --codepage-all

codepage to use for grammar, input, and output streams; defaults to UTF-8

--codepage-grammar

codepage to use for grammar; overrides --codepage-all

--codepage-input

codepage to use for input; overrides --codepage-all

--codepage-output

codepage to use for output and errors; overrides --codepage-all

-L, --locale-all

locale to use for grammar, input, and output streams; defaults to en_US_POSIX

--locale-grammar

locale to use for grammar; overrides --locale-all

--locale-input

locale to use for input; overrides --locale-all

--locale-output

locale to use for output and errors; overrides --locale-all

--no-mappings

disables all MAP, ADD, and REPLACE rules

--no-corrections

disables all SUBSTITUTE and APPEND rules

--no-before-sections

disables all rules in BEFORE-SECTIONS parts

--no-sections

disables all rules in SECTION parts

--no-after-sections

disables all rules in AFTER-SECTIONS parts

-t, --trace

prints debug output alongside with normal output

--trace-name-only

if a rule is named, omit the line number; implies --trace

--trace-no-removed

does not print removed readings; implies --trace

--trace-encl

traces which enclosure pass is currently happening; implies --trace

--dry-run

make no actual changes to the input

--single-run

runs each section only once; same as --max-runs 1

--max-runs

runs each section max N times; defaults to unlimited (0)

-S, --statistics

gathers profiling statistics while applying grammar

-Z, --optimize-unsafe

destructively optimize the profiled grammar to be faster

-z, --optimize-safe

conservatively optimize the profiled grammar to be faster

-p, --prefix

sets the mapping prefix; defaults to @

--unicode-tags

outputs Unicode code points for things like ->

--unique-tags

outputs unique tags only once per reading

--num-windows

number of windows to keep in before/ahead buffers; defaults to 2

--always-span

forces scanning tests to always span across window boundaries

--soft-limit

number of cohorts after which the SOFT-DELIMITERS kick in; defaults to 300

--hard-limit

number of cohorts after which the window is forcefully cut; defaults to 500

-D, --dep-delimit

delimit windows based on dependency instead of DELIMITERS; defaults to 10

--dep-original

outputs the original input dependency tag even if it is no longer valid

--dep-allow-loops

allows the creation of circular dependencies

--dep-no-crossing

prevents the creation of dependencies that would result in crossing branches

--no-magic-readings

prevents running rules on magic readings

-o, --no-pass-origin

prevents scanning tests from passing the point of origin

-e, --show-end-tags

allows the <<< tags to appear in output

--show-unused-sets

prints a list of unused sets and their line numbers; implies --grammar-only

--show-tag-hashes

prints a list of tags and their hashes as they are parsed during the run

--show-set-hashes

prints a list of sets and their hashes; implies --grammar-only