racc 1.4.9 → 1.4.10

data/rdoc/en/command.en.html

@@ -1,78 +0,0 @@
-<h1>Racc Command Reference</h1>
-<p>
-racc [-o<var>filename</var>] [--output-file=<var>filename</var>]
-     [-e<var>rubypath</var>] [--embedded=<var>rubypath</var>]
-     [-v] [--verbose]
-     [-O<var>filename</var>] [--log-file=<var>filename</var>]
-     [-g] [--debug]
-     [-E] [--embedded]
-     [-l] [--no-line-convert]
-     [-c] [--line-convert-all]
-     [-a] [--no-omit-actions]
-     [-C] [--check-only]
-     [-S] [--output-status]
-     [--version] [--copyright] [--help] <var>grammarfile</var>
-</p>
-
-<dl>
-<dt><var>filename</var>
-<dd>
-Racc grammar file. Any extention is permitted.
-</dd>
-<dt>-o<var>outfile</var>, --output-file=<var>outfile</var>
-<dd>
-A filename for output. default is &lt;filename&gt;.tab.rb
-</dd>
-<dt>-O<var>filename</var>, --log-file=<var>filename</var>
-<dd>
-Place logging output in file <var>filename</var>.
-Default log file name is <var>filename</var>.output.
-</dd>
-<dt>-e<var>rubypath</var>, --executable=<var>rubypath</var>
-<dd>
-output executable file(mode 755). <var>path</var> is a path of ruby interpreter.
-</dd>
-<dt>-v, --verbose
-<dd>
-verbose mode. create &lt;filename&gt;.output file, like yacc's y.output file.
-</dd>
-<dt>-g, --debug
-<dd>
-add debug code to parser class. To display debuggin information,
-use this '-g' option and set @yydebug true in parser class.
-</dd>
-<dt>-E, --embedded
-<dd>
-Output parser which doesn't need runtime files (racc/parser.rb).
-</dd>
-<dt>-C, --check-only
-<dd>
-Check syntax of racc grammer file and quit.
-</dd>
-<dt>-S, --output-status
-<dd>
-Print messages time to time while compiling.
-</dd>
-<dt>-l, --no-line-convert
-<dd>
-turns off line number converting.
-</dd>
-<dt>-c, --line-convert-all
-<dd>
-Convert line number of actions, inner, header and footer.
-<dt>-a, --no-omit-actions
-<dd>
-Call all actions, even if an action is empty.
-</dd>
-<dt>--version
-<dd>
-print Racc version and quit.
-</dd>
-<dt>--copyright
-<dd>
-Print copyright and quit.
-<dt>--help
-<dd>
-Print usage and quit.
-</dd>
-</dl>

data/rdoc/en/debug.en.rdoc

@@ -1,20 +0,0 @@
-= Debugging
-
-== Racc reported syntax error.
-
-Isn't there too many "end"?
-grammar of racc file is changed in v0.10.
-
-Racc does not use '%' mark, while yacc uses huge number of '%' marks..
-
-== Racc reported "XXXX conflicts".
-
-Try "racc -v xxxx.y".
-It causes producing racc's internal log file, xxxx.output.
-
-== Generated parsers does not work correctly
-
-Try "racc -g xxxx.y".
-This command let racc generate "debugging parser".
-Then set @yydebug=true in your parser.
-It produces a working log of your parser.

data/rdoc/en/index.en.html

@@ -1,10 +0,0 @@
-<h1>Racc User Manual</h1>
-<p>updated for version 1.4</p>
-<ul>
-<li><a href="usage.html">Usage</a>
-<li><a href="command.html">Racc Command Reference</a>
-<li><a href="grammar.html">Racc Grammar File Reference</a>
-<li><a href="parser.html">Racc::Parser class Reference</a>
-<li><a href="debug.html">Debugging Parser</a>
-<li><a href="NEWS.html">Release Note</a>
-</ul>

data/rdoc/en/parser.en.rdoc

