bison.xml 2.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  3. <!ENTITY % general-entities SYSTEM "../general.ent">
  4. %general-entities;
  5. ]>
  6. <sect1 id="ch-system-bison" xreflabel="Bison" role="wrap">
  7. <title>Bison-&bison-version;</title>
  8. <?dbhtml filename="bison.html"?>
  9. <indexterm zone="ch-system-bison"><primary sortas="a-Bison">Bison</primary></indexterm>
  10. <sect2 role="package"><title/>
  11. <para>The Bison package contains a parser generator.</para>
  12. <segmentedlist>
  13. <segtitle>&buildtime;</segtitle>
  14. <segtitle>&diskspace;</segtitle>
  15. <seglistitem><seg>0.6 SBU</seg><seg>10.6 MB</seg></seglistitem>
  16. </segmentedlist>
  17. <segmentedlist>
  18. <segtitle>Bison installation depends on</segtitle>
  19. <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
  20. GCC, Gettext, Glibc, Grep, M4, Make, Sed</seg></seglistitem>
  21. </segmentedlist>
  22. </sect2>
  23. <sect2 role="installation">
  24. <title>Installation of Bison</title>
  25. <para>Prepare Bison for compilation:</para>
  26. <screen><userinput>./configure --prefix=/usr</userinput></screen>
  27. <para>Compile the package:</para>
  28. <screen><userinput>make</userinput></screen>
  29. <para>To test the results, issue:
  30. <userinput>make check</userinput>.</para>
  31. <para>Now install the package:</para>
  32. <screen><userinput>make install</userinput></screen>
  33. </sect2>
  34. <sect2 id="contents-bison"><title>Contents of Bison</title>
  35. <para><emphasis>Installed programs</emphasis>: bison and yacc</para>
  36. <para><emphasis>Installed library</emphasis>: liby.a</para>
  37. </sect2>
  38. <sect2><title>Short descriptions</title>
  39. <indexterm zone="ch-system-bison bison"><primary sortas="b-bison">bison</primary></indexterm>
  40. <para id="bison"><command>bison</command> generates, from a series of rules, a program
  41. for analyzing the structure of text files. Bison is a replacement for yacc
  42. (Yet Another Compiler Compiler).</para>
  43. <indexterm zone="ch-system-bison yacc"><primary sortas="b-yacc">yacc</primary></indexterm>
  44. <para id="yacc"><command>yacc</command> is a wrapper for bison, meant for programs
  45. that still call yacc instead of bison. It calls bison with the -y option.</para>
  46. <indexterm zone="ch-system-bison liby.a"><primary sortas="c-liby.a">liby.a</primary></indexterm>
  47. <para id="liby.a"><command>liby.a</command> is the Yacc library containing
  48. implementations of Yacc-compatible yyerror and main functions. This library
  49. is normally not very useful, but POSIX requires it.</para>
  50. </sect2>
  51. </sect1>