| 1 |
.TH vislcg3 1 2014-05-07 "" "" |
| 2 |
.SH NAME |
| 3 |
vislcg3 \- This application is part of ( |
| 4 |
.B cg3 |
| 5 |
) |
| 6 |
.PP |
| 7 |
This tool is part of the CG-3 |
| 8 |
constraint grammar system: \fBhttps://edu.visl.dk/cg3.html\fR. |
| 9 |
.SH SYNOPSIS |
| 10 |
.B vislcg3 |
| 11 |
[OPTIONS] |
| 12 |
.SH DESCRIPTION |
| 13 |
.BR vislcg3 |
| 14 |
is the grammar parser and disambiguator in the VISL |
| 15 |
constraint grammar system. It chooses between different analyses |
| 16 |
(or "readings") of a word delivered by a morphological analyser |
| 17 |
based on a set of grammatical rules. |
| 18 |
.PP |
| 19 |
By default, vislcg3 reads input from stdin and writes output |
| 20 |
to stdout. |
| 21 |
.RE |
| 22 |
.SH OPTIONS |
| 23 |
.TP |
| 24 |
\fB\-h\fR, \fB\-\-help\fR |
| 25 |
shows this help |
| 26 |
.TP |
| 27 |
\-?, \fB\-\-\fR? |
| 28 |
shows this help |
| 29 |
.TP |
| 30 |
\fB\-V\fR, \fB\-\-version\fR |
| 31 |
prints copyright and version information |
| 32 |
.TP |
| 33 |
\fB\-g\fR, \fB\-\-grammar\fR |
| 34 |
specifies the grammar file to use for disambiguation |
| 35 |
.TP |
| 36 |
\fB\-\-grammar\-out\fR |
| 37 |
writes the compiled grammar in textual form to a file |
| 38 |
.TP |
| 39 |
\fB\-\-grammar\-bin\fR |
| 40 |
writes the compiled grammar in binary form to a file |
| 41 |
.TP |
| 42 |
\fB\-\-grammar\-only\fR |
| 43 |
only compiles the grammar; implies \fB\-\-verbose\fR |
| 44 |
.TP |
| 45 |
\fB\-\-ordered\fR |
| 46 |
(will in future allow full ordered matching) |
| 47 |
.TP |
| 48 |
\fB\-u\fR, \fB\-\-unsafe\fR |
| 49 |
allows the removal of all readings in a cohort, even the last one |
| 50 |
.TP |
| 51 |
\fB\-s\fR, \fB\-\-sections\fR |
| 52 |
number or ranges of sections to run; defaults to all sections |
| 53 |
.TP |
| 54 |
\fB\-\-rules\fR |
| 55 |
number or ranges of rules to run; defaults to all rules |
| 56 |
.TP |
| 57 |
\fB\-\-rule\fR |
| 58 |
a name or number of a single rule to run |
| 59 |
.TP |
| 60 |
\fB\-d\fR, \fB\-\-debug\fR |
| 61 |
enables debug output (very noisy) |
| 62 |
.TP |
| 63 |
\fB\-v\fR, \fB\-\-verbose\fR |
| 64 |
increases verbosity |
| 65 |
.TP |
| 66 |
\fB\-2\fR, \fB\-\-vislcg\-compat\fR |
| 67 |
enables compatibility mode for older CG\-2 and vislcg grammars |
| 68 |
.TP |
| 69 |
\fB\-I\fR, \fB\-\-stdin\fR |
| 70 |
file to read input from instead of stdin |
| 71 |
.TP |
| 72 |
\fB\-O\fR, \fB\-\-stdout\fR |
| 73 |
file to print output to instead of stdout |
| 74 |
.TP |
| 75 |
\fB\-E\fR, \fB\-\-stderr\fR |
| 76 |
file to print errors to instead of stderr |
| 77 |
.TP |
| 78 |
\fB\-C\fR, \fB\-\-codepage\-all\fR |
| 79 |
codepage to use for grammar, input, and output streams; defaults to UTF\-8 |
| 80 |
.TP |
| 81 |
\fB\-\-codepage\-grammar\fR |
| 82 |
codepage to use for grammar; overrides \fB\-\-codepage\-all\fR |
| 83 |
.TP |
| 84 |
\fB\-\-codepage\-input\fR |
| 85 |
codepage to use for input; overrides \fB\-\-codepage\-all\fR |
| 86 |
.TP |
| 87 |
\fB\-\-codepage\-output\fR |
| 88 |
codepage to use for output and errors; overrides \fB\-\-codepage\-all\fR |
| 89 |
.TP |
| 90 |
\fB\-L\fR, \fB\-\-locale\-all\fR |
| 91 |
locale to use for grammar, input, and output streams; defaults to en_US_POSIX |
| 92 |
.TP |
| 93 |
\fB\-\-locale\-grammar\fR |
| 94 |
locale to use for grammar; overrides \fB\-\-locale\-all\fR |
| 95 |
.TP |
| 96 |
\fB\-\-locale\-input\fR |
| 97 |
locale to use for input; overrides \fB\-\-locale\-all\fR |
| 98 |
.TP |
| 99 |
\fB\-\-locale\-output\fR |
| 100 |
locale to use for output and errors; overrides \fB\-\-locale\-all\fR |
| 101 |
.TP |
| 102 |
\fB\-\-no\-mappings\fR |
| 103 |
disables all MAP, ADD, and REPLACE rules |
| 104 |
.TP |
| 105 |
\fB\-\-no\-corrections\fR |
| 106 |
disables all SUBSTITUTE and APPEND rules |
| 107 |
.TP |
| 108 |
\fB\-\-no\-before\-sections\fR |
| 109 |
disables all rules in BEFORE\-SECTIONS parts |
| 110 |
.TP |
| 111 |
\fB\-\-no\-sections\fR |
| 112 |
disables all rules in SECTION parts |
| 113 |
.TP |
| 114 |
\fB\-\-no\-after\-sections\fR |
| 115 |
disables all rules in AFTER\-SECTIONS parts |
| 116 |
.TP |
| 117 |
\fB\-t\fR, \fB\-\-trace\fR |
| 118 |
prints debug output alongside with normal output |
| 119 |
.TP |
| 120 |
\fB\-\-trace\-name\-only\fR |
| 121 |
if a rule is named, omit the line number; implies \fB\-\-trace\fR |
| 122 |
.TP |
| 123 |
\fB\-\-trace\-no\-removed\fR |
| 124 |
does not print removed readings; implies \fB\-\-trace\fR |
| 125 |
.TP |
| 126 |
\fB\-\-trace\-encl\fR |
| 127 |
traces which enclosure pass is currently happening; implies \fB\-\-trace\fR |
| 128 |
.TP |
| 129 |
\fB\-\-dry\-run\fR |
| 130 |
make no actual changes to the input |
| 131 |
.TP |
| 132 |
\fB\-\-single\-run\fR |
| 133 |
runs each section only once; same as \fB\-\-max\-runs\fR 1 |
| 134 |
.TP |
| 135 |
\fB\-\-max\-runs\fR |
| 136 |
runs each section max N times; defaults to unlimited (0) |
| 137 |
.TP |
| 138 |
\fB\-S\fR, \fB\-\-statistics\fR |
| 139 |
gathers profiling statistics while applying grammar |
| 140 |
.TP |
| 141 |
\fB\-Z\fR, \fB\-\-optimize\-unsafe\fR |
| 142 |
destructively optimize the profiled grammar to be faster |
| 143 |
.TP |
| 144 |
\fB\-z\fR, \fB\-\-optimize\-safe\fR |
| 145 |
conservatively optimize the profiled grammar to be faster |
| 146 |
.TP |
| 147 |
\fB\-p\fR, \fB\-\-prefix\fR |
| 148 |
sets the mapping prefix; defaults to @ |
| 149 |
.TP |
| 150 |
\fB\-\-unicode\-tags\fR |
| 151 |
outputs Unicode code points for things like \-> |
| 152 |
.TP |
| 153 |
\fB\-\-unique\-tags\fR |
| 154 |
outputs unique tags only once per reading |
| 155 |
.TP |
| 156 |
\fB\-\-num\-windows\fR |
| 157 |
number of windows to keep in before/ahead buffers; defaults to 2 |
| 158 |
.TP |
| 159 |
\fB\-\-always\-span\fR |
| 160 |
forces scanning tests to always span across window boundaries |
| 161 |
.TP |
| 162 |
\fB\-\-soft\-limit\fR |
| 163 |
number of cohorts after which the SOFT\-DELIMITERS kick in; defaults to 300 |
| 164 |
.TP |
| 165 |
\fB\-\-hard\-limit\fR |
| 166 |
number of cohorts after which the window is forcefully cut; defaults to 500 |
| 167 |
.TP |
| 168 |
\fB\-D\fR, \fB\-\-dep\-delimit\fR |
| 169 |
delimit windows based on dependency instead of DELIMITERS; defaults to 10 |
| 170 |
.TP |
| 171 |
\fB\-\-dep\-original\fR |
| 172 |
outputs the original input dependency tag even if it is no longer valid |
| 173 |
.TP |
| 174 |
\fB\-\-dep\-allow\-loops\fR |
| 175 |
allows the creation of circular dependencies |
| 176 |
.TP |
| 177 |
\fB\-\-dep\-no\-crossing\fR |
| 178 |
prevents the creation of dependencies that would result in crossing branches |
| 179 |
.TP |
| 180 |
\fB\-\-no\-magic\-readings\fR |
| 181 |
prevents running rules on magic readings |
| 182 |
.TP |
| 183 |
\fB\-o\fR, \fB\-\-no\-pass\-origin\fR |
| 184 |
prevents scanning tests from passing the point of origin |
| 185 |
.TP |
| 186 |
\fB\-e\fR, \fB\-\-show\-end\-tags\fR |
| 187 |
allows the <<< tags to appear in output |
| 188 |
.TP |
| 189 |
\fB\-\-show\-unused\-sets\fR |
| 190 |
prints a list of unused sets and their line numbers; implies \fB\-\-grammar\-only\fR |
| 191 |
.TP |
| 192 |
\fB\-\-show\-tag\-hashes\fR |
| 193 |
prints a list of tags and their hashes as they are parsed during the run |
| 194 |
.TP |
| 195 |
\fB\-\-show\-set\-hashes\fR |
| 196 |
prints a list of sets and their hashes; implies \fB\-\-grammar\-only\fR |
| 197 |
.RS |
| 198 |
.SH BUGS |
| 199 |
Email to: Tino Didriksen <[email protected]> |
| 200 |
.SH AUTHOR |
| 201 |
(c) 2007-2025 GrammarSoft ApS |