[llvm-readobj] Switch command line parsing from llvm::cl to OptTable
authorFangrui Song <i@maskray.me>
Mon, 12 Jul 2021 17:14:42 +0000 (10:14 -0700)
committerFangrui Song <i@maskray.me>
Mon, 12 Jul 2021 17:14:42 +0000 (10:14 -0700)
commit46580d43fc70dcecf21d2cedceeb4910c756fa6e
tree6eeae71f07bdd67222f128839876f4f6c399dfa1
parentfe892114e33b8f98bf3537a0dd6d6798821cb849
[llvm-readobj] Switch command line parsing from llvm::cl to OptTable

Users should generally observe no difference as long as they don't use
unintended option forms. Behavior changes:

* `-t=d` is removed. Use `-t d` instead.
* `--demangle=false` and `--demangle=0` cannot be used. Omit the option or use `--no-demangle`. Other flag-style options don't have `--no-` forms.
* `--help-list` is removed. This is a `cl::` specific option.
* llvm-readobj now supports grouped short options as well.
* `--color` is removed. This is generally not useful (only apply to errors/warnings) but was inherited from Support.

Some adjustment to the canonical forms
(usually from GNU readelf; currently llvm-readobj has too many redundant aliases):

* --dyn-syms is canonical. --dyn-symbols is a hidden alias
* --file-header is canonical. --file-headers is a hidden alias
* --histogram is canonical. --elf-hash-histogram is a hidden alias
* --relocs is canonical. --relocations is a hidden alias
* --section-groups is canonical. --elf-section-groups is a hidden alias

OptTable avoids global option collision if we decide to support multiplexing for binary utilities.

* Most one-dash long options are still supported. `-dt, -sd, -st, -sr` are dropped due to their conflict with grouped short options.
* `--section-mapping=false` (D57365) is strange but is kept for now.
* Many `cl::opt` variables were unnecessarily external. I added `static` whenever appropriate.

Reviewed By: jhenderson

Differential Revision: https://reviews.llvm.org/D105532
17 files changed:
llvm/docs/CommandGuide/llvm-readelf.rst
llvm/docs/CommandGuide/llvm-readobj.rst
llvm/test/Object/invalid.test
llvm/test/Support/check-default-options.txt
llvm/test/tools/llvm-readobj/ELF/demangle.test
llvm/test/tools/llvm-readobj/ELF/grouped.test
llvm/test/tools/llvm-readobj/ELF/hex-dump.test
llvm/test/tools/llvm-readobj/ELF/output-style.test [new file with mode: 0644]
llvm/test/tools/llvm-readobj/ELF/string-dump.test
llvm/test/tools/llvm-readobj/basic.test
llvm/test/tools/yaml2obj/ELF/shstrtab.yaml
llvm/tools/llvm-readobj/CMakeLists.txt
llvm/tools/llvm-readobj/Opts.td [new file with mode: 0644]
llvm/tools/llvm-readobj/llvm-readobj.cpp
llvm/tools/llvm-readobj/llvm-readobj.h
llvm/utils/gn/secondary/llvm/tools/llvm-readobj/BUILD.gn
utils/bazel/llvm-project-overlay/llvm/BUILD.bazel