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

« back to all changes in this revision

Viewing changes to packages/racc/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
1
Racc README
 
2
===========
2
3
 
3
4
  Racc is a LALR(1) parser generator.
4
 
  It is written in Ruby and outputs Ruby script.
5
 
 
6
 
[Requirement]
7
 
 
8
 
  *  ruby version 1.4.x or later. Latest 1.6 is best.
9
 
  *  make, C compiler
10
 
 
11
 
[Installation]
12
 
 
13
 
  Type this:
14
 
 
15
 
    $ ruby install.rb config
16
 
    $ ruby install.rb setup
17
 
    # ruby install.rb install   (maybe by root)
18
 
 
19
 
  You can install Racc into your favorite directory by using
20
 
  install.rb options. For details, try "ruby install.rb --help".
21
 
 
22
 
[Testing Racc]
 
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
------------
23
48
 
24
49
  Racc comes with simple calculator. To compile this, on shell:
25
50
 
26
 
      $ racc -e ruby -o calc calc.y
27
 
 
28
 
  This process costs few seconds (or less). Then type
29
 
 
30
 
      $ ./calc
31
 
 
32
 
  Is it OK ?
33
 
  For Racc details, see HTML documents placed under 'doc.en/'
 
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/'
34
59
  and sample grammer files under 'sample/'.
35
60
 
36
 
[License]
 
61
 
 
62
License
 
63
-------
37
64
 
38
65
  Racc is distributed under the terms of the GNU Lesser General
39
 
  Public License version 2. But ruby script file generated
40
 
  by Racc is not. You can treat those files as you like.
41
 
 
42
 
[Bug]
43
 
 
44
 
  Bug report is welcome.
45
 
  If you find a bug of Racc, please e-mail me. Your grammer file,
 
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,
46
76
  debug output genereted by "racc -g", are helpful.
47
77
 
48
78
 
49
79
                                                      Minero Aoki
50
80
                                              aamine@loveruby.net
51
 
                                          http://www.loveruby.net
 
81
                                            http://i.loveruby.net