Create jflex rule for bazel

[regisd]

• Define the Bazel rule jflex. Fix Add support for Bazel #204 (Bazel support)
• The rule uses JFlex 1.6.1 because v1.7.0 has missing dependencies (see Failure to find de.jflex:cup_runtime:jar:11b #390)
• Show how to use the rule on example "simple"
  • Make examples a Bazel workspace
  • In an wish to support all build systems in the examples, show how to generate a lexer with Bazel on "simple".
  • Attempted to have a java_test on Yylex. However dropped, because the dump format has changed between 1.6.1 and 1.7.0. Blocked on Failure to find de.jflex:cup_runtime:jar:11b #390
  • Import the deps needed for simple via the bazel migration tool.
  • Also define, a few third_party aliases
  • N.B. Renamed ant build directory to antbuild because we cannot have both a build directory ant a BUILD file on case insensitive filesystems
  • Also, in the YylexTest output the logs in a ByteArrayOutputStream rather than an actual file.
• Add documentation