Options File

[Remillard]

The amount of options (and the length of the names) make the CLI somewhat tedious to work with. I've got a new file that will do indentation, however the inference is not working for alignment. Hence I'm looking at having to specify all the align parameters.

However, there is the --flagfile option but I've seen no documentation on how this file is to be formatted. Is it just one option per line, or a JSON or YAML format (similar to the Github action). An example somewhere in the documentation would be mighty useful.

Just as an example I tried putting the following in a txt file:

indentation_spaces=4
inplace=true

And I got the response:

ERROR: Unexpected line in the flagfile .\verible_fmt_flags.txt: indentation_spaces=4
ERROR: Unexpected line in the flagfile .\verible_fmt_flags.txt: inplace=true

So, clearly there's some expectation here that I'm not satisfying. Is there an example anywhere for this?

[IEncinas10]

verible-verilog-format --helpfull

shows

[...]

  Flags from external/com_google_absl/absl/flags/parse.cc:
    --flagfile (comma-separated list of files to load flags from); default: ;
    --fromenv (comma-separated list of flags to set from the environment [use
      'export FLAGS_flag1=value']); default: ;
    --tryfromenv (comma-separated list of flags to try to set from the
      environment if present); default: ;
    --undefok (comma-separated list of flag names that it is okay to specify on
      the command line even if the program does not define a flag with that
      name); default: ;

[...]

Note that the --flagfile option comes from the abseil flags library (I tried finding a better link but it the failed state where I live we block cloudflare IPs to "combat football piracy"), thats why it isn't really documented here.

You just need to write the flags in verible_fmt_flags.txt like you would in the command line

-indentation_spaces=4
-inplace=true
+--indentation_spaces=4
+--inplace=true