Allow comments in flagfile

The `--flagfile` argument to the compiler is a convenient way to package up the many options needed.
However, the options can be surprising, so the flag file would strongly benefit from being able to add comments:
- what this option does
- explanation for why it's used in the project
- a TODO to change the option to another value, link to a bug