bison.1 1.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263
  1. .TH BISON 1 local
  2. .SH NAME
  3. bison \- GNU Project parser generator (yacc replacement)
  4. .SH SYNOPSIS
  5. .B bison
  6. [
  7. .B \-dvy
  8. ] file
  9. .SH DESCRIPTION
  10. .I Bison
  11. is a parser generator in the style of
  12. .IR yacc (1).
  13. It should be upwardly compatible with input files designed
  14. for
  15. .IR yacc .
  16. .PP
  17. Input files should follow the
  18. .I yacc
  19. convention of ending in ``.y''.
  20. Unlike
  21. .IR yacc ,
  22. the generated files do not have fixed names, but instead use the prefix
  23. of the input file.
  24. For instance, a grammar description file named
  25. .B parse.y
  26. would produce the generated parser in a file named
  27. .BR parse.tab.c ,
  28. instead of
  29. .IR yacc 's
  30. .BR y.tab.c .
  31. .PP
  32. .I Bison
  33. takes three optional flags.
  34. .TP
  35. .B \-d
  36. Produce a
  37. .B .tab.h
  38. file, similar to
  39. .IR yacc 's
  40. .B y.tab.h
  41. file.
  42. .TP
  43. .B \-v
  44. Be verbose. Analogous to the same flag for
  45. .IR yacc .
  46. .TP
  47. .B \-y
  48. Use fixed output file names. I.e., force the output to be in files
  49. .BR y.tab.c ,
  50. .BR y.tab.h ,
  51. and so on. This is for full
  52. .I yacc
  53. compatibility.
  54. .SH FILES
  55. /usr/local/lib/bison.simple simple parser
  56. .br
  57. /usr/local/lib/bison.hairy complicated parser
  58. .SH SEE ALSO
  59. .IR yacc (1)
  60. .SH DIAGNOSTICS
  61. ``Self explanatory.''
  62. ... ha!