packaging: remove build dependens on automake, bison
[platform/upstream/flex.git] / doc / flex.info
1 This is flex.info, produced by makeinfo version 6.1 from flex.texi.
2
3 The flex manual is placed under the same licensing conditions as the
4 rest of flex:
5
6    Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2012 The Flex
7 Project.
8
9    Copyright (C) 1990, 1997 The Regents of the University of California.
10 All rights reserved.
11
12    This code is derived from software contributed to Berkeley by Vern
13 Paxson.
14
15    The United States Government has rights in this work pursuant to
16 contract no.  DE-AC03-76SF00098 between the United States Department of
17 Energy and the University of California.
18
19    Redistribution and use in source and binary forms, with or without
20 modification, are permitted provided that the following conditions are
21 met:
22
23   1. Redistributions of source code must retain the above copyright
24      notice, this list of conditions and the following disclaimer.
25
26   2. Redistributions in binary form must reproduce the above copyright
27      notice, this list of conditions and the following disclaimer in the
28      documentation and/or other materials provided with the
29      distribution.
30
31    Neither the name of the University nor the names of its contributors
32 may be used to endorse or promote products derived from this software
33 without specific prior written permission.
34
35    THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
36 WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
37 MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
38 INFO-DIR-SECTION Programming
39 START-INFO-DIR-ENTRY
40 * flex: (flex).      Fast lexical analyzer generator (lex replacement).
41 END-INFO-DIR-ENTRY
42
43 \1f
44 Indirect:
45 flex.info-1: 1622
46 flex.info-2: 318745
47 \1f
48 Tag Table:
49 (Indirect)
50 Node: Top\7f1622
51 Node: Copyright\7f9414
52 Node: Reporting Bugs\7f10933
53 Node: Introduction\7f11189
54 Node: Simple Examples\7f12018
55 Node: Format\7f15304
56 Node: Definitions Section\7f15759
57 Ref: Definitions Section-Footnote-1\7f18017
58 Node: Rules Section\7f18085
59 Node: User Code Section\7f19243
60 Node: Comments in the Input\7f19681
61 Node: Patterns\7f21051
62 Ref: case and character ranges\7f27883
63 Node: Matching\7f31886
64 Node: Actions\7f35171
65 Node: Generated Scanner\7f44133
66 Node: Start Conditions\7f49136
67 Node: Multiple Input Buffers\7f59678
68 Ref: Scanning Strings\7f66221
69 Node: EOF\7f67850
70 Node: Misc Macros\7f69436
71 Node: User Values\7f72290
72 Node: Yacc\7f74615
73 Node: Scanner Options\7f75510
74 Node: Options for Specifying Filenames\7f78299
75 Ref: option-header\7f78525
76 Ref: option-outfile\7f79239
77 Ref: option-stdout\7f79564
78 Node: Options Affecting Scanner Behavior\7f80547
79 Ref: option-case-insensitive\7f80788
80 Ref: option-lex-compat\7f81221
81 Ref: option-batch\7f81753
82 Ref: option-interactive\7f82272
83 Ref: option-7bit\7f83626
84 Ref: option-8bit\7f84930
85 Ref: option-default\7f85342
86 Ref: option-always-interactive\7f85406
87 Ref: option-posix\7f86010
88 Ref: option-stack\7f87157
89 Ref: option-stdinit\7f87265
90 Ref: option-yylineno\7f87744
91 Ref: option-yywrap\7f88187
92 Node: Code-Level And API Options\7f88454
93 Ref: option-ansi-definitions\7f88681
94 Ref: option-ansi-prototypes\7f88756
95 Ref: option-bison-bridge\7f88829
96 Ref: option-bison-locations\7f89170
97 Ref: option-noline\7f89430
98 Ref: option-reentrant\7f89944
99 Ref: option-c++\7f90556
100 Ref: option-array\7f90682
101 Ref: option-pointer\7f90780
102 Ref: option-prefix\7f90907
103 Ref: option-main\7f92435
104 Ref: option-nounistd\7f92619
105 Ref: option-yyclass\7f93130
106 Node: Options for Scanner Speed and Size\7f93614
107 Ref: option-align\7f94164
108 Ref: option-ecs\7f94666
109 Ref: option-meta-ecs\7f95705
110 Ref: option-read\7f96193
111 Ref: option-full\7f98076
112 Ref: option-fast\7f98271
113 Node: Debugging Options\7f99195
114 Ref: option-backup\7f99382
115 Ref: option-debug\7f99927
116 Ref: option-perf-report\7f100649
117 Ref: option-nodefault\7f101275
118 Ref: option-trace\7f101593
119 Ref: option-nowarn\7f101884
120 Ref: option-verbose\7f101952
121 Ref: option-warn\7f102381
122 Node: Miscellaneous Options\7f102600
123 Node: Performance\7f103056
124 Node: Cxx\7f113303
125 Node: Reentrant\7f121395
126 Node: Reentrant Uses\7f122129
127 Node: Reentrant Overview\7f123691
128 Node: Reentrant Example\7f124491
129 Node: Reentrant Detail\7f125264
130 Node: Specify Reentrant\7f125768
131 Node: Extra Reentrant Argument\7f126418
132 Node: Global Replacement\7f127670
133 Node: Init and Destroy Functions\7f128905
134 Node: Accessor Methods\7f131426
135 Node: Extra Data\7f132773
136 Node: About yyscan_t\7f135040
137 Node: Reentrant Functions\7f135437
138 Ref: bison-functions\7f136921
139 Node: Lex and Posix\7f137660
140 Node: Memory Management\7f145007
141 Ref: memory-management\7f145153
142 Node: The Default Memory Management\7f145387
143 Ref: The Default Memory Management-Footnote-1\7f149207
144 Node: Overriding The Default Memory Management\7f149360
145 Ref: Overriding The Default Memory Management-Footnote-1\7f151774
146 Node: A Note About yytext And Memory\7f151938
147 Node: Serialized Tables\7f153178
148 Ref: serialization\7f153322
149 Node: Creating Serialized Tables\7f154102
150 Node: Loading and Unloading Serialized Tables\7f155717
151 Node: Tables File Format\7f157490
152 Node: Diagnostics\7f164515
153 Node: Limitations\7f167924
154 Node: Bibliography\7f169872
155 Node: FAQ\7f170542
156 Node: When was flex born?\7f175705
157 Node: How do I expand backslash-escape sequences in C-style quoted strings?\7f176082
158 Node: Why do flex scanners call fileno if it is not ANSI compatible?\7f177385
159 Node: Does flex support recursive pattern definitions?\7f178182
160 Node: How do I skip huge chunks of input (tens of megabytes) while using flex?\7f179029
161 Node: Flex is not matching my patterns in the same order that I defined them.\7f179496
162 Node: My actions are executing out of order or sometimes not at all.\7f181242
163 Node: How can I have multiple input sources feed into the same scanner at the same time?\7f182015
164 Node: Can I build nested parsers that work with the same input file?\7f184000
165 Node: How can I match text only at the end of a file?\7f185007
166 Node: How can I make REJECT cascade across start condition boundaries?\7f185811
167 Node: Why cant I use fast or full tables with interactive mode?\7f186825
168 Node: How much faster is -F or -f than -C?\7f188082
169 Node: If I have a simple grammar cant I just parse it with flex?\7f188394
170 Node: Why doesn't yyrestart() set the start state back to INITIAL?\7f188876
171 Node: How can I match C-style comments?\7f189503
172 Node: The period isn't working the way I expected.\7f190313
173 Node: Can I get the flex manual in another format?\7f191558
174 Node: Does there exist a "faster" NDFA->DFA algorithm?\7f192048
175 Node: How does flex compile the DFA so quickly?\7f192558
176 Node: How can I use more than 8192 rules?\7f193524
177 Node: How do I abandon a file in the middle of a scan and switch to a new file?\7f194934
178 Node: How do I execute code only during initialization (only before the first scan)?\7f195488
179 Node: How do I execute code at termination?\7f196265
180 Node: Where else can I find help?\7f196591
181 Node: Can I include comments in the "rules" section of the file?\7f196965
182 Node: I get an error about undefined yywrap().\7f197345
183 Node: How can I change the matching pattern at run time?\7f197821
184 Node: How can I expand macros in the input?\7f198183
185 Node: How can I build a two-pass scanner?\7f199215
186 Node: How do I match any string not matched in the preceding rules?\7f200133
187 Node: I am trying to port code from AT&T lex that uses yysptr and yysbuf.\7f201042
188 Node: Is there a way to make flex treat NULL like a regular character?\7f201837
189 Node: Whenever flex can not match the input it says "flex scanner jammed".\7f202357
190 Node: Why doesn't flex have non-greedy operators like perl does?\7f203000
191 Node: Memory leak - 16386 bytes allocated by malloc.\7f204353
192 Ref: faq-memory-leak\7f204651
193 Node: How do I track the byte offset for lseek()?\7f205622
194 Node: How do I use my own I/O classes in a C++ scanner?\7f207131
195 Node: How do I skip as many chars as possible?\7f207974
196 Node: deleteme00\7f209049
197 Node: Are certain equivalent patterns faster than others?\7f209489
198 Node: Is backing up a big deal?\7f212907
199 Node: Can I fake multi-byte character support?\7f214813
200 Node: deleteme01\7f216254
201 Node: Can you discuss some flex internals?\7f217363
202 Node: unput() messes up yy_at_bol\7f219607
203 Node: The | operator is not doing what I want\7f220709
204 Node: Why can't flex understand this variable trailing context pattern?\7f222255
205 Node: The ^ operator isn't working\7f223504
206 Node: Trailing context is getting confused with trailing optional patterns\7f224739
207 Node: Is flex GNU or not?\7f225982
208 Node: ERASEME53\7f227655
209 Node: I need to scan if-then-else blocks and while loops\7f228425
210 Node: ERASEME55\7f229624
211 Node: ERASEME56\7f230722
212 Node: ERASEME57\7f232080
213 Node: Is there a repository for flex scanners?\7f233078
214 Node: How can I conditionally compile or preprocess my flex input file?\7f233394
215 Node: Where can I find grammars for lex and yacc?\7f233867
216 Node: I get an end-of-buffer message for each character scanned.\7f234214
217 Node: unnamed-faq-62\7f234809
218 Node: unnamed-faq-63\7f235827
219 Node: unnamed-faq-64\7f237124
220 Node: unnamed-faq-65\7f238090
221 Node: unnamed-faq-66\7f238876
222 Node: unnamed-faq-67\7f239991
223 Node: unnamed-faq-68\7f240978
224 Node: unnamed-faq-69\7f242120
225 Node: unnamed-faq-70\7f242833
226 Node: unnamed-faq-71\7f243594
227 Node: unnamed-faq-72\7f244803
228 Node: unnamed-faq-73\7f245846
229 Node: unnamed-faq-74\7f246770
230 Node: unnamed-faq-75\7f247715
231 Node: unnamed-faq-76\7f248847
232 Node: unnamed-faq-77\7f249553
233 Node: unnamed-faq-78\7f250446
234 Node: unnamed-faq-79\7f251444
235 Node: unnamed-faq-80\7f253144
236 Node: unnamed-faq-81\7f254462
237 Node: unnamed-faq-82\7f257262
238 Node: unnamed-faq-83\7f258219
239 Node: unnamed-faq-84\7f259999
240 Node: unnamed-faq-85\7f261102
241 Node: unnamed-faq-86\7f262109
242 Node: unnamed-faq-87\7f263047
243 Node: unnamed-faq-88\7f263693
244 Node: unnamed-faq-90\7f264524
245 Node: unnamed-faq-91\7f265787
246 Node: unnamed-faq-92\7f268215
247 Node: unnamed-faq-93\7f268714
248 Node: unnamed-faq-94\7f269641
249 Node: unnamed-faq-95\7f271053
250 Node: unnamed-faq-96\7f272571
251 Node: unnamed-faq-97\7f273330
252 Node: unnamed-faq-98\7f273997
253 Node: unnamed-faq-99\7f274662
254 Node: unnamed-faq-100\7f275591
255 Node: unnamed-faq-101\7f276301
256 Node: What is the difference between YYLEX_PARAM and YY_DECL?\7f277114
257 Node: Why do I get "conflicting types for yylex" error?\7f277638
258 Node: How do I access the values set in a Flex action from within a Bison action?\7f278168
259 Node: Appendices\7f278597
260 Node: Makefiles and Flex\7f278862
261 Ref: Makefiles and Flex-Footnote-1\7f282064
262 Ref: Makefiles and Flex-Footnote-2\7f282181
263 Ref: Makefiles and Flex-Footnote-3\7f282368
264 Node: Bison Bridge\7f282419
265 Ref: Bison Bridge-Footnote-1\7f285086
266 Node: M4 Dependency\7f285278
267 Ref: M4 Dependency-Footnote-1\7f286692
268 Node: Common Patterns\7f286828
269 Node: Numbers\7f287151
270 Node: Identifiers\7f288127
271 Node: Quoted Constructs\7f288954
272 Node: Addresses\7f290008
273 Node: Indices\7f291320
274 Node: Concept Index\7f291612
275 Node: Index of Functions and Macros\7f318745
276 Node: Index of Variables\7f323714
277 Node: Index of Data Types\7f325380
278 Node: Index of Hooks\7f326268
279 Node: Index of Scanner Options\7f326836
280 \1f
281 End Tag Table