diff options
author | Fangrui Song <i@maskray.me> | 2021-07-12 10:14:42 -0700 |
---|---|---|
committer | Fangrui Song <i@maskray.me> | 2021-07-12 10:14:42 -0700 |
commit | 46580d43fc70dcecf21d2cedceeb4910c756fa6e (patch) | |
tree | 6eeae71f07bdd67222f128839876f4f6c399dfa1 /llvm/docs/CommandGuide/llvm-readelf.rst | |
parent | fe892114e33b8f98bf3537a0dd6d6798821cb849 (diff) | |
download | llvm-46580d43fc70dcecf21d2cedceeb4910c756fa6e.zip llvm-46580d43fc70dcecf21d2cedceeb4910c756fa6e.tar.gz llvm-46580d43fc70dcecf21d2cedceeb4910c756fa6e.tar.bz2 |
[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
Diffstat (limited to 'llvm/docs/CommandGuide/llvm-readelf.rst')
-rw-r--r-- | llvm/docs/CommandGuide/llvm-readelf.rst | 10 |
1 files changed, 1 insertions, 9 deletions
diff --git a/llvm/docs/CommandGuide/llvm-readelf.rst b/llvm/docs/CommandGuide/llvm-readelf.rst index cf4222f..7af304a 100644 --- a/llvm/docs/CommandGuide/llvm-readelf.rst +++ b/llvm/docs/CommandGuide/llvm-readelf.rst @@ -37,10 +37,6 @@ OPTIONS Display the contents of the basic block address map section(s), which contain the address of each function, along with the relative offset of each basic block. -.. option:: --color - - Use colors in the output for warnings and errors. - .. option:: --demangle, -C Display demangled symbol names in the output. @@ -84,7 +80,7 @@ OPTIONS When used with :option:`--relocations`, display each relocation in an expanded multi-line format. -.. option:: --file-headers, -h +.. option:: --file-header, -h Display file headers. @@ -109,10 +105,6 @@ OPTIONS Display a summary of command line options. -.. option:: --help-list - - Display an uncategorized summary of command line options. - .. option:: --hex-dump=<section[,section,...]>, -x Display the specified section(s) as hexadecimal bytes. ``section`` may be a |