~ubuntu-branches/ubuntu/intrepid/racc/intrepid

« back to all changes in this revision

Viewing changes to packages/raccrt/README.en

  • Committer: Bazaar Package Importer
  • Author(s): akira yamada
  • Date: 2005-04-09 17:54:44 UTC
  • mfrom: (1.2.1 upstream) (2.1.1 warty)
  • Revision ID: james.westby@ubuntu.com-20050409175444-fvtir838ypkn7a58
Tags: 1.4.4-1
* new upstream version.  (closes: #301768)
* added racc2y.1 and y2racc.1.
* modified racc2y and y2racc to use optparse instead of deprecated getopts.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
Racc Runtime README
2
 
===================
3
 
 
4
 
Racc is a parser generator for Ruby. This library contains
5
 
runtime routine for parsers which is generated by Racc.
6
 
For details, see documents distributed with Racc package.
7
 
You can get Racc from http://www.loveruby.net/en/prog/  .
8
 
 
9
 
 
10
 
                                               Minero Aoki
11
 
                                       aamine@loveruby.net
12
 
                                   http://www.loveruby.net
 
1
Racc README
 
2
===========
 
3
 
 
4
  Racc is a LALR(1) parser generator.
 
5
  It is written in Ruby itself, and generates Ruby program.
 
6
 
 
7
  NOTE: Ruby 1.8.x comes with Racc runtime module.  You
 
8
  can run your parsers generated by racc 1.4.x out of the
 
9
  box.
 
10
 
 
11
 
 
12
Requirement
 
13
-----------
 
14
 
 
15
  *  ruby version 1.6.x or later.
 
16
 (*) make and C compiler.
 
17
 
 
18
 
 
19
Installation
 
20
------------
 
21
 
 
22
  Type this in the top directory of the extracted archive:
 
23
 
 
24
    $ ruby setup.rb config
 
25
    $ ruby setup.rb setup
 
26
   ($ su)
 
27
    # ruby setup.rb install
 
28
 
 
29
  You can install Racc into your favorite directory by giving
 
30
  options to setup.rb. e.g.
 
31
  
 
32
    $ ruby setup.rb config --prefix=/usr
 
33
  
 
34
  For details, try "ruby setup.rb --help".
 
35
 
 
36
 
 
37
  If you don't have C Compiler
 
38
  ----------------------------
 
39
 
 
40
  You can install Racc without C compilers. Type following
 
41
  command in config phase.
 
42
 
 
43
    $ ruby setup.rb config --without-ext
 
44
 
 
45
 
 
46
Testing Racc
 
47
------------
 
48
 
 
49
  Racc comes with simple calculator. To compile this, on shell:
 
50
 
 
51
      $ racc -o calc calc.y
 
52
 
 
53
  This process costs few seconds (or less). Then type:
 
54
 
 
55
      $ ruby calc
 
56
 
 
57
  ... Does it works?
 
58
  For details of Racc, see HTML documents placed under 'doc.en/'
 
59
  and sample grammer files under 'sample/'.
 
60
 
 
61
 
 
62
License
 
63
-------
 
64
 
 
65
  Racc is distributed under the terms of the GNU Lesser General
 
66
  Public License version 2. Note that you do NOT need to follow
 
67
  LGPL for your own parser (racc outputs). You can provide those
 
68
  files under any licenses you want.
 
69
 
 
70
 
 
71
Bug Reports
 
72
-----------
 
73
 
 
74
  Any kind of bug reports are welcome.
 
75
  If you find a bug of Racc, please email me. Your grammer file,
 
76
  debug output genereted by "racc -g", are helpful.
 
77
 
 
78
 
 
79
                                                      Minero Aoki
 
80
                                              aamine@loveruby.net
 
81
                                            http://i.loveruby.net