1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
<sect1 id="ch-system-bison" role="wrap">
<?dbhtml filename="bison.html"?>
<title>Bison-&bison-version;</title>
<indexterm zone="ch-system-bison">
<primary sortas="a-Bison">Bison</primary>
</indexterm>
<sect2 role="package">
<title/>
<para>The Bison package contains a parser generator.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem>
<seg>0.6 SBU</seg>
<seg>9.9 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>&dependencies;</segtitle>
<seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc,
Grep, M4, Make, and Sed</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Bison</title>
<para>Prepare Bison for compilation:</para>
<screen><userinput>./configure --prefix=/usr</userinput></screen>
<para>The configure system causes bison to be built without support for
internationalization of error messages if a <command>bison</command>
program is not already in $PATH. The following addition will correct
this.</para>
<screen><userinput>echo '#define YYENABLE_NLS 1' >> config.h</userinput></screen>
<para>Compile the package:</para>
<screen><userinput>make</userinput></screen>
<para>To test the results, issue:
<userinput>make check</userinput>.</para>
<para>Install the package:</para>
<screen><userinput>make install</userinput></screen>
</sect2>
<sect2 id="contents-bison" role="content">
<title>Contents of Bison</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<segtitle>Installed library</segtitle>
<seglistitem>
<seg>bison and yacc</seg>
<seg>liby.a</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="bison">
<term><command>bison</command></term>
<listitem>
<para>Generates, from a series of rules, a program for analyzing the
structure of text files; Bison is a replacement for Yacc (Yet Another
Compiler Compiler)</para>
<indexterm zone="ch-system-bison bison">
<primary sortas="b-bison">bison</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="yacc">
<term><command>yacc</command></term>
<listitem>
<para>A wrapper for <command>bison</command>, meant for programs that
still call <command>yacc</command> instead of <command>bison</command>;
it calls <command>bison</command> with the <parameter>-y</parameter>
option</para>
<indexterm zone="ch-system-bison yacc">
<primary sortas="b-yacc">yacc</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="liby.a">
<term><filename class="libraryfile">liby.a</filename></term>
<listitem>
<para>The Yacc library containing implementations of Yacc-compatible
<function>yyerror</function> and <function>main</function> functions;
this library is normally not very useful, but POSIX requires it</para>
<indexterm zone="ch-system-bison liby.a">
<primary sortas="c-liby.a">liby.a</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>
|
