commit 7c6a610b98e344ef485f60862db46ec271a50c5a
from: Omar Polo <op@omarpolo.com>
date: Thu Oct 01 11:07:57 2020 UTC

improved readme.  also mention bison

commit - 5f4cdf4fa31e121c74571a03ef5c81a4fa7376d4
commit + 7c6a610b98e344ef485f60862db46ec271a50c5a
blob - ad55b3892535095587bf543c20f62e6fdd4468d0
blob + cc926c272ce118e599019e3f403998c938bbf36c
--- README.md
+++ README.md
@@ -13,20 +13,28 @@ Check out the [manpage](star-platinum.1) for more info
 
     make
 
+OpenBSD' `lex` and `yacc` were tested, as well as `bison` 3.3.2, GNU
+gcc 4.2.1 and 8.4.0, and clang 10.0.1
+
 Configuration for the build process can be found in `config.mk`, but
 you usually don't need to modify it: passing the variables to make
 should be enough.  For instance, to build with `gcc`
 
     make CC=gcc
 
-## FAQ
+`bison` can be used instead of `yacc` by changing the `YACC` variable
 
- - *something something* bison *something something*
+    make YACC=bison
 
-   `star-platinum` should build with GNU `bison` and flex, but I've
-   still not tried.  `bison` has some defaults different from `yacc`
-   IIRC, so additional flags may be needed.
+Unless you are compiling on OpenBSD, you probably want to change the
+default `CFLAGS` and `LDFLAGS`.
 
+If `etags` is available, a `TAGS` file is created.  Note however that
+`etags` is **not needed** for building: it's only a support tool used
+to aid the development.
+
+## FAQ
+
  - the name is a jojo reference?
 
    Sort of.  I was listening to 「sono chi kioku」, the fourth opening,