[PATCH] D156436: [llvm/OptTable] Print options without documentation

Andrzej Warzynski via Phabricator via llvm-commits llvm-commits at lists.llvm.org
Fri Jul 28 08:09:09 PDT 2023


awarzynski added a comment.

@j0le, thanks for caring about `--help` - it could really benefit from a bit of love. However, I'm not convinced that this is the right direction:

> With these changes:
>
>   $ ./clang.exe --help | wc -l
>   2451
>   
>   $ ./clang.exe --help-hidden | wc -l
>   2556

We should focus on quality rather than the quantity of the help text being printed. Personally, I find `clang --help` of little help because it is just a very long dump of unfiltered/uncategorized text. As pointed out in my inline comment, it's perfectly fine to skip some options from the `--help` dump if they don't really contribute any new information. However, categorizing options so that `clang --help` would greatly improve the user experience. At least for Clang. In the case of Flang the list of supported options is still very short and `--help` is quite "manageable".


CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D156436/new/

https://reviews.llvm.org/D156436



More information about the llvm-commits mailing list