Debian Codegraph @

manual/man/vislcg3.1

raw
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