@@ -1,74 +0,0 @@
-= class Racc::Parser
-
-== Super Class
-
-Object
-
-== Instance Methods
-
-: do_parse -> Object
-    The entry point of parser. This method is used with #next_token.
-    If Racc wants to get token (and its value), calls next_token.
-
-      --
-      # Example
-      ---- inner
-        def parse
-          @q = [[1,1],
-                [2,2],
-                [3,3],
-                [false, '$']]
-          do_parse
-        end
-
-        def next_token
-          @q.shift
-        end
-      --
-
-: next_token -> [Symbol, Object]
-    [abstract method]
-
-    The method to fetch next token.  If you use #do_parse method,
-    you must implement #next_token.  The format of return value is
-    [TOKEN_SYMBOL, VALUE].  token-symbol is represented by Ruby's symbol
-    by default, e.g. :IDENT for 'IDENT'.  ";" (String) for ';'.
-
-    The final symbol (End of file) must be false.
-
-: yyparse( receiver, method_id )
-    The another entry point of parser.
-    If you use this method, you must implement RECEIVER#METHOD_ID method.
-
-    RECEIVER#METHOD_ID is a method to get next token.
-    It must 'yield's token, which format is [TOKEN-SYMBOL, VALUE].
-
-: on_error( error_token_id, error_value, value_stack )
-    This method is called when parse error is found.
-
-    ERROR_TOKEN_ID is an internal ID of token which caused error.
-    You can get string replesentation of this ID by calling
-    #token_to_str.
-
-    ERROR_VALUE is a value of error token.
-
-    value_stack is a stack of symbol values.
-    DO NOT MODIFY this object.
-
-    This method raises ParseError by default.
-
-    If this method returns, parsers enter "error recovering mode".
-
-: token_to_str( t ) -> String
-    Convert internal ID of token symbol to the string.
-
-: yyerror
-    Enter error recovering mode.
-    This method does not call #on_error.
-
-: yyerrok
-    Leave error recovering mode.
-
-: yyaccept
-    Exit parser.
-    Return value is Symbol_Value_Stack[0].

data/rdoc/en/usage.en.html

@@ -1,92 +0,0 @@
-<h1>Usage</h1>
-
-<h2>Generating Parser Using Racc</h2>
-<p>
-To compile Racc grammar file, simply type:
-</p>
-<pre>
-$ racc parse.y
-</pre>
-<p>
-This creates ruby script file "parse.tab.y". -o option changes this.
-</p>
-
-<h2>Writing Racc Grammer File</h2>
-<p>
-If you want your own parser, you have to write grammar file.
-A grammar file contains name of parser class, grammar the parser can parse,
-user code, and any.<br>
-When writing grammar file, yacc's knowledge is helpful.
-If you have not use yacc, also racc is too difficult.
-</p>
-<p>
-Here's example of Racc grammar file.
-</p>
-<pre>
-class Calcparser
-rule
-  target: exp { print val[0] }
-
-  exp: exp '+' exp
-     | exp '*' exp
-     | '(' exp ')'
-     | NUMBER
-end
-</pre>
-<p>
-Racc grammar file is resembles to yacc file.
-But (of cource), action is Ruby code. yacc's $$ is 'result', $0, $1... is
-an array 'val', $-1, $-2... is an array '_values'.
-</p>
-<p>
-Then you must prepare parse entry method. There's two types of
-racc's parse method, 
-<a href="parser.html#Racc%3a%3aParser-do_parse"><code>do_parse</code></a> and
-<a href="parser.html#Racc%3a%3aParser-yyparse"><code>yyparse</code></a>.
-</p>
-<p>
-"do_parse()" is simple. it is yyparse() of yacc, and "next_token()" is
-yylex(). This method must returns an array like [TOKENSYMBOL, ITS_VALUE].
-EOF is [false, false].
-(token symbol is ruby symbol (got by String#intern) as default.
- If you want to change this, see <a href="grammar.html#token">grammar reference</a>.
-</p>
-<p>
-"yyparse()" is little complecated, but useful. It does not use "next_token()",
-it gets tokens from any iterator. For example, "yyparse(obj, :scan)" causes
-calling obj#scan, and you can return tokens by yielding them from obj#scan.
-</p>
-<p>
-When debugging, "-v" or/and "-g" option is helpful.
-"-v" causes creating verbose log file (.output).
-"-g" causes creating "Verbose Parser".
-Verbose Parser prints internal status when parsing.
-But it is <em>not</em> automatic.
-You must use -g option and set @yydebug true to get output.
--g option only creates verbose parser.
-</p>
-
-<h3>re-distributing Racc runtime</h3>
-<p>
-A parser, which is created by Racc, requires Racc runtime module;
-racc/parser.rb.
-</p>
-<p>
-Ruby 1.8.x comes with racc runtime module,
-you need NOT distribute racc runtime files.
-</p>
-<p>
-If you want to run your parsers on ruby 1.6,
-you need re-distribute racc runtime module with your parser.
-It can be done by using '-E' option:
-<pre>
-$ racc -E -omyparser.rb myparser.y
-</pre>
-<p>
-This command creates myparser.rb which `includes' racc runtime.
-Only you must do is to distribute your parser file (myparser.rb).
-</p>
-<p>
-Note: parser.rb is LGPL, but your parser is not.
-Your own parser is completely yours.
-</p>