home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c100 / 4.ddi / BISON.ZIP / BISON.DOC < prev    next >
Encoding:
Text File  |  1990-04-17  |  1.7 KB  |  58 lines
  1. This is a plaintext version of bison.1 for those of us who don't have
  2. the required text formatter.
  3.  
  4. bison \- GNU Project parser generator (yacc replacement)
  5.  
  6.  
  7. SYNOPSIS
  8.  
  9.     bison [-dlvtyh] file
  10.  
  11.  
  12. DESCRIPTION
  13.  
  14. Bison is a parser generator in the style of yacc (1).
  15.  
  16. It should be upwardly compatible with input files designed for yacc.  Input
  17. files should follow the yacc convention of ending in '.y'.  Unlike yacc, the
  18. generated files do not have fixed names, but instead use the prefix of the
  19. input file.  For instance, a grammar description file named "parse.y" would
  20. produce the generated parser in a file named "parse.tab.c", instead of yacc's
  21. "y.tab.c".  
  22.  
  23. Bison takes six optional flags.
  24.  
  25.     -h  Displays usage instructions.
  26.  
  27.     -d  Produce a ".tab.h" file, similar to yacc 's "y.tab.h" file.
  28.  
  29.     -l  Omit #line lines in the parser output file. Error messages from the C
  30.         compiler will then be associated with lines in the parser output file,
  31.         instead of lines in the original grammar file.
  32.  
  33.     -t  Turn on debugging. This option causes the bison output to have
  34.         debugging code made available via the C pre-processor.  The external
  35.         variable "yydebug" should be made non-zero to have the debugging code
  36.         actually produce output.
  37.  
  38.     -v  Be verbose. Analogous to the same flag for yacc.
  39.  
  40.     -y  Use fixed output file names. I.e., force the output to be in files
  41.         "y.tab.c", "y.tab.h", and so on. This is for full yacc compatibility.
  42.  
  43.  
  44. FILES
  45.  
  46.     /usr/local/lib/bison.simple    simple parser
  47.     /usr/local/lib/bison.hairy    complicated parser
  48.  
  49. SEE ALSO
  50. yacc (1), The "Bison Reference Manual", included as the file bison.texinfo
  51. in the bison source distribution.  
  52.  
  53.  
  54. DIAGNOSTICS
  55.  
  56. `Self explanatory.'
  57. ... ha!
  58.