update README to reflect current code generation

Also, add part about riml_include re-ordering and avoidance of
multiple-inclusion.

Add 'Tools' and 'Projects' sections.

[ci-skip]