From: helly Date: Sun, 4 Sep 2005 12:01:21 +0000 (+0000) Subject: - Update docu X-Git-Tag: 0.13.6~603 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=5ee51adec4357970340cc7dc901c2fe040d102ac;p=re2c - Update docu --- diff --git a/htdocs/manual.html b/htdocs/manual.html index 052d190c..657f0b04 100755 --- a/htdocs/manual.html +++ b/htdocs/manual.html @@ -7,7 +7,7 @@

RE2C

Section: User Commands (1)
-Updated: 26 June 2005
+Updated: 04 September 2005
Index

@@ -15,7 +15,7 @@ Updated: 26 June 2005

re2c - convert regular expressions to C/C++

SYNOPSIS

re2c [-efsbvhd] [-o output] file

re2c [-efsbvhdi] [-o output] file

DESCRIPTION

re2c is a preprocessor that generates C-based recognizers from @@ -111,6 +111,10 @@ parser issues and states. If you use this switch you need to define a macro YYDEBUG that is called like a function with two parameters: void YYDEBUG(int state, char current). The first parameter receives the state or -1 and the second parameter receives the input at the current cursor.

+

-i

Do not output #line information. This is usefull when you want use a CMS +tool with the re2c output which you might want if you do not require your users +to have re2c themselves when building from your source.

-h

-? Invoke a short help.

-v

@@ -164,6 +168,15 @@ the user wish to save the state of the scanner and have YYFILL return to the caller, all he has to do is store that unique identifer in a variable. Later, when the scannered is called again, it will call YYGETSTATE() and resume execution right where it left off.

+

YYDEBUG(state,current)

This is only needed if the -d flag was specified. It allows to +easily debug the generated parser by calling a user defined function for every +state. The function should have the following signature: void YYDEBUG(int +state, char current). The first parameter receives the state or -1 and the +second parameter receives the input at the current cursor.

YYMAXFILL

This will be automatically defined by /*!max:re2c */ blocks as explained +above.

@@ -209,6 +222,8 @@ ANSI-C escape sequences can be used.

[abj-oZ]

a "character class" with a range in it; matches an 'a', a 'b', any letter from 'j' through 'o', or a 'Z'.

[^class]

an inverted "character class".

r\s

match any r which isn't an s. r and s must be regular expressions which can be expressed as character classes.

@@ -236,19 +251,28 @@ context".

matches r at least n times.

r{n,m}

matches r at least n but not more than m times.

match any character except newline (\n).

def

matches named definition as specified by def.

Character classes and string literals may contain octoal or hexadecimal +character definitions and the following set of escape sequences (\n,
+ \t, \v, \b, \r, \f, \a, \\). An octal character is defined by a backslash +followed by its three octal digits and a hexadecimal character is defined by +backslash, a lower cased 'x' and its two hexadecimal digits.

The regular expressions listed above are grouped according to precedence, from highest precedence at the top to lowest at the bottom. Those grouped together have equal precedence.

A LARGER EXAMPLE

-#include <stdlib.h>
-#include <stdio.h>
-#include <fcntl.h>
-#include <string.h>
+#include <stdlib.h>
+#include <stdio.h>
+#include <fcntl.h>
+#include <string.h>
 
 #define ADDEQ   257
 #define ANDAND  258
@@ -538,9 +562,8 @@ newline (or some other character that can't appear within another token); upon
 recognizing such a character check to see if it is the sentinel and act
 accordingly.
 re2c does not provide start conditions: use a separate scanner
-specification for each start condition (as illustrated in the above
-example).
-No [^x]. Use difference instead.  
+specification for each start condition (as illustrated in the above example).
+ 
 BUGS
 Only fixed length trailing context can be handled.
 Difference only works for character sets.
@@ -570,7 +593,7 @@ No [^x]. Use difference instead.  
 

  
 VERSION INFORMATION
-This manpage describes re2c, version 0.9.8.
+This manpage describes re2c, version 0.9.10.
 
  
 Index
@@ -594,6 +617,6 @@ No [^x]. Use difference instead.  
 

 
 This document was created by man2html, using the manual pages.

-Time: 10:30:42 GMT, June 26, 2005
+Time: 11:33:44 GMT, September 04, 2005