etc/README.md

   1 # bench.pl
   2 A primitive Perl script to run benches.  Currently its only bench is the
   3 usual calculator: it has a lightweight processing part (but not null), so it
   4 is really emphasizing the cost of the whole parsing (including scanning and
   5 I/O).
   6
   7 Set the envvars `BISON` and `CC` to the programs and flags you want to use.
   8 They default to `bison` and `gcc`.  To run a non-installed bison from a
   9 tarball built in _build, I suggest the following.
  10
  11     BISON=_build/tests/bison CC='gcc -O2' ./bench.pl
  12
  13 (The `_build/tests/bison` wrapper makes sure that `_build/src/bison` will
  14 use the tarballs' skeletons, not those already installed as a
  15 straightforward use of `_build/src/bison` would.)
  16
  17 <!--
  18
  19 Local Variables:
  20 mode: markdown
  21 fill-column: 76
  22 ispell-dictionary: "american"
  23 End:
  24
  25 Copyright (C) 2006, 2009-2015, 2018-2020 Free Software Foundation, Inc.
  26
  27 This file is part of Bison, the GNU Compiler Compiler.
  28
  29 Permission is granted to copy, distribute and/or modify this document
  30 under the terms of the GNU Free Documentation License, Version 1.3 or
  31 any later version published by the Free Software Foundation; with no
  32 Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
  33 Texts.  A copy of the license is included in the "GNU Free
  34 Documentation License" file as part of this distribution.
  35
  36 -->